Android API级别外文翻译资料

Android API Levels

As you develop your application on Android, its useful to understand the platforms general approach to API change management. Its also important to understand the API Level identifier and the role it plays in ensuring your applications compatibility with devices on which it may be installed.

The sections below provide information about API Level and how it affects your applications.

For information about how to use the 'Filter by API Level' control available in the API reference documentation, see Filtering the documentation at the end of this document.

What is API Level?

API Level is an integer value that uniquely identifies the framework API revision offered by a version of the Android platform.

The Android platform provides a framework API that applications can use to interact with the underlying Android system. The framework API consists of:

• A core set of packages and classes
• A set of XML elements and attributes for declaring a manifest file
• A set of XML elements and attributes for declaring and accessing resources
• A set of Intents
• A set of permissions that applications can request, as well as permission enforcements included in the system

Each successive version of the Android platform can include updates to the Android application framework API that it delivers.

Updates to the framework API are designed so that the new API remains compatible with earlier versions of the API. That is, most changes in the API are additive and introduce new or replacement functionality. As parts of the API are upgraded, the older replaced parts are deprecated but are not removed, so that existing applications can still use them. In a very small number of cases, parts of the API may be modified or removed, although typically such changes are only needed to ensure API robustness and application or system security. All other API parts from earlier revisions are carried forward without modification.

The framework API that an Android platform delivers is specified using an integer identifier called 'API Level'. Each Android platform version supports exactly one API Level, although support is implicit for all earlier API Levels (down to API Level 1). The initial release of the Android platform provided API Level 1 and subsequent releases have incremented the API Level.

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

Uses of API Level in Android

The API Level identifier serves a key role in ensuring the best possible experience for users and application developers:

• It lets the Android platform describe the maximum framework API revision that it supports
• It lets applications describe the framework API revision that they require
• It lets the system negotiate the installation of applications on the users device, such that version-incompatible applications are not installed.

Each Android platform version stores its API Level identifier internally, in the Android system itself.

Applications can use a manifest element provided by the framework API — lt;uses-sdkgt; — 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 lt;uses-sdkgt; documentation before using this attribute.

For example, to specify the minimum system API Level that an application requires in order to run, the application would include in its manifest a lt;uses-sdkgt; element with a android:minSdkVersion attribute. The value of android:minSdkVersion would be the integer corresponding to the API Level of the earliest version of the Android platform under which the application can run.

When the user attempts to install an application, or when revalidating an appplication after a system update, the Android system first checks the lt;uses-sdkgt; attributes in the applications manifest and compares the values against its own internal API Level. The system allows the installation to begin only if these conditions are met:

