39 lines
1.4 KiB
Markdown
39 lines
1.4 KiB
Markdown
# iOS 通用环境检查
|
|
|
|
远程 Mac 的执行位置统一由 `.pouch/agent.yaml` 的 `locations`/`bindings` 提供。必须按
|
|
environment、host、project、绝对 path 精确解析 Orca worktree；没有唯一 worktree 时记为
|
|
`environment-fail`，不能按项目名称、分支或 basename 猜测，也不能 fallback 到 Linux。
|
|
|
|
## 目标判定
|
|
|
|
先明确以下之一：
|
|
|
|
- `local-device`：当前 macOS 连接的 iPhone/iPad。
|
|
- `local-simulator`：当前 macOS 的 Xcode Simulator。
|
|
- `remote-mac`：用户提供的远程 Mac 执行命令或 CI 入口。
|
|
- `cloud-device`：用户提供的云设备执行入口。
|
|
|
|
Linux 本机不是有效的 `local-simulator`。若用户要求在 Linux 本机跑 Simulator，应停止
|
|
并记为 `environment-fail`，同时说明需要 Mac 或远程 Mac。
|
|
|
|
## macOS 检查
|
|
|
|
```bash
|
|
xcode-select -p
|
|
xcodebuild -version
|
|
xcrun simctl list devices available
|
|
```
|
|
|
|
还要确认：
|
|
|
|
- Xcode 版本与项目部署目标兼容。
|
|
- 对应 iOS Simulator runtime 已安装。
|
|
- workspace/project、scheme 和 destination 存在。
|
|
- 测试所需的签名和开发团队配置存在。
|
|
|
|
## Linux 检查
|
|
|
|
Linux 只能作为测试编排端或远程执行端。不要安装所谓的“Linux iOS Simulator”，也不
|
|
使用 Android Emulator 代替。若使用远程 Mac，检查用户提供的连接/执行入口，不在 skill
|
|
中保存 SSH 密码、Apple 账号或云平台 token。
|