Android入门之API版本问题详解

Android API Levels

在本文中

API的级别是什么?

在Android中使用API级别

开发者需要考虑的内容

应用程序的向前兼容性

应用程序的向后兼容性

平台版本和API级别的选择

声明最低API级别

针对高版本的API级别测试

使用临时的API级别

通过API级别进行文档内容过滤

参见

<uses-sdk> manifest element

当你开发你的Android应用程序时，了解该平台API变更管理的基本方法和概念是很有帮助的。同样的，知道API级别标识以及该标识如何保障你的应用与实际硬件设备相兼容对于开发及后续的发布、维护都是有益的。

本节内容告诉你API级别的知识，以及它如何影响你开发和使用的应用。

关于如何使用“以API级别进行过滤”来使用API参考手册，从本文末尾的文档过滤(Filtering the documentation)中可以得到更多信息。

API级别是什么？(What is API Level?)

API级别是一个整数值，它唯一标识了一个具体版本的Android平台，及其框架的API的版本。

Android平台提供了一套框架API，使得应用程序可以与系统底层进行交互。该框架API由以下模块组成：

• 一组核心的包和类
• 清单(manifest)文件的XML元素和属性声明
• 资源文件的XML元素和属性声明及访问形式
• 各类意图(Intents)
• 应用程序可以请求的各类授权，以及系统中包含的授权执行

每个Android平台的后续版本会包括它提供的更新的Andr​​oid应用程序框架的API。

该框架的API的更新设计，使高版本的API与早期版本兼容。也就是说，在新版本API中大多数都是新增功能，和引进新的或替代的功能。作为API的部分升级，老的替换的部分已过时，但不会从新版本中删除，使得已有的应用程序仍然可以使用它们。在极少数情况下，旧版本API的部分可能被修改或删除，通常这种变化是为了保障API的稳定性及应用程序或系统的安全。所有其他早期版​​本的API将不做修改的保留。

一个Android平台提供的框架API，被指定一个整数标识符，称为“API级别”。每一个版本的Android平台只支持有一个API级别，虽然该支持是隐含地包括了所有早期的API级别（一直到API级别1级）。 Andr​​oid平台的最初版本提供的框架API级别是1级，随后的版本依次递增。

下表说明了具体平台版本和支持的API级别的对应关系。

The following table specifies the API Level supported by each version of the Android platform.

安卓平台版本	API级别	VERSION_CODE	Notes