AndroidManifest.xml官方介紹

每個Android應用的根目錄中都必須包含一個 AndroidManifest.xml 文件。 清單文件爲 Android 系統提供有關您的應用的基本信息，系統必須獲得這些信息才能運行任意應用代碼。

此外，清單文件還可執行以下操作：

1,爲應用的 Java 軟件包命名。即：構成應用的 Activity、服務、廣播接收器和內容提供程序。

2,爲實現每個組件的類命名併發布其功能（例如，它們可以處理的 Intent 消息）。

3,聲明應用必須具備哪些權限才能訪問 API 中受保護的部分並與其他應用交互還聲明其他應用與該應用組件交互所需具備的權限列出

Instrumentation 類，這些類可在應用運行期間提供分析和其他信息等。文件內容及格式如下

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97

<?xmlversion="1.0"encoding="utf-8"?>   <!--<manifest>元素是必需的，必須存在並且只能出現一次&&除了根 <manifest> 元素的一些屬性外，所有屬性名稱均以 android: 前綴開頭，例如，android:alwaysRetainTaskState。由於該前綴是通用的，因此在按名稱引用屬性時，本文檔通常會將其忽略。-->   <manifest>   <!--權限 是一種限制，用於限制對部分代碼或設備上數據的訪問。 施加限制是爲了保護可能被誤用以致破壞或損害用戶體驗的關鍵數據和代碼。-->   <uses-permission/>   <permission/>   <!--<permission-tree> 元素爲一組將在代碼中定義的權限聲明命名空間。-->   <permission-tree/>   <!--<permission-group> 爲一組權限（包括在清單文件中使用 <permission> 元素聲明的權限以及在其他位置聲明的權限）定義標籤。-->   <permission-group/>   <instrumentation/>   <uses-sdk/>   <uses-configuration/>   <uses-feature/>   <supports-screens/>   <compatible-screens/>   <supports-gl-texture/>   <!--<application>元素也是必需的，必須存在並且只能出現一次-->   <application>   <!--同一級別的元素不分先後順序。例如，<activity>、<provider>、<receiver> 和 <service> 元素可以按任何順序混合在一起。-->   <activity>   <!--組件的所有屬性都是可選的。但是，有些屬性必須指定給元素以實現其目的。-->   <!--如果可以指定多個值，則幾乎總是在重複此元素，而不是列出單個元素內的多個值。如：<intent-filter . . . >   <action android:name="android.intent.action.EDIT" /> <action android:name="android.intent.action.INSERT" /> <action android:name="android.intent.action.DELETE" /> . . . </intent-filter>-->   <action/>   <category/>   <data/>   </intent-filter>   <meta-data/>   </activity>   <activity-alias>   <intent-filter> . . . </intent-filter>   <meta-data/>   </activity-alias>   <!--許多元素對應於 Java 對象，其中包括應用本身的元素（<application> 元素）及其主要組件 (<activity>)、服務 (<service>)、廣播接收器 (<receiver>) 以及內容提供程序 (<provider>)。   如果按照您針對組件類（Activity、Service、BroadcastReceiver 和 ContentProvider）幾乎一直採用的方式來定義子類，則該子類需通過 name 屬性來聲明。 該名稱必須包含完整的軟件包名稱。--> <pre> <service>  <intent-filter> . . . </intent-filter>  <meta-data/>  </service>   <receiver>  <intent-filter> . . . </intent-filter>  <meta-data/>  </receiver>   <provider>  <grant-uri-permission/>  <meta-data/>  <path-permission/>  </provider>   <uses-library/>   </application>   </manifest>

———–AndroidManifest.xml文件詳細約定 ———–

有些約定和規則普遍適用於清單文件中的所有元素和屬性：

元素

只有 <manifest> 和 <application> 元素是必需的，它們都必須存在並且只能出現一次。其他大部分元素可以出現多次或者根本不出現，即便清單文件中必須至少存在其中某些元素才能完成任何有意義的操作也是如此。

如果一個元素包含某些內容，也就包含其他元素。所有值均通過屬性進行設置，而不是通過元素內的字符數據設置。

同一級別的元素通常不分先後順序。例如，<activity>、<provider> 和 <service> 元素可以按任何順序混合在一起。 （<activity-alias> 元素不適用此規則： 它必須跟在別名所指的 <activity> 之後。）

屬性

