Flutter iOS运行报Module 'audioplayers' not found 模拟器构建失败如何解决

第一步：彻底清理并重建依赖 #

• 在Flutter项目根目录依次执行以下命令，清除旧的构建缓存和依赖文件：

  flutter clean
  rm -rf ios/Pods ios/Podfile.lock ios/Runner.xcworkspace
  flutter pub get
  

• 打开项目ios目录下的Podfile，在post_install代码块中新增模拟器架构适配配置，修改后完整代码如下：

  post_install do |installer|
    installer.pods_project.targets.each do |target|
      flutter_additional_ios_build_settings(target)
      # 新增适配代码开始
      target.build_configurations.each do |config|
        # 排除模拟器不支持的arm64架构，避免编译冲突
        config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64'
        # 这里的版本号需和Xcode中设置的iOS部署目标版本一致，最低不低于11.0
        config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '12.0'
      end
      # 新增适配代码结束
    end
  end
  

• 在ios目录下执行命令更新Pod依赖：

  pod install --repo-update
  

第二步：校验Xcode构建设置 #

• 打开项目的Runner.xcworkspace文件，选中左侧导航栏的Runner项目，进入Build Settings页面
• 找到Excluded Architectures配置，确认针对Any iOS Simulator SDK的配置值为arm64，如果没有自动同步则手动添加
• 找到Build Active Architecture Only配置，Debug模式设置为YES，Release模式设置为NO

第三步：重置模拟器缓存 #

• 完全关闭所有已打开的iOS模拟器，在终端执行命令清除模拟器缓存：

  xcrun simctl erase all
  

• 重新启动模拟器后执行flutter run构建即可

兜底方案 #

如果以上操作完成后仍报错，升级audioplayers依赖到最新稳定版，老版本存在iOS模拟器适配缺陷。苹果硅设备请勿使用Rosetta模式启动Xcode，避免架构适配冲突。

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