码迷,mamicode.com
首页 > 移动开发 > 详细

Android开发-API指南-<application>

时间:2014-12-22 14:15:56      阅读:276      评论:0      收藏:0      [点我收藏+]

标签:

<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=["true" | "false"]
             android:allowBackup=["true" | "false"]
             android:backupAgent="string"
             android:debuggable=["true" | "false"]
             android:description="string resource"
             android:enabled=["true" | "false"]
             android:hasCode=["true" | "false"]
             android:hardwareAccelerated=["true" | "false"]
             android:icon="drawable resource"
             android:killAfterRestore=["true" | "false"]
             android:largeHeap=["true" | "false"]
             android:label="string resource"
             android:logo="drawable resource"
             android:manageSpaceActivity="string"
             android:name="string"
             android:permission="string"
             android:persistent=["true" | "false"]
             android:process="string"
             android:restoreAnyVersion=["true" | "false"]
             android:requiredAccountType="string"
             android:restrictedAccountType="string"
             android:supportsRtl=["true" | "false"]
             android:taskAffinity="string"
             android:testOnly=["true" | "false"]
             android:theme="resource or theme"
             android:uiOptions=["none" | "splitActionBarWhenNarrow"]
             android:vmSafeMode=["true" | "false"] >
    . . .
</application>
包含于:
<manifest>
可包含:
<activity>
<activity-alias>
<meta-data>
<service>
<receiver>
<provider>
<uses-library>
说明:
对应用程序的声明。 本元素包含了声明每个程序组件的子元素,及作用于全部组件的属性。 很多属性(比如 iconlabelpermissionprocesstaskAffinityallowTaskReparenting) 设置了组件元素中对应属性的默认值。 其他属性(比如 debuggableenableddescriptionallowClearUserData)则设置了应用程序的全局属性值,且不能被组件的属性值覆盖。
属性:
android:allowTaskReparenting
当具有相同 affinity 名称的 Task 即将返回前台时,应用程序的 Activity 是否能从启动时的 Task 转移至此 Task 中去 — “ true”表示可以移动,“false”表示必须留在启动时的 Task 中, 缺省值是“false”。

<activity> 元素拥有自己的 allowTaskReparenting 属性,它可以覆盖本值。 详情请参阅其说明。

android:allowbackup
是否允许应用程序参加备份和恢复机制。 如果本属性设为 false ,则不会执行应用程序的备份和恢复,即使是在进行全系统的备份时也不会。 备份机制将会把应用程序的所有数据都通过 adb 保存下来。 本属性的默认值是 true。
android:backupAgent
实现应用程序备份代理的类名,这是 BackupAgent 的子类。本属性值应为完全限定的类名(比如“com.example.project.MyBackupAgent”)。 不过作为简称,如果名称的首字符是句点(比如“.MyBackupAgent”),则 <manifest> 元素中设置的包名称将会自动加到前面。

没有默认值,必须指定名称。

 

android:debuggable
应用程序能否被调试,即便是以用户模式运行于设备中时 — “true”表示可以,“false”表示不允许。

默认值是“false”。

android:description
供用户阅读的应用程序描述信息,比 label 的内容更多也更详细。 本属性值必须设为对字符串资源的引用。 与 label 不同,本属性不能直接设为字符串。

没有默认值。

android:enabled
Android 系统能否实例化应用程序中的各组件 — “true”表示可以,“false”表示不允许。 如果此值设为“true”,则由每个组件的 enabled 属性确定自身的启用或禁用。 如果此值设为“false”,则覆盖组件的设置值;所有组件都将被禁用。

默认值是“true”。

android:hasCode
应用程序是否包含代码 — “true”表示包含,“false”表示不包含。 如果此值设为“false”,则在启动组件时系统不会试图装载任何程序代码。 默认值是“true”。

应用程序不包含任何自有代码的情况极少发生。 仅当只用到了内置的组件类时才有可能,比如使用了 AliasActivity 类的 Activity。

android:hardwareAccelerated
是否为应用程序中所有的 Activity 和 View 启用硬件加速渲染功能 —“true”表示开启,“false”表示关闭。 如果 minSdkVersiontargetSdkVersion 的值大于等于“14”,则本属性默认值是“true”。否则,默认值为“false”。

