Android - API Levels- API级别是什么

怼烎@ 2022-09-21 13:17 187阅读 0赞

http://www.cnblogs.com/zziss/archive/2012/02/13/2350032.html

API级别是什么

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

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

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

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

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

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

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

<table style="word-wrap:break-word; color:rgb(102,102,102); font-family:宋体,Arial; font-size:16px; line-height:26px; border:currentcolor; margin-left:26.7pt"> 
 <tbody style="word-wrap:break-word"> 
 <tr style="word-wrap:break-word"> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border:1pt solid black; width:70.85pt; background:rgb(222,232,241)"> 平台版本 </td> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:1pt 1pt 1pt medium; border-style:solid solid solid none; border-color:black black black currentcolor; width:63.8pt; background:rgb(222,232,241)"> API级别 </td> 
 </tr> 
 <tr style="word-wrap:break-word"> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt; border-style:none solid solid; border-color:currentcolor; width:70.85pt"> Android 3.0 </td> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt medium; border-style:none solid solid none; border-color:currentcolor; width:63.8pt"> 11 </td> 
 </tr> 
 <tr style="word-wrap:break-word"> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt; border-style:none solid solid; border-color:currentcolor; width:70.85pt"> Android 2.3.3 </td> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt medium; border-style:none solid solid none; border-color:currentcolor; width:63.8pt"> 10 </td> 
 </tr> 
 <tr style="word-wrap:break-word"> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt; border-style:none solid solid; border-color:currentcolor; width:70.85pt"> Android 2.3 </td> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt medium; border-style:none solid solid none; border-color:currentcolor; width:63.8pt"> 9 </td> 
 </tr> 
 <tr style="word-wrap:break-word"> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt; border-style:none solid solid; border-color:currentcolor; width:70.85pt"> Android 2.2 </td> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt medium; border-style:none solid solid none; border-color:currentcolor; width:63.8pt"> 8 </td> 
 </tr> 
 <tr style="word-wrap:break-word"> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt; border-style:none solid solid; border-color:currentcolor; width:70.85pt"> Android 2.1 </td> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt medium; border-style:none solid solid none; border-color:currentcolor; width:63.8pt"> 7 </td> 
 </tr> 
 <tr style="word-wrap:break-word"> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt; border-style:none solid solid; border-color:currentcolor; width:70.85pt"> Android 2.0.1 </td> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt medium; border-style:none solid solid none; border-color:currentcolor; width:63.8pt"> 6 </td> 
 </tr> 
 <tr style="word-wrap:break-word"> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt; border-style:none solid solid; border-color:currentcolor; width:70.85pt"> Android 2.0 </td> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt medium; border-style:none solid solid none; border-color:currentcolor; width:63.8pt"> 5 </td> 
 </tr> 
 <tr style="word-wrap:break-word"> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt; border-style:none solid solid; border-color:currentcolor; width:70.85pt"> Android 1.6 </td> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt medium; border-style:none solid solid none; border-color:currentcolor; width:63.8pt"> 4 </td> 
 </tr> 
 <tr style="word-wrap:break-word"> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt; border-style:none solid solid; border-color:currentcolor; width:70.85pt"> Android 1.5 </td> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt medium; border-style:none solid solid none; border-color:currentcolor; width:63.8pt"> 3 </td> 
 </tr> 
 <tr style="word-wrap:break-word"> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt; border-style:none solid solid; border-color:currentcolor; width:70.85pt"> Android 1.1 </td> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt medium; border-style:none solid solid none; border-color:currentcolor; width:63.8pt"> 2 </td> 
 </tr> 
 <tr style="word-wrap:break-word"> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt; border-style:none solid solid; border-color:currentcolor; width:70.85pt"> Android 1.0 </td> 
 <td style="word-wrap:break-word; margin:0px; padding:0cm 5.4pt; border-width:medium 1pt 1pt medium; border-style:none solid solid none; border-color:currentcolor; width:63.8pt"> 1 </td> 
 </tr> 
 </tbody> 
</table>

在Android中使用API级别

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

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

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

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

*  android:minSdkVersion — 指明该应用程序可以运行的API最低版本。默认是“1”。
 *  android:targetSdkVersion — 指明该应用程序设计时期望运行的目标API版本。这允许应用程序使用目标API级别下定义的清单元素或行为，而不是只限于使用最低API级别定义的内容。
 *  android:maxSdkVersion — 指明该应用程序可以运行的最高API级别。

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

*  如果声明了android:minSdkVersion属性，其属性值必须小于或等于该系统的API级别对应的整数值。如果未声明，系统会默认该应用程序运行需要的最低API级别是1。
 *  如果声明了android:maxSdkVersion属性，其属性值必须等于或大于该系统的API级对应的整数值。如果未声明，系统会默认该应用程序没有最高API级别限制。

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

[![\[转载\]Android - API Levels][Android - API Levels]][Android - API Levels_Android - API Levels]

这样做的主要原因是，应用程序会通过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级)上却是无法安装的

在AndroidMenifest.xml中，常常会有下面的语句：
    
     
    
    在default.properties中，会看到下面的语句：
    
     target=android-10
    
    如果是使用Eclipse的话，还可能会看到这样的警告：
    Attribute minSdkVersion (4) is lower than the project target API level (10)
    
    
    
    那么，这里面的minSdkVersion、targetSdkVersion、maxSdkVersion、target API level四个数值到底有什么区别？
    
    
    minSdkVersion与maxSdkVersion比较容易理解，就是在安装程序的时候，如果目标设备的API版本小于minSdkVersion，或者大于maxSdkVersion，程序将无法安装。一般来说没有必要设置maxSdkVersion。
    
     
    
    targetSdkVersion相对复杂一些，如果设置了此属性，那么在程序执行时，如果目标设备的API版本正好等于此数值，他会告诉Android平台：此程序在此版本已经经过充分测，没有问题。不必为此程序开启兼容性检查判断的工作了。也就是说，如果targetSdkVersion与目标设备的API版本相同时，运行效率可能会高一些。
    
    但是，这个设置仅仅是一个声明、一个通知，不会有太实质的作用，比如说，使用了targetSdkVersion这个SDK版本中的一个特性，但是这个特性在低版本中是不支持的，那么在低版本的API设备上运行程序时，可能会报错：java.lang.VerifyError。也就是说，此属性不会帮你解决兼容性的测试问题。你至少需要在minSdkVersion这个版本上将程序完整的跑一遍来确定兼容性是没有问题的。(这个问题确实让人头疼)
    
    
    
    
    在default.properties中的target是指在编译的时候使用哪个版本的API进行编译。
    
     综上，上面的四个值其实是作用于不同的时期：
    target API level是在编译的时候起作用，用于指定使用哪个API版本(SDK版本)进行编译。
    minSdkVersion和maxSdkVersion是在程序安装的时候起作用，用于指定哪些版本的设备可以安装此应用。
    targetSdkVersion是在程序运行的时候起作用，用于提高指定版本的设备上程序运行体验。
    
    这四个数值在程序编译时也没有严格的检查，比如说，你可以将minSdkVersion设置的比maxSdkVersion还大，他会自动忽略掉错误的maxSdkVersion。

[Android - API Levels]: http://s14.sinaimg.cn/middle/48a45b95xa8630b496c5d&690
[Android - API Levels_Android - API Levels]: /images/20220721/034be39cf80442d7892adc3e5ed515d2.png
[android.appwidget]: http://developer.android.com/reference/android/appwidget/package-summary.html