该属性的默认值为 false。

如果未设置该属性，则对 Activity 应用由 <application> 元素的相应 allowTaskReparenting 属性所设置的值。默认值为“false”。

正常情况下，Activity 启动时会与启动它的任务关联，并在其整个生命周期中一直留在该任务处。当不再显示现有任务时，您可以使用该属性强制 Activity 将其父项更改为与其有相似性的任务。该属性通常用于将应用的 Activity 转移至与该应用关联的主任务。

例如，如果电子邮件消息包含网页链接，则点击该链接会调出可显示该网页的 Activity。该 Activity 由浏览器应用定义，但作为电子邮件任务的一部分启动。如果将该 Activity 的父项更改为浏览器任务，则它会在浏览器下一次转至前台时显示，在电子邮件任务再次转至前台时消失。

Activity 的相似性由 taskAffinity 属性定义。通过读取任务根 Activity 的相似性即可确定任务的相似性。因此，按照定义，根 Activity 始终位于具有同一相似性的任务中。由于具有“singleTask”或“singleInstance”启动模式的 Activity 只能位于任务的根，因此更改父项仅限于“standard”和“singleTop”模式。（另请参阅 launchMode 属性。）

正常情况下，当用户从主屏幕重新选择某个任务时，系统会在特定情况下清除该任务（从根 Activity 上的堆栈中移除所有 Activity）。通常，如果用户在一段时间（如 30 分钟）内未访问任务，系统会执行此操作。

不过，如果该属性的值是“true”，则无论用户如何返回任务，该任务始终会显示最后一次的状态。例如，该属性非常适用于网络浏览器这类应用，因为其中存在大量用户不愿丢失的状态（如多个打开的标签）。

系统使用横幅，以在 Android TV 主屏幕中表示应用。由于横幅只显示在主屏幕中，因此只有 Activity 可处理 CATEGORY_LEANBACK_LAUNCHER Intent 的应用才能指定该横幅。

必须将该属性设置为对包含图像的可绘制资源的引用（例如 "@drawable/banner"）。没有默认横幅。

如需了解详细信息，请参阅“电视应用入门指南”中的提供主屏幕横幅。

若值为“true”，则每次当用户再次启动任务时，无论用户最后在任务中正在执行哪个 Activity，也无论用户是使用返回还是主屏幕按钮离开，系统都会将用户转至任务的根 Activity。当值为“false”时，可在某些情况下清除任务中的 Activity（请参阅 alwaysRetainTaskState 属性），但也有例外。

例如，假设用户从主屏幕启动 Activity P，然后从该处转到 Activity Q。接着，该用户按下主屏幕按钮，然后返回到 Activity P。正常情况下，用户将看到 Activity Q，因为这是其最后在 P 的任务中所执行的 Activity。不过，如果 P 将此标志设置为“true”，则当用户按下主屏幕将任务转入后台时，系统会移除 P 上方的所有 Activity（在本例中为 Q）。因此用户在返回任务时只会看到 P。

如果该属性和 allowTaskReparenting 的值均为“true”，则如上所述，任何可更改父项的 Activity 都将转移至与其有相似性的任务；而其余 Activity 随即会被移除。

请求在兼容设备上以广色域模式显示 Activity。在广色域模式下，窗口可以在 SRGB 色域之外进行渲染，从而显示更鲜艳的色彩。如果设备不支持广色域渲染，则此属性无效。如需了解在广色域模式下进行渲染的详细信息，请参阅使用广色域内容增强图形。

请注意：应避免使用该属性，并且只应在万不得已的情况下使用。如需了解有关如何正确处理配置变更所致重启的详细信息，请阅读处理运行时变更。

任何或所有下列字符串均是该属性的有效值。若有多个值，则使用“|”进行分隔，例如“locale|navigation|orientation”。

所有这些配置变更都可能影响应用所看到的资源值。因此，调用 onConfigurationChanged() 时，通常有必要再次检索所有资源（包括视图布局、可绘制对象等），以正确处理变更。

请注意：如要处理所有多窗口模式相关的配置变更，请使用 "screenLayout" 和 "smallestScreenSize"。Android 7.0（API 级别 24）或更高版本的系统支持多窗口模式。

Activity 是否支持直接启动，即其是否可以在用户解锁设备之前运行。

请注意：在直接启动期间，应用中的 Activity 仅可访问存储在设备保护存储区的数据。

默认值为 "false"。

该属性有四个值，会在用户使用该应用打开文档时产生以下效果：

请注意：对于除“none”和“never”以外的值，必须使用 launchMode="standard" 定义 Activity。如果未指定此属性，则使用 documentLaunchMode="none"。

