我們在進行APP開發的時候都會遇到一個檔案：AndroidManifest.xml。從剛開始進行Android開發，到現在已經過去了幾個月，還是對這個檔案一知半解，只知道它是配置用的。但是這檔案裡的東西具體有什麼用，該怎麼用一直都沒有理解。藉著做專案的機會，仔細研究一下這個檔案。

研究AndroidManifest.xml最好的方式自然就是對照著官方文件詳細理解專案中每個欄位的作用，並且做出一些修改來驗證。

AndroidManifest是什麼?

AndroidManifest官方解釋是應用清單（manifest意思是貨單），每個應用的根目錄中都必須包含一個，並且檔名必須一模一樣。這個檔案中包含了APP的配置資訊，系統需要根據裡面的內容執行APP的程式碼，顯示介面。

AndroidManifest的作用是什麼？

上述的功能是非常籠統的解釋，具體到細節就是：

為應用的 Java 軟體包命名。軟體包名稱充當應用的唯一識別符號。描述應用的各個元件，包括構成應用的 Activity、服務、廣播接收器和內容提供程式。它還為實現每個元件的類命名併發布其功能，例如它們可以處理的 Intent 訊息。這些宣告向 Android 系統告知有關元件以及可以啟動這些元件的條件的資訊。確定託管應用元件的程序。宣告應用必須具備哪些許可權才能訪問 API 中受保護的部分並與其他應用互動。還宣告其他應用與該應用元件互動所需具備的許可權列出 Instrumentation類，這些類可在應用執行時提供分析和其他資訊。這些宣告只會在應用處於開發階段時出現在清單中，在應用釋出之前將移除。宣告應用所需的最低 Android API 級別列出應用必須連結到的庫

上面是官方的解釋。很多東西筆者現在還不能理解，也沒有用到，先挑筆者理解的進行解釋。

<manifest>元素

首先，所有的xml都必須包含<manifest>元素。這是檔案的根節點。它必須要包含<application>元素，並且指明xmlns:android和package屬性。

<manifest>元素中的屬性

xmlns:android

這個屬性定義了Android名稱空間。必須設定成"http://schemas.android.com/apk/res/android"。不要手動修改。

package

這是一個完整的Java語言風格包名。包名由英文字母（大小寫均可）、數字和下劃線組成。每個獨立的名字必須以字母開頭。

構建APK的時候，構建系統使用這個屬性來做兩件事：

1、生成R.java類時用這個名字作為名稱空間（用於訪問APP的資源）

比如：package被設定成com.sample.teapot，那麼生成的R類就是：com.sample.teapot.R

2、用來生成在manifest檔案中定義的類的完整類名。比如package被設定成com.sample.teapot，並且activity元素被宣告成<activity android:name=".MainActivity">，完整的類名就是com.sample.teapot.MainActivity。

包名也代表著唯一的application ID，用來發布應用。但是，要注意的一點是：在APK構建過程的最後一步，package名會被build.gradle檔案中的applicationId屬性取代。如果這兩個屬性值一樣，那麼萬事大吉，如果不一樣，那就要小心了。

android:versionCode

內部的版本號。用來表明哪個版本更新。這個數字不會顯示給使用者。顯示給使用者的是versionName。這個數字必須是整數。不能用16進位制，也就是說不接受"0x1"這種引數

android:versionName

顯示給使用者看的版本號。

<manifest>元素中的元素<uses-feature>元素

Google Play利用這個元素的值從不符合應用需要的裝置上將應用過濾。

這東西的作用是將APP所依賴的硬體或者軟體條件告訴別人。它說明了APP的哪些功能可以隨裝置的變化而變化。

使用的時候要注意，必須在單獨的<uses-feature>元素中指定每個功能，如果要多個功能，需要多個<uses-feture>元素。比如要求裝置同時具有藍芽和相機功能：

<uses-feature android:name="android.hardware.bluetooth" /><uses-feature android:name="android.hardware.camera" /><uses-feature>的屬性

android:name

該屬性以字串形式指定了APP要用的硬體或軟體功能。

android:required

這項屬性如果值為true表示需要這項功能否則應用無法工作，如果為false表示應用在必要時會使用該功能，但是如果沒有此功能應用也能工作。

android:glEsVersion

指明應用需要的Opengl ES版本。高16位表示主版本號，低16位表示次版本號。例如，如果是要3.2的版本，就是0x00030002。如果定義多個glEsVersion，應用會自動啟用最高的設定。

<application>元素

此元素描述了應用的配置。這是一個必備的元素，它包含了很多子元素來描述應用的元件，它的屬性影響到所有的子元件。許多屬性（例如icon、label、permission、process、taskAffinity和allowTaskReparenting）都可以設定成預設值。

<application>的屬性

android:allowBackup

表示是否允許APP加入到備份還原的結構中。如果設定成false，那麼應用就不會備份還原。預設值為true。

android:fullBackupContent

