轉載自:http://blog.csdn.net/zhangjg_blog/article/details/17142395
本文參考了谷歌開發者文檔:http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#provisional
如果開發的應用用戶較多,那么必須保證應用在多個版本不同的設備上能夠正確的運行。這就要求對各個版本比較熟悉,知道在什么版本中加入了什么新的功能或特性。但是Android的版本太多了,是個令人頭疼的問題。如果想了解Android的版本差異,建議讀一下Android開發者文檔上相關的章節。
為了讓你的應用程序指定可以運行的版本,Android的manifest文件中提供了<uses-sdk>標簽。該標簽中有三個屬性,分別是minSdkVersion,targetSdkVersion,maxSdkVersion。這三個屬性比較容易讓人迷惑,我也是仔細讀了谷歌的官方文檔,才弄清楚這三個屬性的意義。此外,在項目構建時,還有個概念叫build target,在本文中也會進行分析。
什么是API level
其實標簽<uses-sdk>中指定的并不是我們使用的sdk的版本,也不是Android系統的版本,而是我們使用的Android平臺的版本,即API level。API level是一個整數,它指的是我們使用的框架(Framework)的版本,也就是我們使用的sdk中的各個平臺下的android.jar。但是這個API level又和Android系統的版本有著對應關系,并且每個系統都會在內部記錄它所使用的API level。舉例來說,我使用的手機系統是Android 2.3.3, 那么它就會在內部記錄使用的API level為10。這個內部的API level可以讓系統判定能不能安裝一款app,這個問題會在下文中提及。
下面給出android系統版本,API level和版本代號之間的對應關系表。(該表來自谷歌官方文檔:http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#provisional)

由上表可以看出,android的系統版本和API level之間并不是一一對應的,比如Android 2.3, Android 2.3.1, Android 2.3.2對應API level 9, 而Android 2.3.3, Android 2.3.4對應API level 10。API level是Android向開發者提供的一套Framework(android.jar)的代號,可能發布了新的系統版本,但是這一套接口并沒有變化,所以就不必提供新的Framework開發包,所以API level也不必改變。由此可知Android系統版本和API level是多對一的關系。由于API level就是發布的android.jar(一套接口)的代號,所以API level和sdk中platforms目錄中的各個android.jar是一一對應的。說白了,Android系統版本是給Android用戶看的,而API level是給應用程序開發者看的。
什么是build target
build target并不存在于manifest文件中,而是存在于項目根目錄中的project.properties文件中。如果使用Eclipse構建項目的話,那么每個項目的根目錄下都會有一個project.properties文件,這個文件中的內容用于告訴構建系統,怎樣構建這個項目。打開這個文件,除了注釋之外,還有以下一行:
target=android-18
這句話就是指明build target,也就是根據哪個android平臺構架這個項目。指明build target為android-18,就是使用sdk中platforms目錄下android-18目錄中的android.jar這個jar包編譯項目。同樣,這個android.jar會被加入到本項目的build path中。如下圖:
每當修改了build target,就會將另一個android.jar加入到build path中替換原來的jar。將build target改成android-17后的效果如下圖:

如果將build target 改成android-8,那么就會使用sdk中android-8下的android.jar編譯項目,如果在Activity中調用ActionBar相關的Api,那么就會報錯,因為ActionBar相關的Api是在API level 11中才加進來的。

一般情況下,應該使用最新的API level作為build target。這也是eclipse生成項目時的默認行為。
android:minSdkVersion
指明應用程序運行所需的最小API level。如果不指明的話,默認是1。也就是說該應用兼容所有的android版本。我們應該總是聲明這個屬性。
如果系統的API level低于android:minSdkVersion設定的值,那么android系統會阻止用戶安裝這個應用。下載將android:minSdkVersion設置為11, 并且將該應用安裝在android 2.3的手機上(對應API level 9),在安裝時會有如下提示:
提示手機API level的版本太低,安裝失敗。
如果指明了這個屬性,并且在項目中使用了高于這個API level的API, 那么會在編譯時報錯。將build target設為最新的android-19,那么就會使用最新的android-19下的android.jar來編譯項目。將minSdkVersion設置為8。在使用的android.jar中,肯定會有和ActionBar相關的API, 但是在項目中調用ActionBar API, 項目會報錯。因為minSdkVersion指明的API level 8中不存在ActionBar相關的API。
調用Activity.getActionBar()和ActionBar.getHeight()方法需要API level 11, 但是指定的minSdkVersion為8,所以報錯。由此可見,minSdkVersion不僅在程序安裝時起作用,也會在項目構建時起作用。
如果沒有設置minSdkVersion這個屬性,那么默認是1。表明程序兼容所有的Android系統,能夠在所有Android系統上運行。如果使用了高于API level 1 的API, 如ActionBar。那么在構建項目時,會提示和上面相同的錯誤,項目構建失敗。

android:targetSdkVersion
標明應用程序目標API Level的一個整數。如果不設置,默認值和minSdkVersion相同。
這個屬性通知系統,你已經針對這個指定的目標版本測試過你的程序,系統不必再使用兼容模式來讓你的應用程序向前兼容這個目標版本。應用程序仍然能在低于targetSdkVersion的系統上運行。
由于Android不斷向著更新的版本進化,一些行為甚至是外觀可能會改變。然而,如果平臺的API Level高于你的應用程序中的targetSdkVersion屬性指定的值,系統會開啟兼容行為來確保你的應用程序繼續以期望的形式來運行。你可以通過指定targetSdkVersion來匹配運行程序的平臺的 API level來禁用這種兼容性行為。舉例來說,設置這個值為11或更高,當你的應用運行在Android3.0或更高的系統上時,系統會為你的應用使用新的默認主題(Holo主題),并且當運行在大屏幕的設備上時會禁用屏幕兼容模式(screen compatibility mode),因為支持了 API level 11就暗示了支持大屏幕。
根據你設置的targetSdkVersion 的值,系統會執行很多兼容行為。一些行為在對應平臺版本的Build.VERSION_CODES中有討論。
為了讓你的應用程序支持每個Android版本,你應當提高targetSdkVersion的值到最新的API level,然后在對應的平臺上徹底的測試你的應用。
從上面的論述可知,targetSdkVersion這個屬性是在程序運行時期起作用的,系統根據這個屬性決定要不要以兼容模式運行這個程序。
一般情況下,應該將這個屬性的值設置為最新的API level 值,這樣的話可以利用新版本系統上的新特性。eclipse在生成項目時,默認將該值設置為最高,如果設置一個較低的值,會給出一個警告,如下圖所示。

這個警告的意思是沒有將targetSdkVersion的值設置為最高值,較新的系統會以兼容模式運行該程序。請考慮在新版本系統上測試程序并將targetSdkVersion設置為最新。更詳細的信息請參考android.os.Build.VERSION_CODES 。
android:maxSdkVersion
標明可以運行你的應用的最高API Level版本。
在Android1.5, 1.6, 2.0 和2.0.1,在安裝應用或系統升級時,系統會檢查這個值。在這兩種情況下,如果應用設置的maxSdkVersion 值低于系統本身使用的API Level,系統將不會允許安裝該應用。在系統升級后,新系統會重新校驗這個值,如果新系統的API Level高于這個值,新系統會刪除你的應用。
在高于2.0.1的系統上,安裝應用時不會再檢驗應用中設置的maxSdkVersion值,在系統升級后也不會重新校驗這個值。但是在向用戶展示可用的應用時,Google Play會繼續使用這個屬性進行過濾。
maxSdkVersion這個屬性本來是在程序安裝時和系統升級后起作用的。但是根據官方文檔中的說明, 已經不再推薦使用這個屬性。
經過測試,將maxSdkVersion的值設置成9,程序是可以安裝在4.2的手機上的。說明這個值已經不再起作用。
- <uses-sdk
- droid:minSdkVersion="8"
- android:targetSdkVersion="19"
- android:maxSdkVersion="9"/>