Flutter多环境（Flavors）应用通过Codemagic分发至App Store时AppIcon不匹配问题

看起来你遇到的问题是本地iOS模拟器能正确加载对应Flavor的专属图标，但通过Codemagic构建分发到App Store后，生产环境却错误使用了默认图标。这大概率是构建过程中没有正确关联Production Flavor的图标配置，或者Codemagic的构建脚本缺少必要的参数传递。下面是一步步的排查和解决方法：

1. 先确认Xcode中Production Flavor的图标配置是否正确 #

先回到本地Xcode项目，确保Production相关的Target和Scheme已经正确绑定专属图标：

• 打开iOS项目的Runner.xcworkspace，找到Production对应的Target（一般是Runner-Production或你自定义的名称）
• 进入General标签页，在App Icons and Launch Images区域，确认App Icon Source选择的是ProductionAppIcon，而非默认的AppIcon
• 同步检查Production Scheme的配置：确保Scheme的Build Configuration关联的是Production环境，没有选错成Debug或QA

2. 修复Codemagic构建脚本的参数问题 #

看你提供的codemagic.yaml，发现两个关键问题：

• flutter build ipa命令里的— flavor用了全角破折号（—），这会导致参数无法被识别，必须换成半角的--
• 后续的xcode-project build-ipa命令没有传递Flavor参数，导致构建时可能 fallback 到默认配置

修改后的完整脚本如下：

environment:
  vars:
    XCODE_WORKSPACE: "$FCI_BUILD_DIR/ios/Runner.xcworkspace"
    XCODE_SCHEME: "Runner"
    BUNDLE_ID: "你的生产环境Bundle ID" # 这里要填生产环境对应的Bundle ID
scripts:
  - name: 获取签名文件
    script: |
      app-store-connect fetch-signing-files "$BUNDLE_ID" --type IOS_APP_STORE --create
      keychain add-certificates
      xcode-project use-profiles
  - name: 用Production Flavor构建Flutter IPA
    script: flutter build ipa -t lib/src/main_prod.dart --flavor Production --release
  - name: 准备分发用的IPA
    script: xcode-project build-ipa --workspace "$XCODE_WORKSPACE" --scheme "$XCODE_SCHEME" --flavor Production

重点注意：

• 把全角破折号替换成半角的--，保证--flavor参数能被正确解析
• 在xcode-project build-ipa命令末尾加上--flavor Production，强制指定用生产环境的配置构建
• 确保BUNDLE_ID是生产环境对应的ID，避免签名文件不匹配导致的配置失效

3. 验证构建产物的图标配置 #

构建完成后，你可以在Codemagic的Artifacts里下载IPA文件，用以下命令验证图标配置是否正确：

# 解压IPA文件
unzip your-app-production.ipa
# 查看Info.plist中的图标配置
plutil -p Payload/Runner.app/Info.plist | grep -A 10 "CFBundleIcons"

确认输出结果里的CFBundlePrimaryIcon对应的资源是ProductionAppIcon，而非默认的AppIcon。

4. 检查Xcode Asset Catalog的资源完整性 #

最后确认Assets.xcassets里的ProductionAppIcon已经添加了所有要求尺寸的图标，没有缺失。同时检查Production Target的Build Phases中，Copy Bundle Resources包含了Assets.xcassets，且没有重复的图标资源导致冲突。

完成以上步骤后，重新触发Codemagic的生产环境构建，分发到App Store后应该就能正确显示Production的专属图标了。

内容的提问来源于stack exchange，提问作者chk.buddi