# native-fast-printer 自定义基座接入（Windows）

本文用于当前项目一键接入 `native-fast-printer`，并打出可安装的 Android 自定义基座。

## 0. 现状确认

本项目已具备以下前提：

- `src/manifest.json` 已声明 `app-plus.nativePlugins.native-fast-printer`
- `nativeplugins/native-fast-printer` 目录可用
- 打印逻辑已在运行时检查插件可用性

你只需要执行同步 + 在 HBuilderX 打自定义基座。

## 1. 同步插件到 uniapp 目录

在仓库根目录执行：

```powershell
powershell -ExecutionPolicy Bypass -File ".\美国版\Food Labeling Management App UniApp\scripts\sync-native-fast-printer.ps1"
```

成功后会输出 `SRC AAR` / `DST AAR` 的大小与时间戳。

## 2. HBuilderX 打包自定义基座（Android）

1. 用 HBuilderX 打开目录：`美国版/Food Labeling Management App UniApp`
2. 进入 `发行 -> 原生App-云打包`
3. 选择 `Android`
4. 关键项：
   - 勾选 `自定义基座`
   - 勾选 `使用本地 nativeplugins`
   - 确认插件列表包含 `native-fast-printer`
5. 开始打包并下载生成的 APK（自定义基座）
6. 卸载设备旧包，安装这个新 APK

## 3. 安装后验收

1. 打开蓝牙页，连接目标打印机
2. 执行测试打印
3. 进入正式打印页打印 1 张
4. 若插件成功生效，不应再出现 `NATIVE_FAST_PRINTER_PLUGIN_NOT_FOUND`

## 4. 常见问题

- 打包后仍提示插件不存在  
  多数是安装了旧包。请先卸载旧包再安装新 APK。

- HBuilderX 未识别 native plugin  
  检查 `nativeplugins/native-fast-printer/package.json` 是否存在且 `id` 为 `native-fast-printer`。

- 需要更新原生代码  
  修改 `打印机安卓基座/native-fast-printer` 后，重新生成 AAR 并再次执行第 1 步同步。

- **内置打印机走 `nativePrintTemplate`（快打）**（AAR ≥ **1.2.7**，调试里 `pluginVersion` 可见）  
  在 App 内选择 **Built-in**，驱动选 **Generic TSC**（`generic-tsc`），且基座已集成 `printUposCommandBytes`（UPOS）。  
  此时 `printTemplate` 会在原生侧生成 TSC 指令后走 **UPOS 内置写出**，无需经典蓝牙；若机芯实际只支持 ESC/POS，请勿选 TSC，否则可能乱码。