如何通过Fastlane将CircleCI环境变量传入Swift项目

核心问题原因 #

你用Build Phase脚本export变量的方式行不通，因为Xcode的每个Build Phase脚本都是在独立的shell进程中运行的，export的变量仅在该进程内有效，不会传递给后续的编译进程或App运行时环境。另外Fastlane默认会过滤Xcode的输出，导致你看不到echo和测试打印的内容。

正确实现步骤 #

1. 通过Fastlane的xcargs传递CircleCI变量到Xcode

在Fastfile的build_app动作中，直接将CircleCI的环境变量通过xcargs传递给Xcode，确保变量能被Xcode的构建系统接收：

build_app(
  scheme: "YourAppScheme",
  workspace: "YourApp.xcworkspace", # 若使用workspace则添加
  xcargs: "CIRCLECI_SECRET_KEY='#{ENV["CIRCLECI_SECRET_KEY"]}'"
)

注意：如果变量包含特殊字符，要用单引号包裹，避免shell解析出错。

2. 让Swift代码获取变量的两种方法

方法一：预编译宏注入

• 打开Xcode，进入项目的Build Settings，搜索Other Swift Flags
• 添加一条配置：-D CIRCLECI_SECRET_KEY=@\"$(CIRCLECI_SECRET_KEY)\"
  （转义是为了让Xcode把变量值作为字符串传递给Swift宏）
• 在Swift代码中直接使用：

#if CIRCLECI_SECRET_KEY
let secretKey = CIRCLECI_SECRET_KEY
#else
// 本地开发时的默认值（可选）
let secretKey = "local_default_key"
#endif

方法二：Info.plist注入

• 在项目的Info.plist中添加新的键值对，比如键为CircleCISecretKey，值设置为$(CIRCLECI_SECRET_KEY)
• 在Swift代码中通过Bundle读取：

guard let secretKey = Bundle.main.infoDictionary?["CircleCISecretKey"] as? String else {
    fatalError("Secret key not found in Info.plist")
}

3. 显示Fastlane运行时的echo和测试打印

Fastlane默认用xcpretty美化输出，过滤了大部分日志。要看到完整输出：

• 运行Fastlane命令时加上--verbose参数，比如：fastlane build --verbose
• 或者在Fastfile的build_app中禁用xcpretty：

build_app(
  # 其他配置...
  xcpretty: false
)

额外注意事项 #

• 确保CircleCI的环境变量已正确设置在项目的环境变量或上下文里，Fastlane才能通过ENV["KEY_NAME"]获取到
• 如果单元测试需要使用变量，要在测试目标的Build Settings中重复上述宏或Info.plist配置，因为测试目标是独立的构建单元

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