Android项目默认依赖库版本判定规则及版本不一致问题咨询

我在参与Android开发课程时，已与讲师的开发环境（包括最低SDK版本、AGP版本）保持一致，但新建项目时自动生成的依赖库版本仍与讲师存在差异，进而引发报错。需要明确Android Studio新建项目时默认依赖版本的设定标准，以及修改AGP和最低SDK版本后依赖版本未变化的原因，以便告知同学。

示例默认依赖如下：

dependencies {
    implementation("androidx.core:core-ktx:1.13.1")
    implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.8.6")
    implementation("androidx.activity:activity-compose:1.9.2")
    implementation(platform("androidx.compose:compose-bom:2023.08.00"))
    implementation("androidx.compose.ui:ui")
    implementation("androidx.compose.ui:ui-graphics")
    implementation("androidx.compose.ui:ui-tooling-preview")
    implementation("androidx.compose.material3:material3")
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.2.1")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.6.1")
    androidTestImplementation(platform("androidx.compose:compose-bom:2023.08.00"))
    androidTestImplementation("androidx.compose.ui:ui-test-junit4")
    debugImplementation("androidx.compose.ui:ui-tooling")
    debugImplementation("androidx.compose.ui:ui-test-manifest")
}

新项目默认依赖版本的设定标准 #

• 核心依赖版本由Android Studio的内置项目模板决定：Studio自带的各类项目模板（如Compose项目、传统View项目）中，硬编码了一套Google官方选定的稳定依赖版本组合，这些版本与当前Studio的发布版本强绑定。
• Compose相关依赖由**Compose BOM（物料清单）**统一管控：模板中预设的BOM版本会锁定所有Compose库的兼容版本，确保依赖间无冲突，BOM版本同样是Studio发布时确定的固定值。
• 测试类依赖（如JUnit、Espresso）的版本为模板预设的稳定版本，与Studio版本同步更新。

修改AGP/最低SDK版本后依赖版本未变化的原因 #

• AGP版本与模板依赖版本无强关联：AGP负责项目构建逻辑，模板内的依赖版本是独立预设的，升级AGP不会自动更新模板中的依赖版本，仅当更新Android Studio到对应版本时，模板依赖才会同步更新。
• 最低SDK版本仅影响依赖兼容性检查，不会改变模板默认的依赖版本号：模板仅根据你选择的项目类型加载预设依赖版本，与minSdk参数无关。
• 可能存在模板缓存问题：Android Studio的模板缓存未更新，导致新建项目时仍调用旧的模板配置生成依赖。

解决方法 #

• 同步Android Studio版本：直接将你的Studio版本更新至与讲师一致的版本，同版本的Studio会生成完全匹配的默认依赖。
• 手动修改依赖版本：若无法更新Studio，可对照讲师的依赖列表，手动修改项目build.gradle.kts（或build.gradle）文件中的依赖版本号，重点同步Compose BOM版本。
• 清除Studio模板缓存：删除对应目录的缓存文件（Windows路径：C:\Users\<用户名>\.AndroidStudio<版本号>\system\templates；Mac/Linux路径：~/.AndroidStudio<版本号>/system/templates），重启Studio后重新创建项目。

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