在Android Studio中修改Android版本的两种主流方法

 更新时间:2025年07月21日 10:30:21   作者:好奇的菜鸟  
在 Android 开发的日常迭代中,我们经常需要升级或降级项目的 minSdkVersion、targetSdkVersion 与 compileSdkVersion,本文将手把手演示在 Android Studio 里修改 Android 版本的两种主流做法,并给出易踩的坑与最佳实践,需要的朋友可以参考下

引言

在 Android 开发的日常迭代中,我们经常需要升级或降级项目的 minSdkVersiontargetSdkVersioncompileSdkVersion。升级可以解锁新特性和性能优化;降级则可能为了兼容旧机型或快速验证问题。本文将手把手演示在 Android Studio 里修改 Android 版本的两种主流做法,并给出易踩的坑与最佳实践,帮助你少踩雷、一次过。

一、先厘清三个关键字段

字段名作用简述常见误区
compileSdkVersion项目编译时使用的 SDK 版本,决定你能调用哪些新 API。并非越高越好,需与 Gradle 插件、依赖库匹配。
minSdkVersion应用最低可安装的 Android 版本。设太低会导致新 API 不可用,设太高会丢失大量用户。
targetSdkVersion声明“我已经在该版本上充分测试”,影响系统兼容性策略。必须 ≤ compileSdkVersion,且建议随 Google Play 要求逐年升级。

二、方法一:图形化操作(适合新手)

  1. 打开项目后,依次点击菜单栏:File → Project Structure(或快捷键 Ctrl+Alt+Shift+S)。
  2. 在左侧选择 Modules → app → Properties 选项卡。
  3. 直接在下拉框里选择需要的版本:
    • Compile Sdk Version:例如 34(Android 14)。
    • Min Sdk Version:例如 24(Android 7.0)。
    • Target Sdk Version:例如 34(与 Compile 同级或更低)。
  4. 点击 Apply → OK,Android Studio 会自动触发 Gradle Sync
  5. 同步完成后,Rebuild Project(Build → Rebuild Project)验证无报错即可。

三、方法二:直接改 build.gradle.kts(推荐进阶)

打开模块级构建脚本(app/build.gradle.ktsapp/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.TIRAMISUcompileSdk 低于 33把 compileSdk 升到 33 及以上。
真机安装失败 INSTALL_FAILED_OLDER_SDKminSdk 高于设备系统版本降低 minSdk 或在 gradle 中启用 abiFilters 分包。
同步时报 Could not find com.android.tools.build:gradle:X.Y.ZGradle 插件版本与 compileSdk 不匹配打开 gradle/libs.versions.toml 或 project-level build.gradle,升级 com.android.tools.build:gradle 至对应版本。

五、最佳实践小结

  1. 年度例行升级:Google Play 每年 8 月左右会提高 targetSdkVersion 的强制要求,建议提前 1~2 个季度完成适配。
  2. Lint 检查:在 Android Studio 中运行 Analyze → Inspect Code,可快速发现高版本 API 在低版本系统上的调用风险。
  3. 多模块项目:若存在 library 模块,需确保所有模块的 minSdk ≤ app 模块的 minSdk,否则合并时会报错。
  4. 版本对照表:收藏官方 API Levels 页面,随时查代号与版本号。

结语

修改 Android 版本只是“改三行数字”那么简单,却牵一发动全身:API 兼容性、依赖库、Google Play 政策、用户覆盖率都会随之变化。希望本文的两种方法 + 避坑清单能让你下次升级时胸有成竹。

以上就是在Android Studio中修改Android版本的两种主流方法的详细内容,更多关于Android Studio修改Android版本的资料请关注脚本之家其它相关文章!

相关文章

  • OkHttp3中默认不保持Cookie的解决方法

    OkHttp3中默认不保持Cookie的解决方法

    这篇文章主要给大家介绍了关于OkHttp3中默认不保持Cookie的解决方法,文中先对OKhttp3中的cookies进行了简单的介绍,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧。
    2018-04-04
  • Android虚拟机与类加载机制详情

    Android虚拟机与类加载机制详情

    这篇文章主要介绍了Android虚拟机与类加载机制详情,文章围绕主题展开详细的内容介绍,具有一定的参考价值,需要的小伙伴可以参考一下
    2022-09-09
  • Android 虚拟按键适配动态调整布局的方法

    Android 虚拟按键适配动态调整布局的方法

    今天小编就为大家分享一篇Android 虚拟按键适配动态调整布局的方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-07-07
  • Android 属性动画ValueAnimator与插值器详解

    Android 属性动画ValueAnimator与插值器详解

    这篇文章主要介绍了Android 属性动画ValueAnimator与插值器详解的相关资料,需要的朋友可以参考下
    2017-05-05
  • 教你轻松制作Android音乐播放器

    教你轻松制作Android音乐播放器

    这篇文章主要教大家轻松制作Android音乐播放器,制作一款属于自己的Android音乐播放器,希望大家喜欢。
    2015-11-11
  • Android之使用Bundle进行IPC详解

    Android之使用Bundle进行IPC详解

    这篇文章主要介绍了Android之使用Bundle进行IPC详解,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-01-01
  • Android自定义控件实现短信验证码自动填充

    Android自定义控件实现短信验证码自动填充

    这篇文章主要为大家详细介绍了Android自定义控件实现短信验证码自动填充,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-12-12
  • 6步轻松实现两个listView联动效果

    6步轻松实现两个listView联动效果

    这篇文章主要为大家详细介绍了教大家通过6步轻松实现两个listView联动效果,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-04-04
  • Android音视频之视频采集(系统API预览)

    Android音视频之视频采集(系统API预览)

    这篇文章主要为大家详细介绍了Android音视频之视频采集,系统API预览,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-12-12
  • Android开发手册TextView控件及阴影效果实现

    Android开发手册TextView控件及阴影效果实现

    这篇文章主要为大家介绍了Android开发手册TextView控件及阴影效果的实现示例,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-06-06

最新评论