Флаги запуска activity android

Начать деятельность

Сводка активности установлена ​​в singleTask

Сценарии применения

Сценарии использования этого режима во многом аналогичны почтовому ящику почтового клиента или временной шкале активности социальных приложений (круг друзей).

singleInstance

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

подводить итоги

1. При использовании в качестве цели startActivityForResult (в дальнейшем это относится к запускаемому действию)
   1. Версия 4.x. Запустить в новом стеке задач и немедленно вернуть resultCode of cancel в onActivityResult в действии, которое его запустило.Характеристики singleInstance по-прежнему
   2. Версия 5.x. Он не будет запускаться в новом стеке задач, а будет запускаться непосредственно в текущем стеке задач (появятся несколько экземпляров), и метод onActivityResult для действия, которое запустило его, будет вызывать обычный вызов после его закрытия.Дело в том, что запущенное им действие будет выполняться в другом новом стеке задач..

Сценарии применения

1. Интерфейс входящего вызова вызова InCallScreen

Часто используемый флаг намерения

FLAG_ACTIVITY_NEW_TASK

FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET | FLAG_ACTIVITY_NEW_DOCUMENT (API21)

Если это свойство включено в намерение, действие, к которому оно обращается, и все действия в этом действии будут удалены из задачи при сбросе задачи. Когда мы переводим фоновую задачу обратно на передний план, система при определенных обстоятельствах прикрепляет к этому действию флаг FLAG_ACTIVITY_RESET_TASK_IF_NEEDED, что означает, что задача сбрасывается при необходимости, а затем FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET вступит в силу. После тестирования для приложения в фоновом режиме, если вы щелкните приложение на панели запуска, это действие будет содержать метку FLAG_ACTIVITY_RESET_TASK_IF_NEEDED, нажать и удерживать кнопку «Домой», а затем щелкнуть последнюю запись, это действие не содержит метки FLAG_ACTIVITY_RESET_TASK_IF_NEEDED, поэтому первый будет очищен, второй не встретится.
Сценарии применения:
Например, мы хотим выбрать изображение в главном интерфейсе приложения, а затем запустить интерфейс просмотра изображений, но когда приложение восстанавливается из фона на передний план, в Чтобы избежать путаницы для пользователя, мы надеемся, что пользователь Вы по-прежнему будет видеть основной интерфейс вместо интерфейса просмотра изображений.В настоящее время нам нужно добавить эту отметку в Intent, когда мы перейдем к интерфейсу просмотра изображений.

FLAG_ACTIVITY_MULTIPLE_TASK

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

FLAG_ACTIVITY_CLEAR_TASK

FLAG_ACTIVITY_SINGLE_TOP

FLAG_ACTIVITY_CLEAR_TOP

FLAG_ACTIVITY_REORDER_TO_FRONT

FLAG_ACTIVITY_BROUGHT_TO_FRONT

FLAG_ACTIVITY_NO_HISTORY

FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS

FLAG_ACTIVITY_FORWARD_RESULT

FLAG_ACTIVITY_NO_USER_ACTION

FLAG_ACTIVITY_RETAIN_IN_RECENTS (API21)

FLAG_ACTIVITY_RESET_TASK_IF_NEEDED

FLAG_ACTIVITY_PREVIOUS_IS_TOP

Типичный сценарий находится на странице выбора приложения.Если вы щелкнете URL-адрес в тексте, чтобы перейти в браузер, и в системе установлено несколько приложений браузера, появится страница выбора приложения. Этот флаг будет использоваться, когда определенный браузер выбран для запуска на странице выбора приложения. Затем страница выбора приложения завершится сама, чтобы гарантировать, что она не вернется на страницу выбора при возврате из браузера.
Часто используется с FLAG_ACTIVITY_FORWARD_RESULT.

FLAG_ACTIVITY_TASK_ON_HOME

FLAG_EXCLUDE_STOPPED_PACKAGES

FLAG_DEBUG_LOG_RESOLUTION

Атрибуты деятельности, связанные с задачей

allowTaskReparenting

Следует отметить, что если приложение app1 не запускается снова после того, как приложение app1 переходит в фоновый режим, но приложение app2 запускается напрямую, вышеуказанное явление не произойдет. Действие повторного размещения происходит во время перезапуска appB.

alwaysRetainTaskState

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

clearTaskOnLaunch

finishOnTaskLaunch

documentLaunchMode

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

Источник

Tasks и Back Stack в Android

Итак. Каждое Android приложение, как минимум, состоит из фундаментальных объектов системы — Activity. Activity — это отдельный экран который имеет свою отдельную логику и UI. Количество Activity в приложении бывает разное, от одного до много. При переходах между различными Activity пользователь всегда может вернуться на предыдущую, закрытую Activity при нажатии кнопки back на устройстве. Подобная логика реализована с помощью стека (Activity Stack). Его организация «last in, first out» — т.е. последний вошел, первый вышел. При открытии новой Activity она становится вершиной, а предыдущая уходит в режим stop. Стек не может перемешиваться, он имеет возможность добавления на вершину новой Activity и удаление верхней текущей. Одна и та же Activity может находиться в стеке, сколько угодно раз.
Task — это набор Activity. Каждый таск содержит свой стек. В стандартной ситуации, каждое приложение имеет свой таск и свой стек. При сворачивании приложения, таск уходит в background, но не умирает. Он хранит весь свой стек и при очередном открытии приложения через менеджер или через launcher, существующий таск восстановится и продолжит свою работу.

