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>
时间: 2024-10-08 06:40:08

Android开发-API指南-<manifest>的相关文章

Android开发-API指南-&lt;application&gt;

<application> 英文原文:http://developer.android.com/guide/topics/manifest/application-element.html 采集(更新)日期:2014-5-30 更新下老的文档,祝贺下自己 42 岁的生日. 搬迁自原博客:http://blog.sina.com.cn/s/blog_48d491300100zmga.html 语法: <application android:allowTaskReparenting=[&q

Android开发-API指南-&lt;provider&gt;

<provider> 英文原文:http://developer.android.com/guide/topics/manifest/provider-element.html 采集(更新)日期:2014-7-1 搬迁自原博客:http://blog.sina.com.cn/s/blog_48d491300100zmv5.html 语法: <provider android:authorities="list" android:enabled=["true&

Android开发-API指南-&lt;uses-feature&gt;

<uses-feature> 英文原文:http://developer.android.com/guide/topics/manifest/uses-feature-element.html 采集(更新)日期:2014-7-7 搬迁自原博客:http://blog.sina.com.cn/s/blog_48d491300100zmwf.html 在本文中 Google Play 和基于设备特性的过滤机制 基于显式声明的特性需求进行过滤 基于隐含的特性需求进行过滤 对蓝牙特性的特殊处理 对应用

Android开发-API指南-应用程序开发基础

Application Fundamentals 英文原文:http://developer.android.com/guide/components/fundamentals.html 采集日期:2014-04-16 搬迁自原博客:http://blog.sina.com.cn/s/blog_48d491300101h41p.html 在本文中 应用程序组件 激活组件 Manifest 文件 声明组件 声明应用程序的需求 应用程序资源 Android 应用程序是用 Java 语言编写的.And

Android开发-API指南-&lt;compatible-screens&gt;

<compatible-screens> 英文原文:http://developer.android.com/guide/topics/manifest/compatible-screens-element.html 采集(更新)日期:2014-6-30 搬迁自原博客:http://blog.sina.com.cn/s/blog_48d491300100zmub.html 语法: <compatible-screens> <screen android:screenSize=

Android开发-API指南-任务和回退栈

Task 和 Back Stack 英文原文: http://developer.android.com/guide/components/tasks-and-back-stack.html 采集(更新)日期:2014-12-16 在本文中 保存 Activity 状态 管理多个 Task 指定启动模式 处理 affinity 清理回退栈k 启动任务 相关文章 Multitasking the Android Way 参阅 Android 设计 : 导航 <activity> manifest

【最后一篇API译文】Android开发-API指南- Contacts Provider

Contacts Provider 今年加入了某字幕组,加之杂事颇多,许久未添新文了,惭愧之极. 在听闻 Google 即将重返中国后,近日忽又发现官方网站正在放出 API 中文版,比如本文.当然不是大家所译,但至少句子结构较通顺,窃以为比 MSDN 中文版好些.虽有些生硬(比如将 Provider 译为“提供者”,有趣得紧),但好在前无古人,也许 Google 自此便统一了自己的中文术语也未可知.能让更多的国人精确领悟 Android 的精髓,肯定是好事,希望 Google 继续坚持. 这事应

Android开发-API指南-服务

Service 英文原文:http://developer.android.com/guide/components/services.html 采集(更新)日期:2014-12-23 原博客:http://blog.sina.com.cn/s/blog_48d49130010102pn.html 在本文中 概述 在manifest中声明服务 创建一个started服务 扩展IntentService类 扩展Service类 启动一个服务 终止一个服务 创建一个bound服务 向用户发送通知 在

Android开发-API指南-&lt;service&gt;

<service> 英文原文:http://developer.android.com/guide/topics/manifest/service-element.html 采集(更新)日期:2014-7-2 搬迁自原博客:http://blog.sina.com.cn/s/blog_48d491300100zmva.html 语法: <service android:enabled=["true" | "false"] android:expor

Android开发-API指南-&lt;receiver&gt;

<receiver> 英文原文:http://developer.android.com/guide/topics/manifest/receiver-element.html 采集(更新)日期:2014-7-2 搬迁自原博客:http://blog.sina.com.cn/s/blog_48d491300100zmv7.html 语法: <receiver android:enabled=["true" | "false"] android:ex