无法找到androidx.core:core:1.12.0-alpha02，旧Android项目构建求助

一、解决当前报错步骤 #

当前核心问题是预览版依赖androidx.core:core:1.12.0-alpha02无法被解析，且项目混用了AndroidX与旧Support库，导致依赖冲突。按以下步骤修复：

1. 替换预览版依赖为稳定版
   在app模块的build.gradle中，将core_version改为最新稳定版（优先选择不带alpha/beta的版本）：

   def core_version = "1.13.1"
   implementation "androidx.core:core:$core_version"
   

2. 移除所有旧Support库，替换为AndroidX对应库
   删除所有com.android.support:*开头的依赖，替换为AndroidX版本：

   // 替换 com.android.support:design:33.0.0
   implementation 'com.google.android.material:material:1.11.0'
   // 替换 com.android.support:support-v4:33.0.0
   implementation 'androidx.legacy:legacy-support-v4:1.0.0'
   // 替换 com.android.support:cardview-v7:33.0.0
   implementation 'androidx.cardview:cardview:1.0.0'
   // 替换 com.android.support:customtabs:33.0.0
   implementation 'androidx.browser:browser:1.8.0'
   // 替换 com.android.support:recyclerview-v7:33.0.0
   implementation 'androidx.recyclerview:recyclerview:1.3.2'
   // 移除 com.android.support:animated-vector-drawable:33.0.0（已包含在appcompat或material中）
   

3. 修正测试运行器
   将testInstrumentationRunner改为AndroidX版本：

   testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
   

4. 清理缓存并同步项目

   • 在Android Studio内执行：File > Invalidate Caches... > Invalidate and Restart
   • 或命令行运行：

     ./gradlew clean build --refresh-dependencies
     

二、重启旧项目的正确流程（避免后续踩坑） #

1. 先备份项目
   用Git提交当前状态，或压缩项目文件夹，确保改坏了能回滚。

2. 升级Gradle与AGP到兼容版本
   不要盲目选最新版，优先用Android Studio提示的兼容组合：

   • 打开项目时，AS会提示升级AGP/Gradle，直接点击"Upgrade"即可自动处理版本匹配。
   • 手动修改需确保AGP版本和Gradle版本对应（比如AGP 8.1.x对应Gradle 8.0-8.2）。

3. 一键迁移到AndroidX
   使用AS内置工具：Refactor > Migrate to AndroidX，自动替换所有Support库为AndroidX，避免手动替换出错。

4. 统一管理依赖版本
   在项目根build.gradle的ext块中定义所有依赖版本，方便后续统一升级：

   ext {
       appcompat_version = "1.6.1"
       material_version = "1.11.0"
       core_version = "1.13.1"
       // 其他依赖版本...
   }
   

5. 逐步升级依赖

   • 先升级AndroidX核心依赖（appcompat、core、material等）到稳定版。
   • 再升级第三方依赖（Firebase、FirebaseUI等），确保版本与核心依赖兼容。
   • 避免一次性把所有依赖升到最新，分批次升级并同步测试。

6. 定期维护与记录

   • 每隔3-6个月，花10分钟升级一次依赖到最新稳定版，提交Git并备注变更。
   • 确保gradle.properties开启AndroidX：

     android.useAndroidX=true
     android.enableJetifier=true
     

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