让打包任务继续跑下去

先查看当前开发者目录和版本，确认目标 Xcode 已安装。以下示例把系统默认目录切到 /Applications/Xcode.app；使用其他版本时，替换成实际应用路径。

xcode-select -p
xcodebuild -version
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
xcodebuild -version
xcrun --find swift

系统级切换会影响随后启动的其他任务。若不同流水线需要不同版本，优先在任务环境中设置 DEVELOPER_DIR，不要让两个作业反复修改全局目录。

DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer \
xcodebuild -list -workspace MyApp.xcworkspace

切换后先列出 Scheme，再做一次 Archive。缺少平台组件或首次运行配置时，先在 macOS 图形界面完成对应工具链的初始化，再恢复自动化任务。

准备包含私钥的证书导出文件、该文件的密码，以及匹配 App 标识和分发方式的描述文件。只有证书、没有对应私钥，通常无法完成代码签名。

1. 以运行构建任务的 macOS 用户打开“钥匙串访问”，把证书导入该用户的钥匙串。
2. 展开证书，确认下面存在对应私钥。用下方命令检查有效的代码签名身份。
3. 按所用 Xcode 版本的要求安装描述文件；在项目签名设置中核对 Team、Bundle Identifier 和分发方式。
4. 逐个检查 App、Widget 和 Extension 的签名配置，再执行 Archive 与导出验证。

security find-identity -v -p codesigning

CI 执行用户的钥匙串环境可能不同于远程桌面用户。无人值守构建需要在作业中正确解锁钥匙串并配置必要访问权限。密码从 CI 的受保护变量读取，不写入仓库、命令回显或工单。

若手动打包通过、CI 失败，优先比较执行用户和钥匙串状态。提交签名错误时，只提供证书类型、有效期与脱敏错误行，不上传私钥或证书密码。

不要把重装当作保留文件的操作。重装可能清除系统与工作目录；提交请求前，先通过控制台工单确认处理范围，并完成节点外备份。租期结束后，节点执行磁盘擦除，不能把到期后的节点作为恢复来源。

备份至少包含未推送的源码、构建配置、必要工件、描述文件及受保护的密钥材料。DerivedData、依赖下载目录等缓存可重新生成，但会影响恢复后的首次构建时间。

备份完成不等于恢复可用。选一个独立目录解压备份，核对文件数量与关键配置，确认能够取回最近一次产物，再停止原节点任务。重装后重新安装工具链、恢复签名环境并注册 runner。

登录订单所属账户，在控制台核对实例、到期时间与可选续费周期，然后按页面返回的账单完成付款。续费成功与新的租期以控制台实时返回为准，不以支付截图或浏览器关闭前的画面判断。

仅支持 USDT-TRC20 与 Visa / Mastercard / Amex（经 Stripe），全部以美元结算；实际可用网关以后端接口返回为准。链上付款前核对网络、金额与收款信息，卡支付完成后返回控制台检查账单。

若账单与实例状态不一致，提交订单编号、账单编号及交易参考信息。不要重复付款来尝试修复状态，也不要在工单中发送完整卡号。到期前先备份工件与必要文件，避免把续费流程当作数据备份机制。

先在控制台核对节点地址、端口、用户名和实例状态。区分连接超时与认证失败：前者优先检查网络可达性，后者优先检查用户名、密码或密钥。SSH 与 VNC 使用各自的连接信息，不要混用端口。

ssh -v -p PORT USER@HOST

把 PORT、USER、HOST 替换为实际信息。日志中若出现主机指纹变化，先通过可信的控制台信息或工单确认原因，不要直接关闭主机身份校验。

远程桌面适合检查 macOS 图形界面、钥匙串和 Xcode 设置；SSH 适合命令行和 CI。提交日志前移除用户名、地址及本地路径中的敏感信息，只保留错误类型与发生顺序。

按四项核对：runner 是否在线、作业标签是否匹配、项目是否允许使用该 runner、进程是否以正确用户运行。注册成功只代表建立了关联，不代表所有作业都会自动分配到该节点。

先提交只输出工具链信息的测试作业，确认执行用户、目录和 Xcode 版本，再加入依赖安装与签名步骤。

whoami
pwd
xcode-select -p
xcodebuild -version
security find-identity -v -p codesigning

把 macOS、芯片架构与用途写进标签，并在项目配置中明确选择。初次接入先限制单任务执行，确认缓存、钥匙串和产物目录互不覆盖，再逐步增加并发。注册令牌属于凭据，不应进入工单或构建日志。

先确认使用的是正确 workspace、共享 Scheme 和 Release 配置。Archive 与模拟器构建不是同一条路径；设备目标的签名、架构和导出设置需要单独核对。

xcodebuild -list -workspace MyApp.xcworkspace
xcodebuild archive \
  -workspace MyApp.xcworkspace \
  -scheme MyApp \
  -configuration Release \
  -destination 'generic/platform=iOS' \
  -archivePath build/MyApp.xcarchive

保留第一条实质错误及其上下文，不只截取最后的“失败”结论。分别检查依赖安装、脚本阶段、签名阶段和磁盘写入。Archive 成功后仍需验证导出工件，不能把归档完成等同于可分发包已生成。

先检查磁盘占用与任务状态，再区分可重建缓存和需要保留的产物。不要在正在执行的作业中删除它依赖的目录，也不要把源码、签名材料或尚未上传的 Archive 当作缓存处理。

df -h
du -sh ~/Library/Developer/Xcode/DerivedData
du -sh ~/Library/Developer/Xcode/Archives

为缓存与产物分别制定保留规则。清理后首次编译和依赖解析可能变慢，应把这次构建当作冷启动验证。长期空间不足时，先统计项目与工件增长量，再选择更合适的机型或 SSD 附加项。