如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion
2017-07-18 08:32
323 查看
转载:http://chinagdg.org/2016/01/picking-your-compilesdkversion-minsdkversion-targetsdkversion/
http://www.jianshu.com/p/544d9f72883d
https://developer.android.com/guide/topics/manifest/uses-sdk-element.html?utm_campaign=adp_series_sdkversion_010616&utm_source=medium&utm_medium=blog#ApiLevels
当你发布一个应用之后,(取决于具体的发布时间)可能没过几个月 Android 系统就发布了一个新版本。这对你的应用意味着什么,所有东西都不能用了?
别担心,向前兼容是 Android 非常关注的事情。用户在升级到新版 Android 的时候,用以前版本的 SDK 构建的现有应用应该不会出问题。这就是 compileSdkVersion, minSdkVersion 和 targetSdkVersion 的作用:他们分别控制可以使用哪些 API ,要求的 API 级别是什么,以及应用的兼容模式。
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 和新特性提供兼容性支持。
如果 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 是 Android 提供向前兼容的主要依据,在应用的 targetSdkVersion 没有更新之前系统不会应用最新的行为变化。这允许你在适应新的行为变化之前就可以使用新的
API【Zoran:感觉相当于提前使用新的API,你的应用是在targetSDK版本进行过测试的】 (因为你已经更新了 compileSdkVersion 不是吗?)。
targetSdkVersion 所暗示的许多行为变化都记录在 VERSION_CODES 文档中了,但是所有恐怖的细节也都列在每次发布的平台亮点中了,在这个 API
Level 表中可以方便地找到相应的链接。
例如,Android
6.0 变化文档中谈了 target 为 API 23 时会如何把你的应用转换到运行时权限模型上,Android
4.4 行为变化阐述了 target 为 API 19 及以上时使用 set() 和 setRepeating() 设置
alarm 会有怎样的行为变化。
由于某些行为的变化对用户是非常明显的(弃用的
menu 按钮,运行时权限等),所以将 target 更新为最新的 SDK 是所有应用都应该优先处理的事情。但这不意味着你一定要使用所有新引入的功能,也不意味着你可以不做任何测试就盲目地更新 targetSdkVersion ,请一定在更新 targetSdkVersion 之前做测试!你的用户会感谢你的。
所以设置正确的 compileSdkVersion, minSdkVersion 和 targetSdkVersion 很重要。如你所想, Gradle 和 Android
Studio 都在构建系统中集成了它们。在你的模块的 build.gradle 文件中(也可以在 Android Studio 的项目结构选项中)设置:
编译时用到的 compileSdkVersion 是和构建工具版本一起设置的 Android 设置之一。其他两个稍有不同,他们在构建变体(build variant)的那里声明。defaultConfig 是所有构建变体的基础,也是设置这些默认值的地方。你可以想象在一个更复杂的系统中,应用的某些版本可能会有不同的 minSdkVersion 。minSdkVersion 和 targetSdkVersion 与 compileSdkVersion 的另一个不同之处是它们会被包含进最终的 APK 文件中,如果你查看生成的 AndroidManifest.xml 文件,你会看到类似下面这样的标签:
如果你在 manifest 文件中手工设置,你会发现 Gradle 在构建时会忽略它们(尽管其它构建系统可能会明确依赖它们)。
如果你按照上面示例那样配置,你会发现这三个值的关系是:
这种直觉是合理的,如果 compileSdkVersion 是你的最大值,minSdkVersion 是最小值,那么最大值必需至少和最小值一样大且 target 必需在二者之间。理想上,在稳定状态下三者的关系应该更像这样:
用较低的 minSdkVersion 来覆盖最大的人群,用最新的 SDK 设置 target 和 compile 来获得最好的外观和行为。#BuildBetterApps
关于本文的内容您可以参与我们 Google+
帖子上的讨论,关注我们的 Android
Development Patterns 信息流获得更多信息。
译者注: Android Development Patterns 系列视频见 YouTube 或 优酷 。
Applications can use a manifest element provided by the framework API —
The element offers three key attributes:
Level, rather than being restricted to using only those defined for the minimum API Level.
before using this attribute.
Because almost all changes to the framework API are additive, an Android application developed using any given version of the API (as specified by its API Level) is forward-compatible with later versions of the Android platform and higher API levels. The application
should be able to run on all later versions of the Android platform, except in isolated cases where the application uses a part of the API that is later removed for some reason.
Forward compatibility is important because many Android-powered devices receive over-the-air (OTA) system updates. The user may install your application and use it successfully, then later receive an OTA update to a new version of the Android platform. Once
the update is installed, your application will run in a new run-time version of the environment, but one that has the API and system capabilities that your application depends on.
In some cases, changes below the API, such those in the underlying system itself, may affect your application when it is run in the new environment. For that reason it's important for you, as the application developer, to understand how the application
will look and behave in each system environment. To help you test your application on various versions of the Android platform, the Android SDK includes multiple platforms that you can download. Each platform includes a compatible system image that you can
run in an AVD, to test your application.
[Zoran] targetsdkVersion 介绍以及作用
Level, rather than being restricted to using only those defined for the minimum API Level.
(1)Specifies the API Level on which the application is designed to run
(2)this allows the application to use manifest elements or behaviors defined in the target API Level, rather than being
restricted to using only those defined for the minimum API Level.
http://www.jianshu.com/p/544d9f72883d
https://developer.android.com/guide/topics/manifest/uses-sdk-element.html?utm_campaign=adp_series_sdkversion_010616&utm_source=medium&utm_medium=blog#ApiLevels
当你发布一个应用之后,(取决于具体的发布时间)可能没过几个月 Android 系统就发布了一个新版本。这对你的应用意味着什么,所有东西都不能用了?
别担心,向前兼容是 Android 非常关注的事情。用户在升级到新版 Android 的时候,用以前版本的 SDK 构建的现有应用应该不会出问题。这就是 compileSdkVersion, minSdkVersion 和 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 没有更新之前系统不会应用最新的行为变化。这允许你在适应新的行为变化之前就可以使用新的API【Zoran:感觉相当于提前使用新的API,你的应用是在targetSDK版本进行过测试的】 (因为你已经更新了 compileSdkVersion 不是吗?)。
targetSdkVersion 所暗示的许多行为变化都记录在 VERSION_CODES 文档中了,但是所有恐怖的细节也都列在每次发布的平台亮点中了,在这个 API
Level 表中可以方便地找到相应的链接。
例如,Android
6.0 变化文档中谈了 target 为 API 23 时会如何把你的应用转换到运行时权限模型上,Android
4.4 行为变化阐述了 target 为 API 19 及以上时使用 set() 和 setRepeating() 设置
alarm 会有怎样的行为变化。
由于某些行为的变化对用户是非常明显的(弃用的
menu 按钮,运行时权限等),所以将 target 更新为最新的 SDK 是所有应用都应该优先处理的事情。但这不意味着你一定要使用所有新引入的功能,也不意味着你可以不做任何测试就盲目地更新 targetSdkVersion ,请一定在更新 targetSdkVersion 之前做测试!你的用户会感谢你的。
Gradle 和 SDK 版本
所以设置正确的 compileSdkVersion, minSdkVersion 和 targetSdkVersion 很重要。如你所想, Gradle 和 AndroidStudio 都在构建系统中集成了它们。在你的模块的 build.gradle 文件中(也可以在 Android Studio 的项目结构选项中)设置:
123456789101112 | android { compileSdkVersion 23 buildToolsVersion "23.0.1" defaultConfig { applicationId "com.example.checkyourtargetsdk" minSdkVersion 7 targetSdkVersion 23 versionCode 1 versionName "1.0" }} |
1 | <uses-sdkandroid:targetSdkVersion="23"android:minSdkVersion="7" /> |
综合来看
如果你按照上面示例那样配置,你会发现这三个值的关系是:1 | minSdkVersion <= targetSdkVersion <= compileSdkVersion |
1 2 | minSdkVersion(lowestpossible)<= targetSdkVersion==compileSdkVersion(latestSDK) |
关于本文的内容您可以参与我们 Google+
帖子上的讨论,关注我们的 Android
Development Patterns 信息流获得更多信息。
译者注: Android Development Patterns 系列视频见 YouTube 或 优酷 。
Applications can use a manifest element provided by the framework API —
<uses-sdk>— to describe the minimum and maximum API Levels under which they are able to run, as well as the preferred API Level that they are designed to support.
The element offers three key attributes:
android:minSdkVersion— Specifies the minimum API Level on which the application is able to run. The default value is "1".
android:targetSdkVersion— Specifies the API Level on which the application is designed to run. In some cases, this allows the application to use manifest elements or behaviors defined in the target API
Level, rather than being restricted to using only those defined for the minimum API Level.
android:maxSdkVersion— Specifies the maximum API Level on which the application is able to run. Important: Please read the
<uses-sdk>documentation
before using this attribute.
Development Considerations
The sections below provide information related to API level that you should consider when developing your application.Application forward compatibility
Android applications are generally forward-compatible with new versions of the Android platform.Because almost all changes to the framework API are additive, an Android application developed using any given version of the API (as specified by its API Level) is forward-compatible with later versions of the Android platform and higher API levels. The application
should be able to run on all later versions of the Android platform, except in isolated cases where the application uses a part of the API that is later removed for some reason.
Forward compatibility is important because many Android-powered devices receive over-the-air (OTA) system updates. The user may install your application and use it successfully, then later receive an OTA update to a new version of the Android platform. Once
the update is installed, your application will run in a new run-time version of the environment, but one that has the API and system capabilities that your application depends on.
In some cases, changes below the API, such those in the underlying system itself, may affect your application when it is run in the new environment. For that reason it's important for you, as the application developer, to understand how the application
will look and behave in each system environment. To help you test your application on various versions of the Android platform, the Android SDK includes multiple platforms that you can download. Each platform includes a compatible system image that you can
run in an AVD, to test your application.
[Zoran] targetsdkVersion 介绍以及作用
android:targetSdkVersion— Specifies the API Level on which the application is designed to run. In some cases, this allows the application to use manifest elements or behaviors defined in the target API
Level, rather than being restricted to using only those defined for the minimum API Level.
(1)Specifies the API Level on which the application is designed to run
(2)this allows the application to use manifest elements or behaviors defined in the target API Level, rather than being
restricted to using only those defined for the minimum API Level.
相关文章推荐
- 如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion
- 如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion
- Android Studio 使用教程(二十)之如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion
- Android学习笔记 ----如何选择compileSdkVersion, minSdkVersion 和 targetSdkVersion区别
- 如何选择compileSdkVersion, minSdkVersion 和 targetSdkVersion
- 如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion
- Android targetSdkVersion 原理 如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion
- 如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion
- 如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion
- 如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion
- compileSdkVersion,minSdkVersion,targetSdkVersion作用和如何选择关系
- 如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion
- android开发如何选择compileSdkVersion, minSdkVersion 和 targetSdkVersion
- 如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion
- 如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion
- (转)如何选择 compileSdkVersion, minSdkVersion,targetSdk
- 如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion
- 如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion
- 如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion
- 如何选择 compileSdkVersion, minSdkVersion 和 targetSdkVersion