从 Lodop 并行迁移:一周 PoC web-print-pdf(不必一刀切)

正在做 Lodop 迁移,又不敢全切?本文给出盘点 → 下载客户端跑通样例 → 与 Lodop 并行 PoC → 按单据 HTML 化的步骤,不是 API 一对一替换。选型见 Lodop 替代对比;Chrome/C-Lodop 见 C-Lodop 排查。

如何阅读本文

Lodop 在套打、内网票据等场景有长期应用积累。若现有 Lodop 运行稳定,无需仅因本文而变更。本文面向:新建业务模块、希望用 HTML/CSS 统一报表版式、需在 Win/Mac/信创多端共用 npm 接口、或需与 远程打印 联动的团队,作为与 Lodop 并行的 PoC 参考。

迁移前盘点(建议表格记录)

先梳理现状,再决定哪些单据并行 PoC、哪些继续沿用 Lodop。

盘点项建议记录用途
单据/模板清单名称、调用页面、日打印量排 PoC 与 HTML 化优先级
版式类型A4 报表 / 热敏 / 毫米套打评估是否适合 HTML 渲染
打印机驱动名称、纸张、是否默认机配置 printOptions
终端环境Windows / 信创、浏览器版本选客户端安装包
现有 Lodop 调用入口函数、是否 C-Lodop设计并行开关,便于回滚

实现方式对照(参考)

下表描述常见集成差异,非 API 一对一替换说明;具体以各产品官方文档为准。

环节Lodop 常见做法web-print-pdf 常见做法
版式Lodop 指令 / 套打HTML/CSS 模板
触发LODOP 对象 APIprintHtml(html, pdfOpts, printOpts)
静默出纸本地控件 / 服务Web打印专家客户端 + npm
浏览器侧含 C-Lodop 等部署标准 Web + WebSocket 本地服务
信创桌面以 Lodop 官方说明为准deb 客户端(见 Linux 部署)

分阶段路径(可并行 Lodop)

三阶段可重叠:阶段 1 验证技术可行;阶段 2 业务并行;阶段 3 按盘点表逐步扩展。全程可保留 Lodop 处理尚未 HTML 化的单据。

阶段 1:PoC(约 1~2 个工作日)

  1. 下载并启动 Web打印专家客户端
  2. 浏览器打开 80mm 小票样例,先跑通静默打印(约 5 分钟)
  3. 项目 npm install web-print-pdf
  4. 选一张结构简单的 HTML 报表(建议先非毫米套打)
  5. 调用 printHtml,与 Lodop 样张并排对比
  6. 业务方签字确认是否进入并行

阶段 2:并行运行(约 2~4 周)

  1. 配置功能开关:新模块 / 新单据走 web-print-pdf
  2. 存量 Lodop 单据维持原链路,不做一刀切
  3. 记录异常与回滚步骤(关闭开关即可)
  4. 需要服务端推送时,参考 WMS 远程面单
  5. 2~4 周后复盘打印量与故障率

阶段 3:按优先级 HTML 化

  1. 按盘点表「日打印量 × HTML 化难度」排序
  2. 优先迁移 A4 报表、订单类 HTML 版式
  3. 毫米套打逐项评估;暂不适合的可继续 Lodop
  4. 信创工位统一 deb 客户端,见 麒麟 / UOS 专题
  5. 更新运维文档与 错误处理 规范

并行与回滚

并行期务必保留 Lodop 环境与授权配置,回滚时关闭 web-print-pdf 开关、恢复原有 Lodop 调用即可。避免在未完成 PoC 前卸载 Lodop 服务或删除模板。

下载客户端 · 先跑通样例再并行 80mm 小票样例 → Lodop 选型对比

风险与应对

  • 套打偏差:HTML 版式需打样校准;不达标单据可继续 Lodop
  • 双链路运维:并行期明确哪类单据走哪条链路,写进运维手册
  • 客户端未启动:工位自检 getConnectStatus(),见错误处理专题
  • 授权与合规:Lodop 与 web-print-pdf 授权政策各自独立,请分别遵循官方条款

常见问题

能否把 Lodop API 直接改成 printHtml?

不能一对一替换。需为目标单据准备 HTML/CSS 版式,再调用 printHtml;Lodop 模板需单独评估重写范围。

哪些单据建议继续用 Lodop?

已稳定运行的精密套打、短期无法 HTML 化的票据,可继续 Lodop;新建 HTML 报表优先 PoC web-print-pdf。

并行期出问题如何回滚?

关闭 web-print-pdf 功能开关,恢复原有 Lodop 调用;勿删除 Lodop 服务与模板。

与 C-Lodop / Chrome 专题有何区别?

C-Lodop 与浏览器适配见 C-Lodop 专题;本文侧重分阶段并行接入步骤。

说明与商标

本文仅供技术集成参考。Lodop、C-Lodop 为独立产品,名称仅用于识别与对比,商标归权利人所有。文中现象为部分环境的公开反馈,不代表该产品必然存在缺陷。是否继续 Lodop 或引入 web-print-pdf,请以官方文档与本单位 IT 规范为准。

各平台客户端部署

同一套 web-print-pdf 前端代码可在 Windows、macOS、Linux/信创混合环境运行;请按终端操作系统安装对应客户端。

下载客户端 · 先跑通样例再并行 查看 npm 包 开发文档