安卓 英文 外文文獻翻譯 Android API級別

N尊*理工大修GuilinUniversityofTechnology本科畢業(yè)設(shè)計（論文）夕卜文翻譯（附外文原文）學院： 信息科學與工程學院課題名稱：基于騰訊微博開放平臺的數(shù)字教學交流系統(tǒng)專業(yè)（方向）：計算機科學與技術(shù)班級：BCU09-4學 生：周杰倫指導教師：方文山日 期： 2013/4/19AndroidAPI級別當你開發(fā)你的Android應用程序時，了解該平臺API變更管理的基本方法和概念是很有幫助的。同樣的，知道API級別標識以及該標識如何保障你的應用與實際硬件設(shè)備相兼容對于開發(fā)及后續(xù)的發(fā)布、維護都是有益的。本節(jié)內(nèi)容告訴你API級別的知識，以及它如何影響你開發(fā)和使用的應用。關(guān)于如何使用“以API級別進行過濾〃來使用API參考手冊，從本文末尾的文檔過濾(Filteringthedocumentation)中可以得到更多信息。API級別是什么?API級別是一個整數(shù)值，它唯一標識了一個具體版本的Android平臺，及其框架的API的版本。Android平臺提供了一套框架API，使得應用程序可以與系統(tǒng)底層進行交互。該框架API由以下模塊組成：一組核心的包和類清單(manifest)文件的XML元素和屬性聲明資源文件的XML元素和屬性聲明及訪問形式各類意圖(Intents)應用程序可以請求的各類授權(quán)，以及系統(tǒng)中包含的授權(quán)執(zhí)行每個Android平臺的后續(xù)版本會包括它提供的更新的Android應用程序框架的API。該框架的API的更新設(shè)計，使高版本的API與早期版本兼容。也就是說，在新版本API中大多數(shù)都是新增功能，和引進新的或替代的功能。作為API的部分升級，老的替換的部分已過時，但不會從新版本中刪除，使得已有的應用程序仍然可以使用它們。在極少數(shù)情況下，舊版本API的部分可能被修改或刪除，通常這種變化是為了保障API的穩(wěn)定性及應用程序或系統(tǒng)的安全。所有其他早期版本的API將不做修改的保留。一個Android平臺提供的框架API，被指定一個整數(shù)標識符，稱為“API級別〃。每一個版本的Android平臺只支持有一個API級別，雖然該支持是隱含地包括了所有早期的API級別(一直到API級別1級)。Android平臺的最初版本提供的框架API級別是1級，隨后的版本依次遞增。下表說明了具體平臺版本和支持的API級別的對應關(guān)系。平臺版本API級別Android3.011Android2.3.310Android2.39Android2.28Android2.17Android2.0.16Android2.05Android1.64Android1.53Android1.12Android1.01在Android中使用API級別API級別標識為保證用戶和應用程序開發(fā)者的最佳體驗，起了關(guān)鍵作用：它讓Android平臺可以描述它支持的框架API的最高版本它讓應用程序可以描述它需要的框架API版本它使得系統(tǒng)可以在硬件設(shè)備上安裝應用程序時能夠檢查版本是否匹配，使得版本不兼容的應用程序不會被錯誤安裝在設(shè)備之上.每個版本的Android平臺都在其內(nèi)部存儲了自己的API級別標識。應用程序可以用框架API提供的清單文件元素一＜uses-sdk＞來描述該應用程序可以運行的最小和最大API級別，以及應用程序開發(fā)者設(shè)計期望運行的平臺版本。三種屬性分別描述如下：android:minSdkVersion—指明該應用程序可以運行的API最低版本。默認是''1"。android:targetSdkVersion—指明該應用程序設(shè)計時期望運行的目標API版本。在某些情況下，這允許應用程序使用目標API級別下定義的清單元素或行為，而不是只限于使用最低API級別定義的內(nèi)容。android:maxSdkVersion—指明該應用程序可以運行的最高API級別。重要聲明：使用該屬性之前請閱讀＜uses-sdk＞文檔。比如，要指明一個應用程序能夠運行的最低API級別，應當在該應用程序的清單文件的＜uses-sdk＞元素中加入android:minSdkVersion屬性。android:minSdkVersion的值是一個正整數(shù)，對應的是該應用程序能夠運行的最低平臺的API級別標識。用戶嘗試安裝一個應用程序，或者在系統(tǒng)升級后重驗證應用程序的時候，Android系統(tǒng)首先會檢查應用程序的清單文件中的＜uses-sdk＞屬性，將其與系統(tǒng)內(nèi)部API級別對比。系統(tǒng)只有在滿足下列情況時才允許進行應用程序安裝：如果聲明了android:minSdkVersion屬性，其屬性值必須小于或等于該系統(tǒng)的API級別對應的整數(shù)值。如果未聲明，系統(tǒng)會默認該應用程序運行需要的最低API級別是1。如果聲明了android:maxSdkVersion屬性，其屬性值必須等于或大于該系統(tǒng)的API級對應的整數(shù)值。如果未聲明，系統(tǒng)會默認該應用程序沒有最高API級別限制。請通過閱讀文檔＜uses%dk＞以獲得系統(tǒng)如何處理該屬性的更多信息。應用程序清單文件中聲明該屬性后，＜uses-sdk＞元素看起來應類似于下面的例子：<manifest><uses-sdkandroid:minSdkVersion="5"/>???</manifest>這樣做的主要原因是，應用程序會通過android:miniSdkVersion聲明的API級別來告知系統(tǒng)一一?該應用程序使用的API是指定引入的API級別。假如沒有這種屬性聲明，一個應用程序如果因為某些不知名的原因被安裝在低級別API系統(tǒng)之上，那么該應用程序會在運行時因為嘗試訪問不存在的API而崩潰。為此，Android系統(tǒng)通過不允許應用程序被安裝在不滿足其最低API級別要求的目標硬件上來防止此類結(jié)果發(fā)生。例如，android.appwidget類包是在API級別3中開始引入的。如果一個應用程序使用了這個API，就必須通過指明android:minSdkVersion屬性為3來聲明運行的最低要求。于是，該應用程序就可以在Android1.5（API級別3級）、Android1.6（API級別4級）等平臺上安裝，但是在Android1.1（API級別2級）和Android1.0平臺（API級別1級）上卻是無法安裝的。欲知關(guān)于如何聲明應用程序API級別需求的更多信息，請閱讀文檔中關(guān)于清單文件的＜uses-sdk＞章節(jié)。開發(fā)者需要考慮的內(nèi)容本節(jié)屬于應用程序開發(fā)者需要了解的內(nèi)容。應用程序的向前兼容性Android應用程序一般向前兼容于Android平臺的新版本。這是因為幾乎所有的框架API變更都是添加性質(zhì)的，一個以某種版本的API開發(fā)的應用程序是向前兼容與后續(xù)Android系統(tǒng)及高版本API。應用程序應當可以運行于高版本的平臺，除非使用了未來因某種原因移除的API。向前兼容性的特性如此重要，是因為很多的Android驅(qū)動的設(shè)備能夠使用OTA遠程下載技術(shù)進行系統(tǒng)更新。用戶開始時能夠很好的安裝和使用你開發(fā)的應用程序，后來進行了OTA升級到新版本的Android平臺。一旦升級完畢，你的應用程序?qū)⑦\行在一個新的版本環(huán)境下，而這個環(huán)境應當包含了你的應用程序所需的API和系統(tǒng)功能。某些情況下，API背后的變化，例如系統(tǒng)底層的變化，可能會影響到你的應用程序運行在新的環(huán)境下。為此，作為應用程序開發(fā)人員，應當了解應用程序在不同系統(tǒng)環(huán)境下將會有如何的外觀和行為。AndroidSDK包含了多個平臺版本，開發(fā)人員可以下載下來，用于測試自己的應用程序在不同版本下的運行情況。每個版本的平臺都提供了兼容的系統(tǒng)鏡像，你可以將應用程序運行在對應的Android虛擬設(shè)備（模擬器）上進行測試。應用程序的向后兼容性Android應用程序不一定向后兼容于那些比這些應用程序開發(fā)環(huán)境低的平臺環(huán)境。Android平臺的每個新版本包含了新的框架API，例如新的平臺功能，或者替代部分已有的API。應用程序在新平臺上可以訪問這些新的API，就像之前提到的，在后續(xù)更新的版本中，這些新功能API也是可以繼續(xù)使用。相反的，因為早期版本的平臺不會包含新的API功能，使用了新API的應用程序在那些舊平臺上是無法運行的。雖然一個Android平臺設(shè)備不太可能降級到以前的版本，但是需要了解的是：實際生活中可能會有很多設(shè)備運行的是較舊的平臺版本。即使在設(shè)備接收到OTA遠程下載升級，有些人仍然可能會滯后甚至可能不會收到更新。平臺版本和API級別的選擇當你開發(fā)應用程序時，你需要選擇一個平臺用于編譯該應用程序。通常，你應該在你的應用程序可以支持的最低版本的平臺上進行編譯。你可以通過尋找最低的可以支持你的應用程序編譯的平臺方式來決定你將會支持的最低平臺版本。一旦你確定了支持的最低版本后，你就可以創(chuàng)建對應版本的AVD模擬器來全面測試你的應用程序。你需要注意的是不要忘記在應用程序清單文件中申明android:minSdkVersion屬性，并賦上正確的API級別標識。聲明最低API級別如果你開發(fā)的應用程序使用了最新平臺上引入的API或平臺特性，你就需要將android:minSdkVersion屬性賦最新平臺的API級別標識。這將保證用戶只能在他們的設(shè)備與你的應用程序平臺版本兼容情況下安裝。反過來說，這樣能夠保證你的應用程序在他們的設(shè)備上表現(xiàn)正常。如果你用了最新的API或平臺特性，但是沒有申明android:minSdkVersion屬性，那么你的應用程序在最新平臺上運行是沒有穩(wěn)定，但是在早期版本的平臺上是會出錯的。在后一種情況，應用程序在嘗試訪問舊平臺上不存在的API時會崩潰。針對高版本的API級別測試編譯完你的應用程序，你應當在支持的最低版本平臺上詳細測試應用程序的表現(xiàn)?？梢酝ㄟ^創(chuàng)建對應平臺的AVD模擬器進行測試。此外，要保證向前兼容性，你應當在你的應用程序可能運行的更高平臺版本上進行運行和測試。AndroidSDK包含了多個平臺版本供開發(fā)者使用，其中包括了最新的版本，并且提供了升級工具使得開發(fā)者可以獲取其他的版本。要使用升級工具，可以通過Android命令行方式，該工具位于<sdk>/tools路徑下。你可以用敲入android指令運行該升級工具，而不用指定任何參數(shù)。你也可以簡單地通過雙擊Windows下的android.bat或OSX/Linux下的android文件來啟動升級工具。在ADT工具界面，你可以通過菜單的Window>AndroidSDKandAVDManager來訪問升級工具。要想將你的應用程序在不同平臺版本的模擬器上運行，需要創(chuàng)建對應的AVD設(shè)備。關(guān)于AVD的更多信息，請參見CreatingandManagingVirtualDevices。如果你用物理設(shè)備進行測試，確保清楚運行的具體平臺版本。通過本文開始部分的映射表格可以知道平臺版本對應的API級別標識。使用臨時的API級別某些情況下，有可能會發(fā)布“早期預覽(EarlyLook)〃版的Android平臺SDK。在此平臺版本上開發(fā)使用的API將不會是最終發(fā)布版，平臺的API級別標識數(shù)字就不會指定。你必須在程序清單文件中使用臨時的API級別進行標識，以便建立對應的平臺應用。臨時API級別不是一個整數(shù)，而是一個表示未發(fā)布的平臺版本的字符串代號。"早期預覽〃版本的API級別在發(fā)布說明中會申明，該代號是大小寫敏感的。臨時API級別標識的用途是保護開發(fā)者和設(shè)備使用者免于無意中發(fā)布或安裝在"早期預覽〃平臺版本上開發(fā)的應用程序，這些應用程序可能在最終的發(fā)布系統(tǒng)上運行不穩(wěn)定。臨時API級別標識僅僅在使用"早期預覽〃版本的SDK下有效，并且只能運行應用程序于模擬器之中。實際的Android設(shè)備上是無法安裝使用臨時API級別標識的應用程序的。在最終版本平臺發(fā)布后，你必須將程序清單文件中用到的臨時API級別標識替換成最終平臺的實際API級別整數(shù)值。通過API級別進行文檔內(nèi)容過濾Android開發(fā)者站點上的參考文檔的每個頁面的右上方提供了“FilterbyAPILevel〃控件。你可以用這個控件來僅僅顯示你應用程序相關(guān)的那部分API文檔，可以通過應用程序清單文件中的android:minSdkVersion屬性值進行過濾。要使用過濾功能，可以通過頁面搜索框下面的選擇框來啟用過濾功能。比如設(shè)定“FilterbyAPILevel”控件內(nèi)容與你應用程序申明的相同。注意：在選定級別之后引入的心API會以灰色顯示，并且內(nèi)容被隱藏，因為你的應用程序是無法訪問這些新功能。API級別過濾方法不會提供每個API級別中新添加的功能視圖，僅僅展現(xiàn)對應API級別的整個內(nèi)容，其中去除了后續(xù)新版本中的內(nèi)容。如果你不想過濾API文檔了，只需要關(guān)閉該選擇框的特性。API級別過濾默認是關(guān)閉的，因此你可以看到整個框架API的全貌，而不管具體的API級別。還要注意的是個別的API元素申明了該API參考文檔在哪一級引入的。這通過在每個文檔頁面正文部分的右上角的“Since<apilevel〉”進行聲明該包和類的引入信息。類成員的API級別在其詳細描述文件頭部的右邊進行描述。AndroidAPILevelsAsyoudevelopyourapplicationonAndroid,it'susefultounderstandtheplatform'sgeneralapproachtoAPIchangemanagement.It'salsoimportanttounderstandtheAPILevelidentifierandtheroleitplaysinensuringyourapplication'scompatibilitywithdevicesonwhichitmaybeinstalled.ThesectionsbelowprovideinformationaboutAPILevelandhowitaffectsyourapplications.Forinformationabouthowtousethe"FilterbyAPILevel"controlavailableintheAPIreferencedocumentation,see attheendofthisdocument.WhatisAPILevel?APILevelisanintegervaluethatuniquelyidentifiestheframeworkAPIrevisionofferedbyaversionoftheAndroidplatform.TheAndroidplatformprovidesaframeworkAPIthatapplicationscanusetointeractwiththeunderlyingAndroidsystem.TheframeworkAPIconsistsof:AcoresetofpackagesandclassesAsetofXMLelementsandattributesfordeclaringamanifestfileAsetofXMLelementsandattributesfordeclaringandaccessingresourcesAsetofIntentsAsetofpermissionsthatapplicationscanrequest,aswellaspermissionenforcementsincludedinthesystemEachsuccessiveversionoftheAndroidplatformcanincludeupdatestotheAndroidapplicationframeworkAPIthatitdelivers.UpdatestotheframeworkAPIaredesignedsothatthenewAPIremainscompatiblewithearlierversionsoftheAPI.Thatis,mostchangesintheAPIareadditiveandintroduceneworreplacementfunctionality.AspartsoftheAPIareupgraded,theolderreplacedpartsaredeprecatedbutarenotremoved,sothatexistingapplicationscanstillusethem.Inaverysmallnumberofcases,partsoftheAPImaybemodifiedorremoved,althoughtypicallysuchchangesareonlyneededtoensureAPIrobustnessandapplicationorsystemsecurity.AllotherAPIpartsfromearlierrevisionsarecarriedforwardwithoutmodification.TheframeworkAPIthatanAndroidplatformdeliversisspecifiedusinganintegeridentifiercalled"APILevel".EachAndroidplatformversionsupportsexactlyoneAPILevel,althoughsupportisimplicitforallearlierAPILevels(downtoAPILevel1).TheinitialreleaseoftheAndroidplatformprovidedAPILevel1andsubsequentreleaseshaveincrementedtheAPILevel.ThefollowingtablespecifiestheAPILevelsupportedbyeachversionoftheAndroidplatform.PlatformVersionAPILevelAndroid3.011Android2.3.310Android2.39Android2.28Android2.17Android2.0.16Android2.05Android1.64Android1.53Android1.12Android1.01UsesofAPILevelinAndroidTheAPILevelidentifierservesakeyroleinensuringthebestpossibleexperienceforusersandapplicationdevelopers:ItletstheAndroidplatformdescribethemaximumframeworkAPIrevisionthatitsupportsItletsapplicationsdescribetheframeworkAPIrevisionthattheyrequireItletsthesystemnegotiatetheinstallationofapplicationsontheuser'sdevice,suchthatversion-incompatibleapplicationsarenotinstalled.EachAndroidplatformversionstoresitsAPILevelidentifierinternally,intheAndroidsystemitself.ApplicationscanuseamanifestelementprovidedbytheframeworkAPI—<usessdk>—todescribetheminimumandmaximumAPILevelsunderwhichtheyareabletorun,aswellasthepreferredAPILevelthattheyaredesignedtosupport.Theelementoffersthreekeyattributes:? android：rninSdkVersion—SpecifiestheminimumAPILevelonwhichtheapplicationisabletorun.Thedefaultvalueis"1".android:targetSdkVersion—SpecifiestheAPILevelonwhichtheapplicationisdesignedtorun.Insomecases,thisallowstheapplicationtousemanifestelementsorbehaviorsdefinedinthetargetAPILevel,ratherthanbeingrestrictedtousingonlythosedefinedfortheminimumAPILevel.android：maxSdkVersion—SpecifiesthemaximumAPILevelonwhichtheapplicationisabletorun.Important：Pleasereadthe〈usvs-sdk〉documentationbeforeusingthisattribute.Forexample,tospecifytheminimumsystemAPILevelthatanapplicationrequiresinordertorun,theapplicationwouldincludeinitsmanifesta〈uses-sdk〉elementwithaandroid:minSdkVersionattribute.Thevalueofandroid：minSdkVersionwouldbetheintegercorrespondingtotheAPILeveloftheearliestversionoftheAndroidplatformunderwhichtheapplicationcanrun.Whentheuserattemptstoinstallanapplication,orwhenrevalidatinganappplicationafterasystemupdate,theAndroidsystemfirstchecksthe〈uses-sdk〉attributesintheapplication'smanifestandcomparesthevaluesagainstitsowninternalAPILevel.Thesystemallowstheinstallationtobeginonlyiftheseconditionsaremet:Ifaandroid：minSdkVersionattributeisdeclared,itsvaluemustbelessthanorequaltothesystem'sAPILevelinteger.Ifnotdeclared,thesystemassumesthattheapplicationrequiresAPILevel1.Ifaandroid：maxSdkVersionattributeisdeclared,itsvaluemustbeequaltoorgreaterthanthesystem'sAPILevelinteger.Ifnotdeclared,thesystemassumesthattheapplicationhasnomaximumAPILevel.Pleasereadthe〈uses-sdk〉documentationformoreinformationabouthowthesystemhandlesthisattribute.Whendeclaredinanapplication'smanifest,a〈uses-sdk〉elementmightlooklikethis:<manifest><uses-sdkandroid:minSdkVersion="5"/>???</manifest>TheprincipalreasonthatanapplicationwoulddeclareanAPILevelinandroid：minSdkVersionistotelltheAndroidsystemthatitisusingAPIsthatwereintroducedintheAPILevelspecified.IftheapplicationweretobesomehowinstalledonaplatformwithalowerAPILevel,thenitwouldcrashatrun-timewhenittriedtoaccessAPIsthatdon'texist.ThesystempreventssuchanoutcomebynotallowingtheapplicationtobeinstalledifthelowestAPILevelitrequiresishigherthanthatoftheplatformversiononthetargetdevice.Forexample,theandroid.appwidgetpackagewasintroducedwithAPILevel3.IfanapplicationusesthatAPI,itmustdeclareaandroid：minSdkVersionattributewithavalueof"3".TheapplicationwillthenbeinstallableonplatformssuchasAndroid1.5(APILevel3)andAndroid1.6(APILevel4),butnotontheAndroid1.1(APILevel2)andAndroid1.0platforms(APILevel1).Formoreinformationabouthowtospecifyanapplication'sAPILevelrequirements,seethe sectionofthemanifestfiledocumentation.DevelopmentConsiderationsThesectionsbelowprovideinformationrelatedtoAPIlevelthatyoushouldconsiderwhendevelopingyourapplication.ApplicationforwardcompatibilityAndroidapplicationsaregenerallyforward-compatiblewithnewversionsoftheAndroidplatform.BecausealmostallchangestotheframeworkAPIareadditive,anAndroidapplicationdevelopedusinganygivenversionoftheAPI(asspecifiedbyitsAPILevel)isforward-compatiblewithlaterversionsoftheAndroidplatformandhigherAPIlevels.TheapplicationshouldbeabletorunonalllaterversionsoftheAndroidplatform,exceptinisolatedcaseswheretheapplicationusesapartoftheAPIthatislaterremovedforsomereason.ForwardcompatibilityisimportantbecausemanyAndroid-powereddevicesreceiveover-the-air(OTA)systemupdates.Theusermayinstallyourapplicationanduseitsuccessfully,thenlaterreceiveanOTAupdatetoanewversionoftheAndroidplatform.Oncetheupdateisinstalled,yourapplicationwillruninanewrun-timeversionoftheenvironment,butonethathastheAPIandsystemcapabilitiesthatyourapplicationdependson.Insomecases,changesbelowtheAPI,suchthoseintheunderlyingsystemitself,mayaffectyourapplicationwhenitisruninthenewenvironment.Forthatreasonit'simportantforyou,astheapplicationdeveloper,tounderstandhowtheapplicationwilllookandbehaveineachsystemenvironment.TohelpyoutestyourapplicationonvariousversionsoftheAndroidplatform,theAndroidSDKincludesmultipleplatformsthatyoucandownload.EachplatformincludesacompatiblesystemimagethatyoucanruninanAVD,totestyourapplication.ApplicationbackwardcompatibilityAndroidapplicationsarenotnecessarilybackwardcompatiblewithversionsoftheAndroidplatformolderthantheversionagainstwhichtheywerecompiled.EachnewversionoftheAndroidplatformcanincludenewframeworkAPIs,suchasthosethatgiveapplicationsaccesstonewplatformcapabilitiesorreplaceexistingAPIparts.ThenewAPIsareaccessibletoapplicationswhenrunningonthenewplatformand,asmentionedabove,alsowhenrunningonlaterversionsoftheplatform,asspecifiedbyAPILevel.Conversely,becauseearlierversionsoftheplatformdonotincludethenewAPIs,applicationsthatusethenewAPIsareunabletorunonthoseplatforms.Althoughit'sunlikelythatanAndroid-powereddevicewouldbedowngradedtoapreviousversionoftheplatform,it'simportanttorealizethattherearelikelytobemanydevicesinthefieldthatrunearlierversionsoftheplatform.EvenamongdevicesthatreceiveOTAupdates,somemightlagandmightnotreceiveanupdateforasignificantamountoftime.SelectingaplatformversionandAPILevelWhenyouaredevelopingyourapplication,youwillneedtochoosetheplatformversionagainstwhichyouwillcompiletheapplication.Ingeneral,youshouldcompileyourapplicationagainstthelowestpossibleversionoftheplatformthatyourapplicationcansupport.Youcandeterminethelowestpossibleplatformversionbycompilingtheapplicationagainstsuccessivelylowerbuildtargets.Afteryoudeterminethelowestversion,youshouldcreateanAVDusingthecorrespondingplatformversion(andAPILevel)andfullytestyourapplication.Makesuretodeclareaandroid:rninSdkVersionattributeintheapplication'smanifestandsetitsvaluetotheAPILeveloftheplatformversion.DeclaringaminimumAPILevelIfyoubuildanapplicationthatusesAPIsorsystemfeaturesintroducedinthelatestplatformversion,youshouldsettheandroid：minSdkVersionattributetotheAPILevelofthelatestplatformversion.ThisensuresthatuserswillonlybeabletoinstallyourapplicationiftheirdevicesarerunningacompatibleversionoftheAndroidplatform.Inturn,thisensuresthatyourapplicationcanfunctionproperlyontheirdevices.IfyourapplicationusesAPIsintroducedinthelatestplatformversionbutdoesnotdeclareaandroid：minSdkVersionattribute,thenitwillrunproperlyondevicesrunningthelatestversionoftheplatform,butnotondevicesrunningearlierversionsoftheplatform.Inthelattercase,theapplicationwillcrashatruntimewhenittriestouseAPIsthatdon'texistontheearlierversions.TestingagainsthigherAPILevelsAftercompilingyourapplication,youshouldmakesuretotestitontheplatformspecifiedintheapplication'sandroid：minSdkVersionattribute.Todoso,createanAVDthatusestheplatformversionrequiredbyyourapplication.Additionally,toensureforward-compatibility,youshouldrunandtesttheapplicationonallplatformsthatuseahigherAPILevelthanthatusedbyyourapplication.TheAndroidSDKincludesmultipleplatformversionsthatyoucanuse,includingthelatestversion,andprovidesanupdatertoolthatyoucanusetodownloadotherplatformversionsasnecessary.Toaccesstheupdater,usetheandroidcommand-linetool,locatedinthe<sdk>/toolsdirectory.YoucanlaunchtheUpdaterbyusingtheandroidcommandwithoutspecifyinganyoptions.Youcanalsosimplydouble-clicktheandroid.bat(Windows)orandroid(OSX/Linux)file.InADT,youcanalsoaccesstheupdaterbyselectingWindow>AndroidSDKandAVDManager.Torunyourapplicationagainstdifferentplatformversionsintheemulator,createanAVDforeachplatformversionthatyouwanttotest.FormoreinformationaboutAVDs,seeCreatingandManagingVirtualDevices.Ifyouareusingaphysicaldevicefortesting,ensurethatyouknowtheAPILeveloftheAndroidplatformitruns.SeethetableatthetopofthisdocumentforalistofplatformversionsandtheirAPILevels.UsingaProvisionalAPILevelInsomecases,an"EarlyLook"AndroidSDKplatformmaybeavailable.ToletyoubegindevelopingontheplatformalthoughtheAPIsmaynotbefinal,theplatform'sAPILevelintegerwillnotbespecified.Youmustinsteadusetheplatform'sprovisionalAPILevelyourapplicationmanifest,inordertobuildapplicationsagainsttheplatform.AprovisionalAPILevelisnotaninteger,butastringmatchingthecodenameoftheunreleasedplatformversion.TheprovisionalAPILevelwillbespecifiedinthereleasenotesfortheEarlyLookSDKreleasenotesandiscase-sensitive.TheuseofaprovisionalAPILevelisdesignedtoprotectdevelopersanddeviceusersfrominadvertentlypublishingorinstallingapplicationsbasedontheEarlyLookframeworkAPI,whichmaynotrunproperl