Flutter iOS构建报错：未声明标识符AVURLAssetHTTPUserAgentKey

问题原因 #

AVURLAssetHTTPUserAgentKey是iOS 15及以上版本才引入的API，而你使用的just_audio 0.9.36直接调用了该API，你的Xcode 13.3对应的iOS SDK或项目部署目标版本不支持这个API，导致编译报错。

可行解决方案 #

1. 升级just_audio到修复兼容性的版本 #

just_audio后续版本已修复该低版本iOS兼容问题，在pubspec.yaml中显式声明更高版本的依赖（覆盖间接引入的旧版本）：

dependencies:
  # 保留原有其他依赖
  just_audio: ^0.9.37 # 或更高稳定版本

执行命令更新依赖：

flutter pub get

2. 提升iOS项目部署目标版本 #

将项目iOS部署目标设为15.0及以上：

• 打开ios/Podfile，找到platform :ios, 'xx.x'行，修改为：

  platform :ios, '15.0'
  

• 进入ios目录执行：

  pod deintegrate && pod install
  

• 重新执行构建或启动模拟器

3. 临时修改just_audio源码（不推荐） #

若上述方法无法实施，可手动修改依赖源码做兼容处理：

• 找到路径ios/.symlinks/plugins/just_audio/ios/Classes/JustAudioPlayer.m
• 定位到使用AVURLAssetHTTPUserAgentKey的代码块，替换为版本判断逻辑：

  // 原代码
  assetOptions[AVURLAssetHTTPUserAgentKey] = self.userAgent;
  // 修改后
  if (@available(iOS 15.0, *)) {
      assetOptions[AVURLAssetHTTPUserAgentKey] = self.userAgent;
  }
  

• 重新编译项目

验证步骤 #

1. 执行flutter clean清理缓存
2. 执行flutter pub get更新依赖
3. 进入ios目录执行pod install
4. 尝试运行模拟器或执行flutter build ios

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