對于一個項目來說，清單既可以很簡單、也可以很復(fù)雜，其具體情況要視應(yīng)用程序而定。我們首先看看清單中那些在所有應(yīng)用中都不可或缺的組成部分，再進一步探索未來在項目開發(fā)中可能涉及的備選組成部分。

在本系列教程當(dāng)中，我們將共同從零開始學(xué)習(xí) Android 開發(fā)，同時了解與這套移動平臺協(xié)作所必需的基礎(chǔ)概念及實踐。到目前為止，我們已經(jīng)熟悉了 Android 項目中的各個組成部分，包括其資源。在今天的文章中，我們將以項目清單文件作為核心內(nèi)容。

介紹

對于一個項目來說，清單既可以很簡單、也可以很復(fù)雜，其具體情況要視應(yīng)用程序而定。我們首先看看清單中那些在所有應(yīng)用中都不可或缺的組成部分，再進一步探索未來在項目開發(fā)中可能涉及的備選組成部分。

清單文件當(dāng)中可以包含眾多元素與屬性，我們不妨點擊此處在 Android 開發(fā)者指南當(dāng)中找到關(guān)于它們的詳細(xì)信息。清單擁有幾大主要作用：它指定應(yīng)用程序包、提供應(yīng)用組件的形式化描述，此外還負(fù)責(zé)聲明權(quán)限、必要的 API 級別以及鏈接庫等。我們目前只討論能夠在清單中列出的最為基礎(chǔ)的元素與屬性，但大家也要知道其中完全可以容納更多元素、并在所涵蓋的元素范圍之外使用更多附加屬性。

1. 清單元素

在 Eclipse 當(dāng)中打開我們的項目清單文件——大家總能在項目的根目錄下找到這份清單。正如前面所提到，大家可以通過多種方式查看清單內(nèi)容。在底部的編輯器區(qū)域中，大家可以看到清單、應(yīng)用、權(quán)限、工具以及 XML 代碼等多個標(biāo)簽?，F(xiàn)在快速瀏覽這些標(biāo)簽——我們需要使用 XML 代碼，所以請切換到“AndroidManifest.xml”標(biāo)簽。

http://wiki.jikexueyuan.com/project/android-sdk/images/10.png" alt="" />

清單文件中所顯示的元素是由 Eclipse 在我們創(chuàng)建項目的同時生成的。但這些只夠滿足簡單應(yīng)用的需求，在大多數(shù)情況下、我們還需要在創(chuàng)建項目時向清單中添加更多元素。文件中的根元素為 manifest 元素：

<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
    package="com.example.myfirstapp" 
    android:versionCode="1" 
    android:versionName="1.0" > 
</manifest> 

Eclipse 會在項目創(chuàng)建時將大家所選擇的包名稱作為 manifest 元素的屬性。版本代碼與名稱初始分別為 1 與 1.0。當(dāng)大家將應(yīng)用程序提交到 Play 商店中并進行后續(xù)次級版本更新時，需要為每一次更新分配一個更新數(shù)字。版本名稱是用戶們在 Play 商店中所看到的應(yīng)用程序的實際名稱，所以大家可以隨意使用自己喜歡的數(shù)字來表示。用戶們是無法看到版本代碼的，而且新版本的數(shù)字必須高于舊版本——不過每一次遞增的幅度并不固定。如果大家嘗試向 Google Play 軟件商店上傳新的應(yīng)用程序版本，但其版本代碼并未高于之前版本的代碼，那么 Play 商店將拒絕這一上傳操作。

2. Uses-SDK 元素

我們在 manifest 元素當(dāng)中首先見到的應(yīng)該是 uses-sdk 元素：

<uses-sdk 
    android:minSdkVersion="8" 
    android:targetSdkVersion="18" /> 

這一元素負(fù)責(zé)定義最低必要 API 級別以及大家在測試項目時所設(shè)定的目標(biāo)級別。我們在創(chuàng)建應(yīng)用程序時就需要選擇這些相關(guān)值。如果需要，大家也可以在項目創(chuàng)建完成后，通過修改清單文件內(nèi)容進行屬性變更。舉例來說，大家可能發(fā)現(xiàn)自己需要使用某些當(dāng)前選定 API 級別無法實現(xiàn)的平臺功能，這時就需要通過清單文件作出調(diào)整了。如果大家改變了 SDK 版本，Eclipse 會重新建立整個項目。