• If a android:minSdkVersion attribute is declared, its value must be less than or equal to the systems API Level integer. If not declared, the system assumes that the application requires API Level 1.
• If a android:maxSdkVersion attribute i

  剩余内容已隐藏，支付完成后下载完整资料

  ---

  Android API级别

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

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

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

  1.API级别是什么？

  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级别的对应关系。

  平台版本	API级别
  Android 3.0	11
  Android 2.3.3	10
  Android 2.3	9
  Android 2.2	8
  Android 2.1	7
  Android 2.0.1	6
  Android 2.0	5
  Android 1.6	4
  Android 1.5	3
  Android 1.1	2
  Android 1.0	1

  2.在Android中使用API级别

  API级别标识为保证用户和应用程序开发者的最佳体验，起了关键作用：

  • 它让Android平台可以描述它支持的框架API的最高版本
  • 它让应用程序可以描述它需要的框架API版本
  • 它使得系统可以在硬件设备上安装应用程序时能够检查版本是否匹配，使得版本不兼容的应用程序不会被错误安装在设备之上.

  每个版本的Android平台都在其内部存储了自己的API级别标识。

  应用程序可以用框架API提供的清单文件元素 — lt;uses-sdkgt; 来描述该应用程序可以运行的最小和最大API级别，以及应用程序开发者设计期望运行的平台版本。三种属性分别描述如下:

  • android:minSdkVersion — 指明该应用程序可以运行的API最低版本。默认是“1”。
  • android:targetSdkVersion — 指明该应用程序设计时期望运行的目标API版本。在某些情况下，这允许应用程序使用目标API级别下定义的清单元素或行为，而不是只限于使用最低API级别定义的内容。
  • android:maxSdkVersion — 指明该应用程序可以运行的最高API级别。重要声明: 使用该属性之前请阅读lt;uses-sdkgt;文档。

  比如，要指明一个应用程序能够运行的最低API级别，应当在该应用程序的清单文件的lt;uses-sdkgt;元素中加入android:minSdkVersion属性。android:minSdkVersion的值是一个正整数，对应的是该应用程序能够运行的最低平台的API级别标识。

  用户尝试安装一个应用程序，或者在系统升级后重验证应用程序的时候，Android系统首先会检查应用程序的清单文件中的lt;uses-sdkgt;属性，将其与系统内部API级别对比。系统只有在满足下列情况时才允许进行应用程序安装：

  • 如果声明了android:minSdkVersion属性，其属性值必须小于或等于该系统的API级别对应的整数值。如果未声明，系统会默认该应用程序运行需要的最低API级别是1。
  • 如果声明了android:maxSdkVersion属性，其属性值必须等于或大于该系统的API级对应的整数值。如果未声明，系统会默认该应用程序没有最高API级别限制。请通过阅读文档lt;uses-sdkgt;以获得系统如何处理该属性的更多信息。

  应用程序清单文件中声明该属性后， lt;uses-sdkgt;元素看起来应类似于下面的例子：

  lt;manifestgt;
  lt;uses-sdk android:minSdkVersion='5' /gt;
  ...
  lt;/manifestgt;

  这样做的主要原因是，应用程序会通过android:miniSdkVersion声明的API级别来告知系统——该应用程序使用的API是指定引入的API级别。假如没有这种属性声明，一个应用程序如果因为某些不知名的原因被安装在低级别API系统之上，那么该应用程序会在运行时因为尝试访问不存在的API而崩溃。为此，Android系统通过不允许应用程序被安装在不满足其最低API级别要求的目标硬件上来防止此类结果发生。

  例如，android.appwidget类包是在API级别3中开始引入的。如果一个应用程序使用了这个API，就必须通过指明android:minSdkVersion属性为3来声明运行的最低要求。于是，该应用程序就可以在Android 1.5（API级别3级）、Android 1.6 (API级别4级)等平台上安装，但是在Android 1.1 (API级别2级)和 Android 1.0 平台(API级别1级)上却是无法安装的。

  欲知关于如何声明应用程序API级别需求的更多信息，请阅读文档中关于清单文件的lt;uses-sdkgt;章节。

  3.开发者需要考虑的内容

  本节属于应用程序开发者需要了解的内容。

  3.1应用程序的向前兼容性

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

  这是因为几乎所有的框架API变更都是添加性质的，一个以某种版本的API开发的应用程序是向前兼容与后续Android系统及高版本API。应用程序应当可以运行于高版本的平台，除非使用了未来因某种原因移除的API。

  向前兼容性的特性如此重要，是因为很多的Android驱动的设备能够使用OTA远程下载技术进行系统更新。用户开始时能够很好的安装和使用你开发的应用程序，后来进行了OTA升级到新版本的Android平台。一旦升级完毕，你的应用程序将运行在一个新的版本环境下，而这个环境应当包含了你的应用程序所需的API和系统功能。

  某些情况下，API背后的变化，例如系统底层的变化，可能会影响到你的应用程序运行在新的环境下。为此，作为应用程序开发人员，应当了解应用程序在不同系统环境下将会有如何的外观和行为。Android SDK包含了多个平台版本，开发人员可以下载下来，用于测试自己的应用程序在不同版本下的运行情况。每个版本的平台都提供了兼容的系统镜像，你可以将应用程序运行在对应的Android虚拟设备（模拟器）上进行测试。

  3.2应用程序的向后兼容性

  Android应用程序不一定向后兼容于那些比这些应用程序开发环境低的平台环境。

  Android平台的每个新版本包含了新的框架API，例如新的平台功能，或者替代部分已有的API。应用程序在新平台上可以访问这些新的API，就像之前提到的，在后续更新的版本中，这些新功能API也是可以继续使用。相反的，因为早期版本的平台不会包含新的API功能，使用了新API的应用程序在那些旧平台上是无法运行的。

  虽然一个Android平台设备不太可能降级到以前的版本，但是需要了解的是：实际生活中可能会有很多设备运行的是较旧的平台版本。即使在设备接收到OTA远程下载升级，有些人仍然可能会滞后甚至可能不会收到更新。

  3.3平台版本和API级别的选择

  当你开发应用程序时，你需要选择一个平台用于编译该应用程序。通常，你应该在你的应用程序可以支持的最低版本的平台上进行编译。

  你可以通过寻找最低的可以支持你的应用程序编译的平台方式来决定你将会支持的最低平台版本。一旦你确定了支持的最低版本后，你就可以创建对应版本的AVD模拟器来全面测试你的应用程序。你需要注意的是不要忘记在应用程序清单文件中申明android:minSdkVersion属性，并赋上正确的API级别标识。

  3.4声明最低API级别

  如果你开发的应用程序使用了最新平台上引入的API或平台特性，你就需要将android:minSdkVersion属性赋最新平台的API级别标识。这将保证用户只能在他们的设备与你的应用程序平台版本兼容情况下安装。反过来说，这样能够保证你的应用程序在他们的设备上表现正常。

  如果你用了最新的API或平台特性，但是没有申明android:minSdkVersion属性，那么你的应用程序在最新平台上运行是没有稳定，但是在早期版本的平台上是会出错的。在后一种情况，应用程序在尝试访问旧平台上不存在的API时会崩溃。

  3.5针对高版本的API级别测试

  编译完你的应用程序，你应当在支持的最低版本平台上详细测试应用程序的表现。可以通过创建对应平台的AVD模拟器进行测试。此外，要保证向前兼容性，你应当在你的应用程序可能运行的更高平台版本上进行运行和测试。

  Android SDK包含了多个平台版本供开发者使用，其中包括了最新的版本，并且提供了升级工具使得开发者可以获取其他的版本。

  要使用升级工具，可以通过Android命令行方式，该工具位于lt;sdkgt;/tools路径下。你可以用敲入android指令运行该升级工具，而不用指定任何参数。你也可以简单地通过双击Windows下的android.bat或OS X/Linux下的android文件来启动升级工具。在ADT工具界面，你可以通过菜单的Window gt; Android SDK and AVD Manager来访问升级工具。

  要想将你的应用程序

  剩余内容已隐藏，支付完成后下载完整资料

  ---

  资料编号：[25655]，资料为PDF文档或Word文档，PDF文档可免费转换为Word

您可能感兴趣的文章

• 基于Ad Hoc网络改进的TNMA时槽分配算法外文翻译资料
• 图像压缩技术:无损和有损算法综述。外文翻译资料
• 测量液体电导率的传感器外文翻译资料
• 使用虚拟现实对类人机器人的外观和性能进行心理评估外文翻译资料
• 以概率的，区间的，模糊的方法对Lamb波在复合材料中传播特性的测定外文翻译资料
• 基于人工神经网络预测PM2.5浓度的温度反演效应外文翻译资料
• 基于红外线传感器和相机的人数清点稳定系统外文翻译资料
• 一种基于GIS技术的半动态地理空间数据显示外文翻译资料
• 使用阈值技术的图像分割外文翻译资料
• 基于单片机的火灾探测及火灾预警系统的设计外文翻译资料