這個屬性指向了一個xml檔案，該檔案中包含了在進行自動備份時的完全備份規則。這些規則定義了哪些檔案需要備份。此屬性是一個可選屬性。預設情況下，自動備份包含了大部分app檔案。

android:supportsRtl

宣告你的APP是否支援RTL（Right To Left）佈局。如果設定成true，並且targetSdkVersion被設定成17或更高。很多RTL API會被集火，這樣你的應用就可以顯示RTL佈局了。如果設定成false或者targetSdkVersion被設定成16或更低。哪些RTL API就不起作用了。

該屬性的預設的值是false。

android:icon

APP的圖示，以及每個元件的預設圖示。可以在組價中自定義圖示。這個屬性必須設定成一個引用，指向一個可繪製的資源，這個資源必須包含圖片。系統不設定預設圖示。例如mipmap/ic_launcher引用的就是下面的資源

android:label

一個使用者可讀的標籤，以及所有元件的預設標籤。子元件可以用他們的label屬性定義自己的標籤，如果沒有定義，那麼就用這個標籤。

標籤必須設定成一個字串資源的引用。這樣它們就能和其他東西一樣被定位，比如@string/app_name。當然，為了開發方便，你也可以定義一個原始字串。

android:theme

該屬性定義了應用使用的主題的，它是一個指向style資源的引用。各個activity也可以用自己的theme屬性設定自己的主題。

android:name

Application子類的全名。包括前面的路徑。例如com.sample.teapot.TeapotApplication。當應用啟動時，這個類的例項被第一個建立。這個屬性是可選的，大多數APP都不需要這個屬性。在沒有這個屬性的時候，Android會啟動一個Application類的例項。

<activity>元素

該元素宣告一個實現應用視覺化介面的Activity（Activity類子類）。這是<application>元素中必要的子元素。所有Activity都必須由清單檔案中的<activity>元素表示。任何未在該處宣告的Activity對系統都不可見，並且永遠不會被執行。

android:name

Activity類的名稱，是Activity類的子類。該屬性值為完全限定類名稱，例如com.sample.teapot.TeapotNativeActivity。為了方便起見，如果第一個字元是點（'.'），就需要加上<manifest>元素中的包名。應用一旦釋出，不應更改該名稱。

沒有預設值，必須指定該名稱。

android:label

Activity標籤，可以被使用者讀取。該標籤會在Activity啟用時顯示在螢幕上。如果未設定，用<application>中的label屬性。對屬性的設定要求和<application>中一樣。

android:configChanges

列出 Activity 將自行處理的配置更改訊息。在執行時發生配置更改時，預設情況下會關閉 Activity 然後將其重新啟動，但使用該屬性宣告配置將阻止 Activity 重新啟動。 Activity 反而會保持執行狀態，並且系統會呼叫其 onConfigurationChanged()方法。

注：應避免使用該屬性，並且只應在萬不得已的情況下使用。 如需了解有關如何正確處理配置更改所致重新啟動的詳細資訊，請閱讀處理執行時變更。

這屬性可以設定的項很多，這裡列出常用的項：

orientation

螢幕放心啊發生了變化，比如使用者旋轉了裝置

keyboardHidden

鍵盤無障礙功能發生了變化，比如使用者顯示了硬體鍵盤

android:launchMode

關於如何啟動Activity的指令。一共有四種指令：

“standard”“singleTop”“singleTask”“singleInstance” 預設情況下是standard。這些模式被分為兩大類："standard"和"singleTop"是一類。該模式的Activity可以多次例項化。例項可屬於任何任務，並且可以位於Activity堆疊中的任何位置。"singleTask"和"singleInstance"是一類。該模式只能啟動任務，它們始終位於Activity堆疊的根位置。此外，裝置一次只能保留一個Activity例項。 設定成singleTask後，系統在新任務的根位置建立Activity並向其傳送Intent。如果已經存在一個Activity例項，則系統會通過呼叫該例項的onNewIntent()方法向其傳送Intent而不是建立一個新的Activity例項。 android:theme 設定主題格式，與<application>中的theme類似。

<meta-data>元素

指定額外的資料項，該資料項是一個name-value對，提供給其父元件。這些資料會組成一個Bundle物件，可以由PackageItemInfo.metaData欄位使用。雖然可以使用多個<meta-data>元素標籤，但是不推薦這麼使用。如果有多個數據項要指定，推薦做法是：將多個數據項合併成一個資源，然後使用一個<meta-data>包含進去。

該元素有三個屬性：

android:name

資料項名稱，這是一個唯一值。

android:resource

一個資源的引用。

android:value

資料項的值。

<intent-filter>元素

指明這個activity可以以什麼樣的意圖(intent)啟動。該元素有幾個子元素可以包含。我們先介紹遇到的這兩個：

<action>元素

表示activity作為一個什麼動作啟動，android.intent.action.MAIN表示作為主activity啟動。

<category>元素

這是action元素的額外類別資訊，android.intent.category.LAUNCHER表示這個activity為當前應用程式優先順序最高的Activity。