如果用戶設(shè)備所運行的 API 級別低于項目的最低要求，則無法下載并安裝我們的應(yīng)用程序。列出目標(biāo) API 級別代表著我們已經(jīng)對當(dāng)前應(yīng)用版本進行過測試。為保證應(yīng)用產(chǎn)品的可靠性，大家應(yīng)該在盡可能多的 API 級別之下進行應(yīng)用程序測試。

3. Application 元素

Eclipse 還會向我們的清單中插入 application 元素。該元素中包含多種子元素，我們將在稍后逐一討論。現(xiàn)在先來看看打開標(biāo)簽后的內(nèi)容：

<application 
    android:allowBackup="true" 
    android:icon="@drawable/ic_launcher" 
    android:label="@string/app_name" 
    android:theme="@style/AppTheme" >

需要注意的幾種主要屬性分別為圖標(biāo)、標(biāo)簽和主題條目。該元素還能夠承載多種附加屬性。圖標(biāo)屬性代表應(yīng)用可繪制資源中的某個文件。在默認(rèn)情況下項目會直接使用 Android 圖標(biāo)，但大家可以添加自己的圖標(biāo)文件并將其引用到這里。標(biāo)簽圖標(biāo)引用的同樣是來自應(yīng)用程序資源的字符串。打開名稱中包含“res/values”字符串 XML 文件，大家會看到被引用的字符串，內(nèi)容如下所示：

<string name="app_name">MyFirstApp</string> 

這應(yīng)該是一條可讀字符串，因為它會顯示在用戶界面中的多個位置，包括緊靠著啟動圖標(biāo)的設(shè)備菜單。大家通常需要變更上述字符串內(nèi)容，例如在表述中加入空格——即“My First App”。

回到清單文件當(dāng)中，請注意 application 元素的主題屬性。它同樣引用一種資源，大家可以在“res/values”類型的 XML 文件中找到其具體引用關(guān)系，馬上去看看吧。接下來切換回清單標(biāo)簽。如果大家稍后決定定義自己的應(yīng)用程序風(fēng)格，則可以在主題屬性當(dāng)中對其加以引用。

4. Activity 元素

在 application 元素當(dāng)中，大家會看到一項 activity 元素——它對應(yīng)著我們在項目開發(fā)中所創(chuàng)建的 Activity 類。在 activity 元素中包含有多種子元素，我們稍后再詳加討論。現(xiàn)在先來看看打開后的標(biāo)簽內(nèi)容：

<activity 
    android:name="com.example.myfirstapp.MainActivity" 
    android:label="@string/app_name" > 

名稱屬性利用應(yīng)用程序包中所限定的路徑引用對應(yīng)類。標(biāo)簽允許我們控制 Activity 啟用時、窗口標(biāo)題中的顯示內(nèi)容。在默認(rèn)情況下，窗口標(biāo)題往往就是應(yīng)用程序名稱，因此大家一般不需要再進行額外調(diào)整。不過隨著應(yīng)用程序復(fù)雜性的提高，大家將向項目中添加更多 Activity——每一個對應(yīng) UI 中的一套屏幕顯示方案。每一次向應(yīng)用程序中添加新的 Activity 類時，大家都需要在 application 元素中添加一個對應(yīng)子元素，如下所示：

<activity android:name=".About" > 
</activity> 

如大家所見，我們并不總是需要使用完整的應(yīng)用包名稱。上面展示的簡寫形式也能正常起效，只要 Activity 類（名稱為‘About’）仍然處于 manifest 元素所定義的應(yīng)用包當(dāng)中即可。Activity 元素能夠容納多種屬性，從而決定用戶如何與其進行交互。

5. 意圖過濾器

在主 activity 元素當(dāng)中，大家會看到一個 intent-filter 元素：

<intent-filter> 
    <action android:name="android.intent.action.MAIN" /> 
    <category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 

這里的 Intent Filter 用于描述主 activity 能夠響應(yīng)哪些“意圖”。在 Android 系統(tǒng)中，所謂意圖是指在 Activity 啟動時向其傳遞的數(shù)據(jù)對象。當(dāng)大家在自己的應(yīng)用程序中啟用一個又一個 Activity 時，就需要使用到意圖機制了——不過意圖也可以在不同應(yīng)用之間進行傳遞。

針對主 activity 的意圖過濾器代表前者應(yīng)該在應(yīng)用程序運行時被一并啟用。意圖是通過 action 元素實現(xiàn)這一效果的，也就是上述代碼中的“MAIN”操作。另外，category 元素旨在通過分類名稱描述意圖過濾器，在我們的示例中就是“LAUNCHER”。這兩種元素相結(jié)合意味著我們的應(yīng)用程序應(yīng)該利用 Activity 作為其主入口點，而且該入口點將在應(yīng)用程序運行時一并啟動。

