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

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

AndroidManifest是什麼?

AndroidManifest官方解釋是應用清單（manifest意思是貨單），每個應用的根目錄中都必須包含一個，並且文件名必須一模一樣。這個文件中包含了APP的配置信息，系統需要根據裡面的內容運行APP的代碼，顯示界面。

AndroidManifest的作用是什麼？

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

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

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

一份真實的AndroidManifest.xml文件

<code><manifest>          package="com.sample.teapot"
          android:versionCode="1"
          android:versionName="1.0.0.1" >

  <uses-feature>

  <application>      android:allowBackup="false"
      android:fullBackupContent="false"
      android:supportsRtl="true"
      android:icon="@mipmap/ic_launcher"
      android:label="@string/app_name"
      android:theme="@style/AppTheme"
      android:name="com.sample.teapot.TeapotApplication"
      >

    
    <activity>              android:label="@string/app_name"
              android:configChanges="orientation|keyboardHidden">
      
            <intent-filter>
        <action>
        <category>
      /<intent-filter> 

    /<meta-data>/<activity>
  /<application>
/<manifest>
/<code>

這是Google官方示例中的teapots項目中的一個文件，我們就針對這份文件來分析字段的意義。字段的意義參考的是官方文檔。

<manifest>元素/<manifest>

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

<manifest>元素中的屬性/<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>，完整的類名就是com.sample.teapot.MainActivity。/<activity>

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

android:versionCode

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

android:versionName

顯示給用戶看的版本號。

<manifest>元素中的元素/<manifest>

<uses-feature>元素/<uses-feature>

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

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

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

<code><uses-feature>
<uses-feature>
/<code>

<uses-feature>的屬性/<uses-feature>

android:name

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

android:required

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

android:glEsVersion

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

<application>元素/<application>

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

<application>的屬性/<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（Activity類子類）。這是<application>元素中必要的子元素。所有Activity都必須由清單文件中的<activity>元素表示。任何未在該處聲明的Activity對系統都不可見，並且永遠不會被執行。/<activity>/<application>

android:name

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

沒有默認值，必須指定該名稱。

android:label

Activity標籤，可以被用戶讀取。該標籤會在Activity激活時顯示在屏幕上。如果未設置，用<application>中的label屬性。對屬性的設置要求和<application>中一樣。/<application>/<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類似。/<application>

<meta-data>元素/<meta-data>

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

該元素有三個屬性：

android:name

數據項名稱，這是一個唯一值。

android:resource

一個資源的引用。

android:value

數據項的值。

<intent-filter>元素/<intent-filter>

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

<action>元素/<action>

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

<category>元素/<category>

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

總結

至此，所有的元素信息已經分析完畢，如有錯誤，歡迎各位讀者指正。後面再遇到什麼元素會繼續往裡面添加。

閱讀更多 linux內核 的文章

關鍵字: Android 詳解 一知半解