iOS 真机安装
核对真实应用身份后构建、安装到连接的设备。
- 版本
- v1.1.0
- 更新
- 内容复核
- 2026-10-06
- 使用条件
- macOS、Xcode、连接的iPhone/iPad、Python 3.10+
验证范围：24项离线脚本回归、12项技能库边界测试；真实设备/签名/公证/上传尚未执行。 完整公开包已复核脱敏；真实业务操作仍待对应环境验收。
给你的 Agent
交给你的 Agent
临时使用：复制提示词，再补充你的具体任务。长期复用：下载下面的完整技能包。
安装到自己的 Agent
解压后保留整个 ios-device-deploy 文件夹，包括 scripts、references 等配套文件。先阅读内容、核实依赖，再放进所用 Agent 的技能目录；Codex 常用 ~/.codex/skills/，Claude Code 常用 ~/.claude/skills/，已有配置优先。同名技能先比较并备份到加载目录外。
包内 skill.json 记录版本和验证范围。在解压的技能文件夹中运行 shasum -a 256 -c SHA256SUMS（macOS），或 sha256sum -c SHA256SUMS（Linux），核对文件完整性。查看说明不需要网站源码。
构建并安装用户当前要验证的应用。CI 的正式构建和 TestFlight/App Store 发布继续使用项目现有流程。
- 阅读项目规则和现有构建配置，确认容器、scheme、设备和本次代码来源。多个目标有歧义时展示候选。
- 使用项目已有签名与元数据配置；先定位 XcodeGen/Tuist/Info.plist 等真实配置源，不覆写其它项目的 Team ID。
- 从当前已同步主线的任务工作树构建，可以包含本次 dirty 改动，记录来源 SHA 和未提交改动；遵循用户已有验包要求。
- 执行本技能目录内的脚本；默认每次使用独立临时 DerivedData，显式复用缓存时传 --derived-data。
- 安装前核对真实产物的 bundle ID、必要隐私声明和现代启动屏。--bundle-id 是预期身份，不能用来掩盖产物不一致。
- 用户要求时启动应用；报告代码版本、设备、app 路径、bundle ID、版本/build、安装与启动结果。命令成功和界面验收分别记录。
python3 "<本技能目录>/scripts/ios_device_deploy.py" --project-root "$PWD" --launch
python3 "<本技能目录>/scripts/ios_device_deploy.py" --project-root "$PWD" --bundle-id com.example.app --device-id "<设备ID>" --launch
先定位安装目录或站内正本再替换命令占位符。脚本提供 --list-devices、--list-schemes 和 --dry-run；dry-run 会读取项目/设备信息但不构建安装。现代启动屏确实有意省略时才能使用 --allow-missing-modern-launch-screen。
项目 UI、设置页与版本显示的开发走相应开发任务；本入口聚焦构建、安装与排查。不默认触发 CI、上传应用或改发布状态。
本版已完成 bundle ID 选择和缓存隔离的离线回归，真实设备构建/安装未执行。
3 个内容文件 · 包内另附版本说明与校验清单
- SKILL.md
e8d635a2356cce3fd01b575840608795d92b4a521866fe44c23a85a2d07960a6 - agents/openai.yaml
759fa3d3c84b992e2f15c18e3ac927e0f8660c2d2e94aa635e142bc8e99eef0e - scripts/ios_device_deploy.py
21c029252f438bafd93b544b1d0f1516c8414232fee4a71a4b1046181a406d3f