在App Store外分发Flutter iOS应用的证书配置问题求助

一、核心证书与配置文件要求（针对已添加设备的内部分发） #

• 证书类型：
  • iOS Development Certificate（开发证书）：适合开发阶段调试，仅能给开发者账号“我的设备”列表里的设备安装
  • iOS Distribution Certificate (Ad Hoc)（Ad Hoc分发证书）：适合正式测试版本，同样支持已添加到账号的设备，稳定性更好
• 配置文件类型：
  • 对应证书类型，需使用Development Provisioning Profile（开发配置文件）或Ad Hoc Provisioning Profile（Ad Hoc配置文件）
  • 关键：配置文件必须包含所有目标设备的UDID，且绑定正确的App ID和对应证书

二、你的现有配置问题分析 #

从你提供的export-options.plist来看，有几个致命错误：

1. method字段错误：你设为ios-application，这是上传App Store的类型，针对Ad Hoc/开发分发应改为ad-hoc或development
2. destination字段错误：upload是上传到App Store Connect的选项，本地导出用于分发需改为export
3. uploadBitcode完全多余：Ad Hoc分发不需要上传Bitcode，直接删除该key；compileBitcode建议设为false，避免编译环节出问题
4. 配置文件匹配问题：如果用的是开发配置文件，必须搭配开发证书签名，且设备必须在账号的开发设备列表内

三、正确的Flutter构建与导出步骤 #

1. 准备证书和配置文件
   • 登录Apple开发者后台：
     • 生成对应证书（开发/Ad Hoc），下载后安装到Mac钥匙串
     • 创建对应类型的配置文件，手动添加所有要安装应用的设备UDID，下载后双击导入Xcode
2. 修改export-options.plist
   以Ad Hoc分发为例，正确的plist内容：

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
       <key>compileBitcode</key>
       <false/>
       <key>method</key>
       <string>ad-hoc</string>
       <key>destination</key>
       <string>export</string>
       <key>teamID</key>
       <string>Q3M.....G3</string>
       <key>provisioningProfiles</key>
       <dict>
           <key>com.toto.totomobile</key>
           <string>你的Ad Hoc配置文件名称</string>
       </dict>
       <key>signingStyle</key>
       <string>manual</string>
   </dict>
   </plist>
   

3. 重新构建IPA
   执行命令：

   flutter build ipa --target lib/main_prd.dart --release --export-options-plist=ios/exportDevId.plist
   

   构建完成后，在build/ios/ipa/目录下找到生成的IPA文件
4. 分发与安装
   • 将IPA上传到你的个人网站，需搭配一个manifest.plist文件（用于引导iOS设备下载安装），安装链接格式为itms-services://?action=download-manifest&url=https://你的网站地址/manifest.plist
   • 确保manifest.plist中填写正确的IPA下载URL、Bundle ID、版本号，且所有目标设备UDID已包含在配置文件内

四、常见问题排查 #

• 提示“无法验证完整性”：大概率是签名配置错误——证书过期、配置文件未包含设备UDID、plist的method/destination设置错误，或误用了App Store分发证书
• 安装后无法启动：检查配置文件是否包含设备UDID、证书是否有效；还可以通过Xcode的Window > Devices and Simulators查看设备控制台日志，获取启动失败的具体错误信息

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