Xcode Cloud构建号与Target构建号同步最佳实践及自动化实现问询

1. 是否属于最佳实践？ #

是。将Target构建号（CURRENT_PROJECT_VERSION）与Xcode Cloud构建号（CI_BUILD_NUMBER）保持一致是推荐的最佳实践，核心原因包括：

• 构建号全局统一，可直接对应Xcode Cloud的构建记录，定位问题、追踪版本来源更高效；
• 团队协作时无需额外映射构建号与CI任务，降低沟通成本；
• 发布或测试阶段能准确关联CI环境生成的构建包，避免版本混淆。

2. 自动化实现方式 #

有两种可靠的自动化方案，可规避xcodebuild的路径依赖问题：

方法一：直接修改项目配置文件（无需xcodebuild） #

通过sed命令直接修改.xcodeproj下的project.pbxproj文件，替换目标Target的CURRENT_PROJECT_VERSION值：

# 替换为你的项目和Target名称
PROJECT_NAME="YourProject.xcodeproj"
TARGET_NAME="YourTarget"

# 定位并替换CURRENT_PROJECT_VERSION
sed -i '' "/TARGETNAME = $TARGET_NAME;/,\/CURRENT_PROJECT_VERSION = /s/CURRENT_PROJECT_VERSION = [0-9]*;/CURRENT_PROJECT_VERSION = $CI_BUILD_NUMBER;/" "$PROJECT_NAME/project.pbxproj"

方法二：使用xcodebuild修改构建号 #

若依赖xcodebuild，需明确指定项目/工作区路径，适配Xcode Cloud的环境：

# 替换为你的项目/工作区和Target名称
# 若使用工作区则替换为 -workspace YourWorkspace.xcworkspace
xcodebuild -project YourProject.xcodeproj -target YourTarget CURRENT_PROJECT_VERSION="$CI_BUILD_NUMBER"

3. 是否可在Xcode Cloud的Shell脚本中完成？ #

完全可以，推荐在**ci_post_clone.sh或ci_pre_xcodebuild.sh**中执行：

• ci_post_clone.sh：克隆代码后立即修改构建号，确保后续所有步骤都使用统一编号；
• ci_pre_xcodebuild.sh：在Xcode启动构建前修改，适合结合其他前置操作的场景。

路径问题解决注意事项 #

• 脚本默认在仓库根目录执行，若项目文件在子目录，需先通过cd切换路径，例如：cd ./Subfolder/YourProject；
• 优先使用相对路径，避免绝对路径适配问题；
• macOS环境下使用sed需添加空参数-i ''，兼容系统语法。

内容的提问来源于stack exchange，提问作者Wilson Desimini