如何在Ionic 5+Cordova跨端APP中实现无交互直接打印至POS热敏打印机？

核心思路 #

要实现无交互、多打印机兼容的打印，核心是绕开系统默认打印对话框，直接通过底层API或专用POS打印插件与打印机通信，分Android和iOS平台针对性处理，同时基于通用打印标准做跨设备适配。

插件选型（替代系统弹窗类插件） #

放弃会触发系统对话框的cordova-plugin-printer，改用专注POS热敏打印的专用插件：

• cordova-plugin-pos-printer：支持EPSON、Star、佳博、芯烨等主流品牌，兼容蓝牙、USB、WiFi三种连接方式，可直接发送打印指令，无系统弹窗。
• cordova-plugin-escpos-printer：轻量型插件，聚焦ESC/POS标准指令集，适配绝大多数热敏打印机，适合追求精简的场景。

无交互打印实现步骤 #

1. 安装插件（以cordova-plugin-pos-printer为例） #

ionic cordova plugin add cordova-plugin-pos-printer
npm install @ionic-native/pos-printer

2. 预配置打印机（避免重复交互） #

• 在APP首次启动或设置页，引导用户扫描并选择常用打印机，将打印机的连接参数（蓝牙MAC、WiFi IP、USB设备ID等）存储到Ionic Storage或localStorage中。
• 打印前直接调用插件的连接方法，使用预存参数，无需用户再次选择。

3. 无交互打印代码实现 #

import { PosPrinter } from '@ionic-native/pos-printer/ngx';
import { Storage } from '@ionic/storage';

constructor(private posPrinter: PosPrinter, private storage: Storage) {}

async printReceipt() {
  // 读取预存的打印机配置
  const printerConfig = await this.storage.get('selected_printer');
  
  // 构造符合格式的打印内容
  const printContent = [
    { text: 'XX生鲜便利店', align: 'center', bold: true, size: 2 },
    { text: '------------------------', align: 'center' },
    { text: '商品名称: 农夫山泉矿泉水', align: 'left' },
    { text: '单价: 2.00元', align: 'right' },
    { text: '数量: 1', align: 'left' },
    { text: '实付: 2.00元', align: 'right' },
    { text: '------------------------', align: 'center' },
    { text: '打印时间: ' + new Date().toLocaleString(), align: 'center' },
    { text: '\n\n' } // 自动走纸
  ];

  try {
    // 直接发起打印，无系统弹窗
    await this.posPrinter.print(printContent, {
      printerId: printerConfig.id,
      interface: printerConfig.interface, // 可选值：'bluetooth'/'usb'/'wifi'
      timeout: 10000
    });
    console.log('打印成功');
  } catch (error) {
    console.error('打印失败:', error);
    // 可添加重试逻辑或静默提示用户检查打印机连接
  }
}

4. 平台权限与特殊处理 #

• Android：
  在AndroidManifest.xml添加必要权限：

  <uses-permission android:name="android.permission.BLUETOOTH" />
  <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <!-- 蓝牙扫描必填 -->
  <uses-permission android:name="android.permission.USB_PERMISSION" />
  

  USB打印首次连接需申请设备权限，授权后保存权限状态，后续无需用户交互。

• iOS：
  在Info.plist添加蓝牙权限描述：

  <key>NSBluetoothAlwaysUsageDescription</key>
  <string>需要蓝牙连接热敏打印机</string>
  <key>NSBluetoothPeripheralUsageDescription</key>
  <string>需要蓝牙连接热敏打印机</string>
  

  WiFi打印机需确保设备与打印机在同一局域网，直接通过IP地址连接即可。

多打印机兼容技巧 #

• 统一使用ESC/POS指令：绝大多数热敏打印机支持ESC/POS标准，直接发送原始指令比依赖插件上层封装兼容性更强。示例：

  const rawEscPos = Buffer.from([
    0x1B, 0x40, // 初始化打印机
    0x1B, 0x61, 0x01, // 居中对齐
    ...Buffer.from('XX便利店\n'),
    0x1B, 0x61, 0x00, // 左对齐
    ...Buffer.from('商品: 矿泉水 2元\n'),
    0x1D, 0x56, 0x41, 0x03 // 走纸3行并切纸
  ]);
  // 发送原始指令打印
  await this.posPrinter.printRaw(rawEscPos, printerConfig);
  

• 添加打印机测试功能：在设置页提供测试打印入口，让用户验证连接有效性，避免预存参数失效。
• 失败 fallback 机制：自动打印失败时，可静默触发一次重试，仍失败再提示用户手动检查，不打断主流程。

注意事项 #

• 部分蓝牙打印机需指定波特率，WiFi打印机需确认端口号（默认9100），需在插件配置中明确。
• Android 12+蓝牙权限需动态申请，需在代码中调用权限API引导用户授权。
• iOS 13+蓝牙扫描需用户主动授权，首次启动时需明确告知用户权限用途。

内容的提问来源于stack exchange，提问作者Yala Hat