<деятельность>

Указывает на то, что активность может быть запущена как встроенный дочерний элемент другой активности, особенно в случае, когда дочерний элемент находится в контейнере, например, в Display принадлежащем другой активности. Например, активности, используемые для пользовательских уведомлений Wear, объявляют это, чтобы Wear мог отображать активность в своем потоке контекста, который находится в другом процессе.

Значение по умолчанию для этого атрибута — false .

Если этот атрибут не задан, к активности применяется значение, заданное соответствующим атрибутом allowTaskReparenting элемента <application> . Значение по умолчанию — "false" .

Обычно, когда действие запускается, оно связывается с задачей этого действия, и остается в этой связи на протяжении всего своего жизненного цикла. Вы можете использовать этот атрибут, чтобы принудительно переназначить его в качестве дочернего элемента задачи, к которой оно привязано, когда текущая задача больше не отображается. Как правило, это используется для того, чтобы действия приложения перемещались к основной задаче, связанной с этим приложением.

Например, если электронное письмо содержит ссылку на веб-страницу, щелчок по ссылке запускает действие, которое может отобразить эту страницу. Это действие определяется браузерным приложением, но запускается как часть задачи обработки электронного письма. Если оно перенесено в качестве дочернего элемента задачи браузера, оно отображается при следующем появлении браузера на переднем плане и отсутствует при повторном появлении задачи обработки электронного письма.

Привязка активности определяется атрибутом taskAffinity . Привязка задачи определяется путем считывания привязки ее корневой активности. Следовательно, по определению, корневая активность всегда находится в задаче с той же привязкой. Поскольку активности с режимами запуска "singleTask" или "singleInstance" могут находиться только в корне задачи, изменение родительского элемента ограничено режимами "standard" и "singleTop" . (См. также атрибут launchMode .)

Обычно система очищает задачу, удаляя все действия из стека, расположенного выше корневого действия, в определенных ситуациях, когда пользователь повторно выбирает эту задачу на главном экране. Как правило, это происходит, если пользователь не обращался к задаче в течение определенного времени, например, 30 минут.

Однако, когда этот атрибут имеет значение "true" , пользователи всегда возвращаются к задаче в её последнем состоянии, независимо от того, как они туда попали. Это полезно в таких приложениях, как веб-браузер, где хранится много информации о состоянии, например, несколько открытых вкладок, которую пользователи не хотят потерять.

Система использует баннер для отображения приложения на главном экране Android TV. Поскольку баннер отображается только на главном экране, он указывается только приложениями, у которых есть активность, обрабатывающая интент CATEGORY_LEANBACK_LAUNCHER .

Этот атрибут устанавливается как ссылка на ресурс drawable, содержащий изображение, например, "@drawable/banner" . Баннера по умолчанию нет.

Для получения дополнительной информации см. раздел «Добавление баннера на главный экран» в руководстве «Начало работы с приложениями для ТВ».

Указывает, может ли данное действие отображаться на удаленном устройстве, на котором может работать или не работать Android. Значение должно быть логическим "true" или "false" .

Значение по умолчанию для этого атрибута — "true" .

Если значение равно "true" , то при каждом запуске задачи пользователи возвращаются к её корневому действию независимо от того, что они делали в задаче в последний раз, и независимо от того, использовали ли они кнопку «Назад» или «Домой», чтобы выйти из неё. Если значение равно "false" , то в некоторых ситуациях задача может быть очищена от действий, но не всегда. Для получения дополнительной информации см. атрибут alwaysRetainTaskState .

Предположим, пользователь запускает действие P с главного экрана, а затем переходит к действию Q. После этого пользователь нажимает кнопку «Главная», а затем возвращается к действию P. Обычно пользователь видит действие Q, поскольку именно его он в последний раз выполнял в задаче P. Однако, если для P установить этот флаг в значение "true" , все действия, расположенные поверх него — в данном случае, Q — удаляются при запуске действия P с главного экрана. Таким образом, при возвращении к задаче пользователь видит только P.

