Android API级别

什么是API级别？

API 级别是一个对 Android 平台版本提供的框架 API 修订版进行唯一标识的整数值。

Android 平台提供了一种框架 API，应用可利用它与底层 Android 系统进行交互。 该框架 API 由以下部分组成：

• 一组核心软件包和类
• 一组用于声明清单文件的 XML 元素和属性
• 一组用于声明和访问资源的 XML 元素和属性
• 一组 Intent
• 一组应用可请求的权限，以及系统中包括的权限强制执行。

每个后续版本的 Android 平台均可包括对其提供的 Android 应用框架 API 的更新。

框架 API 更新的设计用途是使新 API 与早期版本的 API 保持兼容。 也就是说，大多数 API 更改都是新增更改，会引入新功能或替代功能。 在 API 的某些部分得到升级时，旧版的被替换部分将被弃用，但不会被移除，这样现有应用仍可使用它们。 在极少数情况下，可能会修改或移除 API 的某些部分，但通常只有在为了确保 API 稳健性以及应用或系统安全性时，才需要进行此类更改。 所有其他来自早期修订版的 API 部分都将结转，不做任何修改。

相关属性

一、android:minSdkVersion

一个用于指定应用运行所需最低 API 级别的整数。 如果系统的 API 级别低于该属性中指定的值，Android 系统将阻止用户安装应用。 您应该始终声明该属性。注意：如果您不声明该属性，系统将假定默认值为“1”，这表示您的应用兼容所有 Android 版本。 如果您的应用并不兼容所有版本（例如，它使用 API 级别 3 中引入的 API），并且您尚未声明正确的 minSdkVersion，则当应用安装在 API 级别小于 3 的系统上时，应用将在运行时尝试访问不可用的 API 时发生崩溃。 因此，请务必在 minSdkVersion 属性中声明合适的 API 级别。

如果您构建的应用使用的 API 或系统功能是在最新平台版本中引入的，则应将 android:minSdkVersion 属性的值设置为最新平台版本的 API 级别。 这样做可确保用户只能将您的应用安装在运行兼容版本 Android 平台的设备上， 并进而确保您的应用可以在用户设备上正常工作。

如果您的应用使用在最新平台版本中引入的 API，但未声明 android:minSdkVersion 属性，则应用可以在运行最新版本平台的设备上正常工作，但无法在运行早期版本平台的设备上正常工作。 在后一种情况下，应用将在运行时试图使用早期版本上不存在的 API 时发生崩溃。

二、android:targetSdkVersion

一个用于指定应用的目标 API 级别的整数。如果未设置，其默认值与为 minSdkVersion 指定的值相等。
该属性用于通知系统，您已针对目标版本进行测试，并且系统不应启用任何兼容性行为来保持您的应用与目标版本的向前兼容性。 应用仍可在较低版本上运行（最低版本为 minSdkVersion）。

在 Android 随着每个新版本的推出而进化的过程中，一些行为甚至是外观可能会发生变化。不过，如果平台的 API 级别高于您的应用的 targetSdkVersion 所声明的版本，系统就可以通过启用兼容性行为来确保您的应用继续以您所期望的方式工作。 您可以通过将 targetSdkVersion 指定为与应用所运行平台的 API 级别一致来停用此类兼容性行为。 例如，如果将该值设置为“11”或更高，系统便可在您的应用运行在 Android 3.0 或更高版本的平台上时对其应用新的默认主题 (Holo)，还可在您的应用运行在更大屏幕上时停用屏幕兼容性模式（因为对 API 级别 11 的支持隐含了对更大屏幕的支持）。

系统可根据您为该属性设置的值启用许多兼容性行为。 Build.VERSION_CODES 参考资料中的相应平台版本对其中的几种行为做了说明。

要让您的应用与各 Android 版本保持同步，您应该增加该属性的值，使其与最新 API 级别一致，然后在相应平台版本上对您的应用进行全面测试。

引入的版本：API 级别 4

三、android:maxSdkVersion

一个指定作为应用设计运行目标的最高 API 级别的整数。
在 Android 1.5、1.6、2.0 及 2.0.1 中，系统会在安装应用以及系统更新后重新验证应用时检查该属性的值。 在任一情况下，如果应用的 maxSdkVersion 属性低于系统本身使用的 API 级别，系统均不允许安装应用。 在系统更新后重新验证这种情况下，这实际上相当于将您的应用从设备中移除。

为说明该属性在系统更新后对您的应用的影响，请看看下面这个示例：

