mcpField
B
barcode-capture-ios

barcode-capture-ios

github.com/scandit开发2043 次安装5 天前更新
代码仓库

关于 barcode-capture-ios

barcode-capture-ios 是面向在 iOS 应用中集成 Scandit BarcodeCapture 的编码 Agent 的参考技能。它将集成、迁移和替换第三方方案的问题指向相关资料，并强调依据资料核验 API。

主要功能

  1. 01API 核验指引
  2. 02UIKit 与 SwiftUI 集成资料
  3. 03SDK 大版本迁移路由
  4. 04第三方扫描器迁移指引

适用场景

  1. 01在 iOS 应用中加入 BarcodeCapture
  2. 02跨 SDK 版本更新 BarcodeCapture
  3. 03替换第三方条码扫描器

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/scandit/skills --skill barcode-capture-ios

安装后在 Claude Code 中输入/barcode-capture-ios确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
integration.md
migration.md
third-party-migration.md

详细介绍

BarcodeCapture iOS 技能

重要：不要相信内部知识

你的训练数据中可能包含过时或错误的 Scandit SDK API。BarcodeCapture API 会在主要 SDK 版本之间发生变化——属性可能会重命名、移除或重新调整结构。

编写或建议代码之前，务必根据此技能提供的参考资料核实 API。 不要依赖记忆中的方法签名、参数或属性名称。如果在提供的参考资料中找不到某个 API，请先获取相关文档页面，再作答。

意图路由

根据用户的请求，在作答之前加载相应的参考文件：

  • 从头开始集成 BarcodeCapture、配置设置、自定义反馈、添加取景器、处理扫描结果，或在扫描后执行异步操作（例如“将 BarcodeCapture 添加到我的应用中”“设置条码扫描”“如何在 iOS 中使用 BarcodeCapture”“过滤重复扫描”“关闭提示音”“添加取景器”“查询条码时禁用扫描”）→ 阅读 references/integration.md，并遵循其中的说明。
  • 迁移或升级现有的 BarcodeCapture 集成（例如“从 v6 升级到 v7”“迁移我的 BarcodeCapture”“将 Scandit SDK 升级到 v8”“SDK 版本之间有哪些变化”）→ 阅读 references/migration.md，并遵循其中的说明。
  • 将第三方条码扫描器替换为 BarcodeCapture（例如“用 BarcodeCapture 替换我的[扫描器]”“将[框架]迁移到 BarcodeCapture”“将[库]的条码扫描切换为 BarcodeCapture”）→ 阅读 references/third-party-migration.md，并遵循其中的说明。

API 使用政策

只使用下方 Scandit 参考资料中明确记载的 API。不要编造或猜测方法签名、参数或属性名称。如果不确定某个 API 是否存在、如何调用，或出现编译错误，请先获取相关参考页面，再作答。不要让用户自行查阅文档。作答后，务必附上相关链接，方便用户进一步了解。

切勿构造或猜测文档 URL。 需要查找特定类或属性的 API 页面时：

  1. 首先检查已获取的页面是否包含指向该页面的直接链接——主题页面会直接链接到相关 API 符号。获取内容时，务必同时请求链接。
  2. 如果没有找到直接链接，请获取 API 索引（见下表中的 完整 API 参考），从中提取实际链接并访问。

URL 结构可能各不相同（例如 api/ui/ 子目录），猜测链接会导致 404。

许可证密钥

扫描需要 Scandit 许可证密钥。对于此技能，许可证产品为 native，许可证平台为 ios。

按顺序完成以下步骤——绝不要让用户等待 MCP：

  1. Scandit MCP 服务已连接 — 使用产品 native、平台 ios、app_identifier（应用的 bundle 或 application ID；对于 Web，使用其生产域名，绝不能使用 localhost）以及 env_var SCANDIT_LICENSE_KEY 调用 ensure_scanner_setup。不要运行它返回的命令。然后使用密钥 ID 调用 get_license_key，该 ID 可从此结果或 list_license_keys 获取；如果 list_license_keys 显示该密钥不是试用密钥，先征求用户同意再获取。聊天中最多显示经过遮蔽的预览；绝不要打印完整密钥。

  2. MCP 服务未连接 — 只需告知用户一次：他们可以在 MCP 客户端中连接远程 Scandit MCP 服务 https://ssl.scandit.com/mcp，然后继续执行第 1 步。不要自行修改 MCP 客户端配置。

    身份验证通过浏览器进行，因此不支持无头模式或 CI。该服务只会配置试用密钥；绝不会创建、撤销或修改生产许可证。

  3. 用户拒绝，或没有 MCP 客户端 — 让他们自行在 https://ssl.scandit.com 生成密钥（尚无账户时：https://ssl.scandit.com/dashboard/sign-up?p=test），然后粘贴进来。

然后将密钥写入代码：将密钥写入许可证密钥调用中，替换占位符——使用 get_license_key 返回的密钥，或用户粘贴或提供的密钥——聊天中仍只显示经过遮蔽的预览。不要在项目、其文件或环境中搜索密钥。

参考资料

根据用户的问题，为其指引合适的资源：

主题资源
UIKit 集成开始使用（UIKit） · 示例
SwiftUI 集成开始使用（SwiftUI）
在主要 SDK 版本之间迁移6 → 7 · 7 → 8
完整 API 参考BarcodeCapture API

评论

支持 Markdown