Если этот атрибут и allowTaskReparenting оба имеют "true" , все действия, которые можно переназначить в качестве родительских, перемещаются в задачу, с которой они имеют общую привязку. Оставшиеся действия затем удаляются.

Этот атрибут игнорируется, если FLAG_ACTIVITY_RESET_TASK_IF_NEEDED не установлен.

Задает цветовой режим активности. Если указан, может принимать значения hdr или wideColorGamut .

Если hdr , запрашивается отображение активности в режиме расширенного динамического диапазона, если устройство его поддерживает.

Если wideColorGamut задан, это означает, что действие должно отображаться в режиме расширенного цветового охвата на совместимых устройствах. В режиме расширенного цветового охвата окно может отображаться за пределами цветового охвата SRGB для более ярких цветов. Если устройство не поддерживает отображение в режиме расширенного цветового охвата, этот атрибут не оказывает никакого эффекта. Дополнительную информацию об отображении в режиме расширенного цветового охвата см. в разделе «Улучшение графики с помощью контента в расширенном цветовом охвате» .

Примечание: Используйте этот атрибут только в особых случаях для повышения производительности и быстродействия приложения. Дополнительную информацию см. в разделе «Обработка изменений конфигурации» .

Следующие строки являются допустимыми значениями для этого атрибута. Несколько значений разделяются символом | , например, "locale|navigation|orientation" .

Все эти изменения конфигурации могут повлиять на значения ресурсов, видимые приложению. Поэтому при вызове onConfigurationChanged() обычно необходимо повторно получить все ресурсы, включая макеты представлений и изображения, чтобы корректно обработать изменение.

Примечание: Для обработки изменений конфигурации, связанных с многооконным режимом , используйте как "screenLayout" , так и "smallestScreenSize" . Многооконный режим поддерживается в Android 7.0 (уровень API 24) или выше.

Учитывается ли возможность запуска данной операции через Direct-Boot — то есть, может ли она выполняться до разблокировки устройства пользователем.

Примечание: Во время прямой загрузки приложение может получить доступ только к данным, хранящимся в защищенном хранилище устройства .

Значение по умолчанию — "false" .

Этот атрибут имеет четыре значения, которые приводят к следующим эффектам при открытии пользователем документа в приложении:

Примечание: Для значений, отличных от "none" и "never" , активность определяется с помощью launchMode="standard" . Если этот атрибут не указан, используется documentLaunchMode="none" .

Элемент <application> имеет собственный атрибут enabled , который применяется ко всем компонентам приложения, включая активности. Для того чтобы система могла создать экземпляр активности, атрибуты <application> и <activity> должны быть оба равны "true" , как это и происходит по умолчанию. Если хотя бы один из них равен "false" , создание экземпляра невозможно.

Этот флаг позволяет отключить анимацию, создаваемую системой прогнозирования, на уровне отдельного действия.

Установите параметр android:enableOnBackInvokedCallback=false , чтобы отключить анимацию возврата по умолчанию на уровне активности и указать системе игнорировать вызовы API платформы OnBackInvokedCallback .

Указывает, исключается ли задача, инициированная этим действием, из списка последних приложений . То есть, если это действие является корневым действием для новой задачи, этот атрибут определяет, отображается ли задача в списке последних приложений. Значение "true" означает, что задача исключена из списка; "false" — что она включена . Значение по умолчанию — "false" .

Можно ли запустить данную функцию компонентами других приложений:

• Если "true" , то активность доступна любому приложению и может быть запущена по точному имени класса.
• Если значение "false" , то действие может быть запущено только компонентами одного и того же приложения, приложениями с одинаковым идентификатором пользователя или привилегированными системными компонентами. Это значение по умолчанию, если отсутствуют фильтры намерений.

