AndroidX项目集成第三方AAR库时出现AppCompatActivity类找不到错误求解决方案

我创建了一个支持AndroidX的项目，Module级build.gradle中的依赖项如下：

dependencies {
    implementation 'androidx.appcompat:appcompat:1.5.1'
    implementation 'com.google.android.material:material:1.7.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
    implementation 'androidx.navigation:navigation-fragment:2.5.3'
    implementation 'androidx.navigation:navigation-ui:2.5.3'
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.3'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
}

但在集成第三方Android库（.aar文件）时，出现以下错误：

java.lang.NoClassDefFoundError: Failed resolution of: Landroid/support/v7/app/AppCompatActivity;
Caused by: java.lang.ClassNotFoundException: Didn't find class "android.support.v7.app.AppCompatActivity" on path: DexPathList[[zip file "/data/app/~~sZEp0KvV8gcfSkrgZ7B96A==/com.example.upiandroidsdk-hgQiGx156STD8ciVSeaJxA==/base.apk"],nativeLibraryDirectories=[/data/app/~~sZEp0KvV8gcfSkrgZ7B96A==/com.example.upiandroidsdk-hgQiGx156STD8ciVSeaJxA==/lib/x86_64, /data/app/~~sZEp0KvV8gcfSkrgZ7B96A==/com.example.upiandroidsdk-hgQiGx156STD8ciVSeaJxA==/base.apk!/lib/x86_64, /system/lib64, /system_ext/lib64]]

解决办法 #

• 启用Jetifier自动转换Support依赖
  在项目根目录的gradle.properties文件中，添加或确保以下配置存在：

  android.useAndroidX=true
  android.enableJetifier=true
  

  Jetifier会自动将第三方AAR库中的旧版Support依赖转换为对应的AndroidX依赖，解决类找不到的兼容性问题。

• 排除AAR中的冲突依赖
  先执行命令查看完整依赖树，确认冲突来源：

  # macOS/Linux环境
  ./gradlew app:dependencies
  
  # Windows环境
  gradlew.bat app:dependencies
  

  如果发现AAR库引入了com.android.support:appcompat-v7，在集成AAR的依赖声明中排除该冲突项：

  implementation(name: '你的AAR文件名', ext: 'aar') {
      exclude group: 'com.android.support', module: 'appcompat-v7'
  }
  

• 清理重建项目
  执行Android Studio中的Build > Clean Project，再执行Build > Rebuild Project，确保所有依赖被正确同步和转换。

• 对齐编译版本
  确保项目的compileSdkVersion和targetSdkVersion不低于AAR库要求的版本，建议使用33及以上版本，与AndroidX依赖版本保持兼容。

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