OWEN/SHEN
GitHub
技能库开发与交付 · 实验中

iOS 真机安装

核对真实应用身份后构建、安装到连接的设备。

版本
v1.1.0
更新
内容复核
2026-10-06
使用条件
macOS、Xcode、连接的iPhone/iPad、Python 3.10+

验证范围：24项离线脚本回归、12项技能库边界测试；真实设备/签名/公证/上传尚未执行。 完整公开包已复核脱敏；真实业务操作仍待对应环境验收。

给你的 Agent

交给你的 Agent

临时使用：复制提示词，再补充你的具体任务。长期复用：下载下面的完整技能包。

下载完整技能包读取 SKILL.md →

安装到自己的 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 发布继续使用项目现有流程。

  1. 阅读项目规则和现有构建配置，确认容器、scheme、设备和本次代码来源。多个目标有歧义时展示候选。
  2. 使用项目已有签名与元数据配置；先定位 XcodeGen/Tuist/Info.plist 等真实配置源，不覆写其它项目的 Team ID。
  3. 从当前已同步主线的任务工作树构建，可以包含本次 dirty 改动，记录来源 SHA 和未提交改动；遵循用户已有验包要求。
  4. 执行本技能目录内的脚本；默认每次使用独立临时 DerivedData，显式复用缓存时传 --derived-data。
  5. 安装前核对真实产物的 bundle ID、必要隐私声明和现代启动屏。--bundle-id 是预期身份，不能用来掩盖产物不一致。
  6. 用户要求时启动应用；报告代码版本、设备、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 个内容文件 · 包内另附版本说明与校验清单