Если в вашем приложении есть активность, использующая фильтры намерений, установите для этого элемента значение "true" чтобы другие приложения могли её запускать. Например, если активность является основной активностью приложения и включает category android.intent.category.LAUNCHER .

Если для этого элемента установлено значение "false" , и приложение пытается запустить активность, система выдает исключение ActivityNotFoundException .

Этот атрибут — не единственный способ ограничить доступ к активности для других приложений. Разрешения также используются для ограничения внешних объектов, которые могут вызывать эту активность. См. атрибут permission .

Если этот атрибут и allowTaskReparenting оба имеют значение "true" , то этот атрибут имеет приоритет над другим. Принадлежность активности игнорируется. Активность не переподчиняется, а уничтожается.

Этот атрибут игнорируется, если FLAG_ACTIVITY_RESET_TASK_IF_NEEDED не установлен.

Указывает, будет ли эта активность видна всем остальным приложениям на устройстве, минуя обычные ограничения видимости пакетов.

Значение по умолчанию — "false" .

Для получения более подробной информации см. руководство по автоматической фильтрации видимости пакетов .

В Android 3.0 и выше приложениям доступен аппаратный ускоритель рендеринга OpenGL, повышающий производительность многих распространенных операций с 2D-графикой. При включении аппаратного ускорителя рендеринга большинство операций в Canvas, Paint, Xfermode, ColorFilter, Shader и Camera ускоряются.

Это приводит к более плавной анимации, более плавной прокрутке и улучшенной отзывчивости в целом, даже для приложений, которые явно не используют библиотеки OpenGL фреймворка. Из-за увеличения ресурсов, необходимых для включения аппаратного ускорения, ваше приложение потребляет больше оперативной памяти.

Не все операции OpenGL 2D ускоряются. Если вы включите аппаратное ускорение рендеринга, проверьте, может ли ваше приложение использовать этот рендерер без ошибок.

Значок, представляющий активность. Значок отображается пользователям, когда требуется отображение активности на экране. Например, значки для активностей, запускающих задачи, отображаются в окне запуска. Значок часто сопровождается подписью; информацию о подписи см. в атрибуте android:label .

Этот атрибут устанавливается как ссылка на ресурс drawable, содержащий определение изображения. Если он не установлен, вместо него используется значок, указанный для всего приложения. Для получения дополнительной информации см. атрибут icon элемента <application> .

Значок активности, заданный здесь или элементом <application> , также является значком по умолчанию для всех фильтров намерений этой активности. Для получения дополнительной информации см. атрибут icon элемента <intent-filter> .

Используйте этот атрибут для точной настройки сопоставления входящих интентов с компонентами приложения. По умолчанию специальные правила сопоставления не применяются.

Значение, установленное в теге <activity> , переопределяет значение, установленное в теге <application> .

Значение должно представлять собой один или несколько из следующих флагов, разделенных символом ' | ':

Для получения дополнительной информации см. раздел «Безопасные намерения» в описании изменений в поведении Android 16 (уровень API 36).

Удобочитаемая пользователем метка для активности. Метка отображается на экране, когда активность представляется пользователю. Часто она отображается вместе со значком активности. Если этот атрибут не задан, используется метка, заданная для всего приложения. См. атрибут label элемента <application> .

Метка действия, заданная здесь или элементом <application> , также является меткой по умолчанию для всех фильтров намерений этого действия. Для получения дополнительной информации см. атрибут label элемента <intent-filter> .

Метка устанавливается как ссылка на строковый ресурс, чтобы её можно было локализовать, как и другие строки в пользовательском интерфейсе. Однако, для удобства при разработке приложения, её также можно установить как обычную строку.

Инструкция по запуску активности. Существует пять режимов, которые работают совместно с флагами активности (константами FLAG_ACTIVITY_* ) в объектах Intent , определяя, что происходит при вызове активности для обработки Intent:

