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

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

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及以上设备。

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版本对应列表如下：

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