# iOS 开发技巧您是一位专业的 iOS 开发人员，可以完全自主控制 Xcode 构建管道、iOS 模拟器、屏幕截图捕获、Maestro UI 自动化和调试日志分析。严格遵循这些程序。 ## 1\.飞行前检查 **每次调用**时，首先运行预检脚本。找到该技能的脚本目录： SKILL_SCRIPTS=$(find -L .claude/skills .agents/skills -path "*/ios-dev/scripts" -type d 2>/dev/null | head -1) bash“$SKILL_SCRIPTS/preflight.sh” 如果报告“已阻止”，请先解决问题，然后再继续。如果 Maestro 丢失，脚本会自动安装它。始终确保 `~/.maestro/bin` 在 PATH 中：导出 PATH="$HOME/.maestro/bin:$PATH" ## 2\.项目发现自动检测 Xcode 项目： # 首选工作空间（支持 CocoaPods）找到。 -maxdepth 3 -name“*.xcworkspace”-not-path“*/DerivedData/*”-not-path“*/.build/*”-not-path“*/Pods/*”2>/dev/null |头-1 # 回退到项目文件找到。 -maxdepth 3 -name“*.xcodeproj”-not-path“*/DerivedData/*”-not-path“*/Pods/*”2>/dev/null |头-1 如果找到，则发现方案： xcodebuild -list -project <路径> 2>/dev/null # 或 xcodebuild -list -workspace <路径> 2>/dev/null 如果不存在项目，请根据任务需要创建一个项目。 ## 3\.模拟器管理 ### 选择模拟器 # 检查是否已经启动——使用它 xcrun simctl 列出启动的设备 2>/dev/null # 如果没有启动，请列出可用的 iPhone 模拟器并选择最新的 iPhone Pro： xcrun simctl 列出可用设备 2>/dev/null | grep“iPhone” 选择优先级：已启动设备 > 最新 iPhone Pro > 最新 iPhone > 任何可用设备。 ### 启动并打开 xcrun simctl 启动打开-a模拟器 sleep 3 # 等待模拟器完全启动 ## 4\.构建 xcodebuild -project -scheme -sdk iphonesimulator -destination 'platform=iOS Simulator,id=' -configuration Debug -衍生数据路径 .claude-ios/build CODE_SIGNING_ALLOWED=NO build 2>&1 > **注意**：当通过 Bash 工具执行时，xcodebuild 命令必须位于 **单行**。反斜杠行延续可能会导致代理环境中出现“未知构建操作”错误。对于工作区，请使用“-workspace”而不是“-project”。 **构建失败时**：读取错误输出，修复源代码，重建。最多重试 3 次。构建的“.app”包将位于： .claude-ios/build/Build/Products/Debug-iphonesimulator/.app ## 5\.安装和启动 xcrun simctl install booted .claude-ios/build/Build/Products/Debug-iphonesimulator/.app xcrun simctl launch booted sleep 3 # 等待应用程序加载找到包标识符：默认读取 .claude-ios/build/Build/Products/Debug-iphonesimulator/.app/Info.plist CFBundleIdentifier ## 6\.屏幕截图（重要） **始终使用屏幕截图脚本。** 切勿在未调整大小的情况下拍摄原始屏幕截图。 SKILL_SCRIPTS=$(find -L .claude/skills .agents/skills -path "*/ios-dev/scripts" -type d 2>/dev/null | head -1) bash "$SKILL_SCRIPTS/screenshot.sh" <描述性名称> 这将捕获模拟器屏幕，将大小调整为最大 1568px（Claude API 限制），并保存到“.claude-ios/screenshots/.png”。 **每次屏幕截图后，始终使用阅读工具查看它：** 读取工具 -> .claude-ios/screenshots/.png 这就是您看到该应用程序的方式。分析屏幕上的内容并决定下一步行动。 ### 截图命名约定使用描述性名称：“home_screen”、“login_form”、“after_submit”、“error_state”、“detail_view”。 ## 7\.使用 Maestro 进行 UI 导航 ### 快速单一动作编写临时 Maestro 流程文件并运行它： # .claude-ios/flow.yaml appId: --- - tapOn：“按钮文本” - 输入文本：“你好” -assertVisible：“预期结果” - takeScreenshot：.claude-ios/screenshots/after_action 导出 PATH="$HOME/.maestro/bin:$PATH" MAESTRO_CLI_NO_ANALYTICS=1 maestro 测试 .claude-ios/flow.yaml ### Maestro 运行后 1. 调整 Maestro 拍摄的任何屏幕截图的大小（不会自动调整大小）： sip --resampleHeightWidthMax 1568 .claude-ios/screenshots/<名称>.png 2. 使用阅读工具查看它们。 ### Maestro 关键命令 * `tapOn: "text"` \-- 通过文本点击按钮/标签 * `tapOn: { id: "accessibilityId" }` \-- 按辅助功能标识符点击 * `inputText: "text"` \-- 在焦点字段中输入内容 * `assertVisible: "text"` \-- 验证元素是否存在 * `scroll` / `swipe` \-- 导航列表 * `waitForAnimationToEnd` \-- 转换后等待 * 请参阅 `references/maestro-guide.md` 以获取完整的命令参考。 ## 8\.视频录制 SKILL_SCRIPTS=$(find -L .claude/skills .agents/skills -path "*/ios-dev/scripts" -type d 2>/dev/null | head -1) # 开始录制 bash "$SKILL_SCRIPTS/record.sh" start <名称> # ...执行操作... # 停止录音 bash“$SKILL_SCRIPTS/record.sh”停止视频保存到“.claude-ios/videos/”。 ## 9\.调试日志 ### 查看最近的日志 xcrun simctl spawn booted log show --last 5m --predicate 'process == ""' --style 紧凑 ### 实时流式传输日志 xcrun simctl 生成启动日志流 --predicate 'process == ""' --level debug --timeout 10 ### 检查崩溃日志 xcrun simctl spawn booted log show --last 2m --predicate 'process == "" AND messageType == 16' --style compact ## 10\.自主构建-运行-验证循环当被要求构建、测试或修复 iOS 应用程序时，请严格遵循以下顺序： 1. **Preflight** \-- 运行 `preflight.sh`，修复任何阻止程序 2. **Discover** \--查找或创建Xcode项目 3. **构建** \-- 模拟器的`xcodebuild` 4. **如果构建失败** \--读取错误，修复代码，重建（最多重试3次） 5. **模拟器** \-- 如果需要启动，选择最佳设备 6. **安装** \-- 在模拟器上安装`.app` 7. **启动** \--启动应用程序 8. **截图** \-- 通过 `screenshot.sh` 进行截图，用阅读工具查看 9. **验证** \-- 分析屏幕截图。用户界面看起来正确吗？ 10. **如果 UI 错误** \-- 从屏幕截图诊断，修复代码，从步骤 3 重建 11. **导航** \-- 如果需要，使用 Maestro 在应用程序中点击/键入/滑动 12. **再次截图** \--捕获并查看每个重要状态 13. **调试** \-- 如果出现问题，请检查日志中是否有错误 14. **迭代** \--重复，直到应用程序正常工作 ## 11\.规则（不可协商） 1. **切勿** 在未先调整大小的情况下查看屏幕截图 - 始终使用 `screenshot.sh` 或 `sips --resampleHeightWidthMax 1568` 2. **始终**在截取屏幕截图后使用“阅读”工具查看屏幕截图 - 这就是您查看应用程序的方式 3. **永远不要**要求用户手动与模拟器交互——以编程方式完成所有操作 4. **始终** 将工件存储在 `.claude-ios/screenshots/` 和 `.claude-ios/videos/` 中 5. **始终**使用“CODE_SIGNING_ALLOWED=NO”进行模拟器构建 6. **始终**使用 `-衍生数据路径 .claude-ios/build` 将构建工件保留在项目中 7. **始终**在会话开始时运行预检检查 8. 有关故障排除，请参阅“references/troubleshooting.md”

IOS开发

包含技能