Android清單AndroidManifest詳細說明

Android清單AndroidManifest詳細說明

在初見Intent一章中，我們已嘗試過使用「startActivity」函式，傳入適當的「Intent」，來呼叫瀏覽器的Activity。

到目前為止，我們可以由學習Android 應用程式的經驗中歸納得出：所有Android 程式的運作流程，都定義在Activity 中。

Android 系統與其他系統很不一樣的地方是：它的應用程式並不直接與底層系統緊密結合，而是跑在Android 框架中。 這意思是設計Android 應用程式時，我們並不需要關心實際上運作的機器是哪一牌的手機或是哪一種嵌入式系統，或使用哪一種架構(ARM、x86、MIPS)。 我們要關心的只有Android 框架提供了那些功能，好讓我們能操作這臺裝置。 具體來說就是我們只要知道這臺機器的螢幕大小、有沒有鍵盤，有沒有支援GPS 等等訊息，就知道我們寫的應用程式是否能在這臺機器上順暢地運作。 Android 框架與底層系統的整合的問題完全可以留給軔體工程師來操心。

在執行「startActivity」函式時，應用程式並不是直接呼叫另一個Activity，而是將「Intent」(意圖)傳進Android 框架中。 Android 框架會檢視「startActivity」 呼叫所傳入的動作與Intent 內容是否在登錄檔中，如果符合，就啟動對應的服務或Activity。

Android 系統中的每一個應用程式，在安裝的過程裡，都得事先在Android 框架中註冊、登記這個應用程式所建立的Activity，並事先註明會使用到的服務。 譬如當我們在Android 上安裝我們撰寫的BMI 應用程式時，BMI 應用程式就會向Android 框架登記相關資訊：BMI 應用程式將會用到「Bmi」這個Activity。

這份訊息存在於每個Android應用程式專案根目錄下的「 AndroidManifest .xml」檔案中。 如果我們在程式裡，要用到其他應用程式或服務所提供的功能，也需一併在此列出。

在安裝應用程式的時候，Android 框架會根據應用程式提供的這份清單，將資訊註冊於Android 框架的登錄檔中。

備註:

這麼說其實是不太精確的。 Android 應用程式的運作流程，存在於四種載體中：

1. Activity (活動)
2. Broadcast Intent Receiver
3. Service
4. Content Provider

各種載體的相關內容會在後續章節提到時作解說。

預設的Activity 清單

我們使用eclipse Android開發工具開啟「BMI/ AndroidManifest .xml」檔案。 切換到「 AndroidManifest .xml」分頁標籤，檢視預設的「BMI/AndroidManifest .xml」檔案原始碼：

  1 <?xml version="1.0" encoding="utf-8"?>
 2 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
 3 package="com.demo.android.bmi"
 4 android:versionCode="1"
 5 android:versionName="1.0">
 6 <application android:icon="@drawable/icon">
 7 <activity android:name=".Bmi" android:label="@string/app_name">
 8 <intent-filter>
 9 <action android:name="android.intent.action.MAIN" />
 10 <category android:name="android.intent.category.LAUNCHER" />
 11 </intent-filter>
 12 </activity>
 13 </application>
 14 <uses-sdk android:minSdkVersion="X" />
 15 </manifest> 

我們分行講解如下：

  <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
     ....>
     ....
 </manifest> 

「 AndroidManifest .xml」這個檔案也是以XML格式描述，每個Android應用程式都需要一個「 AndroidManifest .xml」檔案，每份「AndroidManifest .xml」檔案的開頭都會出現這段敘述。 而整個「 AndroidManifest .xml」檔案的敘述，都包含在「manifest」(清單)這個主要標籤中。

  package="com.demo.android.bmi" 

「package」 是「manifest」(清單)標籤的一個特別屬性，範例中的內容可用來標明，這個應用程式的進入點存在於「com.demo.android.bmi」這個名稱空間/路徑中。

  android:versionCode="1"
 android:versionName="1.0" 

「android:versionCode」和「android:versionName」是應用程式版本號。 這兩個屬性是可選的(非必要)。 「android:versionName」是給使用者看的版本號，如「1.0」、「2.0」。 「android:versionCode」則是開發者用的內部版本號，一般使用流水號。

  <application android:icon="@drawable/icon" android:label="@string/app_name">
 ...
 </application> 

