Android Manifest之元素中文注释

语法
    <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>

父元素
    <manifest>

子元素
    <activity>

    <activity-alias>

    <service>

    <receiver>

    <provider>

    <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的额外选项。

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

值
 描述
 
“none”
 没有额外的UI选项，这是默认值。
 
“splitActionBarWhenNarrow”
 当受限于水平空间时（就像在手机竖屏时），在这个屏幕的底部添加一个bar用来在ActionBar中显示action项。不是在屏幕的顶部action bar里显示少量的action项，而是为了这个action项将这个action bar分成顶部导航部分和底部导航部分。这不仅对这个action项，而且也对导航和顶部的标题元素保证了可用的合理数量的空间。菜单项不能分成两个bar；它们总是一起出现。
 

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

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