Flutter添加audioplayer包后报pod install错误无法运行iOS项目

该报错属于Flutter iOS端引入第三方原生插件后的常见构建错误，按以下步骤从上到下依次操作，每步完成后可尝试运行验证，无需执行全部步骤：

1. 全链路清理构建缓存 #

仅清理pod缓存无法解决残留问题，需同步清理Flutter、Xcode、CocoaPods三层缓存：

• 回到项目根目录，执行flutter clean命令清除Flutter构建产物
• 删除项目根目录下的pubspec.lock文件
• 进入项目ios目录，依次执行以下命令：
  • pod deintegrate
  • rm -f Podfile.lock
  • rm -rf Pods/
• 打开Xcode，使用快捷键Cmd + Shift + K清除Xcode构建缓存后完全关闭Xcode

2. 修复CocoaPods索引异常 #

多数重装CocoaPods后仍报错的场景，本质是本地spec索引损坏或源访问失败：

• 执行pod repo remove master，若提示仓库不存在直接跳过即可
• 国内网络环境下，打开ios目录下的Podfile文件，在文件最顶部添加国内镜像源配置：

source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git'

• 执行pod repo update更新本地spec索引，等待执行完成不要中途中断

3. 对齐iOS最低部署版本 #

audioplayer插件对iOS系统最低版本有要求，版本不匹配会直接导致pod编译失败：

• 打开ios目录下的Podfile，找到首行的platform :ios, 'xx.0'配置，将版本号修改为12.0，即配置为platform :ios, '12.0'
• 打开ios/Runner.xcworkspace，在Xcode中选中Runner目标，找到Minimum Deployments配置项，将iOS版本同样设置为12.0，保证两边配置完全一致

4. 重新安装依赖启动项目 #

回到项目根目录，依次执行以下命令：

• flutter pub get拉取Flutter端依赖
• 进入ios目录执行pod install --repo-update安装iOS端原生依赖
• 回到项目根目录执行flutter run启动项目

注意：如果你pubspec.yaml中引入的是不带s后缀的audioplayer包，该包已停止维护超过3年，本身存在适配最新Xcode、iOS系统的兼容问题，直接替换为官方持续维护的audioplayers包后，重复上述依赖安装流程即可解决问题。

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