「manifest」標籤中主要包含一個「application」標籤(備註1)。 「application」標籤裡面，定​​義了所有這個應用程式用到的Activity、服務等資訊。「application」標籤中的「android:icon」屬性，定義了這個應用程式將顯示在Android 主畫面中的應用程式圖示。「android:icon="@drawable/icon"」表示應用程式圖示的資源檔存在於「res/drawable/icon」 中。 圖示的大小必須超過64x64 畫素（Pixel）。「application」標籤中的「android:label」屬性可用來指定應用程式將顯示在Home 主畫面上的名稱​​。 也就是預設剛開好機時，可以從桌面下方拉出的應用程式列表。

  <activity android:name=".Bmi" android:label="@string/app_name">
 ...
 </activity> 

「application」標籤中所有用到的Activity ，都要包含在一個個「activity」標籤中(備註2)。 Activity 是Android 應用程式與使用者互動的主要元素，當使用者開啟一個應用程式，第一個看到的畫面就是一個Activity。 若是一個應用程式中包含多個畫面時，會定義多個不同的Activity，我們也必須在「application」標籤中，使用多個「activity」標籤，為不同的Activity 新增描述。 如果我們已經在程式碼中定義好了Activity ，卻忘了在「AndroidManifest .xml」檔案中加入對應的「activity」標籤，那麼在執行中呼叫到這個Activity的時候，將無法開啟這個Activity。

「activity」標籤的「android:name」屬性，指出了這個Activity 所對應的類別(class)。 「activity」標籤中的「android:label」屬性可用來指定應用程式將顯示在Activity 畫面上方的名稱。 也可以在程式碼中透過「setTitle(“名稱”)」來動態修改。

因為在上一層「Manifest」標籤屬性中已經定義了「package="com.demo.android.bmi"」，因此在「activity」標籤的「android:name」屬性中，「.Bmi」代表著「com .demo.android.bmi.Bmi」的簡寫。 也可以寫成「Bmi」，一樣是代表「com.demo.android.bmi.Bmi」這個類別。

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

「intent-filter」標籤定義了這個「activity」的性質。 「intent-filter」中主要包含了兩個標籤：「action」跟「category」標籤。 「action」標籤中的「android:name」屬性，其內容「android.intent.action.MAIN」表示：這個Activity 是此應用程式的進入點（就像程式中常見的main 主程式），開啟這個應用程式時，應先執行這個Activity。 。 常見的還有「android.intent.action.EDIT」等標籤，會在之後章節用上的時候講解。 「category」標籤中的「android:name」屬性，其內容「android.intent.category.LAUNCHER」表示：這個Activity 將顯示在Launcher 的應用程式列表中。

我們把整個檔案合到一起看，可以總結出這個檔案所傳達的訊息：在「com.demo.android.bmi」路徑下的「Bmi.java」這個檔案中，已定義了一個主要的Activity; 當我們打​​開Android 的時候，顯示的是位於「res/drawable/icon」的圖示。 一旦我們按下圖示來啟動這個應用程式，Android 應用程式框架會去尋找到定義了「android.intent.action.MAIN」內容的「.Bmi」activity，並呼叫執行。

  <uses-sdk android:minSdkVersion="X" /> 

Android SDK 1.1 版之後引入了這條敘述，「X」代表了目標版本代號。 透過指定這個引數，系統可以依此辨別應用程式是否使用相容的SDK 版本，好決定能否在這臺機器上安裝執行。 這也是一個可選填的選項。 但如果我們的應用程式要釋出出去，一些強勢的通路如Google Android Market 已規定所有新發布的應用程式必須指定「android:minSdkVersion」這個引數。

各目標版本與代號對應表如下:

目標版本	代號
3.0	11
2.3.3	10
2.3	9
2.2	8
2.1	7
2.0.1	6
2.0	5
1.6	4
1.5	3
1.1	2
1.0	1

目前各版本佔有率可以參考官方的版本佔有率圖表： http://developer.android.com/resources/dashboard/platform-versions.html

這個圖表是根據最近2 周間連上Android Market 裝置的比率來繪製。

備註1

除了「application」標籤外，還有「uses-permission」(例如允不允許存取SMS、能否存取聯絡簿、相機功能)、「permission」、「instrumentation」等主要標籤。 相關的內容在後續章節用到時再一併解說。

備註2

除了「activity」標籤外，對應於Android 應用程式的運作流程，還有「service」、「receiver」、「provider」等主要元件。 相關內容會在後續章節提到時作解說。

參考資料

• Android manifest http://developer.android.com/reference/android/R.styleable.html#AndroidManifest
• Intent Action http://developer.android.com/reference/android/content/Intent.html