如何让Xcode Build Settings中的自定义变量兼容CI/CD环境？

核心思路 #

别硬写本地绝对路径，换成相对路径或者CI能识别的动态变量，同时保证CI环境有对应的文件/依赖。

1. 把硬编码本地路径改成项目相对路径 #

如果路径指向的是项目里的资源或依赖，直接用相对于项目根目录的路径就行：

• 比如把 /Users/yourname/Documents/ProjectAssets 换成 $(SRCROOT)/Assets（$(SRCROOT) 是Xcode自带的变量，直接指向项目根目录）
• 验证下：本地跑的时候确认路径没问题，CI环境里项目根目录和本地一致，不用额外配置。

2. 用CI环境变量动态填路径 #

如果路径指向的是CI环境也有的外部资源（比如共享依赖包）：

• 在Codemagic这类CI平台的环境变量设置里加个对应变量（比如叫CUSTOM_ASSET_PATH），值设成CI环境里的实际路径
• 然后在Xcode Build Settings里把自定义变量的值改成 $(CUSTOM_ASSET_PATH)
• 记得要在CI构建前把对应资源部署好，比如用脚本下载或者克隆到指定路径。

3. 用Xcode配置文件区分环境 #

建不同的Build Configuration（比如Debug/Release/CI）：

• 给CI配置单独设自定义变量的值，适配CI的路径
• Codemagic构建的时候指定用CI配置，这样就不会和本地配置冲突了。

4. 用构建脚本动态生成路径 #

如果路径得根据环境动态计算：

• 在Xcode的Build Phases里加一个"Run Script"阶段
• 脚本里判断是不是CI环境（Codemagic会自动设CI=true这个环境变量），然后设置自定义变量：

  if [ "$CI" = "true" ]; then
      echo "设置CI环境路径..."
      export CUSTOM_PATH="/Users/builder/ci-assets"
  else
      export CUSTOM_PATH="/Users/yourname/local-assets"
  fi
  # 把变量传给Xcode
  echo "CUSTOM_PATH=$CUSTOM_PATH" >> "$SCRIPT_OUTPUT_FILE_0"
  

• 然后在Build Settings里引用这个脚本输出的变量就行。

5. 检查CI环境的依赖有没有 #

要确保CI环境里有自定义路径指向的资源：

• 如果是第三方依赖，在CI构建前用pod install、brew install这类脚本安装
• 如果是自己的资源，要么加到Git仓库里，要么用CI脚本从云存储（比如S3、Git LFS）下载到指定路径。

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