Flutter iOS项目编译报错:Module 'camera_avfoundation' not found
故障原因分析
- 插件与Flutter版本不兼容:camera插件0.10.5+5发布时间较早,未适配Flutter 3.16.0的底层API变化,导致iOS端
camera_avfoundation模块无法被正常识别。 - Pod依赖缓存损坏:常规
pod install未清理损坏的本地Pods缓存,或插件的iOS子模块未正确拉取到本地。 - Xcode项目配置异常:Build Settings中的框架搜索路径配置错误,或打开的是
.xcodeproj而非.xcworkspace,导致Pods框架无法加载。 - 本地依赖文件损坏:Flutter项目iOS目录下的缓存或生成文件损坏,引发模块引用失效。
可行解决方案
- 升级camera插件到兼容版本:
将插件升级至支持Flutter 3.16.0的版本(如0.10.6+1及以上),执行命令:flutter pub upgrade camera flutter clean flutter pub get cd ios && pod install --repo-update - 彻底清理Pod缓存与依赖:
删除iOS目录下的Pods文件夹和Podfile.lock,清理全局缓存后重新安装:cd ios rm -rf Pods Podfile.lock pod cache clean --all pod install - 正确打开Xcode工作区:
关闭当前Xcode项目,重新打开项目根目录下的Runner.xcworkspace(而非Runner.xcodeproj),确保Pods框架被正确引入。 - 修复Xcode Build Settings配置:
在Xcode中选中Runner target,进入Build Settings:- 搜索
Framework Search Paths,确认包含$(inherited)和${PODS_ROOT}/camera_avfoundation/ios,缺失则手动添加; - 搜索
Header Search Paths,确保包含$(inherited)。
- 搜索
- 重新生成iOS项目文件:
重新生成iOS目录核心文件(保留Info.plist等配置):
之后再次执行flutter create --platforms ios .flutter pub get和cd ios && pod install。 - 切换Flutter到稳定通道:
若当前使用beta/dev通道,切换到stable通道并升级:flutter channel stable flutter upgrade flutter clean flutter pub get cd ios && pod install
内容的提问来源于stack exchange,提问作者user22968058
相关产品推荐
相关产品推荐

