设备准备
让电脑识别 iPhone。电脑上安装驱动，手机上信任并打开开发者模式，第一次调试时下载符号库，多台设备如何选择。
安装设备驱动
电脑上没有 Apple 设备驱动时，KXBuild 视图的设备节点会提示「点击配置」，点一下即可。命令行运行 kxdevice doctor。
> kxdevice doctor| 系统 | 说明 |
|---|---|
| Windows | 启动 Apple 设备服务，需要一次管理员授权。请先从 Microsoft Store 安装并打开「Apple 设备」以完成驱动安装 |
| WSL | 驱动装在 Windows 侧，手机插在 Windows 上，WSL 中可以直接使用。不要用 usbipd 把手机直通到 WSL |
| Linux | 安装并启动 usbmuxd，需要 sudo |
| macOS | 不需要 |
手机设置
1
信任此电脑
第一次连接时手机会弹出「信任此电脑」，解锁后点信任。用充电线而不是数据线、或手机锁屏时弹窗不会出现。以前点过「不信任」的，在 设置 → 通用 → 传输或还原 iPhone → 还原 → 还原位置与隐私 之后重新插拔。
2
打开开发者模式
设置 → 隐私与安全性 → 开发者模式，打开后手机重启一次。这个开关在手机连接过电脑之后才会出现。
3
等待符号库下载
第一次调试某个 iOS 版本会自动下载对应的符号库，有几个 GB，大约十多分钟，只需一次，进度显示在通知中。中断后下次继续。
选择设备
KXBuild 视图的「设备」节点列出手机后，点一下选为当前设备，点状态栏也可以切换。命令行用 kxdevice device list 查看，第一列是 UDID，多台设备时用 --udid 指定，默认第一台。
> kxdevice device list同一台手机可能同时出现 USB 和 Wi-Fi 两行，安装和调试走 USB 更稳定。列表为空时换数据线或 USB 口，解锁手机查看弹窗。「Apple 设备」能看到手机，KXBuild 就能看到。