You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter应用无法在iOS Simulator运行的问题求助

解决Flutter在iOS Simulator启动失败的问题

从错误日志来看,核心问题是Xcode无法找到指定ID的模拟器设备,且当前项目的可用部署目标仅包含macOS和iOS占位设备,结合你使用的Flutter 3.0.0(2022年版本)与Xcode 15.0(2023年版本)的版本差异,可按以下步骤排查解决:

1. 检查项目iOS部署目标与模拟器版本匹配

  • 打开项目的ios/Runner.xcworkspace,在Xcode中选中Runner目标,进入Deployment Info页面;
  • 确保设置的iOS Deployment Target版本 ≤ 当前模拟器的iOS版本,比如模拟器是iOS 17.0,部署目标就不能设为iOS 18.0。

2. 清除Flutter与Xcode缓存并重建依赖

执行以下命令清理缓存并重新安装依赖:

flutter clean
rm -rf ios/Pods
rm ios/Podfile.lock
flutter pub get
cd ios && pod install

回到项目根目录后,重新尝试启动模拟器。

3. 指定可用模拟器设备启动

先查看本地可用的模拟器列表:

flutter emulators

找到目标模拟器的ID或名称,用命令直接指定启动:

# 使用模拟器ID启动
flutter emulators --launch <模拟器ID>
flutter run -d <模拟器ID>

# 或使用设备名称启动
flutter run -d "iPhone 13 Pro Max"

4. 调整Xcode项目架构配置

  • 在Xcode的Runner目标中,进入Build Settings页面,搜索Excluded Architectures;
  • 确保Debug模式下未排除模拟器支持的架构(如arm64,针对M系列Mac);
  • 同时检查Valid Architectures,确保包含x86_64(Intel Mac)或arm64(M系列Mac)。

5. 适配Flutter 3.0.0与Xcode 15的兼容性

由于Flutter 3.0.0发布时Xcode 15尚未推出,存在原生兼容性问题,可修改ios/Podfile添加适配补丁:
打开ios/Podfile,在post_install代码块中补充配置:

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['IPHONEOS_DEPLOYMENT_TARGET'] = '12.0'
      config.build_settings['ENABLE_BITCODE'] = 'NO'
      config.build_settings['CODE_SIGNING_ALLOWED'] = 'NO'
    end
  end
end

修改后执行cd ios && pod install,再重新运行项目。

6. 直接在Xcode中启动验证

打开ios/Runner.xcworkspace,在Xcode中选择目标模拟器并点击运行按钮,若能成功启动,说明问题出在Flutter工具链与Xcode的交互层,可尝试重启Android Studio或Flutter daemon(执行flutter daemon --kill)后再试。

内容的提问来源于stack exchange,提问作者kalinor

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.09 11:20:23