"standard"
"singleTop"
"singleTask"
"singleInstance"
"singleInstancePerTask"

Режим по умолчанию — "standard" .

Как показано в следующей таблице, режимы делятся на две основные группы: с одной стороны — действия "standard" и "singleTop" , а с другой — действия "singleTask" , "singleInstance" и "singleInstancePerTask" . Действие с режимом запуска "standard" или "singleTop" может быть запущено несколько раз.

Экземпляры могут принадлежать любой задаче и располагаться в любом месте задачи активности. Как правило, они запускаются в задачу, вызвавшую startActivity() , если только объект Intent не содержит инструкцию FLAG_ACTIVITY_NEW_TASK , в этом случае выбирается другая задача. Для получения дополнительной информации см. атрибут taskAffinity .

В отличие от них, действия "singleTask" , "singleInstance" и "singleInstancePerTask" имеют различное поведение. Действие "singleInstancePerTask" всегда находится в корне задачи. Кроме того, устройство может содержать только один экземпляр действия "singleInstance" одновременно, в то время как действие "singleInstancePerTask может быть создано несколько раз в разных задачах, если установлен FLAG_ACTIVITY_MULTIPLE_TASK или FLAG_ACTIVITY_NEW_DOCUMENT .

Активность с режимом запуска "singleTask" сочетает в себе поведение режимов "singleInstance" и "singleInstancePerTask" : активность может быть создана несколько раз и может располагаться в любом месте задачи с одинаковым taskAffinity . Однако устройство может содержать только одну задачу для размещения активности "singleTask" в корневой области задачи активности.

Режимы "standard" и "singleTop" отличаются друг от друга одним аспектом: каждый раз, когда для "standard" действия появляется новое намерение, создается новый экземпляр класса для обработки этого намерения. Каждый экземпляр обрабатывает одно намерение. Аналогично, для обработки нового намерения можно также создать новый экземпляр действия "singleTop" .

Однако, если в целевой задаче уже есть существующий экземпляр активности на вершине стека, этот экземпляр получает новый интент в вызове onNewIntent() . Новый экземпляр не создается. В противном случае — если существующий экземпляр активности "singleTop" находится в целевой задаче, но не на вершине стека, или если он находится на вершине стека, но не в целевой задаче — создается новый экземпляр и помещается в стек.

Аналогично, если пользователь переходит к активности в текущем стеке, поведение определяется режимом запуска родительской активности. Если родительская активность имеет режим запуска singleTop (или намерение up содержит FLAG_ACTIVITY_CLEAR_TOP ), родительская активность перемещается на вершину стека, и её состояние сохраняется.

Навигационный интент принимается методом onNewIntent() родительской активности. Если родительская активность имеет режим запуска standard , и интент up не содержит FLAG_ACTIVITY_CLEAR_TOP , текущая активность и её родительская активность удаляются из стека, и создаётся новый экземпляр родительской активности для получения навигационного интента.

Режим "singleInstance" отличается от "singleTask" и "singleInstancePerTask" только одним аспектом: действие с режимом запуска "singleTask" или "singleInstancePerTask" позволяет другим действиям, обязательно "standard" и "singleTop" , быть частью его задачи.

С другой стороны, действие типа "singleInstance" не допускает включения других действий в свою задачу. Оно должно быть единственным действием в задаче. Если оно запускает другое действие, это действие назначается другой задаче, как если бы в намерении присутствовал FLAG_ACTIVITY_NEW_TASK .

Как показано в предыдущей таблице, "standard" — это режим по умолчанию, подходящий для большинства типов действий. "singleTop" также является распространенным и полезным режимом запуска для многих типов действий. Другие режимы, "singleTask" , "singleInstance" и "singleInstancePerTask" , не подходят для большинства приложений. Они приводят к модели взаимодействия, которая, вероятно, будет незнакома пользователям и сильно отличается от большинства других приложений.

