В чем разница между singleTop и singleTask?

Разница между launchMode singleTop и singleTask

singleTop и singleTask — это два значения параметра launchMode в манифесте Android (или флаги запуска в Intent), которые управляют поведением Activity в back stack (стеке возврата). Хотя оба режима предотвращают создание множественных инстансов Activity, они делают это по-разному и имеют различные сценарии применения.

Основная концепция Back Stack в Android

Перед детальным разбором, важно понимать, что Back Stack — это стек, в котором хранятся запущенные активности в порядке "последним пришел — первым вышел" (LIFO). Когда пользователь нажимает кнопку "Назад", текущая активность уничтожается, и восстанавливается предыдущая.

Режим singleTop ("Одна наверху")

Режим singleTop проверяет, находится ли экземпляр искомой Activity уже на вершине стека (top of the stack). Если да, то новый Intent не создает новый экземпляр, а передается существующему через метод onNewIntent(). Если Activity не на вершине стека, создается новый экземпляр.

Ключевые характеристики singleTop:

• Локальная проверка: Проверяет только вершину стека.
• Множественные инстансы: В стеке может быть несколько инстансов одной и той же Activity, если они не находятся друг над другом.
• Метод обратного вызова: Для обработки нового Intent используется onNewIntent().
• Типичный use-case: Идеально для активности, которая может получать множественные вызовы и должна обновляться, а не создавать новые копии (например, экран уведомлений, экран поиска).

Пример в манифесте и коде:

<!-- AndroidManifest.xml -->
<activity
    android:name=".SearchActivity"
    android:launchMode="singleTop" />

// SearchActivity.kt
class SearchActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_search)
        handleIntent(intent)
    }

    override fun onNewIntent(newIntent: Intent?) {
        super.onNewIntent(newIntent)
        // Новый Intent получен, когда Activity уже была на вершине стека.
        // Важно: использовать setIntent() и обработать данные заново.
        intent = newIntent
        handleIntent(newIntent)
    }

    private fun handleIntent(intent: Intent?) {
        // Обработка данных поиска из intent
    }
}

Режим singleTask ("Одна задача")

Режим singleTask более агрессивен. Он создает Activity в корне новой или существующей задачи (Task) и гарантирует, что в этой задаче существует только один экземпляр данной Activity. Если экземпляр уже существует где-либо в стеке своей задачи, система не создает новый, а, во-первых, уничтожает все активности, находящиеся сверху над этим экземпляром, а во-вторых, передает Intent существующему экземпляру через onNewIntent().

Ключевые характеристики singleTask:

• Глобальная проверка в рамках задачи: Проверяет всю задачу (Task) на наличие экземпляра.
• Очистка стека (Clearing the top): Удаляет все активности, находящиеся выше искомой, чтобы привести ее на вершину.
• Один инстанс на задачу: Гарантирует единственный экземпляр в своей задаче.
• Концепция задачи (Task): Может запустить новую "задачу" (отдельный стек) или использовать существующую, в зависимости от атрибутов taskAffinity.
• Типичный use-case: Применяется для главного экрана (Launcher Activity) или для активности, которая является логической "точкой входа" в отдельный модуль приложения и должна быть единственной в своем стеке (например, экран входа, главный хаб приложения).

Пример и важное замечание:

<!-- AndroidManifest.xml -->
<activity
    android:name=".MainActivity"
    android:launchMode="singleTask" />

Представьте стек: A -> B -> C (где C на вершине). Если из Activity C запустить MainActivity (объявленную как singleTask), и она уже находится в стеке как A, то результат будет:

1. Активности B и C будут уничтожены.
2. Стек станет: A (MainActivity).
3. MainActivity будет выведена на передний план, и у нее вызовется onNewIntent().

Сравнительная таблица

Заключение и практический совет

• Используйте singleTop, когда нужно обработать несколько намерений (Intents) в одной открытой активности, не создавая ее копий подряд. Это безопасный и предсказуемый режим.
• Используйте singleTask с большой осторожностью, в основном для корневой активности (root activity). Его способность очищать стек может привести к неожиданному пользовательскому опыту (потере контекста, внезапному возврату на главный экран). Часто более современной и контролируемой альтернативой для организации навигации являются Navigation Component с Single Top Graph или явная работа со стеком через флаги.

Важно: Начиная с Android 10 (API 29) и особенно с Android 11 (API 30), поведение singleTask и других режимов, влияющих на задачи, было дополнительно ограничено в целях безопасности и согласованности работы жестов навигации. Для сложной навигации всегда предпочтительнее использовать современные архитектурные компоненты.