如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion

  对这几个概念模模糊糊,看到一篇文章就记录下来。

当你发布一个应用之后,(取决于具体的发布时间)可能没过几个月 Android 系统就发布了一个新版本。这对你的应用意味着什么,所有东西都不能用了?别担心,向前兼容是 Android 非常关注的事情。用户在升级到新版 Android 的时候,用以前版本的 SDK 构建的现有应用应该不会出问题。这就是 compileSdkVersionminSdkVersion 和 targetSdkVersion 的作用:他们分别控制可以使用哪些 API ,要求的 API 级别是什么,以及应用的兼容模式。

  

compileSdkVersion

  compileSdkVersion告诉Gradle用哪一个Android SDK版本编译你的应用。使用任何新添加的API就需要使用对应Level的Android SDK。需要强调的是修改 compileSdkVersion 不会改变运行时的行为,当你修改了compileSdkVersion的时候,可能出现新的编译警告、编译错误,但是新的compileSdkVersion不会被包含到APK中,它只是纯粹在编译的时候使用,因此我们强烈推荐总是使用最新的SDK进行编译,在现有代码上使用新的编译检查可以获得很多好处。避免弃用的API,并且为新的API做好准备。

  注意如果使用Support Library,那么使用最新的Support Library就需要使用最新的SDK编译,例如,要使用23.1.1版本的Support Library , compileSdkVersion就必须至少23(大版本号要一致)。通常,新版的Support Library随着新的系统版本而发布。他为系统新的增加API和新特性提供兼容性支持。

minSdkVersion

  如果compileSdkVersion设置可用最新的API,那么minSdkVersion则是应用可用运行的最低要求。minSdkVersion是Google Play商店用来判断用户设备是否可以安装某个应用的标志之一。

在开发时,minSdkVersion也起到一个重要角色:lint默认会在项目中运行,它在你使用了高于minSdkVersion的API时会警告你,帮你避免调用不存在API的运行时问题,如果只在较高版本的系统上才使用某些API,通常使用运行时检查系统版本的方式解决。

请记住,你所使用的库,如 Support Library 或 Google Play services,可能有他们自己的 minSdkVersion 。你的应用设置的 minSdkVersion 必需大于等于这些库的 minSdkVersion 。例如有三个库,它们的 minSdkVersion 分别是 4, 7 和 9 ,那么你的 minSdkVersion  必需至少是 9 才能使用它们。在少数情况下,你仍然想用一个比你应用的 minSdkVersion 还高的库(处理所有的边缘情况,确保它只在较新的平台上使用),你可以使用 tools:overrideLibrary 标记,但请做彻底的测试!

当你决定使用什么 minSdkVersion 时候,你应该参考当前的 Android 分布统计,它显示了最近 7 天所有访问 Google Play 的设备信息。他们就是你把应用发布到 Google Play 时的潜在用户。最终这是一个商业决策问题,取决于为了支持额外 3% 的设备,确保最佳体验而付出的开发和测试成本是否值得。当然,如果某个新的 API 是你整个应用的关键,那么确定 minSdkVersion 的值就比较容易了。不过要记得 14 亿设备中的 0.7% 也是个不小的数字。

targetSdkVersion

  三个版本中最有趣的就是targetSdkVersion了,targetSdkVersion是Android提供向前兼容的主要依据,在应用的targetSdkVersion没有更新之前系统不会应用最新的行为变化。(这句话的意思是系统会根据targetSdkVersion的版本来决定是否引入新的api依据特性)这允许你在适应新的行为变化之前就可以使用新的API(因为你已经更新compileSdkVersion不是吗)。targetSdkVersion 所暗示的许多行为变化都记录在 VERSION_CODES 文档中了,但是所有恐怖的细节也都列在每次发布的平台亮点中了,在这个 API Level 表中可以方便地找到相应的链接。由于某些行为的变化对用户是非常明显的(弃用的 menu 按钮,运行时权限等),所以将 target 更新为最新的 SDK 是所有应用都应该优先处理的事情。但这不意味着你一定要使用所有新引入的功能,也不意味着你可以不做任何测试就盲目地更新 targetSdkVersion ,请一定在更新 targetSdkVersion 之前做测试!你的用户会感谢你的。

Gradle 和 SDK 版本

  所以设置正确的 compileSdkVersion, minSdkVersion 和 targetSdkVersion 很重要。如你所想, Gradle 和 Android Studio 都在构建系统中集成了它们。在你的模块的 build.gradle 文件中(也可以在 Android Studio 的项目结构选项中)设置:

android {
  compileSdkVersion 23
  buildToolsVersion "23.0.1"

  defaultConfig {
    applicationId "com.example.checkyourtargetsdk"
    minSdkVersion 7
    targetSdkVersion 23
    versionCode 1
    versionName “1.0”
  }
}

编译时用到的 compileSdkVersion 是和构建工具版本一起设置的 Android 设置之一。其他两个稍有不同,他们在构建变体(build variant)的那里声明。defaultConfig 是所有构建变体的基础,也是设置这些默认值的地方。你可以想象在一个更复杂的系统中,应用的某些版本可能会有不同的 minSdkVersion 。minSdkVersion 和 targetSdkVersion 与 compileSdkVersion 的另一个不同之处是它们会被包含进最终的 APK 文件中,如果你查看生成的 AndroidManifest.xml 文件,你会看到类似下面这样的标签:

<uses-sdk android:targetSdkVersion="23" android:minSdkVersion="7" />

如果你在 manifest 文件中手工设置,你会发现 Gradle 在构建时会忽略它们(尽管其它构建系统可能会明确依赖它们)。

综合来看

如果你按照上面示例那样配置,你会发现这三个值的关系是:

minSdkVersion <= targetSdkVersion <= compileSdkVersion

这种直觉是合理的,如果 compileSdkVersion 是你的最大值,minSdkVersion 是最小值,那么最大值必需至少和最小值一样大且 target 必需在二者之间。理想上,在稳定状态下三者的关系应该更像这样:

  minSdkVersion(lowest)<= targetSdkVersion == compileSdkVersion(latest)

用较低的 minSdkVersion 来覆盖最大的人群,用最新的 SDK 设置 target 和 compile 来获得最好的外观和行为。

引用文章地址:

http://chinagdg.org/2016/01/picking-your-compilesdkversion-minsdkversion-targetsdkversion/

posted @ 2016-11-16 16:23  麦哈顿博士  阅读(322)  评论(0编辑  收藏  举报