自 Android 3.0 (API 级别 11)开始,应用程序可以使用硬件加速的 OpenGL 渲染功能来提高很多常用 2D 图形操作的性能。 当开启硬件加速渲染功能时,大部分 Canvas、Paint、Xfermode、ColorFilter、Shader 和 Camera 中的操作都会被加速。 即便应用程序没有显式地调用系统的 OpenGL 库,这仍能使动画更加平滑、屏幕滚动也更加流畅、整体响应速度获得改善。

请注意,并非所有的 OpenGL 2D 操作都会被加速。 如果开启了硬件加速渲染功能,请对应用程序进行测试以确保使用渲染时不会出错。

更多信息,请参阅硬件加速指南。

android:icon
代表整个应用程序的图标,也即应用程序中每个组件的默认图标。 请参阅 <activity><activity-alias> 、<service> 、<receiver> 和 <provider> 元素各自的icon属性。

本属性必须设为对 drawable 资源的引用(例如“ @drawable/icon ”)。 图标没有默认值。

android:killAfterRestore
在执行全系统的恢复操作时,配置恢复后相关的应用程序是否要被终止。 单个包的恢复操作不会导致程序被关闭。 全系统的恢复操作一般只会发生一次,即第一次配置手机时。 第三方应用程序通常不需要用到本属性。

默认值是“true”,表示全系统恢复过程中,应用程序在处理完数据后将被关闭。

android:largeHeap
应用程序的进程是否会用较大的 Dalvik 堆来创建。 这将作用于所有为该应用程序创建的进程,但只对第一个被装入进程的应用程序生效。 如果通过共享用户 ID 的方式让多个应用程序公用一个进程,那么这些应用程序必须全部指定本选项,否则将会导致不可预知的后果。

大部分应用程序不需要用到本属性,而是应该关注如何减少内存消耗以提高性能。 使用本属性并不能确保一定会增加可用的内存,因为某些设备可用的内存本来就很有限。

要在运行时查询可用的内存大小,请使用 getMemoryClass()getLargeMemoryClass() 方法。

android:label
供用户阅读的代表整个应用程序的文本标签,也即应用程序中每个组件的默认标签。 请参阅 <activity>、 <activity-alias> 、<service> 、<receiver> 和 <provider> 元素各自的 label 属性。

文本标签应设为一个字符串资源的引用,这样就能像其它用户界面内的字符串一样对其进行本地化。 不过,考虑到开发时的便利性,也可以将其直接设为字符串。

android:logo
整个应用程序的 logo 标识,也即各 Activity 的默认 logo。

本属性必须设为对 drawable 资源的引用,该资源中包含了图片文件(例如“@drawable/logo”)。 logo 没有默认值。

android:manageSpaceActivity
指定某个 Activity 子类的完全限定名称,系统可以启动此 Activity 来让用户管理应用程序占用的内存空间。 这个 Activity 必须已用 <activity> 元素进行了声明。
android:name
实现本应用程序的 Application 子类的完全限定名称。 当应用程序开始运行时,此类将先于所有程序组件被初始化。

该子类是可选的:大多数应用程序不需要用到。 在未提供子类置时,Android 将使用 Application 类的实例。

android:permission
客户端要与应用程序交互而必须拥有的权限名称。 本属性为一次设置适用于全部程序组件的权限提供了一个便捷途径。 它可以被组件各自的 permission 属性覆盖。

关于权限的详细信息,请参阅介绍一文中的 权限 章节和另一篇文档 安全和权限

android:persistent
应用程序是否需要一直保持运行状态 —“true”表示是,“false”表示否。 默认值是“false”。 一般情况下,应用程序不应该设置本标志;持久运行模式仅适用于某些特定的系统应用。
android:process
应用程序的全部组件都将运行于其中的进程名称。 每个组件通过设置各自的 process 属性,可以覆盖本缺省值。

默认情况下,当需要运行应用程序的第一个组件时,Android 会为程序创建一个进程。 然后所有组件都会运行在这个进程中。 默认进程的名称与 <manifest> 元素设置的包名一致。

通过将本属性设置为其他应用程序的进程名称,可以让两个应用程序的组件运行于同一个进程中 — 但只有这两个程序共享同一个用户 ID 并用同一个证书签名时才行。

如果赋予本属性的名称是以冒号(‘:‘)开头的,则必要时将会为应用程序创建一个新的私有进程。 如果进程名称以小写字母开头,则将创建以此名称命名的全局进程。 全局进程可以被其他应用程序共享,以减少资源的占用。

