Android开发-API指南-<manifest>

<manifest>

英文原文：http://developer.android.com/guide/topics/manifest/manifest-element.html
采集（更新）日期：2014-5-30
搬迁自原博客：http://blog.sina.com.cn/s/blog_48d491300100zmum.html

语法：

<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>

包含于：

无

必须包含：

<application>

可包含：

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

说明：

AndroidManifest.xml 文件的根元素。 必须包含 <application> 元素且设定 xmlns:android 和 package 属性。

属性：

xmlns:android

定义 Android 命名空间。 应该确保本属性值为“http://schemas.android.com/apk/res/android”。

package

为应用程序指定 Java 语言风格的完整包名称。名称必须唯一。 名称中可以包含大小写字母（'A'到'Z')、数字和下划线（'_'）。 不过，包名称中的每个部分只能以字母开头。

为了避免与其他开发人员起名的冲突，应该用自己拥有的 Internet 域名作为包名称的基础部分（顺序颠倒）。 例如，Google 发布的应用程序就以 com.google 开头。 绝不要在发布应用时使用 com.example 作为命名空间。

包名将用作应用程序的唯一标识。 同时它也是应用程序进程的默认名称（参阅 <application>元素的 process 属性）和 Activity 默认任务的 Affinity 名称（参阅 <activity> 元素的 taskAffinity属性）。

提醒： 应用程序一经发布，包名称就不允许再更改了。 包名称定义了应用程序的标识，如果修改了包名称，就意味着变成了另一个应用程序，旧版本的用户就不能再更新了。

android:sharedUserId

要与其它应用程序共享的 Linux 用户ID。 默认情况下，Android 将为每个应用程序分配唯一的用户 ID。 不过，如果将两个以上应用程序的本属性设置为同一个值，则这些程序将共享同一个 ID — 它们将用同一个证书进行签名。 拥有相同用户 ID 的多个应用程序可以相互访问数据，如果需要的话还可以运行于同一个进程中。

android:sharedUserLabel

供用户阅读的共享用户 ID 的文字标签。 本属性必须设为对字符串资源的引用，不能直接设为字符串。

本属性自 API 级别 3 开始引入。仅当同时设置了 sharedUserId 属性后才会生效。

android:versionCode

内部版本号。本数字仅用于确定版本的新旧程度，数字越大代表版本越新。 这不是显示给用户看的版本号，那个版本号是由 versionName 属性设置的。

本属性值必须设为整数值，比如“100”。 你可以将其设为任意大小的值，只要每个后续版本的值都比之前的大即可。 比如可以设为 bulid 版本号。 或者可以把“x.y”格式的版本号转换为整数，把“x”和“y”分别作为低16位和高16位编码即可。 或者也可以只是在每次发布新版本时简单地将其加1。

android:versionName

供用户查看的版本号。 本属性可直接设为字符串或者设为对字符串资源的引用。 除了显示给用户查看以外，此字符串没有其他任何意义。 versionCode 属性才保存了内部使用的真正的版本号。

android:installLocation

应用程序的默认安装位置。

仅接受以下关键字：

值	说明
"internalOnly"	应用程序必须安装在内部存储中。如果设为此值，则应用程序绝不会安装到外部存储上去。 如果内部存储满了，系统就无法安装程序。 这也是未定义 android:installLocation 时的默认设置。
"auto"	应用程序可以安装到外部存储中，但默认系统会首先在内部存储中安装。 如果内部存储空间不足，系统才会将其安装到外部存储上。 一旦安装完毕，用户就可以通过系统设置将程序自由转移到内部或外部存储上。
"preferExternal"	应用程序最好是安装到外部存储中（SD卡）。 系统不能保证每次都会成功。 如果外部存储介质不可用或者没有空间，那么应用程序可能还会安装到内部存储中。 一旦安装完毕，用户可以通过系统设置将程序自由转移到内部或外部存储上。

注意： 默认情况下，应用程序将会安装到内部存储中去。 仅当定义了属性“auto”或“preferExternal”时，才可能会安装到外部存储中。

如果应用程序安装于外部存储中：

• .apk 文件将保存在外部存储中，但应用程序的数据（比如数据库）仍然保存于设备内部存储中的。
• .apk 文件的保存容器是用密钥加密过的，只允许应用程序在安装设备上进行访问。 （即使把SD卡换到其他设备上，用户也无法使用装在卡上的应用程序。） 不过，在同一个设备上是可以使用多张SD卡的。
• 在用户需要时，应用程序可以转移到内部存储中去。

用户也可以要求把应用程序从内部存储转移到外部存储中去。 但是本属性的默认设置是 internalOnly，这时系统不允许用户把应用程序转移到外部存储。

关于使用本属性的详情，请参阅应用程序安装位置 （包括如何保持向后兼容性）。

引入自 API 级别 8。

引入自：

均为 API 级别 1，属性说明中特别注明的除外。

参阅：

<application>