Android WebView应用POS 58MM打印机打印故障求助

桌面端依赖浏览器打印API或系统打印服务实现的POS 58MM打印逻辑，无法直接在安卓WebView中生效。WebView作为安卓原生组件，需要通过JS与原生代码交互，调用printerlibs.jar的安卓端打印能力才能实现需求。

• 配置WebView启用JS并绑定原生交互接口

  WebView webView = findViewById(R.id.webview);
  WebSettings webSettings = webView.getSettings();
  webSettings.setJavaScriptEnabled(true);
  // 绑定JS调用的原生桥接对象，"PrintBridge"为网页端调用标识
  webView.addJavascriptInterface(new PrintHandler(this), "PrintBridge");
  

• 封装printerlibs.jar的打印逻辑到原生交互类

  public class PrintHandler {
      private Context context;
  
      public PrintHandler(Context ctx) {
          this.context = ctx;
      }
  
      @JavascriptInterface // 必须添加此注解，允许JS调用
      public void printPOSContent(String content) {
          // 调用printerlibs.jar完成打印，示例逻辑
          POSPrinter printer = new POSPrinter(context);
          if (printer.connect()) {
              printer.printText(content);
              printer.disconnect();
          } else {
              // 打印失败时回调网页
              webView.post(() -> webView.loadUrl("javascript:onPrintResult('连接打印机失败')"));
          }
      }
  }
  

• 修改网页端打印逻辑，适配安卓WebView环境

  function printReceipt(printData) {
      // 检测是否在安卓WebView中
      if (window.PrintBridge) {
          window.PrintBridge.printPOSContent(printData);
      } else {
          // 保留桌面端原有打印逻辑
          window.print();
      }
  }
  
  // 接收原生端的打印结果回调
  function onPrintResult(msg) {
      alert(msg);
  }
  

• 配置安卓权限与适配

  • 在AndroidManifest.xml中添加打印机所需权限（根据连接方式选择）

    <!-- 蓝牙打印机权限 -->
    <uses-permission android:name="android.permission.BLUETOOTH" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
    <!-- USB打印机权限 -->
    <uses-permission android:name="android.permission.USB_PERMISSION" />
    

  • 安卓6.0及以上版本需动态申请相关权限，避免权限拒绝导致打印失败

• 必须添加@JavascriptInterface注解，否则JS无法调用原生方法
• 打印操作需放在子线程执行，避免阻塞UI线程（可使用AsyncTask或协程）
• 打印内容需适配58MM打印机宽度（通常为384px），防止内容排版异常

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