Flutter项目Codemagic CI/CD打包iOS生成.app而非.ipa问题求助

核心问题分析 #

Codemagic产出MacOS的.app文件，说明构建目标被误设为MacOS，或者未执行正确的iOS IPA生成命令，导致无法适配Firebase App Distribution的iOS分发要求。

分步解决方案 #

• 修正构建命令
  在Codemagic工作流的「Build」步骤中，替换默认命令为iOS IPA构建命令：

  flutter build ipa --release
  

  如果需要跳过本地签名（由Codemagic处理签名），可添加--no-codesign参数：

  flutter build ipa --release --no-codesign
  

• 确认目标平台配置
  在工作流的「Platforms」设置中，仅勾选iOS，取消MacOS的勾选，避免触发MacOS应用构建。

• 配置iOS签名与导出参数

  1. 进入Codemagic的「Code signing」模块，为iOS配置正确的签名证书与描述文件；
  2. 若手动管理导出配置，需在构建命令中指定ExportOptions.plist路径：

     flutter build ipa --release --export-options-plist=ios/ExportOptions.plist
     

     该plist文件需设置对应导出方法（如ad-hoc、app-store），确保生成标准IPA包。

• 修正Firebase分发的产物路径
  在Firebase App Distribution步骤中，将产物路径设置为：

  build/ios/ipa/*.ipa
  

  避免指向MacOS构建的.app文件路径。

关于旧教程的「Flutter build ipa」勾选项 #

Codemagic新版界面已移除该勾选选项，改为通过自定义构建命令+平台选择的方式控制IPA生成，无需寻找旧选项。

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