<application> 元素拥有自己的 enabled 属性，该属性适用于所有应用组件，包括 Activity。只有在 <application> 和 <activity> 属性都为“true”（因为它们都默认使用该值）时，系统才能将 Activity 实例化。如果其中一个属性是“false”，则无法实例化 Activity。

如果您使用的是 Intent 过滤器，则不应将此元素设置为“false”。否则，在应用尝试调用 Activity 时，系统会抛出 ActivityNotFoundException 异常。相反，您不应为其设置 Intent 过滤器，以免其他应用调用 Activity。

如果没有 Intent 过滤器，则此元素的默认值为“false”。如果您将元素设置为“true”，则任何知道其确切类名的应用均可访问 Activity，但在系统尝试匹配隐式 Intent 时，该 Activity 无法解析。

此属性并非是限制 Activity 向其他应用公开的唯一方式。您还可使用权限来限制哪些外部实体能够调用 Activity（请参阅 permission 属性）。

如果此属性和 allowTaskReparenting 均为“true”，则优先使用此属性。系统会忽略 Activity 的相似性。系统不会更改 Activity 的父项，而是将其销毁。

自 Android 3.0 开始，应用可使用经硬件加速的 OpenGL 渲染器，从而提高许多常见 2D 图形运算的性能。启用硬件加速渲染器后，Canvas、Paint、Xfermode、ColorFilter、Shader 和 Camera 中的大多数运算都会获得加速。这可以提高动画及滚动的流畅度并改善整体响应，即便是未显式利用框架 OpenGL 库的应用也会从中受益。由于启用硬件加速会增加资源消耗，因此您的应用将占用更多内存。

请注意，并非所有 OpenGL 2D 运算都会获得加速。如果您启用硬件加速渲染器，请对应用进行测试，确保其在利用渲染器时不会出错。

必须将该属性设置为对包含图像定义的可绘制资源的引用。如果未设置该属性，则转而使用为应用整体指定的图标（请参阅 <application> 元素的 icon 属性）。

Activity 的图标（无论是在此处设置，还是由 <application> 元素设置）同时也是 Activity 所有 Intent 过滤器的默认图标（请参阅 <intent-filter> 元素的 icon 属性）。

如果未设置该属性，则转而使用为应用整体设置的标签（请参阅 <application> 元素的 label 属性）。

Activity 的标签（无论是在此处设置，还是由 <application> 元素设置）同时也是 Activity 所有 Intent 过滤器的默认标签（请参阅 <intent-filter> 元素的 label 属性）。

您应将此标签设置为对字符串资源的引用，以便可以像界面中的其他字符串那样对其进行本地化。不过，为便于开发应用，您也可将其设置为原始字符串。

“standard”
“singleTop”
“singleTask”
“singleInstance”

默认模式是“standard”。

如下表所示，这些模式可分为两大类：“standard”和“singleTop”Activity 为一类，“singleTask”和“singleInstance”Activity 为另一类。使用“standard”或“singleTop”启动模式的 Activity 可多次进行实例化。实例可归属任何任务，并且可位于 Activity 堆栈中的任何位置。通常，它们会启动到名为 startActivity() 的任务中（除非 Intent 对象包含 FLAG_ACTIVITY_NEW_TASK 指令，在此情况下会选择其他任务 — 请参阅 taskAffinity 属性）。

相比之下，“singleTask”和“singleInstance”Activity 只能启动任务。它们始终位于 Activity 堆栈的根位置。此外，设备一次只能保留一个 Activity 实例，即一次只允许一个此类任务。

“standard”和“singleTop”模式只有一处不同：每次“standard”Activity 有新的 Intent 时，系统都会创建新的类实例来响应该 Intent。每个实例处理单个 Intent。同样地，您也可以创建新的“singleTop”Activity 实例来处理新的 Intent。不过，如果目标任务的 Activity 堆栈顶部已有一个 Activity 实例，则该实例会（通过调用 onNewIntent()）接收新的 Intent；此时不会创建新实例。在其他情况下（例如，如果“singleTop”Activity 的某个现有实例虽在目标任务内，但未处于堆栈顶部，或者虽然位于堆栈顶部，但不在目标任务中），系统会创建新实例并将其送入堆栈。

同样地，如果您向上导航到当前堆栈上的某个 Activity，则该行为由父 Activity 的启动模式决定。如果父 Activity 有启动模式 singleTop（或者 up Intent 包含 FLAG_ACTIVITY_CLEAR_TOP），则系统会将该父项置于堆栈顶部，并保留其状态。导航 Intent 由父 Activity 的 onNewIntent() 方法接收。如果父 Activity 有启动模式 standard（并且 up Intent 不包含 FLAG_ACTIVITY_CLEAR_TOP），则系统会将当前 Activity 及其父项同时送出堆栈，并创建新的父 Activity 实例来接收导航 Intent。

