脚本在本机终端正常,却可能在 Xcode Cloud 失败,因为云端有自己的工作流设置与脚本阶段。先确认失败的工作流确实执行了对应脚本,再验证它是否收到非空值。诊断时不要输出凭据。

确认脚本实际运行


从日志确认工作流名称、使用的项目或工作区以及失败的操作。Apple 支持将特定名称的自定义脚本放在项目或工作区旁的 ci_scripts 目录中。若工作区在 ios 目录而软件包在仓库根目录,先核对云端构建选的是哪一个位置。本机 Shell 启动文件不能证明云端有同样的变量。

加一条无敏感信息的固定日志,标明脚本阶段。若完全看不到,按 Apple 的规则核对已提交的文件名和路径。改动文件前确认这次运行对应的分支和提交。

区分缺值和脚本问题


在实际运行的工作流中设置自定义变量,并核对脚本中的拼写。检查注入时,可以用无敏感信息的变量测试,再判断实际变量是否存在且非空,只输出固定状态。脚本内计算出的值也可能在启动子进程或进入另一阶段时丢失,应分别检查脚本变量与工作流设置。

例如夜间归档失败,但拉取请求构建成功。比较两个工作流及其操作,若夜间工作流缺少归档所需的变量,就补上并核实归档脚本能读到。无需为此把另一个工作流的设置全部复制过去。

验证修复且不输出密钥


用选好的测试分支运行修正后的工作流,查看脚本标记、变量存在的固定状态及最终构建结果。不需要时移除临时诊断。敏感变量用 Xcode Cloud 的密钥选项,脚本不要输出值或含密钥的参数。本文依据 Apple 文档,场景为演示。

官方参考文档