語(yǔ)法：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
              package="string"
              android:sharedUserId="string"
              android:sharedUserLabel="string resource" 
              android:versionCode="integer"
              android:versionName="string"
              android:installLocation=["auto" | "internalOnly" | "preferExternal"] >
        . . .
    </manifest>

 

包含于：

無(wú)

必須包含：

<application>

可包含：

<compatible-screens>
<instrumentation>
<permission>
<permission-group>
<permission-tree>
<supports-gl-texture>
<supports-screens>
<uses-configuration>
<uses-feature>
<uses-permission>
<uses-permission-sdk-23>
<uses-sdk>

說(shuō)明：

AndroidManifest.xml 文件的根元素。它必須包含 <application> 元素并指定 xmlns:android 和 package 屬性。

屬性：

xmlns:android

定義 Android 命名空間。此屬性應(yīng)始終設(shè)置為“http://schemas.android.com/apk/res/android”。

package

Android 應(yīng)用的 Java 語(yǔ)言樣式的完整軟件包名稱(chēng)。此名稱(chēng)可以包含大寫(xiě)或小寫(xiě)字母（從“A”到“Z”）、數(shù)字和下劃線(xiàn)（“_”）。不過(guò)，各個(gè)軟件包名稱(chēng)部分只能以字母開(kāi)頭。

將應(yīng)用構(gòu)建為應(yīng)用軟件包 (APK) 時(shí)，構(gòu)建系統(tǒng)使用 package 屬性執(zhí)行以下兩個(gè)操作：

• 它將此名稱(chēng)用作應(yīng)用生成的 R.java 類(lèi)（用于訪(fǎng)問(wèn)應(yīng)用資源）的命名空間。

  例如，如果將 package 設(shè)置為 "com.example.myapp"，則 R 類(lèi)在 com.example.myapp.R 處創(chuàng)建。

• 它使用此名稱(chēng)解析清單文件中聲明的任何相關(guān)類(lèi)名稱(chēng)。

  例如，如果將 package 設(shè)置為 "com.example.myapp"，則聲明為 <activity android:name=".MainActivity"> 的 Activity 會(huì)解析為 com.example.myapp.MainActivity。

此名稱(chēng)不僅是應(yīng)用進(jìn)程的默認(rèn)名稱(chēng)（請(qǐng)參閱 <application> 元素的 process 屬性），還是您的 Activity 的默認(rèn)任務(wù)相關(guān)性（請(qǐng)參閱 <activity> 元素的 taskAffinity 屬性）。

此名稱(chēng)還表示應(yīng)用 ID，該 ID 必須是通用唯一 ID，您才能在 Google Play 中發(fā)布應(yīng)用。不過(guò)，在 APK 構(gòu)建流程快要結(jié)束時(shí)，構(gòu)建工具會(huì)使用 build.gradle 文件（Android Studio 項(xiàng)目使用的文件）中的 applicationId 屬性替換 package 名稱(chēng)。您只要確保清單的 package 名稱(chēng)與構(gòu)建文件的 applicationId 保持一致，就無(wú)需擔(dān)心。但如果這兩個(gè)值不同，您應(yīng)該閱讀如何設(shè)置應(yīng)用 ID，了解“軟件包名稱(chēng)”和“應(yīng)用 ID”之間的區(qū)別。

為避免與其他開(kāi)發(fā)者發(fā)生沖突，您應(yīng)將互聯(lián)網(wǎng)域名所有者（反過(guò)來(lái)）用作軟件包名稱(chēng)的前綴。例如，由 Google 發(fā)布的應(yīng)用以 com.google 開(kāi)頭。

注意：Google Play 禁止使用 com.example 和 com.android 命名空間。

如果您想在發(fā)布應(yīng)用后更改軟件包名稱(chēng)，可以這樣做，但您必須保持 applicationId 不變。applicationId 定義了應(yīng)用在 Google Play 上的唯一身份。因此，如果您對(duì)其進(jìn)行更改，則該 APK 就會(huì)被視為其他應(yīng)用，而且使用之前版本的用戶(hù)將不會(huì)收到更新。如需了解詳情，請(qǐng)參閱如何設(shè)置應(yīng)用 ID。