“singleTask”和“singleInstance”模式同样只有一处不同：“singleTask”Activity 允许其他 Activity 成为其任务的一部分。该 Activity 始终位于其任务的根位置，但其他 Activity（必然是“standard”和“singleTop”Activity）可以启动到该任务中。另一方面，“singleInstance”Activity 不允许其他 Activity 成为其任务的一部分。它是任务中唯一的 Activity。如果它启动另一个 Activity，则系统会将该 Activity 分配给其他任务，就如同 Intent 中包含 FLAG_ACTIVITY_NEW_TASK 一样。

如上表所示，standard 是默认模式，并且适用于大多数类型的 Activity。对众多类型的 Activity 而言，SingleTop 也是常见且有用的启动模式。其他模式（singleTask 和 singleInstance）不适用于大多数应用，因为它们所形成的交互模式可能让用户感到陌生，并且与大多数其他应用差别较大。

无论您选择哪种启动模式，在 Activity 启动期间以及使用返回按钮从其他 Activity 和任务返回该 Activity 时，请务必对其进行易用性测试。

如需了解有关启动模式及其与 Intent 标志交互的详细信息，请参阅任务和返回栈文档。

Android 可以类似于 Kiosk 的沉浸式方式（称为锁定任务模式）运行任务。当系统在锁定任务模式下运行时，设备用户通常无法查看通知、访问非白名单应用或返回主屏幕（除非主页应用已列入白名单）。只有经设备政策控制器 (DPC) 列入白名单后，应用才能在系统处于锁定任务模式时运行。但是，系统和特权应用无需列入白名单便可在锁定任务模式下运行。

此属性的值可为以下 R.attr.lockTaskMode 任一字符串值：

该属性是 API 级别 23 中的新增属性。

请注意：如果 Activity 已将 resizeableActivity 设置为 true，则系统会忽略此属性，因为这意味着此 Activity 支持任何尺寸。

如需了解有关此属性的详细信息，请参阅支持多种屏幕。

正常情况下，新的 Activity 实例会启动到定义该实例的应用进程内，因此所有 Activity 实例都在同一进程内运行。不过，如果将该标记设置为“true”，则 Activity 实例便可在多个进程内运行，以便系统在任何使用实例的地方创建实例（前提是权限允许这样做），但这几乎毫无必要。

一旦发布应用，即不应更改该名称（除非您设置了 android:exported="false"）。

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

“true”一值表示 Activity 不会留下历史跟踪记录。它不会留在任务的 Activity 堆栈内，因此用户将无法返回 Activity。在此情况下，如果您通过启动另一个 Activity 来获取该 Activity 的结果，系统永远不会调用 onActivityResult()。

该属性是 API 级别 3 中的新增属性。

系统会读取该属性，以确定当用户按下操作栏中的“向上”按钮时应该启动哪一个 Activity。系统还可利用这些信息，通过 TaskStackBuilder 合成 Activity 的返回栈。

如要支持 API 级别 4 至 16，您还可使用为 "android.support.PARENT_ACTIVITY" 指定值的 <meta-data> 元素来声明父 Activity。例如：

<activity
    android:name="com.example.app.ChildActivity"
    android:label="@string/title_child_activity"
    android:parentActivityName="com.example.app.MainActivity" >
    <!-- Parent activity meta-data to support API level 4+ -->
    <meta-data
        android:name="android.support.PARENT_ACTIVITY"
        android:value="com.example.app.MainActivity" />
</activity>

如需了解通过声明父 Activity 来支持向上导航的详细信息，请阅读提供向上导航。

该属性是 API 级别 16 中的新增属性。

定义当设备重启时，如何在包含任务中保留 Activity 实例。

如果任务的根 Activity 将此属性的值设置为 persistRootOnly，则仅保留根 Activity。否则，系统会检查高于任务返回栈的 Activity，并在其中保留任何将此属性的值设置为 persistAcrossReboots 的 Activity。

如果使用此属性，您必须将其值设置为以下某个值：

该属性是 API 级别 21 中的新增属性。

如果未设置该属性，则对 Activity 应用由 <application> 元素的 permission 属性所设置的权限。如果二者均未设置，则 Activity 不受权限保护。

如需了解有关权限的详细信息，请参阅简介的权限部分，以及另一份文档安全与权限。

