本文參考了谷歌開發者文件：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，就會將另一個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

如果沒有設定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

經過測試，將maxSdkVersion的值設定成9，程式是可以安裝在4.2的手機上的。說明這個值已經不再起作用。

    <uses-sdk
		android:minSdkVersion="8"
        android:targetSdkVersion="19" 
        android:maxSdkVersion="9"/>