從某種意義上說，所有屬性都是可選的。但是，有些屬性必須指定給元素以實現其目的。 請使用本文檔作爲參考。 對於真正可選的屬性，它將指定默認值或聲明缺乏規範時將執行何種操作。

除了根 <manifest> 元素的一些屬性外，所有屬性名稱均以 android: 前綴開頭，例如，android:alwaysRetainTaskState。由於該前綴是通用的，因此在按名稱引用屬性時，本文檔通常會將其忽略。

聲明類名

許多元素對應於 Java 對象，其中包括應用本身的元素（<application> 元素）及其主要組件 — Activity (<activity>)、服務 (<service>)、廣播接收器 (<receiver>) 以及內容提供程序 (<provider>)。

如果按照您針對組件類（Activity、Service、BroadcastReceiver 和 ContentProvider）幾乎一直採用的方式來定義子類，則該子類需通過 name 屬性來聲明。 該名稱必須包含完整的軟件包名稱。 例如，Service 子類可能會聲明如下：

1 2 3 4 5 6 7 8

<manifest. . . >      <application. . . >           <serviceandroid:name="com.example.project.SecretService". . . >                . . .           </service>           . . .      </application> </manifest>

但是，爲了簡便起見，如果字符串的第一個字符是句點，則字符串將追加到應用的軟件包名稱（正如 <manifest> 元素的 package 屬性中所指定）。 以下賦值與上述方法相同：

1 2 3 4 5 6 7 8

<manifestpackage="com.example.project". . . > <application. . . >      <serviceandroid:name=".SecretService". . . >          . . .      </service>       . . . </application> </manifest>

當啓動組件時，Android 會創建已命名子類的實例。如果未指定子類，則會創建基類的實例。

多個值

如果可以指定多個值，則幾乎總是在重複此元素，而不是列出單個元素內的多個值。 例如，Intent 過濾器可以列出多個操作：

1 2 3 4 5 6

<intent-filter. . . >       <actionandroid:name="android.intent.action.EDIT"/>       <actionandroid:name="android.intent.action.INSERT"/>       <actionandroid:name="android.intent.action.DELETE"/>        . . . </intent-filter>

資源值

某些屬性的值可以顯示給用戶，例如，Activity 的標籤和圖標。 這些屬性的值應該本地化，因此需要通過資源或主題進行設置。 資源值用以下格式表示：

@[package:]type:name

其中，如果資源與應用位於同一軟件包中，則可忽略 package 名稱； type 是資源類型，如“字串符”或“圖片”； name 是標識特定資源的名稱。例如：

<activity android:icon=”@drawable/smallPic” . . . >

主題中的值用類似的方法表示，但是以“?”開頭而不是“@”：

?[package:]type:name

字串符值

如果屬性值爲字串符，則必須使用雙反斜槓（“\\”） 轉義字符。例如，使用“\\n”表示換行符或使用“\\uxxxx”表示 Unicode 字符）。

文件功能

下文介紹如何在清單文件中利用某些 Android 特性。

Intent 過濾器

應用的核心組件（其 Activity、服務和廣播接收器）由 Intent 激活。Intent 是一系列用於描述所需操作的信息（Intent 對象），其中包括要執行操作的數據、應執行操作的組件類別以及其他相關說明。 Android 會找到合適的組件來響應 Intent，根據需要啓動組件的新實例，並將其傳遞到 Intent 對象。

組件將通過“Intent 過濾器”公佈其功能，即它們可響應的 Intent 類型。 由於 Android 系統在啓動某組件之前必須瞭解該組件可以處理哪些 Intent，因此 Intent 過濾器在清單文件中被指定爲 <intent-filter> 元素。 一個組件可能有任意數量的過濾器，其中每個過濾器描述一種不同的功能。

顯式命名目標組件的 Intent 將激活該組件；過濾器不起作用。但是，不按名稱指定目標的 Intent 只有在能夠通過組件的一個過濾器時纔可激活該組件。

有關如何根據 Intent 過濾器測試 Intent 對象的信息，請參閱單獨的文檔 Intent 和 Intent 過濾器。

圖標和標籤

對於可以顯示給用戶的小圖標和文本標籤，大量元素具有 icon 和 label 屬性。此外，對於同樣可以顯示在屏幕上的較長說明文本，某些元素還具有 description 屬性。例如，<permission> 元素具有所有這三個屬性。因此，當系統詢問用戶是否授權給請求獲得權限的應用時，權限圖標、權限名稱以及所需信息的說明均可呈現給用戶。