android:restoreAnyVersion
指明应用程序是否将尝试恢复任何备份数据集,即使备份数据的程序版本比当前安装的要新。 本属性设为 true 将允许 Backup Manager 尝试恢复操作,即使发生版本冲突也即数据版本不兼容时也是如此。 使用本属性时务必小心!

本属性的默认值是“false”。

android:requiredAccountType
设定应用程序所需的账户类型。 如果应用程序需要一个 Account 才能运行,本属性值必须与账户的认证类型(由 AuthenticatorDescription 定义)吻合,比如“com.google”。

默认值是 null ,表示应用程序 不需要 任何账户就可以运行。

因为目前的受限用户配置功能(Restricted Profile)无法添加账户,设定本属性的应用程序对于受限用户而言是不可用的, 除非你同时将 android:restrictedAccountType 也声明为相同的值。

提醒 如果账户数据可能会泄露个人身份信息,声明本属性就很重要了,并且要把 android:restrictedAccountType 设置为 null ,这样受限用户就无法用你的应用程序来访问机主的个人信息了。

本属性自 API 级别 18 开始加入。

android:restrictedAccountType
设定本应用程序所需的账户类型,并允许受限用户访问机主的该账户。 如果应用程序需要使用 Account 并且允许受限用户访问主账户,本属性值必须与应用程序的账户认证类型(由 AuthenticatorDescription 定义)吻合,比如“com.google”。

默认值为 null ,表示应用程序不需要 任何账户就可以运行。

提醒: 设置本属性将允许受限用户通过主账户使用你的应用程序,这可能会泄露个人身份信息。 如果账户可能会泄露个人信息,请勿使用本属性,而是使用 android:requiredAccountType 属性,以禁止受限用户的使用。

本属性自 API 级别 18 开始加入。

android:supportsRtl
声明应用程序是否要支持自右向左(RTL)布局(Layout)。

如果本属性设为 true 并且 targetSdkVersion 为 17 以上版本,则系统将会激活并使用各种 RTL API ,应用程序就可以显示 RTL Layout。 如果本属性设为 false 或者 targetSdkVersion 为 16 以下版本,则 RTL API 将会被忽略或失效,应用程序将忽略与 Layout 方向有关的用户本地化选项(Layout 都将从左到右布局)。

本属性的默认值是 false

本属性自 API 级别 17 开始加入。

android:taskAffinity
供应用程序中全部 Activity 使用的 affinity 名称,那些在各自的 taskAffinity 属性中设置了其他 affinity 的 Activity 除外。 详情请参阅 Activity 的 affinity 属性。

默认情况下,应用程序中的所有 Activity 都共享同一个 affinity 。affinity 的名称与 <manifest> 元素中设置的包名称相同。

android:testOnly
标明本应用程序是否仅供测试。 比如,本应用程序可能会暴露一些不属于自己的功能或数据,这将引发安全漏洞,但对测试而言这又非常有用。 这种应用程序只能通过 adb 进行安装。
android:theme
对样式(style)资源的引用,该资源定义了应用程序内所有 Activity 的默认主题(theme)。 每个 Activity 可以用各自的 theme 属性覆盖默认主题。 详情请参阅开发指南的 样式和主题
android:uiOptions
供 Activity UI 使用的附加选项。

必须设为以下值之一。

说明
"none" 没有附加 UI 选项。这是默认值。
"splitActionBarWhenNarrow" 当横向空间受限时(比如设备处于纵向模式时),在屏幕底部添加一横条,用于显示 ActionBar 中的 Action 项。 这时不再是在屏幕顶部的 ActionBar 中显示有限的几个 Action 项了,ActionBar 拆分为顶部导航栏和底部横条。 这就确保了合理的可用空间,不仅可以容纳 Action 项,还可以在顶部显示导航和标题。 菜单项不会被拆分为两部分,还是会放在一起显示。

关于 ActionBar 的更多信息,请参阅Action Bar 开发指南。

本属性自 API 级别 14 开始加入。

android:vmSafeMode
标明应用程序是否期望虚拟机(VM)运行于安全模式。 默认值是“ false”。
引入自:
API 级别 1
参阅:
<activity> 
<service>
<receiver>
<provider>

Android开发-API指南-<application>

标签:

原文地址:http://www.cnblogs.com/popapa/p/android_application-element.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!