升级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时均存在冲突
解决步骤
升级Flutter到兼容Xcode14的版本
Flutter 3.3.2版本发布于Xcode14之前,对其兼容性不足。建议升级到3.7及以上的稳定版:flutter upgrade若需要指定稳定版本,可执行:
flutter downgrade 3.7.12更新依赖包到适配版本
旧版本插件未适配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
- 修改
清理构建缓存
清理旧的构建缓存,避免残留冲突:flutter clean cd ios pod deintegrate pod install检查iOS项目配置
打开iOS项目的Runner.xcworkspace,确认:- Build Settings中
Swift Language Version设置为Swift 5.0及以上 - Deployment Target至少为iOS 11.0(部分新插件的最低要求)
- Build Settings中
内容的提问来源于stack exchange,提问作者blue492
相关产品推荐
相关产品推荐

