第九章 Manifest文件

第九章 Manifest文件

到目前為止，我們已經(jīng)熟悉了Android項目中的各個組成部分，包括其資源。在今天的文章中，我們將以項目Manifest文件作為核心內(nèi)容。

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

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

1. Manifest元素

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

Manifest文件中所顯示的元素是由Eclipse在我們創(chuàng)建項目的同時生成的。但這些只夠滿足簡單應(yīng)用的需求，在大多數(shù)情況下、我們還需要在創(chuàng)建項目時向Manifest中添加更多元素。文件中的根元素為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商店中并進(jìn)行后續(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)建完成后，通過修改Manifest文件內(nèi)容進(jìn)行屬性變更。舉例來說，大家可能發(fā)現(xiàn)自己需要使用某些當(dāng)前選定API級別無法實現(xiàn)的平臺功能，這時就需要通過Manifest文件作出調(diào)整了。如果大家改變了SDK版本，Eclipse會重新建立整個項目。

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

3. Application元素

Eclipse還會向我們的Manifest中插入application元素。該元素中包含多種子元素，我們將在稍后逐一討論?，F(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”。

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

4. Activity元素

在application元素當(dāng)中，大家會看到一項activity元素——它對應(yīng)著我們在項目開發(fā)中所創(chuàng)建的Activity類。在activity元素中包含有多種子元素，我們稍后再詳加討論?，F(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)用程序名稱，因此大家一般不需要再進(jìn)行額外調(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元素能夠容納多種屬性，從而決定用戶如何與其進(jìn)行交互。

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時，就需要使用到意圖機(jī)制了——不過意圖也可以在不同應(yīng)用之間進(jìn)行傳遞。

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

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

6. 用戶權(quán)限

我們已經(jīng)了解了創(chuàng)建項目時Eclipse當(dāng)中所包含的所有Manifest元素，現(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)用才能正常運(yùn)行。 在Manifest當(dāng)中必須強(qiáng)制要求的權(quán)限包括使用內(nèi)部數(shù)據(jù)、寫入外部存儲以及訪問攝像頭等設(shè)備功能。我們通過以下示例代碼演示這一概念：

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

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

7. 用戶設(shè)備

有這樣一類Manifest元素可以被用于描述應(yīng)用程序運(yùn)行所必需的硬件及軟件功能，其中包括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ù)運(yùn)行的后臺進(jìn)程——旨在處理數(shù)據(jù)訪問或者接收系統(tǒng)通知。

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

結(jié)論

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