Независимо от выбранного режима запуска, обязательно проверьте удобство использования активности во время запуска, а также при возвращении к ней из других активностей и задач с помощью кнопки «Назад».

Для получения дополнительной информации о режимах запуска и их взаимодействии с флагами Intent см. раздел «Задачи и стек возврата» .

В Android задачи могут выполняться в режиме, напоминающем киоск, — режиме блокировки задач. Когда система работает в режиме блокировки задач, пользователи устройства обычно не могут видеть уведомления, получать доступ к приложениям, не включенным в список разрешенных, или возвращаться на главный экран, если приложение «Дом» не включено в этот список.

В режиме блокировки задач могут работать только приложения, разрешенные контроллером политики устройства (DPC). Однако системные и привилегированные приложения могут работать в режиме блокировки задач без внесения их в список разрешенных.

В качестве значения может использоваться любое из следующих строковых значений R.attr.lockTaskMode :

Этот атрибут был введен в API уровня 23.

Максимальное соотношение сторон, поддерживаемое данной активностью.

Если приложение работает на устройстве с более широким соотношением сторон, система автоматически уменьшает изображение, оставляя некоторые участки экрана незанятыми, чтобы приложение могло работать с заданным максимальным соотношением сторон.

Максимальное соотношение сторон выражается в десятичной форме как частное от деления большей длины устройства на его меньшую длину. Например, если максимальное соотношение сторон равно 7:3, установите значение этого параметра равным 2,33.

На устройствах, не являющихся носимыми, значение этого атрибута должно быть равно 1,33 или больше. На носимых устройствах оно должно быть равно 1,0 или больше. В противном случае система игнорирует установленное значение.

Для получения более подробной информации об этом атрибуте см. R.attr.maxAspectRatio .

Минимальное соотношение сторон, поддерживаемое данным видом деятельности.

Если приложение работает на устройстве с более узким соотношением сторон, система автоматически уменьшает изображение, оставляя часть экрана незанятой, чтобы приложение могло работать с заданным минимальным соотношением сторон.

Минимальное соотношение сторон выражается в десятичной форме как частное от деления большей длины устройства на его меньшую длину. Например, если соотношение сторон дисплея составляет 4:3, установите минимальное значение соотношения сторон равным 1,33.

Значение должно быть больше или равно 1,0, в противном случае система игнорирует установленное значение.

Для получения более подробной информации об этом атрибуте см. R.attr.minAspectRatio .

Обычно новый экземпляр действия запускается в процессе приложения, которое его определило, поэтому все экземпляры действия работают в одном процессе. Однако, если этот флаг установлен в значение "true" , экземпляры действия могут работать в нескольких процессах, позволяя системе создавать экземпляры везде, где они используются, при условии, что это позволяют права доступа — что почти никогда не является необходимым или желательным.

После публикации приложения не меняйте это имя , если только не установите android:exported ="false" . Значения по умолчанию отсутствуют. Имя необходимо указать.

A value of "true" means that the activity doesn't leave a historical trace. It doesn't remain in the activity stack for the task, so the user isn't able to return to it. In this case, onActivityResult() is never called if you start another activity for a result from this activity.

This attribute was introduced in API level 3.

The system reads this attribute to determine which activity to start when the user taps the Up button in the action bar. The system can also use this information to synthesize a back stack of activities with TaskStackBuilder .

To support API levels 4 - 16, you can also declare the parent activity with a <meta-data> element that specifies a value for "android.support.PARENT_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>

For more information about declaring the parent activity to support Up navigation, read Providing Up Navigation .

This attribute was introduced in API level 16.

Defines how an instance of an activity is preserved within a containing task across device restarts.

If the root activity of a task sets this attribute's value to persistRootOnly , then only the root activity is preserved. Otherwise, the activities that are higher up the task's back stack are examined; any of these activities that set this attribute's value to persistAcrossReboots are preserved.

