使用Fastlane&GitHub Actions部署Flutter iOS到TestFlight遇构建错误

核心错误分析 #

从构建日志看，导致失败的关键问题有两个：

1. Generated.xcconfig 文件缺失：该文件由Flutter构建时自动生成在ios/Flutter目录，用于传递Flutter构建配置给Xcode，CI环境未正确生成此文件导致Xcode报错。
2. Pod依赖文件列表无法加载：CI环境是全新环境，未执行pod install，导致Pods相关的xcfilelist文件不存在。
3. Swift Package的Docs.docc错误属于Xcode 14+的已知警告（Swift文档目录识别逻辑问题），不影响构建，可直接忽略。

解决方案步骤 #

1. 修正GitHub Actions工作流 #

（1）补全Flutter iOS构建准备

将原Install Fastlane步骤中的flutter build替换为flutter build ios --no-codesign，确保生成iOS专属的Generated.xcconfig文件：

- name: Prepare Flutter iOS Build Files
  run: |
    flutter clean
    flutter pub get
    flutter build ios --no-codesign
  env:
    APP_STORE_CONNECT_TEAM_ID: "${{ secrets.APP_STORE_CONNECT_TEAM_ID }}"
    DEVELOPER_APP_ID: "${{ secrets.DEVELOPER_APP_ID }}"
    DEVELOPER_APP_IDENTIFIER: "${{ secrets.DEVELOPER_APP_IDENTIFIER }}"
    DEVELOPER_PORTAL_TEAM_ID: "${{ secrets.DEVELOPER_PORTAL_TEAM_ID }}"
    FASTLANE_APPLE_ID: "${{ secrets.FASTLANE_APPLE_ID }}"
    FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD: "${{ secrets.FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD }}"
    MATCH_PASSWORD: "${{ secrets.MATCH_PASSWORD }}"
    GIT_AUTHORIZATION: "${{ secrets.GIT_AUTHORIZATION }}"
    PROVISIONING_PROFILE_SPECIFIER: "${{ secrets.PROVISIONING_PROFILE_SPECIFIER }}"
    TEMP_KEYCHAIN_PASSWORD: "${{ secrets.TEMP_KEYCHAIN_PASSWORD }}"
    TEMP_KEYCHAIN_USER: "${{ secrets.TEMP_KEYCHAIN_USER }}"
    APPLE_KEY_ID: "${{ secrets.APPLE_KEY_ID }}"
    APPLE_ISSUER_ID: "${{ secrets.APPLE_ISSUER_ID }}"
    APPLE_KEY_CONTENT: "${{ secrets.APPLE_KEY_CONTENT }}"

（2）添加Pod依赖安装步骤

在Bundle install for iOS Gemfile步骤之后，新增pod install步骤：

- name: Install iOS Pod Dependencies
  run: |
    cd ${{ github.workspace }}/ios
    pod install --repo-update

2. 修正Fastlane配置 #

（1）修复gym的provisioningProfiles配置

provisioningProfiles的key必须是Bundle ID（即DEVELOPER_APP_IDENTIFIER），而非App Store的应用ID（DEVELOPER_APP_ID）：

gym(
  configuration: "Release",
  workspace: "Runner.xcworkspace",
  scheme: "Runner",
  export_method: "app-store",
  export_options: {
    provisioningProfiles: { 
      DEVELOPER_APP_IDENTIFIER => PROVISIONING_PROFILE_SPECIFIER
    }
  }
)

（2）修正pilot的ipa路径

gym默认生成的ipa文件名为Runner.ipa，且位于当前ios目录下，需调整pilot的ipa路径：

pilot(
  apple_id: "#{DEVELOPER_APP_ID}",
  app_identifier: "#{DEVELOPER_APP_IDENTIFIER}",
  skip_waiting_for_build_processing: true,
  skip_submission: true,
  distribute_external: false,
  notify_external_testers: false,
  ipa: "./Runner.ipa"
)

（3）可选：在Fastlane中自动处理Pods

如果不想在GitHub Actions中单独执行pod install，可在Fastlane的closed_beta lane中添加cocoapods action：

platform :ios do
  lane :closed_beta do
    # ... 其他代码（钥匙串、api_key、match等） ...
    cocoapods(
      workspace: "Runner.xcworkspace",
      podfile: "Podfile",
      repo_update: true
    )
    # ... gym和pilot代码 ...
  end
end

3. 额外优化（可选） #

针对Swift Package的Docs.docc警告，可在gym中添加Xcode参数屏蔽：

gym(
  # ... 其他配置 ...
  xcargs: "CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER=NO"
)

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