Flutter Xcode项目在GitLab CI流水线中忽略DART_DEFINES问题排查

问题核心原因 #

flutter build ios 不仅生成 flutter_export_environment.sh 和 Generated.xcconfig，还会完成两个关键操作：

• 将DART_DEFINES等环境变量注入到Xcode的编译上下文
• 更新Flutter与Xcode项目之间的构建缓存关联

直接用fastlane gym构建时，虽然配置文件存在，但Xcode编译环境并没有加载Flutter专属的环境变量，也没有触发缓存同步，导致DART_DEFINES无法生效。

可行解决方案 #

方案1：加载Flutter环境脚本后执行Gym

在deploy任务的fastlane run gym命令前，先加载Flutter生成的环境脚本，确保环境变量被注入当前shell会话：

source ios/flutter_export_environment.sh
fastlane run gym scheme:"Runner" workspace:"Runner.xcworkspace" export_method:"app-store"

方案2：执行Flutter轻量配置更新命令

用flutter build ios的--config-only参数只更新配置，不重复编译Dart代码和原生框架，避免全量构建的耗时：

flutter build ios --release --no-codesign --dart-define=PROFILE="prod" --config-only
fastlane run gym scheme:"Runner" workspace:"Runner.xcworkspace" export_method:"app-store"

这个命令只会同步配置文件和Xcode项目关联，速度远快于全量构建，同时保持build和deploy任务的职责分离。

方案3：在Gym中指定加载Generated.xcconfig

修改fastlane gym命令，显式指定使用Flutter生成的xcconfig文件，确保Xcode编译时读取正确的DART_DEFINES：

fastlane run gym scheme:"Runner" workspace:"Runner.xcworkspace" export_method:"app-store" xcconfig:"ios/Generated.xcconfig"

额外验证点 #

• 确认deploy任务中ios目录的所有文件（包括Flutter生成的配置和缓存文件）都从build任务完整传递过来，GitLab CI的artifacts要包含ios/下的所有相关内容
• 检查Runner Scheme的Build Configuration是否设置为Release，且继承了Generated.xcconfig的配置

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