Flutter项目Fastlane打包时如何设置dart-define类环境变量？

核心原因 #

你当前的错误在于直接通过gym的xcargs传递环境变量，而Flutter的--dart-define参数需要在**flutter build ios阶段**注入，而非Xcode编译阶段。跳过flutter build ios直接用gym编译，会导致Dart环境变量无法被正确注入到产物中。

解决方案 #

修改你的Fastlane Lane，先执行flutter build ios并传递--dart-define参数，再用gym打包已构建好的Flutter产物：

1. 更新Fastlane Lane代码 #

lane :ios_upload_to_firebase_app_distribution do
  # 先执行Flutter构建，注入环境变量
  sh("flutter build ios --release --dart-define=FLUTTER_BUILD_TYPE=#{ENV['FLUTTER_BUILD_TYPE']} --no-codesign")
  
  # 打包已构建的产物（无需再处理dart-define）
  gym(
    clean: false, # 禁用clean，避免重新编译覆盖Flutter构建产物
    verbose: true,
    scheme: "Runner",
    export_method: "ad-hoc",
    archive_path: "../build/ios/archive/Runner.xcarchive",
    output_directory: "./build/Runner",
    output_name: "my-app.ipa"
  )
  
  # 后续上传Firebase的步骤保持不变
end

2. 关键说明 #

• flutter build ios的--dart-define=FLUTTER_BUILD_TYPE=#{ENV['FLUTTER_BUILD_TYPE']}：从GitHub Actions传递的环境变量中取值，注入到Flutter构建流程
• --no-codesign：跳过Flutter阶段的签名，交由后续gym处理签名逻辑
• gym的clean: false：因为已经完成Flutter构建，无需重新编译，避免丢失注入的环境变量

3. 验证环境变量是否生效 #

可以在App中添加日志输出验证：

void main() {
  print('FLUTTER_BUILD_TYPE: ${String.fromEnvironment('FLUTTER_BUILD_TYPE')}');
  runApp(MyApp());
}

额外注意事项 #

• 确保GitHub Workflow中Run Fastlane步骤的FLUTTER_BUILD_TYPE环境变量已正确传递（你的当前配置是正确的）
• 如果需要传递多个--dart-define参数，可在flutter build ios命令中追加，例如：--dart-define=KEY1=VALUE1 --dart-define=KEY2=VALUE2

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