Google Play 上发布了一个在其清单中声明了 maxSdkVersion="5" 的应用。 一位设备运行 Android 1.6（API 级别 4）的用户下载并安装了该应用。 几周后，该用户收到了 Android 2.0（API 级别 5）OTA 系统更新。 更新安装后，系统检查该应用的 maxSdkVersion 并顺利完成了对其的重新验证。 应用仍可照常工作。 不过，一段时间后，设备又收到了一个系统更新，这次是更新到 Android 2.0.1（API 级别 6）。 更新完成后，系统无法再重新验证应用，因为此时系统本身的 API 级别 (6) 已超过该应用支持的最高级别 (5)。 系统会使该应用对用户不可见，这实际上相当于将它从设备上删除。

警告：不建议声明该属性。 首先，没有必要设置该属性，将其作为阻止您的应用部署到 Android 平台新发布版本上的一种手段。 从设计上讲，新版本平台完全向后兼容。 只要您的应用只使用标准 API 并遵循部署最佳实践，应该能够在新版本平台上正常工作。 其次，请注意在某些情况下，声明该属性可能导致您的应用在系统更新至更高 API 级别后被从用户设备中移除。 大多数可能安装您的应用的设备都会定期收到 OTA 系统更新，因此您应该在设置该属性前考虑这些更新对您的应用的影响。

引入的版本：API 级别 4

未来的 Android 版本（Android 2.0.1 之后的版本）在安装或重新验证时将不再检查或强制执行 maxSdkVersion 属性。 不过，Google Play 在向用户呈现可供下载的应用时将继续使用该属性作为过滤器。

三、android:compileSdkVersion

compileSdkVersion 告诉 Gradle 用哪个 Android SDK 版本编译你的应用。使用任何新添加的 API 就需要使用对应版本的 Android SDK。
修改 compileSdkVersion 不会改变运行时的行为。当你修改了 compileSdkVersion 的时候，可能会出现新的编译警告、编译错误，但新的 compileSdkVersion 不会被包含到 APK 中：它纯粹只是在编译的时候使用。
注意，如果使用 Support Library，那么使用最新发布的 Support Library 就需要使用最新的 SDK 编译。例如，要使用 23.1.1 版本的 Support Library，compileSdkVersion 就必需至少是 23。

开发注意事项

应用向前兼容性

Android 应用一般向前兼容新版本的 Android 平台。

因为几乎所有对框架 API 的更改都是新增更改，所以使用 API 任何给定版本（其 API 级别所指定版本）开发的 Android 应用均向前兼容更新版本的 Android 平台以及更高 API 级别。 应用应该能够在所有后期版本的 Android 平台上运行，除非在个别情况下应用使用的某个 API 部分后来由于某种原因被移除。

向前兼容性很重要，因为许多 Android 设备都接收 OTA 系统更新。 用户可以安装您的应用并顺利使用，然后通过接收 OTA 更新升级到新版本的 Android 平台。 安装更新后，您的应用将运行在新运行时版本的环境中，但这个版本具有您的应用所依赖的 API 和系统功能。

在某些情况下，在该 API 之下所做的更改（例如对底层系统本身的更改）可能会影响运行在新环境中的应用。 因此，作为应用开发者，您必须了解应用在各系统环境中的外观和行为。 为帮助您在各种版本的 Android 平台上测试您的应用，Android SDK 提供了多个可供您下载的平台。每个平台都包括一个兼容的系统映像，您可以在 AVD 中运行该映像来测试您的应用。

应用向后兼容性

Android 应用不一定向后兼容比其编译时所针对的目标版本更久远的 Android 平台版本。

每个新版本的 Android 平台都可能包括新的框架 API，例如那些能够让应用使用新的平台功能或者替换现有 API 部分的 API。 应用可以在运行于新平台时使用这些新 API，如上所述，也可以在运行于更新版本的平台（API 级别所指定的平台）上时使用这些新 API。 反之，由于早期版本的平台不包括新 API，因此使用新 API 的应用无法运行在这些平台上。

尽管 Android 设备降级至之前版本平台的情况不太可能发生，但必须意识到，在现实情况下可能有许多设备运行的是早期版本的平台。 即便是在能够获得 OTA 更新的设备中，也可能发生一些设备获得的更新滞后，可能在相当长时间内无法获得更新的情况。

选择平台版本和 API 级别

当您开发应用时，需要选择您所编译的应用所针对的目标平台版本。 一般而言，您编译的应用所针对的目标版本应该是您的应用所能支持的最低平台版本。

您可以通过在编译应用时依次降低其所针对的目标编译版本来确定可能的最低平台版本。 确定最低版本后，您应该使用相应平台版本（和 API 级别）创建一个 AVD，然后对您的应用进行全面测试。 请务必在应用的清单中声明 android:minSdkVersion 属性，并将其值设置为平台版本的 API 级别。