Flutter iOS Flavor构建失败：Unsupported Swift Architecture

问题描述 #

我有一个Flutter应用，使用flutter run在各类模拟器运行均正常。为实现同一设备同时安装员工使用的生产版和内部Alpha测试版，按官方文档配置了Flavors：

• Android端配置后运行正常
• iOS端遵循官方指南配置、更新Podfile并执行pod install后，使用flutter run --flavor flavorname运行时出现构建失败，错误信息：

  User-Defined Issue (Xcode): Unsupported Swift architecture

已尝试以下操作，但均未解决问题：

• 卸载重装Pods
• 删除Xcode派生数据
• 清理构建目录
• 重新生成Podfile.lock

该错误仅在使用Flavor时出现，常规flutter run无异常，且涉及官方维护的shared_preferences(2.2.2)包，其他用户也存在类似问题。

解决方案 #

1. 统一Xcode项目的架构配置 #

打开iOS项目的Runner.xcworkspace：

• 选中项目根节点，在Info标签页的Configurations下，确认每个Flavor对应的配置（如Debug-alpha、Release-alpha）的架构设置完全一致
• 切换到Build Settings标签页，搜索Architectures：
  • 确保Architectures设置为Standard Architectures (arm64, x86_64)
  • 检查Excluded Architectures，确保在Debug/Release的所有Flavor配置中，没有同时排除arm64和x86_64这类冲突设置

2. 修改Podfile适配Flavor与Swift架构 #

在Podfile的post_install块中添加架构强制配置，确保第三方Swift包（如shared_preferences）适配所有Flavor：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    # 为所有Target统一设置有效架构
    target.build_configurations.each do |config|
      config.build_settings['ARCHS'] = 'arm64 x86_64'
      config.build_settings['VALID_ARCHS'] = 'arm64 x86_64'
      # 关闭Bitcode避免部分包兼容问题
      config.build_settings['ENABLE_BITCODE'] = 'NO'
    end
  end
end

修改后执行cd ios && pod install重新安装依赖。

3. 验证Flavor的Info.plist路径 #

在Xcode的Build Settings中搜索Info.plist File，确认每个Flavor对应的配置都指向正确的Info.plist文件，避免因路径错误导致架构配置不生效。

4. 彻底清理后重新构建 #

执行以下命令完成深度清理，再尝试运行指定Flavor：

flutter clean
rm -rf ios/Pods ios/Podfile.lock ios/Runner.xcworkspace
cd ios && pod install
cd ..
flutter run --flavor flavorname

5. 升级shared_preferences包（可选） #

尝试将shared_preferences升级到最新稳定版，新版本可能修复了Flavor场景下的架构兼容问题：修改pubspec.yaml中的版本号后，执行flutter pub get更新依赖。

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