DCloud_App_Array
DCloud_App_Array
  • 发布:2015-04-01 12:55
  • 更新:2023-04-03 13:37
  • 阅读:102426

Android平台API等级配置 - minSdkVersion&targetSdkVersion

分类:HTML5+

此文档将不再维护,请参考新文档:https://uniapp.dcloud.io/tutorial/app-android-minsdkversion

<a id="minsdkversion"></a>

minSdkVersion

minSdkVersion用于指定应用兼容的最低Android版本(API等级)。
如果APP某些功能无法支持低版本Android系统的设备,可以配置minSdkVersion确保APP只能安装到指定Android版本以上的设备。HBuilder|HBuilderX中可在manifest.json中进行配置。

⚠️注意: minSdkVersion升级时只能增加不能降低。minSdkVersion高的apk无法被minSdkVersion低的apk覆盖安装需要注意!!

可视化界面配置

打开项目的manifest.json文件,在 "App常用其它设置" 项中 "Android设置" 下的 minSdkVersion编辑框中输入要支持的最低Android版本号:

源码视图配置

打开项目的manifest.json文件,切换到 "源码视图"

  • 5+APP项目
    在plus->distribute->google节点下添加“minSdkVersion”字段,并配置要支持的最低Android版本号:
    "plus": {  
        "distribute": {  
            "google":{  
                "minSdkVersion": 22  
            }  
        }  
    }
  • uni-app项目
    在"app-plus"->distribute->android节点下添加“minSdkVersion”字段,并配置要支持的最低Android版本号:
    "app-plus": {  
        "distribute": {  
            "android":{  
                "minSdkVersion": 22  
            }  
        }  
    }

Number类型,整数值,应用要求的最低系统版本,必须大于等于19(Android4.4)小于等于23(android 6.0),默认值为19
示例中设置值为22表示应用只能安装在Android5.1及以上设备。

<a id="targetsdkversion"></a>

targetSdkVersion

HBuilder3.2.13版本开始targetSdkVersion默认值由26调整为28
** 注意:某些uni原生插件可能没有适配好targetSdkVersion为28会引起部分功能异常,碰到这类情况请联系插件开发者进行适配 **

⚠️注意: targetSdkVersion升级时只能增加不能降低。targetSdkVersion高的apk无法被targetSdkVersion低的apk覆盖安装需要注意!!

targetSdkVersion用于指定应用适配的Android版本(API等级)。
在Android系统中设置低版本的targetSdkVersion会使APP兼容模式运行,也就可能无法用到新系统的特性,甚至在兼容模式下运行可能存在安全漏洞等问题。
随着Android系统的升级,一些应用市场会要求设置较高的targetSdkVersion才可以提交。HBuilder|HBuilderX中可在manifest.json中进行配置。

可视化界面配置

打开项目的manifest.json文件,在 "App常用其它设置" 项中 "Android设置" 下的 targetSdkVersion编辑框中输入要支持的最低Android版本号:

源码视图配置

打开项目的manifest.json文件,切换到 "源码视图"

  • 5+APP项目
    在plus->distribute->google节点下添加“targetSdkVersion”字段:
    "plus": {  
        "distribute": {  
            "google":{  
                "targetSdkVersion": 26  
            }  
        }  
    }
  • uni-app项目
    在"app-plus"->distribute->android节点下添加“targetSdkVersion”字段:
    "app-plus": {  
        "distribute": {  
            "android":{  
                "targetSdkVersion": 26  
            }  
        }  
    }

Number类型,整数值,云端打包默认的targetSdkVersion值为26

  • 5+App项目:最小值为19,最大值29
  • uni-app项目:最小值为26,最大值29

HBuilderX2.8.3及以下版本targetSdkVersion最大值支持28
HBuilderX2.8.4+版本targetSdkVersion最大值支持29

Android版本列表

API等级与Android版本对应列表如下:

| API等级 | Android版本号 |
| --:-- | --:-- |
| 14 | Android4.0 |
| 15 | Android4.0.3 |
| 16 | Android4.1.2 |
| 17 | Android4.2.2 |
| 18 | Android4.3.1 |
| 19 | Android4.4.2 |
| 20 | Android4.4W.2 |
| 21 | Android5.0.1 |
| 22 | Android5.1 |
| 24 | Android7.0 |
| 25 | Android7.1.1 |
| 26 | Android8.0 |
| 27 | Android8.1 |
| 28 | Android9.0 |
| 29 | Android10.0(Android Q) |
| 30 | Android11.0 |

配置完成保存提交App云端打包后才能生效

12 关注 分享
枫桥居APP 蔡繁荣 Trust 雪之梦技术驿站 乌龙球 7***@qq.com 3***@qq.com 老泼尼 2***@qq.com 小七哥 1***@qq.com 远一航一

要回复文章请先登录注册

h***@qq.com

h***@qq.com

回复 5***@qq.com :
我也是,想支持4.2.2,提示有问题的是uses-sdk:minSdkVersion 17 cannot be smaller than version 19 declared in library [gallery-dmcBig-release.aar]
2020-04-08 10:57
蓓岑2015

蓓岑2015

我把targetSdkVersion设置为28,mui.ajax报超时,请问该怎么解决?
2020-03-25 11:01
w***@shopsuite.cn

w***@shopsuite.cn

回复 DCloud_App_Array :
解决了,直播推流权限取消,app常用其他设置里面编译模式全部不要勾选,Android设置:minSdkVersion:14 targetSdkVersion:28 支持CPU类型全选
2020-02-27 16:51
DCloud_App_Array

DCloud_App_Array (作者)

回复 w***@shopsuite.cn :
上传前的apk是否可以安装到手机,请把apk发出来。
2020-01-18 14:57
w***@shopsuite.cn

w***@shopsuite.cn

上传谷歌市场,安卓手机全部无法安装,提示不兼容。https://play.google.com/store/apps/details?id=com.suteshop.ouqi.app
2020-01-17 18:29
DCloud_App_Array

DCloud_App_Array (作者)

回复 9***@qq.com :
出现什么警告窗口?
2020-01-04 15:06
9***@qq.com

9***@qq.com

回复 y***@163.com :
Android10还是有问题呀,调成29了还出现警告窗口
2020-01-04 11:29
y***@163.com

y***@163.com

请问10支持了吗
2019-12-26 17:48
崔大人

崔大人

回复 狗尾巴花儿 :
请问解决了吗?我也遇到一样的问题
2019-12-25 11:55
前端小生

前端小生

回复 5***@qq.com :
解决了吗?我也遇见这个问题了
2019-12-17 14:51