Flutter iOS构建报错：需在Signing & Capabilities编辑器选开发团队

问题现象 #

已在Xcode中完成主工程的Signing相关配置，但构建Flutter应用到iOS设备时，多个Pod依赖组件（如GoogleSignIn-GoogleSignIn、DKPhotoGallery-DKPhotoGallery等）仍提示需在Signing & Capabilities编辑器中选择开发团队，错误日志如下：

Could not build the precompiled application for the device.
Error (Xcode): Signing for "GoogleSignIn-GoogleSignIn" requires a development team. Select a development team in the Signing & Capabilities editor.
/Users/home_1/StudioProjects/Example%20Project/app/ios/Pods/Pods.xcodeproj

Error (Xcode): Signing for "DKPhotoGallery-DKPhotoGallery" requires a development team. Select a development team in the Signing & Capabilities editor.
/Users/home_1/StudioProjects/Example%20Project/app/ios/Pods/Pods.xcodeproj

Error (Xcode): Signing for "DKImagePickerController-DKImagePickerController" requires a development team. Select a development team in the Signing & Capabilities editor.
/Users/home_1/StudioProjects/Example%20Project/app/ios/Pods/Pods.xcodeproj

Error (Xcode): Signing for "gRPC-C++-gRPCCertificates-Cpp" requires a development team. Select a development team in the Signing & Capabilities editor.
/Users/home_1/StudioProjects/Example%20Project/app/ios/Pods/Pods.xcodeproj

问题原因 #

1. Pod依赖的子工程未继承主工程的签名配置，部分第三方库的Podspec未正确设置签名相关Build Settings，导致需要手动指定开发团队
2. Pod安装生成的Pods.xcodeproj中，各目标的签名配置未自动同步主工程的开发团队信息
3. 本地构建缓存残留，导致新的签名配置未生效

解决方案 #

方案一：通过Podfile自动统一配置所有Pod的签名团队 #

在项目ios目录下的Podfile末尾添加以下代码，让所有Pod目标继承主工程的开发团队配置：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      # 替换为你的开发团队ID（可在Xcode主工程Signing页面查看）
      config.build_settings['DEVELOPMENT_TEAM'] = 'YOUR_TEAM_ID'
      config.build_settings['CODE_SIGN_IDENTITY'] = 'iPhone Developer'
    end
  end
end

执行以下命令更新Pod配置：

cd ios
pod install

重新打开Xcode的Runner.xcworkspace进行构建。

方案二：手动为Pod子工程配置签名团队 #

1. 打开Flutter项目ios目录下的Runner.xcworkspace
2. 在左侧导航栏展开Pods.xcodeproj，逐个选中报错的Pod目标（如GoogleSignIn-GoogleSignIn）
3. 切换到Signing & Capabilities标签页，勾选Automatically manage signing，并选择你的开发团队
4. 重复上述操作，为所有报错的Pod目标配置完成后，重新构建项目

方案三：清理缓存后重新安装Pods #

若缓存导致配置未生效，执行以下步骤：

# 清理Flutter缓存
flutter clean

# 进入ios目录，清理Pod依赖
cd ios
pod deintegrate

# 重新安装Pod依赖
pod install

重新打开Runner.xcworkspace，确认主工程签名配置无误后再构建。

注意事项 #

• 确保你的Apple开发者账号拥有开发权限，且测试设备已添加到开发者账号的设备列表中
• 若使用Flutter的beta/dev版本，建议切换到stable版本，避免兼容性问题

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