Android中build target，minSdkVersion，targetSdkVersion，maxSdkVersion概念區分

本文參考了谷歌開發者文檔：http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#provisional
本文轉載：http://blog.csdn.net/zhangjg_blog/article/details/17142395

如果開發的應用用戶較多，那么必須保證應用在多個版本不同的設備上能夠正確的運行。這就要求對各個版本比較熟悉，知道在什么版本中加入了什么新的功能或特性。但是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的手機上的。說明這個值已經不再起作用。
[html] ? view plain copy

<uses-sdk??

droid:minSdkVersion="8"??

? ??android:targetSdkVersion="19"? ?

? ??android:maxSdkVersion="9"/>??

總結

以上是生活随笔為你收集整理的Android中build target，minSdkVersion，targetSdkVersion，maxSdkVersion概念区分的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。