升级至ExoPlayer 2.18.2后遇到导入问题求助

核心问题分析 #

你遇到的编译错误本质是依赖同步不完整和迁移脚本未覆盖所有变更点，结合操作步骤来看，问题大概率出在几个关键环节的遗漏上。

具体排查修复步骤 #

1. 补全Gradle配置要求 #

• 确认项目根目录build.gradle（或settings.gradle，依AGP版本而定）已添加Google Maven仓库：

  repositories {
      google()
      mavenCentral()
  }
  

• 检查模块级build.gradle的Media3依赖是否完整，确保所有原ExoPlayer相关模块都已替换：

  // 替换旧的ExoPlayer依赖
  implementation "androidx.media3:media3-exoplayer:1.0.0-beta03"
  implementation "androidx.media3:media3-exoplayer-ima:1.0.0-beta03"
  implementation "androidx.media3:media3-ui:1.0.0-beta03"
  // 若使用HLS/DASH等扩展，同步替换对应依赖
  // implementation "androidx.media3:media3-exoplayer-hls:1.0.0-beta03"
  

• 确保compileSdkVersion和targetSdkVersion至少为33（Media3对SDK版本有最低要求）：

  android {
      compileSdk 33
      defaultConfig {
          targetSdk 33
      }
  }
  

2. 强制清理并同步依赖 #

• 执行Gradle清理命令，彻底刷新依赖：

  ./gradlew clean build --refresh-dependencies
  

• 在Android Studio中点击File > Sync Project with Gradle Files，等待依赖完全下载完成。

3. 手动补全迁移脚本未覆盖的变更 #

迁移脚本仅处理部分Java/Kotlin代码，需手动检查以下文件：

• XML布局：全局替换com.google.android.exoplayer2.ui.PlayerView为androidx.media3.ui.PlayerView，确保控件类名正确。
• Manifest文件：若注册过ExoPlayer相关服务/广播接收器，同步替换为Media3对应的类。
• ProGuard/R8规则：替换旧的ExoPlayer规则为Media3规则，添加到proguard-rules.pro：

  -keep class androidx.media3.** { *; }
  -keep interface androidx.media3.** { *; }
  

4. 修复代码导入错误 #

• 针对无法解析symbol 'media3'：
  1. 检查External Libraries中是否存在androidx.media3相关库，若无则重新同步Gradle。
  2. 手动替换所有旧导入路径：

     // 旧导入
     import com.google.android.exoplayer2.ExoPlayer;
     import com.google.android.exoplayer2.Player;
     // 替换为
     import androidx.media3.exoplayer.ExoPlayer;
     import androidx.media3.common.Player;
     

• 针对无法解析symbol 'android'：此问题多为依赖同步失败导致Android SDK库未加载，重新执行Gradle同步即可解决。

5. 验证XML文件正确性 #

• 检查所有包含播放器控件的XML，确保类名和命名空间正确：

  <!-- 替换前 -->
  <com.google.android.exoplayer2.ui.PlayerView
      android:id="@+id/player_view"
      android:layout_width="match_parent"
      android:layout_height="match_parent"/>
  <!-- 替换后 -->
  <androidx.media3.ui.PlayerView
      android:id="@+id/player_view"
      android:layout_width="match_parent"
      android:layout_height="match_parent"/>
  

• 若XML验证错误源于命名空间，确保根布局包含xmlns:android="http://schemas.android.com/apk/res/android"。

你的迁移步骤遗漏点 #

你修改LEGACY_PEER_VERSION并执行脚本，但忽略了：

1. 未确认Gradle仓库和SDK版本是否满足Media3的最低要求；
2. 迁移脚本未覆盖XML、Manifest等非代码文件的变更；
3. 未清理Gradle缓存导致依赖未正确更新。

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