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

升级Xcode 14后Flutter iOS构建失败问题求助

Xcode 14升级后Flutter iOS构建失败的解决办法

问题背景

升级Xcode 14后,Mac端通过Android Studio执行Build->Flutter->Build iOS时构建失败,当前使用Flutter 3.3.2,依赖shared_preferences: ^2.0.15;升级前项目运行正常,Windows环境无异常。核心报错包括:

  • shared_preferences_ios-2.1.1插件中FlutterPluginRegistrar类型未找到、messenger属性不存在
  • Command SwiftCompile执行失败
  • 新建仅含shared_preferences的项目也出现相同问题,同时searchable_dropdown: ^1.1.3、file_picker: ^4.6.1、html_editor_enhanced: ^2.5.0、image_cropper: ^3.0.0等多个依赖包在Mac端构建iOS时均存在冲突

解决步骤

  1. 升级Flutter到兼容Xcode14的版本
    Flutter 3.3.2版本发布于Xcode14之前,对其兼容性不足。建议升级到3.7及以上的稳定版:

    flutter upgrade
    

    若需要指定稳定版本,可执行:

    flutter downgrade 3.7.12
    
  2. 更新依赖包到适配版本
    旧版本插件未适配Xcode14的API变化,需更新以下依赖:

    • 修改pubspec.yaml中的依赖版本:
      shared_preferences: ^2.2.0
      file_picker: ^5.3.0
      html_editor_enhanced: ^3.0.0
      image_cropper: ^4.0.0
      
    • 注意:searchable_dropdown: ^1.1.3已停止维护,建议替换为dropdown_search等活跃维护的替代包
    • 执行命令更新依赖:
      flutter pub get
      
  3. 清理构建缓存
    清理旧的构建缓存,避免残留冲突:

    flutter clean
    cd ios
    pod deintegrate
    pod install
    
  4. 检查iOS项目配置
    打开iOS项目的Runner.xcworkspace,确认:

    • Build Settings中Swift Language Version设置为Swift 5.0及以上
    • Deployment Target至少为iOS 11.0(部分新插件的最低要求)

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.19 02:55:23