如果为该属性分配的名称以冒号（“:”）开头，则系统会在需要时创建应用专用的新进程，并且 Activity 会在该进程中运行。如果进程名称以小写字符开头，则 Activity 将在使用该名称的全局进程中运行，前提是它拥有相应的权限。如此一来，不同应用中的组件便可共享进程，从而减少资源使用。

<application> 元素的 process 属性可为所有组件设置不同的默认进程名称。

如果将该属性设置为“true”，则 Activity 还可利用 ActivityManager.TaskDescription 来更改概览屏幕中的标签、颜色和图标。

指定应用是否支持多窗口显示。您可以在 <activity> 或 <application> 元素中设置该属性。

如果您将该属性设置为 true，则用户可以在分屏和*窗口模式下启动 Activity。如果您将该属性设置为 false，则 Activity 不支持多窗口模式。如果该值为 false，且用户尝试在多窗口模式下启动 Activity，则该 Activity 将全屏显示。

如果应用面向 API 级别 24 或更高级别，但您未指定该属性的值，则该属性的值默认设为 true。

该属性是 API 级别 24 中的新增属性。

其值可以是下列任一字符串：

请注意：如果您声明其中一个横向或纵向值，则系统会将其视为对 Activity 运行方向的硬性要求。因此，您声明的值支持通过 Google Play 等服务进行过滤，这样只有支持 Activity 规定方向的设备才能使用您的应用。例如，如果您声明 "landscape"、"reverseLandscape" 或 "sensorLandscape"，则您的应用只能供支持横向方向的设备使用。不过，您还应通过 <uses-feature> 元素明确声明，您的应用要求采用纵向还是横向方向。例如，<uses-feature android:name="android.hardware.screen.portrait"/>。这纯粹是 Google Play（以及其他支持过滤的服务）提供的一种过滤行为，平台本身并不能控制是否可在仅支持某种方向的设备上安装您的应用。

当设备的当前用户不是启动 Activity 的用户时，是否要显示 Activity。您可将此属性设置为字面量值（"true" 或 "false"），或包含布尔值的资源或主题属性。

此属性为 API 级别 23 中的新增属性。

正常情况下，为保存资源而暂时关闭 Activity 前，系统会调用其 onSaveInstanceState() 方法。该方法会将 Activity 的当前状态存储在一个 Bundle 对象中，然后在 Activity 重启时将其传递给 onCreate()。如果将该属性设置为“true”，则系统可能不会调用 onSaveInstanceState()，并且会向 onCreate() 传递 null（而非 Bundle）— 这与 Activity 首次启动时的情况完全相同。

“true”设置可确保 Activity 能够在未保留状态时重启。例如，显示主屏幕的 Activity 可以使用该设置，确保系统不会在该 Activity 因某种原因而崩溃时将其移除。

指定 Activity 是否支持画中画显示。如果 android:resizeableActivity 是 false，则系统会忽略该属性。

该属性是在 API 级别 24 添加的。

相似性确定两点内容 — Activity 更改父项后的任务（请参阅 allowTaskReparenting 属性），以及通过 FLAG_ACTIVITY_NEW_TASK 标记启动 Activity 时，用于容纳该 Activity 的任务。

默认情况下，应用中的所有 Activity 都具有同一相似性。您可以设置该属性，以不同方式将其分组，甚至可以在同一任务内放置不同应用中定义的 Activity。如要指定 Activity 与任何任务均无相似性，请将其设置为空字符串。

如果未设置该属性，则 Activity 会继承为应用设置的相似性（请参阅 <application> 元素的 taskAffinity 属性）。应用默认相似性的名称为 <manifest> 元素所设置的软件包名称。

如果未设置该属性，则 Activity 会继承通过 <application> 元素的 theme 属性为应用所整体设置的主题。如果同样未设置该属性，则使用默认系统主题。如需了解详细信息，请参阅样式和主题开发者指南。

必须是下列值之一。

如需了解有关应用栏的详细信息，请参阅添加应用栏培训课程。

该属性是在 API 级别 14 添加的。

• 当 Activity 成为用户注意的焦点时，软键盘的状态为隐藏还是可见。
• 对 Activity 主窗口所做的调整 — 是否将其尺寸调小，为软键盘腾出空间；或当软键盘遮盖部分窗口时，是否平移其内容以使当前焦点可见。

该设置必须是下表所列的其中一项值，或一个“state...”值加上一个“adjust...”值的组合。在任一组中设置多个值（例如，多个“state...”值）均会产生未定义的结果。各值之间使用竖线 (|) 进行分隔。例如：

<activity android:windowSoftInputMode="stateVisible|adjustResize" ... >

以下设置的值（“stateUnspecified”和“adjustUnspecified”除外）会替换主题中设置的值。

该属性是 API 级别 3 中的新增属性。