Android项目minSDK高于设备SDK,如何修改项目API版本?
如何修改Android项目的minSDK版本以适配Android 4.2.2(API 17)
嗨,这个问题太常见了,我帮你快速搞定!要让你的应用能在Android 4.2.2(API 17)的旧设备上运行,核心就是把项目的最低兼容SDK版本从23降到17,这里有两种简单的操作方法:
方法一:通过Android Studio图形界面修改
- 打开你的项目,顶部菜单栏选
File→Project Structure(快捷键:Windows/Linux用Ctrl+Alt+Shift+S,Mac用Cmd+;) - 在弹出的窗口左侧选中
Modules,再点选你的主模块(一般是app) - 切换到
Flavors标签页,找到Min SDK Version下拉框,直接选择API 17: Android 4.2.2 (Jelly Bean) - 点击
OK保存,Android Studio会自动同步项目的gradle配置
方法二:直接修改模块级build.gradle文件
这种方法更直接,适合熟悉gradle配置的开发者:
- 在项目视图里找到
app模块下的build.gradle (Module: app)文件(注意别选错成项目根目录的gradle文件) - 打开文件后,定位到
defaultConfig代码块,找到这一行:minSdkVersion 23 - 把
23改成17,修改后变成:minSdkVersion 17 - 保存文件,点击Android Studio右上角的
Sync Now按钮,等待同步完成
关键注意事项
- 修改完版本后,一定要检查项目里有没有用API 17以上才支持的方法或类。如果有,要么替换成兼容的低版本API,要么加版本判断(比如用
if (Build.VERSION.SDK_INT >= 23)做条件分支),不然旧设备运行时会直接崩溃。 - 如果你用了AndroidX或者第三方库,要确认这些库是否支持API 17,有些库的最低兼容版本可能比17高,这时候得找对应的兼容版本库,或者根据实际情况调整minSDK版本。
内容的提问来源于stack exchange,提问作者Lechucico
相关产品推荐
相关产品推荐

