Flutter构建IPA遇签名问题：如何传递-allowProvisioningUpdates给Xcodebuild？

问题场景 #

通过Shell搭建自定义CI系统，Flutter项目构建IPA阶段触发Xcode签名错误：

Error (Xcode): No profiles for 'x.y.z.a' were found: Xcode couldn't find any iOS App Development provisioning profiles matching 'x.y.z.a'. Automatic signing is disabled and unable to generate a profile. To enable automatic signing, pass -allowProvisioningUpdates to xcodebuild.
/Users/me/Repos/mynewproject/mynewapp/ios/Runner.xcodeproj

App Store Connect中已存在对应配置文件，需通过编程方式让Flutter构建时自动传递签名更新参数，或配置Xcode项目允许自动更新配置。

解决方案 #

方案1：直接为flutter build ipa传递xcodebuild参数 #

Flutter的build ipa命令支持附加xcodebuild参数，通过-x指定即可：

flutter build ipa --export-options-plist=ExportOptions.plist -x allowProvisioningUpdates=YES

如果需要更精细控制，也可以拆分构建流程，手动调用xcodebuild：

flutter build ipa --release --no-codesign --export-options-plist=ExportOptions.plist && \
xcodebuild -exportArchive -archivePath build/ios/archive/Runner.xcarchive \
-exportPath build/ios/ipa -exportOptionsPlist ExportOptions.plist -allowProvisioningUpdates

CI环境需确保已配置Apple开发者账号凭据（比如通过fastlane match或Xcode登录账号）。

方案2：编程修改Xcode项目开启自动签名 #

用sed或plutil命令修改Runner.xcodeproj配置，开启自动签名并允许配置更新：

1. 切换自动签名模式：

sed -i '' 's/CODE_SIGN_STYLE = Manual;/CODE_SIGN_STYLE = Automatic;/' ios/Runner.xcodeproj/project.pbxproj

2. 设置Apple团队ID（替换为你的团队ID）：

sed -i '' 's/DEVELOPMENT_TEAM = "";/DEVELOPMENT_TEAM = "YOUR_TEAM_ID";/' ios/Runner.xcodeproj/project.pbxproj

3. 允许自动管理配置文件：

plutil -replace "buildSettings.ENABLE_AUTOMATIC_PROVISIONING" -bool YES ios/Runner.xcodeproj/project.pbxproj

方案3：通过ExportOptions.plist配置添加权限 #

在ExportOptions.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>allowProvisioningUpdates</key>
    <true/>
</dict>
</plist>

构建时指定该配置文件：

flutter build ipa --export-options-plist=ExportOptions.plist

注意事项 #

• CI环境需验证Xcode已登录正确开发者账号，可通过xcodebuild -list确认账号状态。
• 若使用手动签名，需在ExportOptions.plist中明确配置文件映射：

<key>provisioningProfiles</key>
<dict>
    <key>x.y.z.a</key>
    <string>你的配置文件名称</string>
</dict>

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