Android Manifest之<application>元素中文注释

青旅半醒 2022-08-06 02:06 136阅读 0赞

#### 语法 ####

<application android:allowTaskReparenting=\["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:supportsRtl=\["true" | "false"\]

android:taskAffinity="string"

android:theme="resource or theme"

android:uiOptions=\["none" | "splitActionBarWhenNarrow"\]>

.. .

</application>

#### 父元素 ####

#### 子元素 ####

<activity-alias>

<uses-library>

#### 描述 ####

定义这个应用。这个元素包含定义了每个应用组件的子元素，拥有能影响所有应用组件的属性。这些属性中的大部分（如icon, label, permission,process, taskAffinity, 和allowTaskReparenting）都对特定组件元素的对应属性设置默认值。其它属性（如debuggable, enabled,description, 和allowClearUserData）是对这个应用整体进行设置，这些属性不能被具体的组件重写。

#### 属性 ####

android:allowTaskReparenting

这个应用定义的activities是否能从启动它们的task移动到和它们有关联的task（当接下来这个task到前台的时候）-如果“true”，则能移动，否则它们必须和启动它们的任务待到一起-“false”。默认值是“false”。

<activity>元素有它自己的能重写这个属性值的android:allowTaskReparenting属性。更多内容参见这个属性。

android:backupAgent

实现应用backup agent的类的名称，这个类是BackupAgent的子类。这个属性值应该是完整的类名（例如，“com.example.project.MyBackupAgent”）。然而，有一个简写，如果这个名称的第一个字母是点（例如，“.MyBackupAgent”）,那么它会追加到在<manifest>元素中定义的包名的后面。

这个属性没有默认值，必须指定。

android:debuggable

是否这个应用可调式，即使用用户模式在设备上运行时-如果可以，则为“true”，否则为“false”。默认值是“false”。

android:description

这个应用的用户可读文本，同应用的label相比，它有更多或更长的叙述性内容。这个值必须通过string资源的引用来指定。和label不同的是，它不能为raw串。没有默认值。

android:enabled

是否android系统能初始这个应用的组件-如果能，则为“true”；否则为“false”。如果这个值是“true”，那么每个组件自身的enabled属性能决定这个组件是否enabled。如果这个值是“false”，它会重写指定组件的值；所有的组件都是disabled的。

默认值是“true”。

android:hasCode

是否这个应用包含代码-如果包含，则为“true”，否则为“false”。当它的值为“false”时，在运行组件时系统就不会设法装载任何应用代码。默认值是“true”。

如果它只是使用内置组件类，那么应用自身就不会有任何代码。例如，使用了AliasActivity类的activity，这种情况很少发生。

android:hardwareAccelerated

是否对所有的activity和这个应用中所有的视图启用硬件加速功能-如果应该启用，则为“true”，否则为“false”。

如果你已经设置minSdkVersion或targetSdkVersion到“14”或者更高，那么这个值为“true”；否则，它的值为“false”。

从Android3.0（API Level 11）开始，硬件加速渲染器就对应用可用，这个功能主要用来提升大部分通用2D图形操作的执行性能。当这个渲染器启用时，大部分Canvas,Paint,Xfermode,ColorFilter,Shader和Camera的操作就会加速。总的来说，这就会产生平滑的动画、平滑的滚动以及提升响应速度，甚至对那些没有明确说明使用框架的OpenGL 库的应用都有效。

需要注意的是，并非所有的OpenGL 2D操作都会加速。如果你启用了硬件加速器，你需要测试你的应用以保证它能正确无误的使用渲染器。

关于这方面的更多信息，参见Hardware Acceleration向导。

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

这个标签应当设置为对string资源的引用，以便它能像用户接口中的其它字符串一样本地化。然而，为了开发应用方便，你也可以直接使用raw串（硬编码）。

android:logo

这个应用的logo，同时也是activities的默认logo。

这个属性必须设置为包含图片的drawable资源的引用（例如：“@drawable/logo”）。没有默认logo。

android:manageSpaceActivity

Activity子类的完整标示符名称，系统能运行这个子类让用户来管理设备上应用的内存占用。这个activity也应该用<activity>元素来定义。

android:name

实现这个应用的application子类的完整名称。当这个应用的进程启动时，这个类会在这个应用的所有组件之前初始化。

这个子类是可选的；大部分应用都不需要。在这个application的子类不存在时，android会使用最基本的Application类的实例。

android:permission

客户端同这个应用交互时需要的权限的名称。这个属性是为这个应用的所有组件设置权限的最方便的方式。它能通过独立的组件自身来重写。

android:persistent

是否这个应用应当随时保持运行-如果应当则为“true”，否则为“false”。默认是“false”。一般来说，应用不用设置这个标记；persistence模式在特定的系统应用中使用。

android:process

所有的应用组件应当运行的进程的名称。每个组件都能通过它自身的process属性来重写这个默认值。

默认情况下，当应用的第一个组件需要运行时，Android会对应用创建一个进程。所有的组件都运行在这个进程中。这个默认的进程名匹配在manifest中设置的包名。

通过设置其他应用能共享的进程名称，你能为运行在同一个进程中的两个应用的组件做准备-只是在如果两个应用也共享同一个用户ID并通过相同的证书来签名的条件下。

如果分配的名称用冒号（:）开始，那么一个新的，对应用私有的进程就在需要它的时候创建。如果进程名字以小写字母开始，那么一个全局的进程就被创建。这个全局的进程能被其它应用共享，降低资源消耗。

android:restoreAnyVersion

表名应用准备尝试备份数据的恢复，即使是这个备份是由比在当前设备上安装的应用更新的版本保存的。设置这个属性为true意味着即使当新版本采取了不兼容的数据时，也允 许备份管理器尝试进行恢复操作。因此，使用时要消息！

这个属性的默认值是false。

android:supportsRtl

声明是否你的应用支持right-to-left（RTL）布局。

如果设置为true，并且targetSdkVersion设置了17或更高版本，大量的RTL APIs就会通过系统被激活和使用，所以你的应用就可以显示RTL布局。如果设置为false或targetSdkVersion设置了16或更低版本，这个RTL APIs就会被忽略或无效，并且不管用户当前选择了什么方向，你的应用都以相同的方式运行（也就是你的布局总是left-to-right）。

这个属性的默认值是false。

这个属性在API Level 17中被添加。

android:taskAffinity

应用到这个应用的所有activities的affinity名称，除了那些通过它们自己的taskAffinity属性设置了不同的值的组件。

默认情况下，应用中的所有activities共享同一个affinity。这个affinity名称匹配在<manifest>元素中定义的包名。

android:theme

对这个应用当中的所有activities声明默认主题的资源的引用。每个activity本身也能通过它自己的theme属性重写这个默认值。更多信息，参见*Stylesand Themes*向导。

android:uiOptions

activity UI的额外选项。

值必须是下面当中的一种。

<table style="color:rgb(0,0,0); font-size:14px; line-height:26px"> 
 <tbody> 
 <tr> 
 <td style="background:rgb(198,217,241)"> 值 </td> 
 <td style="background:rgb(198,217,241)"> 描述 </td> 
 </tr> 
 <tr> 
 <td> “none” </td> 
 <td> 没有额外的UI选项，这是默认值。 </td> 
 </tr> 
 <tr> 
 <td> “splitActionBarWhenNarrow” </td> 
 <td> 当受限于水平空间时（就像在手机竖屏时），在这个屏幕的底部添加一个bar用来在ActionBar中显示action项。不是在屏幕的顶部action bar里显示少量的action项，而是为了这个action项将这个action bar分成顶部导航部分和底部导航部分。这不仅对这个action项，而且也对导航和顶部的标题元素保证了可用的合理数量的空间。菜单项不能分成两个bar；它们总是一起出现。 </td> 
 </tr> 
 </tbody> 
</table>

关于这个action bar的更多信息，参见ActionBar开发人员向导。

这个属性在API Level 14中被添加。

#### 出处 ####

API Level 1

转帖：http://blog.csdn.net/jewleo/article/details/8950220