android:sharedUserId

API 級(jí)別 29 中已棄用此常量。
共享用戶(hù) ID 會(huì)在軟件包管理器中導(dǎo)致具有不確定性的行為。因此，強(qiáng)烈建議您不要使用它，并且我們?cè)谖磥?lái)的 Android 版本中會(huì)將其移除。相反，應(yīng)用應(yīng)使用適當(dāng)?shù)耐ㄐ艡C(jī)制（例如服務(wù)和內(nèi)容提供程序），在共享組件之間實(shí)現(xiàn)互操作性。

與其他應(yīng)用共享的 Linux 用戶(hù) ID 的名稱(chēng)。默認(rèn)情況下，Android 會(huì)為每個(gè)應(yīng)用分配其唯一用戶(hù) ID。不過(guò)，如果針對(duì)兩個(gè)或多個(gè)應(yīng)用將此屬性設(shè)置為相同的值，則這些應(yīng)用都將共享相同的 ID，前提是這些應(yīng)用的證書(shū)集完全相同。具有相同用戶(hù) ID 的應(yīng)用可以訪(fǎng)問(wèn)彼此的數(shù)據(jù)，如果需要的話(huà)，還可以在同一進(jìn)程中運(yùn)行。

android:targetSandboxVersion

此應(yīng)用要使用的目標(biāo)沙盒。沙盒版本號(hào)越高，安全級(jí)別就越高。其默認(rèn)值為 1；您也可以將其設(shè)置為 2。將此屬性設(shè)置為 2 可將應(yīng)用切換到其他 SELinux 沙盒。

以下限制適用于 2 級(jí)沙盒：

• 網(wǎng)絡(luò)安全配置中的 usesCleartextTraffic 的默認(rèn)值為 false。
• 不允許共享 uid。

對(duì)于以 Android 8.0（API 級(jí)別 26）或更高版本為目標(biāo)平臺(tái)的 Android 免安裝應(yīng)用，此屬性必須設(shè)置為 2。您可以在應(yīng)用的已安裝版本中將沙盒級(jí)別設(shè)置為限制比較寬松的級(jí)別 1，但如果這樣做，您的應(yīng)用就不會(huì)將免安裝應(yīng)用中的應(yīng)用數(shù)據(jù)保留到應(yīng)用的已安裝版本。您必須將已安裝應(yīng)用的沙盒值設(shè)置為 2，才能將免安裝應(yīng)用中的數(shù)據(jù)保留到已安裝版本。

應(yīng)用安裝后，您只能將其目標(biāo)沙盒值更新為更高的值。要對(duì)目標(biāo)沙盒值進(jìn)行降級(jí)，您必須卸載該應(yīng)用，并將其替換為其清單包含此屬性的更低值的版本。

android:sharedUserLabel

API 級(jí)別 29 中已棄用此常量。
共享用戶(hù) ID 會(huì)在軟件包管理器中導(dǎo)致具有不確定性的行為。因此，強(qiáng)烈建議您不要使用它，并且我們?cè)谖磥?lái)的 Android 版本中會(huì)將其移除。相反，應(yīng)用應(yīng)使用適當(dāng)?shù)耐ㄐ艡C(jī)制（例如服務(wù)和內(nèi)容提供程序），在共享組件之間實(shí)現(xiàn)互操作性。

共享用戶(hù) ID 的用戶(hù)可讀標(biāo)簽。此標(biāo)簽必須設(shè)置為對(duì)字符串資源的引用；它不能是原始字符串。

此屬性在 API 級(jí)別 3 中引入。僅當(dāng)同時(shí)設(shè)置了 sharedUserId 屬性時(shí)，此屬性才有意義。

android:versionCode

內(nèi)部版本號(hào)。此數(shù)字僅用于確定某個(gè)版本是否比另一個(gè)版本更新：數(shù)字越大，則版本越新。這不是向用戶(hù)顯示的版本號(hào)；此數(shù)字由 versionName 屬性設(shè)置。