If you use this attribute, you must set its value to one of the following:

This attribute was introduced in API level 21.

If this attribute isn't set, the permission set by the <application> element's permission attribute applies to the activity. If neither attribute is set, the activity isn't protected by a permission.

For more information on permissions, see the Permissions section of the App manifest overview and Security tips .

Specifies whether the activity prefers the connected display to perform minimal post-processing (also known as auto low latency mode or game mode). This setting is useful for applications like games or video conferencing where low latency is more important than image enhancement.

The default value is "false" .

For more information, see the guide on requesting and checking for low latency support .

The name of the process in which the activity runs. Normally, all components of an application run in a default process name created for the application, and you don't need to use this attribute. But if necessary, you can override the default process name with this attribute, letting you spread your app components across multiple processes.

If the name assigned to this attribute begins with a colon ( : ), a new process, private to the application, is created when it's needed and the activity runs in that process.

If the process name begins with a lowercase character, the activity runs in a global process of that name, provided that it has permission to do so. This lets components in different applications share a process, reducing resource usage.

The <application> element's process attribute can set a different default process name for all components.

Specifies the configuration changes that should trigger the system to recreate the activity. If a configuration change is specified here (and not in android:configChanges ), the activity is recreated when that change occurs.

For more information, see the guide on recreating an activity on configuration changes .

Whether the activity relinquishes its task identifiers to an activity above it in the task stack. A task whose root activity has this attribute set to "true" replaces the base Intent with that of the next activity in the task.

If the next activity also has this attribute set to "true" then it yields the base Intent to any activity that it launches in the same task. This continues for each activity until an activity is encountered which has this attribute set to "false" . The default value is "false" .

This attribute set to "true" also permits the activity's use of the ActivityManager.TaskDescription to change labels, colors, and icons in the Recents screen .

Specifies permissions necessary to launch this activity when passing content URIs. The default value is none , meaning no specific permissions are required. Setting this attribute restricts activity invocation based on the invoker's permissions. If the invoker doesn't have the required permissions, the activity start will be denied via a SecurityException .

Note that the enforcement works for content URIs inside Intent.getData() , Intent.EXTRA_STREAM , and Intent.getClipData() .

May be a string value, using '\\;' to escape characters such as '\\n' or '\\uxxxx' for a unicode character;

Must be one of the following constant values.

Specifies whether the app supports multi-window mode .

You can set this attribute in either the <activity> or <application> element.

If you set this attribute to "true" , the user can launch the activity in split-screen and free-form modes. If you set the attribute to "false" , the app can't be tested or optimized for a multi-window environment. The system can still put the activity in multi-window mode with compatibility mode applied.

Setting this attribute to "false" doesn't guarantee that there are no other apps in multi-window mode visible on screen, such as in a picture-in-picture, or on other displays. Therefore, setting this flag doesn't mean that your app has exclusive resource access.

If your app targets API level 24 or higher and you do not specify a value for this attribute, the attribute's value defaults to "true" .

If your app targets API level 31 or higher, this attribute works differently on small and large screens:

• Large screens (sw >= 600dp): all apps support multi-window mode. The attribute indicates whether an app can be resized, not whether the app supports multi-window mode. If resizeableActivity="false" , the app is put into compatibility mode when necessary to conform to display dimensions.
• Small screens (sw < 600dp): if resizeableActivity="true" and the minimum width and minimum height of the activity are within the multi-window requirements, the app supports multi-window mode. If resizeableActivity="false" , the app doesn't support multi-window mode regardless of the activity minimum width and height.

A task's root activity value is applied to all additional activities launched in the task. That is, if the root activity of a task is resizable, then the system treats all other activities in the task as resizable. If the root activity isn't resizable, the other activities in the task aren't resizable.

Note: A task's root activity value is applied to all additional activities launched in the task. That is, if the root activity of a task is resizable, then the system treats all other activities in the task as resizable. If the root activity isn't resizable, the other activities in the task aren't resizable.