Ниже покажу картинку, как работает стек.

Если продолжать нажимать кнопку back, то стек будет удалять Activity до того, пока не останется главная корневая. Если же на ней пользователь нажмет back, приложение закроется и таск умрет. Кстати, я говорил о том, что когда мы сворачиваем наше приложение и запускам например новое, то наш таск просто уходит в background и будет ждать момента, пока мы его вызовем. На самом деле есть одно «но». Если мы будем иметь много задач в background или же просто сильно нагружать свое устройство, не мала вероятность того, что таск умрет из за нехватки системных ресурсов. Это не война конечно, но то что мы потеряем все наши текущие данные и наш стек очистится — это точно. Кстати для избежания потери данных в таком случаи, вам стоит почитать про SavingActivityState.

Маленький итог

Управление тасками

Существует два пути для изменения стандартной организации тасков. Мы можем устанавливать специальные атрибуты в манифесте для каждой Activity. Также мы можем устанавливать специальные флаги для Intent, который запускает новую Activity с помощью startActivity(). Заметьте, что иногда атрибуты в манифесте и флаги в Intent могут противоречить друг другу. В этом случаи флаги Intent будут более приоритетны.

Атрибут launchMode

Для каждой Activity в манифесте можно указать атрибут launchMode. Он имеет несколько значений:

• standard — (по умолчанию) при запуске Activity создается новый экземпляр в стеке. Activity может размещаться в стеке несколько раз
• singleTop — Activity может распологаться в стеке несколько раз. Новая запись в стеке создается только в том случаи, если данная Activity не расположена в вершине стека. Если она на данный момент является вершиной, то у нее сработает onNewIntent() метод, но она не будет пересоздана
• singleTask — создает новый таск и устанавливает Activity корнeвой для него, но только в случаи, если экземпляра данной Activity нет ни в одном другом таске. Если Activity уже расположена в каком либо таске, то откроется именно тот экземпляр и вызовется метод onNewIntent(). Она в свое время становится главной, и все верхние экземпляры удаляются, если они есть. Только один экземпляр такой Activity может существовать
• singleInstance — тоже что и singleTask, но для данной Activity всегда будет создаваться отдельный таск и она будет в ней корневой. Данный флаг указывает, что Activity будет одним и единственным членом своего таска

На самом деле не важно, в каком таске открыта новая Activity. При нажатии кнопки back мы все равно вернемся на предыдущий таск и предыдущие Activity. Единственный момент, который нужно учитывать — это параметр singleTask. Если при открытии такой Activity мы достанем ее из другого background таска, то мы полностью переключаемся на него и на его стек. на картинке ниже это продемонстрировано.

Флаги

Как и говорил, мы можем устанавливать специальный флаги для Intent, который запускает новую Activity. Флаги более приоритетны, чем launchMode. Существует несколько флагов:

• FLAG_ACTIVITY_NEW_TASK — запускает Activity в новом таске. Если уже существует таск с экземпляром данной Activity, то этот таск становится активным, и срабатываем метод onNewIntent().
  Флаг аналогичен параметру singleTop описанному выше
• FLAG_ACTIVITY_SINGLE_TOP — если Activity запускает сама себя, т.е. она находится в вершине стека, то вместо создания нового экземпляра в стеке вызывается метод onNewIntent().
  Флаг аналогичен параметру singleTop описанному выше
• FLAG_ACTIVITY_CLEAR_TOP — если экземпляр данной Activity уже существует в стеке данного таска, то все Activity, находящиеся поверх нее разрушаются и этот экземпляр становится вершиной стека. Также вызовется onNewIntent()

Affinity

Стандартно все Activity нашего приложения работают в одном таске. По желанию мы можем изменять такое поведение и указывать, чтобы в одном приложении Activity работали в разных тасках, или Activity разных приложений работали в одном. Для этого мы можем в манифесте для каждой Activity указывать название таска параметром taskAffinity. Это строковое значение, которое не должно совпадать с названием package, т.к. стандартный таск приложения называется именно как наш пакет. В общем случаи данный параметр указывает, что Activity будет гарантированно открываться в своём отдельном таске. Данный параметр актуален, если мы указываем флаг FLAG_ACTIVITY_NEW_TASK или устанавливаем для Activity атрибут allowTaskReparenting=«true». Этот атрибут указывает, что Activity может перемещаться между тасками, который её запустил и таском, который указан в taskAffinity, если один из них становится активным.

Чистка стека

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

• alwaysRetainTaskState — если флаг установлен в true для корневой Activity, то стек не будет чиститься и полностью восстановится даже после длительного времени
• clearTaskOnLaunch — если установить флаг в true для корневой Activity, то стек будет чиститься моментально, как только пользователь покинет таск. Полная противоположность alwaysRetainTaskState
• finishOnTaskLaunch — работает аналогично clearTaskOnLaunch, но может устанавливаться на любую Activity и удалять из стека именно её

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

Источник