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:androidpackage 属性。
属性:
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>

posted on 2014-12-22 16:31  呆呆大虾  阅读(1475)  评论(0编辑  收藏  举报

导航