意圖過濾器當(dāng)中可以包含多種子元素，其中包括數(shù)據(jù)規(guī)范。如果大家希望了解更多信息，可以點擊此處查看 Android 開發(fā)者指南中的“意圖與意圖管理器”章節(jié)。在 activity 元素中，除了 intent-filter 之外還可以包含其它子元素——例如 metadata，其作用是定義一個數(shù)據(jù)條目的名值對。

6. 用戶權(quán)限

我們已經(jīng)了解了創(chuàng)建項目時 Eclipse 當(dāng)中所包含的所有清單元素，現(xiàn)在再來看看今后開發(fā)復(fù)雜應(yīng)用時需要涉及的其它元素。某些應(yīng)用程序需要判斷用戶是否有權(quán)執(zhí)行特定操作或者查看特定內(nèi)容，這種與權(quán)限相關(guān)的功能要靠 uses-permission 元素來實現(xiàn)。當(dāng)用戶在 Play 軟件商店中查看我們的應(yīng)用時，該平臺會在應(yīng)用下載前顯示使用全部功能所必需的權(quán)限。如果用戶選擇繼續(xù)，則需要接受權(quán)限控制提示，而后應(yīng)用才能正常運行。 在清單當(dāng)中必須強制要求的權(quán)限包括使用內(nèi)部數(shù)據(jù)、寫入外部存儲以及訪問攝像頭等設(shè)備功能。我們通過以下示例代碼演示這一概念：

<uses-permission android:name="android.permission.INTERNET" /> 

應(yīng)用程序還可以強制要求其它幾種潛在權(quán)限，請大家點擊此處查看 API 引用說明中的“Manifest.permission”部分。

7. 用戶設(shè)備

有這樣一類清單元素可以被用于描述應(yīng)用程序運行所必需的硬件及軟件功能，其中包括 uses-configuration 元素。在該元素中，大家可以為導(dǎo)航、鍵盤以及觸摸屏選項指定相關(guān)要求。在 uses-feature 元素中，大家可以通過功能名稱與布爾標(biāo)記列舉關(guān)于硬件或者軟件的單一功能要求。這些功能包括藍(lán)牙與攝像頭選項，例如閃存、位置檢測以及傳感器。而 supports-screens 元素則允許大家為應(yīng)用程序定義所支持的屏幕尺寸，所指定的元素可同時涉及尺寸與像素密度。

8. 其它元素

我們前面所探討的元素主要圍繞著自己的初始應(yīng)用展開，但其它不同類型的應(yīng)用中也有一些元素值得關(guān)注。我們?yōu)闃?biāo)準(zhǔn)應(yīng)用所創(chuàng)建的初始項目在啟動后只涉及用戶菜單并為使用者提供一個或者多個 Activity 屏幕。然而其它類型的應(yīng)用還可能包括功能部件以及持續(xù)運行的后臺進程——旨在處理數(shù)據(jù)訪問或者接收系統(tǒng)通知。

應(yīng)用程序通常會利用 Android 系統(tǒng)中的 Service 類來處理后臺進程，這就要求我們在清單當(dāng)中添加 service 元素——與 Activity 類似，service 元素與 Service 類之間一一對應(yīng)。Android 應(yīng)用中的內(nèi)容提供器負(fù)責(zé)管理對數(shù)據(jù)源的訪問，具體內(nèi)容被列入 provider 元素當(dāng)中。最后，清單中的 receiver 元素旨在幫助應(yīng)用接收來自其它應(yīng)用或者操作系統(tǒng)本身的意圖。

結(jié)論

到這里，我們已經(jīng)闡述了 Android 應(yīng)用的清單文件中，最為基礎(chǔ)的各項功能。當(dāng)大家創(chuàng)建應(yīng)用程序時，Eclipse 都會同時向清單文件中添加初始項目必需的主要元素。隨著在應(yīng)用中引入更多功能，我們需要不斷向清單內(nèi)增加新內(nèi)容以確保應(yīng)用程序整體能夠順利起效。如果大家在開發(fā)過程中的實機或者虛擬設(shè)備測試出現(xiàn)了問題，很可能是因為清單中缺少某些必要元素。在下一篇系列教程中，我們將一同了解 Android 應(yīng)用如何存儲及訪問數(shù)據(jù)。

原文鏈接： http://mobile.tutsplus.com/tutorials/android/android-sdk-project-manifest/