如何快速搭建并运行IOS-nRF-Toolbox：面向BLE开发者的Xcode完整教程
【免费下载链接】IOS-nRF-ToolboxThe nRF Toolbox is a container app that stores your Nordic Semiconductor apps for Bluetooth Low Energy in one location.项目地址: https://gitcode.com/gh_mirrors/io/IOS-nRF-Toolbox
nRF Toolbox（IOS-nRF-Toolbox）是一款面向蓝牙低功耗（BLE）开发的 iOS 容器应用，将 Nordic Semiconductor 的多个 BLE 配置文件演示应用集于一身：心率、血压、血糖、骑行、Nordic UART 以及设备固件更新（DFU）。本教程带你 5 步完成 Xcode 工程打开、依赖解析与真机运行，是 BLE 新手最实用的搭建指南。
一、为什么选择 nRF Toolbox？
如果你正在学习 CoreBluetooth，需要一台“真机 + 一个能连 BLE 外设的调试 App”，nRF Toolbox 就是理想选择。它内置了 10+ 个 BLE 配置文件演示：
| 功能模块 | 说明 |
|---|---|
| 🚴 骑行 / 跑步传感器 | Cycling & Running Speed and Cadence |
| ❤️ 心率 / 血压 / 血糖 | Heart Rate、Blood Pressure、Glucose Monitor |
| 🌡️ 体温 / 连续血糖 | Health Thermometer、Continuous Glucose Monitor |
| 🔧 Nordic UART | 自定义串口通信，BLE 调试神器 |
| 📡 DFU 固件更新 | 支持 ZIP / HEX / BIN 空中升级 nRF5x 设备 |
| 🏠 HomeKit | 将 HomeKit 设备切换至 DFU 模式 |
启动后你会看到 Nordic Semiconductor 的启动页，随后进入功能宫格主界面：
nRF Toolbox BLE 应用启动界面，展示 Nordic Semiconductor 品牌画面
二、搭建前准备清单
开始前，请对照下表检查环境（只需满足 3 项即可）：
| 准备项 | 要求 | 说明 |
|---|---|---|
| 电脑 | macOS + Xcode 14 或更高 | 工程使用 Swift 5，依赖库要求较新的 Swift 工具链 |
| 设备 | 真机 iPhone | BLE 连接必须真机，模拟器无法连接硬件外设 |
| 账号 | Apple 开发者账号（免费即可） | 用于代码签名 |
| 网络 | 可访问源码托管网络 | 首次构建需自动下载 Swift 包依赖 |
💡 核心提示：这个项目不需要手动安装任何第三方库，所有依赖由 Swift Package Manager 自动管理。
三、一键克隆仓库
打开终端，执行以下命令克隆代码：
git clone https://gitcode.com/gh_mirrors/io/IOS-nRF-Toolbox.git cd IOS-nRF-Toolbox克隆完成后，用 Xcode 打开根目录下的nRF Toolbox.xcodeproj工程文件即可。工程结构清晰，各 BLE 配置文件均按模块独立存放于nRF Toolbox/Profiles/目录下（如HeartRateMonitor/、UART/、DeviceFirmwareUpdate/），方便后续阅读源码。
四、Xcode 自动解析依赖（关键一步）
首次打开工程时，Xcode 会自动识别并下载 Swift 包依赖，无需任何额外操作。依赖清单可在nRF Toolbox.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved中核对，主要包括：
- Charts：心率、血糖曲线绘制
- IOS-DFU-Library：DFU 固件空中更新核心库
- IOS-nRF-Connect-Device-Manager：设备连接管理
- ZIPFoundation：解析 DFU 分发包 ZIP
- AEXML / SwiftCBOR：Zephyr DFU 协议解析
⏳ 首次构建可能需要 3~5 分钟（依赖下载 + 全量编译），属正常现象。
五、配置签名并在真机运行
- 选择签名团队：在工程 Target → Signing & Capabilities 中，勾选 "Automatically manage signing" 并选择你的团队。
- 确认蓝牙权限：App 已内置蓝牙用途描述（见
nRF Toolbox/nRF Toolbox-Info.plist中的NSBluetoothAlwaysUsageDescription），无需额外配置。 - 运行方案：顶部选择nRF Toolbox方案（构建产物为 nRF Toolbox Debug.app），连接 iPhone 后点击 ▶ 运行。
⚠️ 常见坑与解决方案
| 问题 | 解决方案 |
|---|---|
| 模拟器无法连接 BLE 外设 | 必须使用真机运行 |
| 首次编译极慢或卡住 | 等待 SPM 依赖下载完成；可先 File → Packages → Resolve 预热 |
| 代码签名报错 | 更换 Team，或改用个人免费证书 |
| HomeKit 功能报错 | 个人免费账号下 HomeKit 能力受限，不影响其他 BLE 功能 |
六、运行后的第一次体验
App 安装到 iPhone 后，建议先尝试Nordic UART功能：连接一个配好 UART 服务的 nRF5x 开发板，即可收发数据、查看日志，这是 BLE 新手最好的练手场景。
给设备准备固件文件（DFU 玩法）
如果要做 DFU 固件更新，需要将 HEX / ZIP 固件文件传到 iPhone。最简单的方式是通过iTunes 文件共享面板（工程已开启UIFileSharingEnabled）：
当然，你也可以直接把固件文件通过邮件附件发给自己的 iPhone，然后在 App 中打开：
七、总结：5 步速通清单
- ✅ 克隆仓库（git clone）
- ✅ Xcode 打开
nRF Toolbox.xcodeproj - ✅ 等待 SPM 自动解析依赖
- ✅ 配置签名团队，选择真机
- ✅ 运行 App，先玩 UART，再试 DFU
至此，你的 BLE 调试工具链已搭建完毕。后续可以在主界面逐个探索心率、血糖等配置文件演示，配合nRF Toolbox/README.md与CHANGELOG.md了解各版本特性，祝开发顺利 🚀
【免费下载链接】IOS-nRF-ToolboxThe nRF Toolbox is a container app that stores your Nordic Semiconductor apps for Bluetooth Low Energy in one location.项目地址: https://gitcode.com/gh_mirrors/io/IOS-nRF-Toolbox
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
