<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>
- 说明:
-
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>