iOS17+Xcode15后Flutter项目无法在VSCode/AS运行至iPhone

问题场景 #

更新至iOS 17和Xcode 15后，通过VSCode或Android Studio运行Flutter项目到iPhone 13时触发报错：

无法在设备00001910-00081XXXX19A201E上运行build/ios/iphoneos/Runner.app，提示建议启动Xcode并选择“Product > Run”修复，打开ios/Runner.xcworkspace，同时显示“Error launching application on iPhone”

Xcode可正常运行项目，但VSCode/Android Studio持续报错，已尝试重置设备、flutter clean & pub get、证书/配对重置等8种常规方案无效。

针对性解决方案 #

1. 适配Xcode 15的Podfile配置 #

打开项目根目录下的ios/Podfile，修改post_install钩子，添加Xcode 15适配代码：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    # 适配Xcode 15签名与构建规则
    target.build_configurations.each do |config|
      config.build_settings['CODE_SIGN_STYLE'] = 'Manual'
      config.build_settings['DEVELOPMENT_TEAM'] = '你的开发者团队ID' # 替换为自己的Team ID
      config.build_settings['ENABLE_BITCODE'] = 'NO'
    end
  end
end

执行以下命令更新依赖：

cd ios && pod install && cd ..

2. 统一Flutter与Xcode的iOS部署目标 #

• 打开ios/Runner.xcworkspace，查看项目的Deployment Target（如iOS 17.0）
• 在项目根目录的pubspec.yaml中添加对应配置：

flutter:
  ios:
    deployment_target: 17.0

执行flutter clean && flutter pub get后重试运行。

3. 升级Flutter到适配Xcode 15的版本 #

Xcode 15需要Flutter 3.13及以上版本支持，执行命令升级：

flutter upgrade

若稳定版仍有问题，可切换至beta通道尝试：

flutter channel beta && flutter upgrade

4. 配置IDE运行参数指定签名信息 #

• VSCode：打开.vscode/launch.json，添加签名相关运行参数：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Flutter",
      "request": "launch",
      "type": "dart",
      "args": [
        "--debug",
        "--ios-signing-cert", "iPhone Developer: 你的名字 (XXXXXX)",
        "--ios-team-id", "你的Team ID"
      ]
    }
  ]
}

• Android Studio：在Run Configuration的Additional run args中添加上述参数。

5. 重置IDE设备连接缓存 #

• VSCode：关闭所有窗口，删除~/.vscode/extensions/Dart-Code.dart-code-*/bin/cache目录，重启VSCode
• Android Studio：打开File > Invalidate Caches...，选择Invalidate and Restart

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