該值必須設(shè)置為整數(shù)，例如“100”。您可以根據(jù)需要定義該值，只要每個(gè)連續(xù)版本的數(shù)字都比較大。例如，它可以是版本號(hào)。或者，您可以通過(guò)分別以較低和較高的 16 位對(duì)“x”和“y”進(jìn)行編碼，將“x.y”格式的版本號(hào)轉(zhuǎn)換為整數(shù)。或者，您只需在每次發(fā)布新版本時(shí)將該數(shù)字增加 1 即可。

android:versionName

向用戶(hù)顯示的版本號(hào)。此屬性可設(shè)置為原始字符串或?qū)ψ址Y源的引用。除了向用戶(hù)顯示之外，該字符串沒(méi)有其他用途。versionCode 屬性包含在內(nèi)部使用的重要版本號(hào)。

android:installLocation

應(yīng)用的默認(rèn)安裝位置。

接受以下關(guān)鍵字字符串：

值	說(shuō)明
“internalOnly”	應(yīng)用必須僅安裝在內(nèi)部設(shè)備存儲(chǔ)空間中。如果設(shè)置此值，則應(yīng)用一定不會(huì)安裝在外部存儲(chǔ)空間中。如果內(nèi)部存儲(chǔ)空間已滿(mǎn)，則系統(tǒng)將不會(huì)安裝應(yīng)用。如果您沒(méi)有定義 android:installLocation，則這也是默認(rèn)行為。
“auto”	應(yīng)用可以安裝在外部存儲(chǔ)空間中，但默認(rèn)情況下，系統(tǒng)會(huì)將應(yīng)用安裝在內(nèi)部存儲(chǔ)空間中。如果內(nèi)部存儲(chǔ)空間已滿(mǎn)，系統(tǒng)會(huì)將應(yīng)用安裝在外部存儲(chǔ)空間中。安裝后，用戶(hù)可以通過(guò)系統(tǒng)設(shè)置將應(yīng)用移至內(nèi)部或外部存儲(chǔ)空間。
“preferExternal”	應(yīng)用更傾向于安裝在外部存儲(chǔ)空間（SD 卡）中。無(wú)法保證系統(tǒng)會(huì)遵循該請(qǐng)求。如果外部媒體不可用或已滿(mǎn)，則應(yīng)用可能會(huì)安裝在內(nèi)部存儲(chǔ)空間中。安裝后，用戶(hù)可以通過(guò)系統(tǒng)設(shè)置將應(yīng)用移至內(nèi)部或外部存儲(chǔ)空間。

注意：默認(rèn)情況下，您的應(yīng)用將安裝在內(nèi)部存儲(chǔ)空間中，除非您將此屬性定義為“auto”或“preferExternal”，否則應(yīng)用不會(huì)安裝在外部存儲(chǔ)空間中。

應(yīng)用安裝在外部存儲(chǔ)空間中時(shí)：

• .apk 文件保存到外部存儲(chǔ)空間，但所有應(yīng)用數(shù)據(jù)（如數(shù)據(jù)庫(kù)）仍保存在內(nèi)部設(shè)備內(nèi)存中。
• 用于保存 .apk 文件的容器使用密鑰進(jìn)行加密，該密鑰可讓?xiě)?yīng)用僅在安裝它的設(shè)備上運(yùn)行。（用戶(hù)無(wú)法將 SD 卡轉(zhuǎn)移到其他設(shè)備并使用該卡上安裝的應(yīng)用。）不過(guò)，同一設(shè)備可以使用多個(gè) SD 卡。
• 根據(jù)用戶(hù)的請(qǐng)求，應(yīng)用可以移至內(nèi)部存儲(chǔ)空間。

用戶(hù)還可以請(qǐng)求將應(yīng)用從內(nèi)部存儲(chǔ)空間移至外部存儲(chǔ)空間。不過(guò)，如果此屬性設(shè)置為 internalOnly（默認(rèn)設(shè)置），系統(tǒng)將不允許用戶(hù)將應(yīng)用移至外部存儲(chǔ)空間。

如需詳細(xì)了解如何使用此屬性（包括如何保持向后兼容性），請(qǐng)閱讀應(yīng)用安裝位置。

 

<meta-data>