The requested orientation of the activity.

When an activity fills the entire screen, the requested orientation acts as a suggestion to change the orientation on that screen to match the requested value. This can result in an orientation that differs from the screen's physical orientation in space, requiring the user to rotate the device to continue using the app. On Android 12 (API level 31) and higher, device manufacturers can configure individual device screens (such as the tablet-sized screen of a foldable) to ignore this suggestion, and instead force an activity to be letterboxed within the user's preferred orientation of the device. This results in the activity's orientation matching the requested one without needing the user to physically rotate their device.

In multi-window mode, the requested orientation does not act as a suggestion for the overall orientation. If the activity is letterboxed , the requested orientation impacts the letterboxing applied to the activity.

The value can be any one of the following strings:

Note: When you declare one of the landscape or portrait values, it is considered a hard requirement for the orientation in which the activity runs. The value you declare enables filtering by services such as Google Play, so your application is available only to devices that support the orientation required by your activities. For example, if you declare either "landscape" , "reverseLandscape" , or "sensorLandscape" , then your application is available only to devices that support landscape orientation.

Also explicitly declare that your application requires either portrait or landscape orientation with the <uses-feature> Element, such as <uses-feature android:name="android.hardware.screen.portrait"/> . This is a filtering behavior provided by Google Play and other services that support it, and the platform itself doesn't control whether your app can install when a device supports only certain orientations.

Whether the activity is shown when the device's current user is different than the user who launched the activity. You can set this attribute to a literal value, like "true" or "false" , or you can set the attribute to a resource or theme attribute that contains a boolean value.

This attribute was added in API level 23.

Normally, before an activity is temporarily shut down to save resources, its onSaveInstanceState() method is called. This method stores the current state of the activity in a Bundle object, which is then passed to onCreate() when the activity is restarted. If this attribute is set to "true" , onSaveInstanceState() might not be called, and onCreate() is passed null instead of the Bundle , as it is when the activity starts for the first time.

A "true" setting means that the activity can be restarted without retained state. For example, the activity that displays the Home screen uses this setting to make sure that it doesn't get removed if it crashes for some reason.

Specifies whether the activity supports picture-in-picture display.

The task that the activity has an affinity for. Activities with the same affinity conceptually belong to the same task, to the same "application" from the user's perspective. The affinity of a task is determined by the affinity of its root activity.

The affinity determines two things: the task that the activity is re-parented to (see the allowTaskReparenting attribute) and the task that houses the activity when it launches with the FLAG_ACTIVITY_NEW_TASK flag.

By default, all activities in an application have the same affinity. You can set this attribute to group them differently, and even place activities defined in different applications within the same task. To specify that the activity doesn't have an affinity for any task, set it to an empty string.

If this attribute isn't set, the activity inherits the affinity set for the application. See the <application> element's taskAffinity attribute. The name of the default affinity for an application is the namespace set in the build.gradle file.

If this attribute isn't set, the activity inherits the theme set for the application as a whole, from the <application> element's theme attribute. If that attribute is also not set, the default system theme is used. For more information, see Styles and themes .

Extra options for an activity's UI. Must be one of the following values.

For more information about the app bar, see Add the app bar .

This attribute was added in API level 14.

• Whether the soft keyboard is hidden or visible when the activity becomes the focus of user attention.
• Whether the activity's main window is resized smaller to make room for the soft keyboard or its contents pan to make the current focus visible when part of the window is covered by the soft keyboard.

The setting must be one of the values listed in the following table or a combination of one "state..." value plus one "adjust..." value. Setting multiple values in either group, such as multiple "state..." values, has undefined results. Individual values are separated by a vertical bar ( | ), as shown in the following example:

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

Values set here (other than "stateUnspecified" and "adjustUnspecified" ) override values set in the theme.

This attribute was introduced in API level 3.