在Android Studio中修改Android版本的两种主流方法
作者：好奇的菜鸟
在 Android 开发的日常迭代中,我们经常需要升级或降级项目的 minSdkVersion、targetSdkVersion 与 compileSdkVersion,本文将手把手演示在 Android Studio 里修改 Android 版本的两种主流做法,并给出易踩的坑与最佳实践,需要的朋友可以参考下
引言
在 Android 开发的日常迭代中，我们经常需要升级或降级项目的 minSdkVersion、targetSdkVersion 与 compileSdkVersion。升级可以解锁新特性和性能优化；降级则可能为了兼容旧机型或快速验证问题。本文将手把手演示在 Android Studio 里修改 Android 版本的两种主流做法，并给出易踩的坑与最佳实践，帮助你少踩雷、一次过。
一、先厘清三个关键字段
| 字段名 | 作用简述 | 常见误区 |
|---|---|---|
| compileSdkVersion | 项目编译时使用的 SDK 版本，决定你能调用哪些新 API。 | 并非越高越好，需与 Gradle 插件、依赖库匹配。 |
| minSdkVersion | 应用最低可安装的 Android 版本。 | 设太低会导致新 API 不可用，设太高会丢失大量用户。 |
| targetSdkVersion | 声明“我已经在该版本上充分测试”，影响系统兼容性策略。 | 必须 ≤ compileSdkVersion，且建议随 Google Play 要求逐年升级。 |
二、方法一：图形化操作（适合新手）
- 打开项目后，依次点击菜单栏：
File → Project Structure（或快捷键Ctrl+Alt+Shift+S）。 - 在左侧选择
Modules → app → Properties选项卡。 - 直接在下拉框里选择需要的版本：
- Compile Sdk Version：例如 34（Android 14）。
- Min Sdk Version：例如 24（Android 7.0）。
- Target Sdk Version：例如 34（与 Compile 同级或更低）。
- 点击 Apply → OK，Android Studio 会自动触发 Gradle Sync。
- 同步完成后，Rebuild Project（
Build → Rebuild Project）验证无报错即可。
三、方法二：直接改 build.gradle.kts（推荐进阶）
打开模块级构建脚本（app/build.gradle.kts 或 app/build.gradle），找到 android {} 区块：
android {
compileSdk = 34
defaultConfig {
applicationId = "com.example.myapp"
minSdk = 24
targetSdk = 34
versionCode = 1
versionName = "1.0"
}
// ... 其他配置
}
修改后按 Ctrl+S 保存，顶部会出现 “Sync Now” 提示，点击即可。
如果你喜欢命令行，也可以在终端执行：
./gradlew assembleDebug
四、常见报错与排查清单
| 现象 | 可能原因 | 解决思路 |
|---|---|---|
| Unresolved reference: Build.VERSION_CODES.TIRAMISU | compileSdk 低于 33 | 把 compileSdk 升到 33 及以上。 |
| 真机安装失败 INSTALL_FAILED_OLDER_SDK | minSdk 高于设备系统版本 | 降低 minSdk 或在 gradle 中启用 abiFilters 分包。 |
| 同步时报 Could not find com.android.tools.build:gradle:X.Y.Z | Gradle 插件版本与 compileSdk 不匹配 | 打开 gradle/libs.versions.toml 或 project-level build.gradle，升级 com.android.tools.build:gradle 至对应版本。 |
五、最佳实践小结
- 年度例行升级：Google Play 每年 8 月左右会提高 targetSdkVersion 的强制要求，建议提前 1~2 个季度完成适配。
- Lint 检查：在 Android Studio 中运行
Analyze → Inspect Code，可快速发现高版本 API 在低版本系统上的调用风险。 - 多模块项目：若存在
library模块，需确保所有模块的 minSdk ≤ app 模块的 minSdk，否则合并时会报错。 - 版本对照表：收藏官方 API Levels 页面，随时查代号与版本号。
结语
修改 Android 版本只是“改三行数字”那么简单，却牵一发动全身：API 兼容性、依赖库、Google Play 政策、用户覆盖率都会随之变化。希望本文的两种方法 + 避坑清单能让你下次升级时胸有成竹。
以上就是在Android Studio中修改Android版本的两种主流方法的详细内容，更多关于Android Studio修改Android版本的资料请关注脚本之家其它相关文章！