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>