如何通过GitHub Actions（非自托管）+Fastlane上传Xcode14的dSYM到Firebase

针对你用GitHub Actions云托管Mac Worker、Fastlane，且Xcode14+未启用Bitcode无法从App Store下载dSYM的情况，以下是无需自托管Worker的可行方案：

核心思路 #

Xcode14+即使关闭Bitcode，本地构建（归档）过程中仍会生成完整的dSYM文件，无需依赖App Store Connect的dSYM下载。我们要做的就是在构建流程中直接捕获这些本地生成的dSYM，通过Fastlane自动上传到Firebase。

具体实现步骤 #

1. 配置Fastlane捕获dSYM并上传 #

修改你的Fastfile，在打包阶段确保生成dSYM，并添加上传动作：

lane :build_upload_dsym do
  # 用gym打包，明确开启符号生成
  gym(
    scheme: "YourAppScheme",
    workspace: "YourApp.xcworkspace", # 或project: "YourApp.xcodeproj"
    include_symbols: true,
    include_bitcode: false,
    archive_path: "./build/AppArchive.xcarchive", # 指定归档路径，方便后续定位dSYM
    export_method: "app-store" # 根据你的分发方式调整，比如ad-hoc
  )

  # 方式一：单独上传dSYM到Firebase
  upload_symbols_to_firebase(
    google_service_info_plist_path: "./GoogleService-Info.plist",
    dsym_path: "./build/AppArchive.xcarchive/dSYMs" # 指向归档内的dSYM目录
  )

  # 方式二：如果用Firebase App Distribution分发IPA，可自动附带上传dSYM
  # firebase_app_distribution(
  #   app: "你的Firebase App ID",
  #   testers: "测试邮箱列表",
  #   upload_symbols: true,
  #   google_service_info_plist_path: "./GoogleService-Info.plist"
  # )
end

2. 配置GitHub Actions Workflow #

创建或修改你的GitHub Actions工作流文件（如.github/workflows/build.yml），确保云托管Mac环境能正确执行Fastlane流程：

name: Build & Upload dSYM to Firebase

on:
  push:
    branches: [ main, release/* ] # 根据你的分支策略调整

jobs:
  build:
    runs-on: macos-latest # GitHub官方云托管Mac Worker
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4

      - name: 配置Ruby环境
        uses: ruby/setup-ruby@v1
        with:
          ruby-version: '3.2' # 匹配Fastlane兼容的Ruby版本
          bundler-cache: true # 缓存Gem依赖，加速后续构建

      - name: 安装Fastlane依赖
        run: bundle install

      - name: 构建并上传dSYM
        run: bundle exec fastlane build_upload_dsym
        env:
          # 从GitHub Secrets中读取Firebase服务账号密钥
          GOOGLE_APPLICATION_CREDENTIALS: ${{ secrets.FIREBASE_SERVICE_ACCOUNT_KEY }}

3. 关键配置注意事项 #

• GitHub Secrets配置：将Firebase服务账号的JSON密钥文件内容存入GitHub仓库的Secrets中（命名为FIREBASE_SERVICE_ACCOUNT_KEY），避免敏感信息硬编码。
• Xcode版本指定：如果需要特定Xcode版本，可在工作流中添加步骤切换：

  sudo xcode-select -s /Applications/Xcode_15.0.app
  

• dSYM验证：可在构建后添加验证步骤，确保dSYM与IPA的UUID匹配：

  # 提取IPA的UUID
  dwarfdump --uuid ./build/AppArchive.xcarchive/Products/Applications/YourApp.app | grep UUID
  # 提取dSYM的UUID
  dwarfdump --uuid ./build/AppArchive.xcarchive/dSYMs/YourApp.app.dSYM
  

替代方案：从构建产物中直接提取dSYM #

如果你的构建流程未使用Fastlane gym，也可以通过命令行直接定位dSYM路径：

# 找到最新的DerivedData中的dSYM
DSYM_PATH=$(find ~/Library/Developer/Xcode/DerivedData -name "*.app.dSYM" | sort -r | head -1)
# 上传到Firebase
bundle exec fastlane run upload_symbols_to_firebase google_service_info_plist_path:"./GoogleService-Info.plist" dsym_path:"$DSYM_PATH"

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