SuperAPI AI 工具集

ios-bluetooth-printing

编程与开发

查看项目

更新于 10-16 06:03

技能介绍

用途

本技能用于在 iOS 应用中集成 CoreBluetooth,与 ESC/POS 热敏打印机进行蓝牙低功耗(BLE)通信。它把 Android 端 BluetoothPrinter.kt 与 EscPosReceipt.kt 的模式直接翻译为 Swift/SwiftUI 实现,覆盖 BLE 发现、配对、特征值写入、ESC/POS 指令翻译以及小票格式化。

主要能力

  • CoreBluetooth 架构与 CBCentralManagerDelegate、CBPeripheralDelegate 的使用。
  • ESC/POS 指令从 Android 到 Swift 的直接翻译。
  • 小票构建器,镜像 Android 的 EscPosReceipt 行为。
  • 分块 BLE 写入方式发送打印数据。
  • Info.plist 所需键、SwiftUI 集成与完整小票示例。
  • 常见问题与重连处理,并提供实现检查清单。

使用方式

先阅读 SKILL.md,再按需加载 references/ 目录下的深入文件(如 references/skill-deep-dive.md),避免默认加载全部参考文件。按技能给出的有序指引、检查清单与决策规则执行,而不是零散摘取片段。需要收集相关项目上下文、约束与具体问题,并确认交付物类型(设计、代码、评审、迁移计划、审计或文档)。

适用场景

  • 将 iOS 应用连接到蓝牙热敏打印机。
  • 从 iOS POS 或 SaaS 应用打印小票、发票或标签。
  • 将 Android ESC/POS 打印逻辑移植到 iOS。

限制与不适用场景

  • 不适用于 AirPrint / 网络打印机(应使用 UIPrintInteractionController)。
  • 不适用于 USB/串口打印机(非 BLE)。
  • 不适用于仅生成 PDF 而不进行物理打印的场景。
  • 任务与本技能无关,或存在更具体的配套技能时不应使用。
  • 仅需简单回答、本技能的约束或参考无实质帮助时不应使用。

技术栈与兼容性

Swift 5.9+、CoreBluetooth、SwiftUI、ESC/POS 字节协议;最低 iOS 16.0,目标 iOS 18.x;要求小票输出与 Android 端 EscPosReceipt.kt 字节级一致。

质量与反模式

输出应面向执行、简洁,并符合仓库基线工程标准;除非技能明确要求更高标准,否则保持与现有项目约定兼容;优先采用确定性、可评审的步骤。反模式包括:把示例当作可直接复制的真理而不检查适配性、约束或失败模式;默认加载全部参考文件而非渐进式披露。

产出

可交付实现指引、评审发现、架构决策、模板或生成产物,并明确假设、权衡或未解决的缺口;在有助于执行时列出所用参考、配套技能或后续动作。示例证据产物为 BLE 热敏打印机测试计划(Markdown 文档,覆盖配对、特征发现、写入特征与 ESC/POS 载荷测试,路径 docs/ios/ble-printer-tests.md)。

暂未提供

官方文档未提供具体收费、价格、平台支持范围之外的信息,以及可选辅助插件的具体名称与用途。