Gym (Fastlane)：是什么、IPA 构建及应用开发自动化

什么是 Gym (Fastlane)？

Gym (Fastlane) 是 Fastlane 生态系统的一个组件，通过一个终端命令即可将 iOS 应用程序构建为 IPA 格式。它抽象了使用数十个标志调用 xcodebuild 的复杂过程，并为开发人员提供了具有合理默认值的简单界面。

在 Xcode 中构建 IPA 需要打开项目、选择方案、配置 Archive 和 Export、指定分发方式并等待完成。构建自动化通过 Gym 消除了手动步骤，并确保每次构建都使用相同的参数执行——这对于 CI/CD 管道的可预测性至关重要。

根据 SwiftLee（2024 年）的数据，使用 Gym 进行构建的团队在配置发布过程上花费的时间比通过 Xcode Organizer 手动导出少 40%。Gym 还会生成详细的构建日志，标明每一步 xcodebuild，从而简化失败构建的调试和编译错误分析。

在任何需要定期构建 IPA 以进行测试或发布的 iOS 项目中使用 Gym——这是确保团队中所有机器具有相同构建配置的唯一方法。

Gym 如何构建 IPA：流程和参数

通过 Gym 的 IPA 构建流程

通过 Gym 构建 IPA 包括三个连续阶段：通过 xcodebuild 归档项目、将归档导出为二进制包以及打包为带签名的 IPA 格式。Gym 自动确定项目类型（单个目标或工作区）并选择正确的构建方法。

在归档阶段，Gym 使用项目中指定的方案和配置参数执行 xcodebuild archive。成功创建 .xcarchive 归档后，Gym 使用选定的导出方法执行 xcodebuild -exportArchive。IPA 导出是将 .xcarchive 归档转换为 .ipa 安装文件的过程，包含所有必要的资源和签名。

构建的导出参数

导出方法决定了用于签署 IPA 的 Provisioning Profile 类型。Gym 支持四种方法：development 用于在开发人员设备上调试，app-store 用于在 App Store 发布，ad-hoc 用于在有限数量的设备上进行测试，enterprise 用于企业分发。

其他参数包括指定 export_options_plist 以精确配置导出、抑制 Swift overlay 以减小 IPA 大小以及管理 bitcode。Gym 还支持通过 --skip_package_ipa 标志为模拟器构建，这有助于在不完全导出的情况下快速检查代码。

# 通过 Gym 进行基础 IPA 构建
fastlane gym --workspace "MyApp.xcworkspace" --scheme "MyApp"

# 指定导出方法的构建
fastlane gym --export_method app-store

# 仅构建归档而不导出 IPA
fastlane gym --skip_package_ipa

通过 Gymfile 配置 Gym

Gymfile 是一个 Fastlane 配置文件，以结构化的 Ruby 格式存储所有构建参数。与通过命令行传递标志不同，Gymfile 允许将配置固定在仓库中，并确保所有开发人员和 CI 使用相同的构建设置。

# Gymfile — 构建配置
workspace("MyApp.xcworkspace")
scheme("MyApp")
export_method(:app-store)
configuration("Release")
output_directory("./build")
output_name("MyApp.ipa")
include_symbols(true)
include_bitcode(false)

Gymfile 中的 export_method 参数对应于 Apple Developer Portal 中的配置文件类型。对于 App Store 发布版本使用 :app-store，测试使用 — :development 或 :ad-hoc。configuration 参数确定构建配置：Release 用于发布版本或 Debug 用于调试版本。

include_bitcode 参数控制 IPA 中是否包含 bitcode。Apple 要求 watchOS 和 tvOS 应用程序使用 bitcode，但对于 iOS，可以关闭此参数以减小二进制文件的大小。include_symbols 包含 .dSYM 符号调试文件，这些文件对于从 App Store Connect 或第三方监控服务中符号化崩溃日志是必需的。

Gymfile 的其他参数包括用于自定义导出 plist 文件的 export_options_plist、用于抑制日志中多余输出的 silent 以及用于指定临时构建目录的 build_path。这些参数在将 Gym 集成到对工件有特殊要求的复杂 CI/CD 管道时非常有用。

用于构建应用程序的 Gym 命令

命令接口Gym 包括用于典型构建场景的基本参数和用于精确配置行为的扩展标志。大多数参数可以通过命令行和 Gymfile 传递，命令行参数优先于配置文件。

fastlane gym 命令在没有参数的情况下使用 Gymfile 中的设置或自动确定当前目录中的项目。对于具有多个目标的项目，需要指定 --scheme 和 --workspace 以正确选择目标构建配置。

典型构建命令

对于快速调试构建，使用 fastlane gym --export_method development——它使用 Development 配置文件构建 IPA，用于安装在开发人员设备上。IPA 构建用于 App Store 需要 --export_method app-store 标志，并使用事先在 Match 或 Keychain 中配置好的 Distribution 证书。

# 使用自定义名称构建 App Store 版本
fastlane gym --export_method app-store --output_name "Release_1.0.ipa"

# 归档前先清理的构建
fastlane gym --clean --configuration Debug

# 构建模拟器版本而不生成 IPA
fastlane gym --skip_package_ipa --destination "generic/platform=iOS Simulator"

--clean 标志在运行前删除先前构建的临时文件，防止使用过时的缓存并确保干净的构建。--destination 标志允许指定构建的目标平台：iOS Simulator、iOS Device 或 macOS Catalyst。

将 Gym 集成到 CI/CD 管道

将 Gym 与 CI/CD 集成是追求持续交付的 iOS 开发团队的标准实践。Gym 在 GitHub Actions、GitLab CI、Bitrise 或 Jenkins 管道中的测试阶段之后、发送到 TestFlight 或 App Store 之前运行。

典型的 iOS CI/CD 管道包括：克隆仓库、通过 CocoaPods 或 SPM 安装依赖、通过 Match 配置证书、通过 Gym 构建 IPA 以及通过 Pilot 或 Deliver 上传。GitLab CI 是 GitLab 的持续集成系统，允许在每次推送到仓库时启动构建。

# GitLab CI 中的构建步骤示例
fastlane gym --scheme "MyApp" \
      --export_method app-store \
      --output_directory "$CI_PROJECT_DIR/build"
      
# 将 IPA 保存为构建产物
cp "build/MyApp.ipa" "$CI_PROJECT_DIR/artifacts/"

要使 Gym 在 CI 中正常工作，需要配置 xcodebuild 访问带有证书的钥匙串。这通过在运行 Gym 之前执行 security unlock-keychain 命令来完成。如果使用 Match，证书会自动安装，不需要单独配置钥匙串——Match 会自己为构建创建临时钥匙串。

成功构建后，IPA 可以传递到管道的后续步骤：通过 Pilot 上传到 TestFlight 或通过 Deliver 发送到 App Store Connect。配置 CI 系统的环境变量以存储 Apple Developer 凭据，包括 FASTLANE_APPLE_API_KEY 和 MATCH_PASSWORD，以便管道的所有阶段无需交互输入即可运行。