無論何種情況下，在包含元素中設置的圖標和標籤都將成爲所有容器子元素的默認 icon 和 label 設置。因此，在 <application> 元素中設置的圖標和標籤是每個應用組件的默認圖標和標籤。 同樣，爲組件（例如，<activity> 元素）設置的圖標和標籤是組件每個 <intent-filter> 元素的默認設置。 如果 <application> 元素設置標籤，但是 Activity 及其 Intent 過濾器不執行此操作，則應用標籤將被視爲 Activity 和 Intent 過濾器的標籤。

在實現 Intent 過濾器公佈的功能時，只要向用戶呈現組件，系統便會使用爲過濾器設置的圖標和標籤表示該組件。 例如，具有“android.intent.action.MAIN”和“android.intent.category.LAUNCHER”設置的過濾器將 Activity 公佈爲可啓動應用的功能，即，公佈爲應顯示在應用啓動器中的功能。 因此，在過濾器中設置的圖標和標籤就是顯示在啓動器中的圖標和標籤。

權限

權限 是一種限制，用於限制對部分代碼或設備上數據的訪問。 施加限制是爲了保護可能被誤用以致破壞或損害用戶體驗的關鍵數據和代碼。

每種權限均由一個唯一的標籤標識。標籤通常指示受限制的操作。 例如，以下是由 Android 定義的一些權限：

1 2 3 4

android.permission.CALL_EMERGENCY_NUMBERS android.permission.READ_OWNER_DATA android.permission.SET_WALLPAPER android.permission.DEVICE_POWER

一個功能最多隻能由一種權限保護。

如果應用需要訪問受權限保護的功能，則必須在清單文件中使用 <uses-permission> 元素聲明應用需要該權限。 但是，將應用安裝到設備上之後，安裝程序會通過檢查簽署應用證書的頒發機構並（在某些情況下）詢問用戶，確定是否授予請求的權限。 如果授予權限，則應用能夠使用受保護的功能。 否則，其訪問這些功能的嘗試將會失敗，並且不會向用戶發送任何通知。

此外，應用也可以使用權限保護自己的組件（Activity、服務、廣播接收器和內容提供程序）。 它可以採用由 Android 定義（如 android.Manifest.permission 中所列）或由其他應用聲明的任何權限。或者，它也可以定義自己的權限。新權限用 <permission> 元素來聲明。 例如，Activity 可受到如下保護：

1 2 3 4 5 6 7 8 9 10 11 12

<manifest. . . >       <permissionandroid:name="com.example.project.DEBIT_ACCT". . . />            <uses-permissionandroid:name="com.example.project.DEBIT_ACCT"/>            . . .       <application. . .>            <activityandroid:name="com.example.project.FreneticActivity"                 android:permission="com.example.project.DEBIT_ACCT"                  . . . >             . . .       </activity> </application> </manifest>

請注意，在此示例中，DEBIT_ACCT 權限不僅是通過 <permission> 元素來聲明，而且其使用也是通過 <uses-permission> 元素來請求。要讓應用的其他組件也能夠啓動受保護的 Activity，就必須請求其使用權限，即便保護是由應用本身施加的亦如此。

同樣還是在此示例中，如果將 permission 屬性設置爲在其他位置（例如，android.permission.CALL_EMERGENCY_NUMBERS）聲明的權限，則無需使用 <permission> 元素再次聲明。 但是，仍有必要通過 <uses-permission> 請求使用它。

<permission-tree> 元素爲一組將在代碼中定義的權限聲明命名空間。 同時， <permission-group> 爲一組權限（包括在清單文件中使用 <permission> 元素聲明的權限以及在其他位置聲明的權限）定義標籤。它隻影響如何對提供給用戶的權限進行分組。 <permission-group> 元素並不指定哪些權限屬於該組，而只是爲組提供名稱。 通過向 <permission> 元素的 permissionGroup 屬性分配組名，將權限放入組中。

庫

每個應用均鏈接到默認的 Android 庫，該庫中包括構建應用（以及通用類，如 Activity、服務、 Intent 、視圖、按鈕、應用、ContentProvider 等）的基本軟件包。

但是，某些軟件包駐留在自己的庫中。如果應用使用來自其中任一軟件包的代碼，則必須明確要求其鏈接到這些軟件包。 清單文件必須包含單獨的 <uses-library> 元素來命名其中每個庫。（庫名稱可在軟件包的文檔中找到。）

轉載請註明：Android開發中文站 » AndroidManifest.xml官方介紹