Android SdkVersion那些事儿

Android SdkVersion那些事儿

本文对android项目中的compileSdkVersion、targetSdkVersion、minSdkVersion、maxSdkVersion和buildTarget等概念做一个说明。

compileSdkVersion

定义

编译或构件时采用的API版本,你在项目中查看的android系统相关的源码与这个compileSdkVersion指定的是一致的。

说明

  1. 在eclipse中位于项目根目录中的project.properties文件中(target=xx);
  2. 在android studio中位于项目中的build.gradle中;
  3. 强烈推荐总是使用最新的 SDK 进行编译(默认就是最新的);
  4. 修改 compileSdkVersion 不会改变运行时的行,但可能会出现新的编译警告、编译错误;
  5. compileSdkVersion 不会被包含到 APK 中:它纯粹只是在编译的时候使用;
  6. 如果使用 Support Library ,那么使用最新发布的 Support Library 就需要使用最新的 SDK 编译(对应关系)。

targetSdkVersion

定义

表明当系统api小于或等于targetSdkVersion值时,系统运行程序不用做兼容处理;(相当于告诉系统,我开发时是针对targetSdkVersion指定版本已经做过兼容的)

说明

  1. 如果不设置,默认值和minSdkVersion相同;
  2. 应用程序仍然能在低于targetSdkVersion的系统上运行;
  3. 系统API高于targetSdkVersion,系统会开启向前兼容模式;反之,系统将不采用兼容模式,认为***开发者已做兼容处理***,而直接正常运行这个程序;
  4. targetSdkVersion这个值是在运行时起作用的,该值告诉系统到底要不要采用向前兼容模式来运行程序;

建议开发时将targetSdkVersion设置为最新的值,这样就可以应用新功能,并对新功能做兼容性测试

minSdkVersion

定义

运行应用程序所需要的最低Sdk 版本

说明

  1. 不指定,默认值为1,表明兼容所有android版本;
  2. 系统API高于minSdkVersion时,系统会组织应用的安装;
  3. 如果使用了低于minSdkVersion 的api(方法属性等),编译时会报错;
  4. minSdkVersion要取所有依赖项目中minSdkVersion的最大值,这样才能保证项目运行后不会报错;

maxSdkVersion

运行应用程序支持的最高版本(超过该版本运行不了)

说明

显然这个属性不符合事物发展的规律,现已不推荐使用,或者说已经失效了

高版本方法在低版本系统上的兼容性处理

  1. 采用注解的方式

    • 添加@TargetApi($API_LEVEL)可使编译通过
    • 添加@SuppressLint(“NewApi”)屏蔽一切新API才可使编译通过(一个方法中引用了多种不同API的新方法)

    举个例子,某个方法中使用了api9新加入的方法,而项目设置的android:minSdkVersion=8,此时在方法上加@SuppressLint(“NewApi”)和@TargetApi(Build.VERSION_CODES.GINGERBREAD)都可以,以上是通用的情况。而当你在此方法中又引用了一个api11才加入的方法时,@TargetApi(Build.VERSION_CODES.GINGERBREAD)注解的方法又报错了,而@SuppressLint(“NewApi”)不会报错。

  2. 运行时判断

    在低版本上不调用该方法,而自己提供低版本上的功能实现

下表列出了各 Android 平台版本支持的 API 级别:

平台版本 API 级别 VERSION_CODE 备注
Android 7.0 24 N 平台亮点
Android 6.0 23 M 平台亮点
Android 5.1 22 LOLLIPOP_MR1 平台亮点
Android 5.0 21 LOLLIPOP
Android 4.4W 20 KITKAT_WATCH 仅限 KitKat for Wearables
Android 4.4 19 KITKAT 平台亮点
Android 4.3 18 JELLY_BEAN_MR2 平台亮点
Android 4.2、4.2.2 17 JELLY_BEAN_MR1 平台亮点
Android 4.1、4.1.1 16 JELLY_BEAN 平台亮点
Android 4.0.3、4.0.4 15 ICE_CREAM_SANDWICH_MR1 平台亮点
Android 4.0、4.0.1、4.0.2 14 ICE_CREAM_SANDWICH
Android 3.2 13 HONEYCOMB_MR2
Android 3.1.x 12 HONEYCOMB_MR1 平台亮点
Android 3.0.x 11 HONEYCOMB 平台亮点
Android 2.3.4Android 2.3.3 10 GINGERBREAD_MR1 平台亮点
Android 2.3.2Android 2.3.1Android 2.3 9 GINGERBREAD
Android 2.2.x 8 FROYO 平台亮点
Android 2.1.x 7 ECLAIR_MR1 平台亮点
Android 2.0.1 6 ECLAIR_0_1
Android 2.0 5 ECLAIR
Android 1.6 4 DONUT 平台亮点
Android 1.5 3 CUPCAKE 平台亮点
Android 1.1 2 BASE_1_1
Android 1.0 1 BASE

你可能感兴趣的:(Android学习开发)