Навигация

Navigation – это фреймворк для перемещения между целевыми страницами в приложении для Android. Он предоставляет согласованный API независимо от того, реализованы ли целевые страницы как фрагменты, объекты activity или другие компоненты.
Последнее обновление Основная версия Релиз-кандидат Бета-версия Альфа-версия
23 сентября 2026 г. 2.10.2 - - -

Объявление зависимостей

Чтобы добавить зависимость от Navigation, необходимо добавить в проект репозиторий Google Maven. Подробную информацию можно найти в статье Репозиторий Google Maven.

Добавьте зависимости для нужных артефактов в файл build.gradle приложения или модуля:

Классный

plugins {
  // Kotlin serialization plugin for type safe routes and navigation arguments
  id 'org.jetbrains.kotlin.plugin.serialization' version '2.0.21'
}
  
dependencies {
  def nav_version = "2.10.2"

  // Jetpack Compose Integration
  implementation "androidx.navigation:navigation-compose:$nav_version"

  // Views/Fragments Integration
  implementation "androidx.navigation:navigation-fragment:$nav_version"
  implementation "androidx.navigation:navigation-ui:$nav_version"

  // Feature module support for Fragments
  implementation "androidx.navigation:navigation-dynamic-features-fragment:$nav_version"

  // Testing Navigation
  androidTestImplementation "androidx.navigation:navigation-testing:$nav_version"

  // JSON serialization library, works with the Kotlin serialization plugin.
  implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3"
}

Котлин

plugins {
  // Kotlin serialization plugin for type safe routes and navigation arguments
  kotlin("plugin.serialization") version "2.0.21"
}

dependencies {
  val nav_version = "2.10.2"

  // Jetpack Compose integration
  implementation("androidx.navigation:navigation-compose:$nav_version")

  // Views/Fragments integration
  implementation("androidx.navigation:navigation-fragment:$nav_version")
  implementation("androidx.navigation:navigation-ui:$nav_version")

  // Feature module support for Fragments
  implementation("androidx.navigation:navigation-dynamic-features-fragment:$nav_version")

  // Testing Navigation
  androidTestImplementation("androidx.navigation:navigation-testing:$nav_version")

  // JSON serialization library, works with the Kotlin serialization plugin
  implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3")
}

Safe Args

Чтобы добавить функцию Safe Args в ваш проект, укажите следующий classpath в файле build.gradle верхнего уровня:

Классный

buildscript {
    repositories {
        google()
    }
    dependencies {
        def nav_version = "2.10.2"
        classpath "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version"
    }
}

Котлин

buildscript {
    repositories {
        google()
    }
    dependencies {
        val nav_version = "2.10.2"
        classpath("androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version")
    }
}

Вам также необходимо установить один из двух доступных плагинов.

Чтобы сгенерировать код на языке Java, подходящий для модулей Java или смешанных модулей Java и Kotlin, добавьте следующую строку в файл build.gradle вашего приложения или модуля :

Классный

plugins {
  id 'androidx.navigation.safeargs'
}

Котлин

plugins {
    id("androidx.navigation.safeargs")
}

В качестве альтернативы, для генерации кода Kotlin, подходящего для модулей, работающих только с Kotlin, добавьте:

Классный

plugins {
  id 'androidx.navigation.safeargs.kotlin'
}

Котлин

plugins {
    id("androidx.navigation.safeargs.kotlin")
}

В файле gradle.properties необходимо добавить android.useAndroidX=true как описано в разделе "Переход на AndroidX" .

Информацию об использовании расширений Kotlin можно найти в документации по KTX.

Подробнее о добавлении зависимостей сборки…

Отзыв

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

Как создать выпуск

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

Версия 2.10.2

23 сентября 2026 г.

Данные "androidx.navigation:navigation-*:2.10.2" опубликованы. Версия 2.10.2 содержит эти коммиты.

Обновления зависимостей

  • Зависимости androidx.lifecycle обновлены до версии 2.10.0. I4505a9f9a

Версия 2.10.1

9 сентября 2026 г.

Данные "androidx.navigation:navigation-*:2.10.1" опубликованы. Версия 2.10.1 содержит эти коммиты.

Исправление ошибок

  • Теперь, когда NavHost пропускает анимацию, он также будет рассматривать sizeTransform как часть пропущенной анимации, чтобы предотвратить неожиданное обрезание. (I4f995, b/550924680)

Версия 2.10.0

26 августа 2026 г.

Данные "androidx.navigation:navigation-*:2.10.0" опубликованы. Версия 2.10.0 содержит эти коммиты.

Важные изменения, внесенные в версию 2.9.0

  • В NavHost теперь есть перегрузка, которая принимает параметры predictivePopEnterTransition и predictivePopExitTransition, чтобы можно было настроить переход при использовании жеста "Назад".
  • Файл handleDeepLink был изменен, чтобы обрабатывались только распознанные ссылки на контент, а все остальные игнорировались. Если это приводит к ошибке в приложении, попробуйте перейти на навигацию с помощью ссылок на контент, определенных в графе навигации. Для тестов Robolectric может потребоваться использовать метод setPackage для доверенного пакета.
  • Добавлен метод NavBackStackEntryInfo, который позволяет показывать снимки обратного стека во время событий навигации. Это позволяет создавать более сложные специальные анимации для предпросмотра для жеста "Назад".

Поддержка дополнительных платформ

  • В модули navigation-common, navigation-runtime и navigation-testing добавлена поддержка desktop, linux, macOS, iOS, javascript, WASM, watchos и tvos.

Версия 2.10.0-rc01

12 августа 2026 г.

Данные "androidx.navigation:navigation-*:2.10.0-rc01" опубликованы. Версия 2.10.0-rc01 содержит эти коммиты.

Изменения в поведении

  • Минимальная версия SDK для Navigation SDK перенесена на API 24 вместе с остальными библиотеками AndroidX. (I972da, b/474169350)

Версия 2.10.0-beta01

29 июля 2026 г.

Данные "androidx.navigation:navigation-*:2.10.0-beta01" опубликованы. Версия 2.10.0-beta01 содержит эти коммиты.

Изменения в API

  • Добавьте NavBackStackEntryInfo, чтобы показывать снимки обратного стека во время событий навигации. Это позволяет создавать более интересные анимации с предпросмотром для жеста "Назад". (Icb3b8)

Версия 2.10.0-alpha06

1 июля 2026 г.

Данные "androidx.navigation:navigation-*:2.10.0-alpha06" опубликованы. Версия 2.10.0-alpha06 содержит эти коммиты.

Исправление ошибок

  • Изменен метод handleDeepLink, чтобы обрабатывались только распознанные ссылки на контент (Id4fe3, b/509640056).
  • В ComposableFragment теперь используется полное имя из целевого сервиса, а не аргумент фрагмента для развертывания composable-функций. (I65ded, b/509640586)
  • Исправлен сбой в FragmentNavigator, из-за которого в допустимых фрагментах возникала ошибка IllegalArgumentException, когда операции были оптимизированы. (I093b0, b/340202276)
  • Исправлена ошибка в Navigation with Fragments, из-за которой программно заданный граф не восстанавливался должным образом. (I41251, b/321147435)

Версия 2.10.0-alpha05

19 мая 2026 г.

Данные "androidx.navigation:navigation-*:2.10.0-alpha05" опубликованы. Версия 2.10.0-alpha05 содержит эти коммиты.

Версия 2.10.0-alpha04

6 мая 2026 г.

Данные "androidx.navigation:navigation-*:2.10.0-alpha04" опубликованы. Версия 2.10.0-alpha04 содержит эти коммиты.

Исправление ошибок

  • Улучшена работа NavHost, чтобы предотвратить возможные NullPointerException, вызванные состоянием гонки при предпросмотре для жеста "Назад". (Ie36c6, b/500945998)

Версия 2.10.0-alpha03

22 апреля 2026 г.

Данные "androidx.navigation:navigation-*:2.10.0-alpha03" опубликованы. Версия 2.10.0-alpha03 содержит эти коммиты.

Исправление ошибок

  • Библиотека Compose compileSdk обновлена до API 37. Это означает, что при использовании Compose требуется минимальная версия AGP 9.2.0. (Id45cd, b/413674743)

Внешний вклад

  • Цели watchos и tvos добавлены в модули navigation-common, navigation-runtime и navigation-testing (I60e46).
  • Сделать DefaultNavTransitions общедоступным (Ide293)

Версия 2.10.0-alpha02

25 марта 2026 г.

Данные "androidx.navigation:navigation-*:2.10.0-alpha02" опубликованы. Версия 2.10.0-alpha02 содержит эти коммиты.

Версия 2.10.0-alpha01

11 марта 2026 г.

Данные "androidx.navigation:navigation-*:2.10.0-alpha01" опубликованы. Версия 2.10.0-alpha01 содержит эти коммиты.

Новые функции

  • В NavHost теперь есть перегрузка, которая принимает параметры predictivePopEnterTransition и predictivePopExitTransition, чтобы можно было настроить переход при использовании жеста "Назад". (Iac9b0, b/478294569)

Обновление минимальной версии SDK

  • Значение minSdk по умолчанию изменено с API 21 на API 23, как и в остальных библиотеках AndroidX. (Ibdfca, b/380448311, b/435705964, b/435705223)

Внешний вклад

  • navigation:navigation-common, navigation:navigation-runtime и navigation:navigation-testing теперь поддерживают настольные компьютеры, Linux, macOS, iOS, JavaScript и WASM в дополнение к Android. Благодарим Константина Цховребова (Konstantin Tskhovrebov). (I035d9, Iec624, I1615d)

Версия 2.9

Версия 2.9.8

22 апреля 2026 г.

Данные "androidx.navigation:navigation-*:2.9.8" опубликованы. Версия 2.9.8 содержит эти коммиты.

Исправление ошибок

  • Улучшена работа NavHost, чтобы предотвратить возможные NullPointerException, вызванные состоянием гонки при предпросмотре для жеста "Назад". (Ie36c6, b/500945998)

Версия 2.9.7

28 января 2026 г.

Данные "androidx.navigation:navigation-*:2.9.7" опубликованы. Версия 2.9.7 содержит эти коммиты.

Исправление ошибок

  • При использовании Navigation SafeArgs с сервисами Google больше не возникает проблем с кешированием конфигурации. (I57cda, b/458071608)
  • Исправлена ошибка, из-за которой конструктор SavedStateHandle в navigation-testing не декодировал List<String>. (I26aac,b/454180135)

Версия 2.9.6

5 ноября 2025 г.

Данные "androidx.navigation:navigation-*:2.9.6" опубликованы. Версия 2.9.6 содержит эти коммиты.

Исправление ошибок

  • Плагин Navigation SafeArgs перенесен в современные API плагина Android Gradle, что должно обеспечить его совместимость со всеми выпусками AGP 8.4.2+. В результате этих изменений выходной каталог для файлов, созданных плагином, был изменен на местоположение по умолчанию, предоставленное AGP. (Ie09d6, I7c431, b/203559535, b/293920476, b/269532448, b/443261197)
  • При использовании плагина Navigation SafeArgs с AGP 9.0.0-alpha04+ больше не нужно задавать свойство useAndroidX. (I6c3a4, b/444746731, b/443106400)

Версия 2.9.5

24 сентября 2025 г.

Данные "androidx.navigation:navigation-*:2.9.5" опубликованы. Версия 2.9.5 содержит эти коммиты.

Исправление ошибок

  • Navigation Safe Args теперь может обрабатывать поддержку встроенного Kotlin в AGP 9.0. (I1d9d76)

Обновление зависимостей

  • Плагин Navigation Safe Args теперь зависит от плагина Android Gradle версии 8.4.2. (b/431847270, I5932a)

Версия 2.9.4

10 сентября 2025 г.

Данные "androidx.navigation:navigation-*:2.9.4" опубликованы. Версия 2.9.4 содержит эти коммиты.

Исправление ошибок

  • Предотвращен сбой, который происходил, когда событие предпросмотра для жеста "Назад" доставлялось в середине кадра после отключения обработчика при переходе NavHost. (I5667c, b/384186542)

Версия 2.9.3

30 июля 2025 г.

Данные "androidx.navigation:navigation-*:2.9.3" опубликованы. Версия 2.9.3 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка в NavController, которая приводила к ConcurrentModificationException при использовании OnDestinationChangedListeners. (If7406, b/417784831)
  • Исправлена ошибка, из-за которой при использовании navigate(uri, navOptions,navigationExtras) игнорировались дополнительные параметры. (I67fb7, b/430336813)

Версия 2.9.2

16 июля 2025 г.

Данные "androidx.navigation:navigation-*:2.9.2" опубликованы. Версия 2.9.2 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой запись не возобновлялась, когда диалоговое окно над ней закрывалось (Idb20e, b/418746335).
  • Исправлена ошибка MissingFieldException, возникавшая при тестировании SavedStateHandle с типобезопасными маршрутами и использованием пользовательского NavTypes. (I2f843, b/421002511)

Версия 2.9.1

2 июля 2025 г.

Данные "androidx.navigation:navigation-*:2.9.1" опубликованы. Версия 2.9.1 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой NavEntries, созданные с помощью single top, не выходили за пределы CREATED в Lifecycle.State. (I043ba, b/421095236)

Версия 2.9.0

7 мая 2025 г.

Данные "androidx.navigation:navigation-*:2.9.0" опубликованы. Версия 2.9.0 содержит эти коммиты.

Важные изменения, начиная с версии 2.8.0

  • Действия Navigation Safe Args теперь генерируются с аннотацией @CheckResult, чтобы обеспечить их использование.

Интерфейс SupportingPane

  • Теперь в Custom Navigators можно помечать пункты назначения как реализующие интерфейс SupportingPane. Это указывает NavController, что такие пункты назначения будут показываться вместе с другими. Например, с помощью этого интерфейса можно одновременно RESUMED несколько целевых страниц.

Compose Kotlin Multiplatform

  • В Navigation теперь есть новая общая функция NavController.handleDeepLink(), которая принимает NavDeepLinkRequest вместо Intent. Это позволяет платформам, отличным от Android, правильно обрабатывать ссылки на контент. Спасибо, Константин Цховребов!
  • В Navigation теперь доступна функция NavUri – новый общий синтаксический анализатор, который представляет собой совместимый API для URI Android на других платформах. Это позволяет создавать URI независимо от платформы. Спасибо, Константин Цховребов!

Функции Type Safe

  • Типобезопасные API, которые ранее были доступны только через методы reified, то есть composable<YourScreen> теперь имеют нереализованные версии, которые напрямую принимают экземпляр KClass.
  • Типобезопасность навигации теперь поддерживает классы значений в качестве маршрута или типа аргумента маршрута.

Версия 2.9.0-rc01

23 апреля 2025 г.

Данные "androidx.navigation:navigation-*:2.9.0-rc01" опубликованы. Версия 2.9.0-rc01 содержит эти коммиты.

Исправление ошибок

  • Из Jetpack Navigation удалены все целевые платформы, кроме Android, поскольку они не работают. Вместо этого теперь предоставляются заглушки для разных платформ (I2877d).

Версия 2.9.0-beta01

9 апреля 2025 г.

Данные "androidx.navigation:navigation-*:2.9.0-beta01" опубликованы. Версия 2.9.0-beta01 содержит эти коммиты.

Изменения в API

  • Общий API parseStringAsNavUri заменен на фабричную функцию NavUri, которая принимает строку. (I4db6e, b/403616316)

Обновления зависимостей

  • Теперь эта библиотека предназначена для Kotlin 2.0 и требует KGP 2.0.0 или более поздней версии. (Idb6b5)

Версия 2.9.0-alpha09

26 марта 2025 г.

Данные "androidx.navigation:navigation-*:2.9.0-alpha09" опубликованы. Версия 2.9.0-alpha09 содержит эти коммиты.

Новые функции

  • Модуль navigation-testing теперь поддерживается на компьютерах, в Linux, macOS и iOS, а также на устройствах Android. (I2b770, b/398265336)
  • NavType теперь поддерживается на компьютерах, Linux, macOS и iOS в дополнение к Android. (I297d8)

Версия 2.9.0-alpha08

12 марта 2025 г.

Данные "androidx.navigation:navigation-*:2.9.0-alpha08" опубликованы. Версия 2.9.0-alpha08 содержит эти коммиты.

Исправление ошибок

  • Из Navigation 2.8.9: исправлена регрессия, обнаруженная в Navigation 2.8.8, из-за которой ссылка на контент считалась соответствующей запросу на установление связи или интенту, только если она точно совпадала со всеми их полями. Из-за этого ссылки на контент, которые содержали частичные совпадения полей и не имели других, перестали работать. (Ie5e36, b/399826566)

Внешний вклад

  • Новая функция синтаксического анализатора для создания NavUri. Спасибо, Константин Цховребов! (If0a6a)

Версия 2.9.0-alpha07

26 февраля 2025 г.

Данные "androidx.navigation:navigation-*:2.9.0-alpha07" опубликованы. Версия 2.9.0-alpha07 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой попытка выполнить saveState с неинклюзивным pop приводила к нулевому savedState, что могло вызвать сбой при восстановлении. (I9f3e8, b/395091644)
  • Начиная с версии Navigation 2.8.8 исправлено сопоставление NavDeepLink, при котором ссылка на контент и запрос на нее должны точно совпадать по URI, действию и MIME. Сопоставление больше не разрешено, если совпадают только одно или два поля. (I3b029, b/395712033)
  • Из Navigation 2.8.8: исправлена ошибка, из-за которой маршруты с подстановочными знаками не соответствовали добавленной ссылке на контент (I7ea92, b/389970341).

Внешний вклад

  • Извлеките API navigation-common, navigation-runtime и navigation-compose на общую платформу. Спасибо, Константин Цховребов! (I1e626, Ica76f, Idf479)

Известные проблемы

  • Из-за ошибки b/395712033 ссылки на контент должны содержать те же поля, что и запрос ссылки на контент и/или Intent. Ссылки на контент должны соответствовать только тем полям, которые в них есть. Поля, которые не включены в ссылки, должны игнорироваться. Проблема будет устранена в одном из следующих выпусков (b/399826566).

Версия 2.9.0-alpha06

12 февраля 2025 г.

Данные "androidx.navigation:navigation-*:2.9.0-alpha06" опубликованы. Версия 2.9.0-alpha06 содержит эти коммиты.

Новые функции

  • Действия Navigation Safe Args теперь генерируются с аннотацией @CheckResult, чтобы обеспечить их использование. (I14d4c, b/356323084)

Исправление ошибок

  • Исправлена ошибка в NavController, из-за которой состояния backStack неправильно восстанавливались в массив, когда они были сохранены в список. (Idfb9b)
  • Из Navigation 2.8.7: Navigation Safe Args теперь поддерживает composable-функции. (I35320, b/362791955)

Версия 2.9.0-alpha05

29 января 2025 г.

Данные "androidx.navigation:navigation-*:2.9.0-alpha05" опубликованы. Версия 2.9.0-alpha05 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой при использовании Navigation Compose возникала непредвиденная анимация масштабирования. (I480f4, b/353294030)
  • Навигация 2.8.6: ярлыки NavDestination, предоставленные через XML, будут обработаны с помощью NavType.get, чтобы обеспечить соблюдение пользовательской логики NavType. (I7ec2f, b/388100796)
  • Навигация 2.8.6. При переходе к действию с помощью dataPattern ActivityNavigator теперь пытается закодировать значение аргумента с помощью NavType аргумента. (I16376, b/383616432)
  • Navigation 2.8.5. Исправлена ошибка, из-за которой при использовании Navigation Compose и вызове navigate в том же кадре, в котором заканчивается текущая анимация, возникала непредвиденная анимация масштабирования. (I26cb1, b/353294030)

Версия 2.9.0-alpha04

11 декабря 2024 г.

Данные "androidx.navigation:navigation-*:2.9.0-alpha04" опубликованы. Версия 2.9.0-alpha04 содержит эти коммиты.

Новые функции

В таблице ниже приведены API Reified и KClass.

reified KClass
composable<TestClass> { } composable(TestClass::class) { }
navigation<NestedGraph>(startDestination = TestClass::class) navigation(route = NestedGraph::class, startDestination = TestClass::class)
dialog<TestClass> {} dialog(TestClass::class) {}
navDeepLink<TestClass>(baseUri) navDeepLink(TestClass::class, baseUri)
NavDeepLink.Builder.setUriPattern<TestClass>(baseUri) NavDeepLink.Builder.setUriPattern(TestClass::class, baseUri)
NavDestinationBuilder.deepLink<TestDeepLink>(baseUri) { } NavDestinationBuilder.deepLink(TestDeepLink::class, baseUri) { }
navController.getBackStackEntry<TestClass>() navController.getBackStackEntry(TestClass::class)
navController.popBackStack<TestClass>(true) navController.popBackStack(TestClass::class, true)
navController.clearBackStack<TestClass>() navController.clearBackStack(TestClass::class)
NavOptions.setPopUpTo<TestClass>() NavOptions.setPopUpTo(TestClass::class)
navOptions { popUpTo<TestClass> {...} } navOptions { popUpTo(TestClass::class) {...} }
NavGraph.setStartDestination<TestClass>() NavGraph.setStartDestination(TestClass::class)
NavGraph.findNode<TestClass>() NavGraph.findNode(TestClass::class)
backStackEntry.toRoute<TestClass>() backStackEntry.toRoute(TestClass::class)
savedStateHandle.toRoute<TestClass>() savedStateHandle.toRoute(TestClass::class)

Изменения в API

  • Перегрузка NavGraph.setStartDestination для типобезопасности, характерная для Kotlin, скрыта от источников Java. (Ic640c, b/364634035)

Исправление ошибок

  • Навигация 2.8.5. Исправлена ошибка, из-за которой NavHost мог вызывать исключение в PredictiveBackHandler, если обратный стек уменьшался до одной записи и в том же фрейме активировался системный возврат. (I1a429, b/375343407)
  • Навигация 2.8.5: исправлена ошибка NavDestination NullPointerException при обновлении startDestination графика. (I99421, b/361560785)

Внешний вклад

  • Из Navigation 2.8.5: типобезопасность Navigation теперь поддерживает List<Enum> в качестве типа аргумента маршрута без необходимости использовать пользовательский NavType. Спасибо, Csaba Kozák! (GH-725, b/375559962)

Версия 2.9.0-alpha03

13 ноября 2024 г.

Данные "androidx.navigation:navigation-*:2.9.0-alpha03" опубликованы. Версия 2.9.0-alpha03 содержит эти коммиты.

Новые функции

  • Типобезопасность навигации теперь поддерживает классы значений в качестве маршрута или типа аргумента маршрута. (I9344a, b/374347483)

Исправление ошибок

  • Исправлена ошибка ConcurrentModificationException, которая могла возникать, когда LifecycleObserver, прикрепленный к NavBackStackEntry, инициировал изменение обратного стека при изменении состояния жизненного цикла хоста LifecycleOwner, например содержащего его объекта Activity или Fragment. (Ia9494)

Версия 2.9.0-alpha02

30 октября 2024 г.

Данные "androidx.navigation:navigation-*:2.9.0-alpha02" опубликованы. Версия 2.9.0-alpha02 содержит эти коммиты.

Внешний вклад

  • Новый общий метод NavController.handleDeepLink(request: NavDeepLinkRequest). Спасибо, Константин Цховребов! (I3e228)

Версия 2.9.0-alpha01

16 октября 2024 г.

Данные "androidx.navigation:navigation-*:2.9.0-alpha01" опубликованы. Версия 2.9.0-alpha01 содержит эти коммиты.

Новые функции

  • Теперь в Custom Navigators можно помечать пункты назначения как реализующие интерфейс SupportingPane. Это указывает NavController, что такие пункты назначения будут показываться вместе с другими. Например, с помощью этого интерфейса можно одновременно RESUMED несколько целевых страниц. (Id5559)
  • Из Navigation 2.8.3: добавлены новые проверки lint для модулей navigation-common, navigation-runtime и navigation-compose, которые помогают выявлять типобезопасные маршруты, неправильно аннотированные с помощью @Serializable. Эта проверка применяется ко всем функциям расширения NavGraphBuilder и NavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816)
  • Навигация 2.8.3. Добавлены новые проверки lint для модулей navigation-common, navigation-runtime и navigation-compose, которые помогают выявлять типобезопасные маршруты с аргументами Enum, не аннотированными должным образом с помощью @Keep. Эта проверка применяется ко всем функциям расширения NavGraphBuilder и NavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)

Изменения в поведении

  • Попытка использовать NavController, который ранее был DESTROYED, теперь приведет к IllegalStateException. (I520da, b/369616172)

Исправление ошибок

  • Обновите исключение "Класс Enum не найден", чтобы предлагать использовать аннотацию @Keep, если класс Enum удаляется в минифицированных сборках. (I90e79, b/358137294)

Известные проблемы

  • В новых правилах lint, добавленных в версии Navigation 2.8.*, есть ошибка, которая приводит к ошибке Obsolete custom lint check при попытке запустить lint с плагином Android Gradle версии 8.4 или более поздней (b/368070326, b/371463741).

Версия 2.8

Версия 2.8.9

12 марта 2025 г.

Данные "androidx.navigation:navigation-*:2.8.9" опубликованы. Версия 2.8.9 содержит эти коммиты.

Исправление ошибок

  • Исправлена регрессия, обнаруженная в Navigation 2.8.8. Из-за нее ссылка на контент считалась соответствующей запросу или намерению, только если она точно совпадала со всеми их полями. Из-за этого ссылки на контент, которые содержали частичные совпадения полей и не имели других, перестали работать. (Ie5e36, b/399826566)

Версия 2.8.8

26 февраля 2025 г.

Данные "androidx.navigation:navigation-*:2.8.8" опубликованы. Версия 2.8.8 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой маршруты с подстановочными знаками не соответствовали добавленной ссылке на контент. (I7ea92, b/389970341)
  • NavDeepLink Исправлена ошибка, из-за которой ссылка на контент и запрос ссылки на контент должны были точно совпадать по URI, действию и MIME. Сопоставление больше не разрешено, если совпадают только одно или два поля. (I3227f, b/395712033)

Известные проблемы

  • Из-за ошибки b/395712033 в ссылках на контент должны быть те же поля, что и в запросе ссылки на контент и/или в Intent. Ссылки на контент должны соответствовать только тем полям, которые в них есть. Поля, которые не включены в ссылки, должны игнорироваться. Проблема будет устранена в одном из следующих выпусков (b/399826566).

Версия 2.8.7

12 февраля 2025 г.

Данные "androidx.navigation:navigation-*:2.8.7" опубликованы. Версия 2.8.7 содержит эти коммиты.

Исправление ошибок

  • Navigation Safe Args теперь поддерживает composable-функции. (I35320, b/362791955)

Версия 2.8.6

29 января 2025 г.

Данные "androidx.navigation:navigation-*:2.8.6" опубликованы. Версия 2.8.6 содержит эти коммиты.

Исправление ошибок

  • Ярлыки NavDestination, указанные в XML, будут обработаны с помощью NavType.get, чтобы обеспечить соблюдение логики NavType. (Id366d, b/388100796)
  • При переходе к действию с помощью dataPattern ActivityNavigator теперь будет пытаться закодировать значение аргумента с помощью NavType аргумента. (I1a71d, b/383616432)

Версия 2.8.5

11 декабря 2024 г.

Данные "androidx.navigation:navigation-*:2.8.5" опубликованы. Версия 2.8.5 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой NavHost мог вызывать исключение внутри PredictiveBackHandler, если обратный стек сокращался до одной записи и в том же фрейме запускался системный возврат. (I1a429, b/375343407)
  • Исправлена ошибка NavDestination NullPointerException, возникавшая при обновлении startDestination графа. (I99421, b/361560785)
  • Исправлена ошибка, из-за которой при использовании Navigation Compose и вызове navigate в том же кадре, в котором заканчивается текущая анимация, возникала непредвиденная анимация масштабирования. (I26cb1, b/353294030)
  • Исправлена ошибка ConcurrentModificationException, которая могла возникать, когда LifecycleObserver, прикрепленный к NavBackStackEntry, инициировал изменение обратного стека при изменении состояния жизненного цикла хоста LifecycleOwner, например содержащего его объекта Activity или Fragment. (Ia9494)

Внешний вклад

  • Типобезопасность навигации теперь поддерживает List<Enum> в качестве типа аргумента маршрута без необходимости использовать пользовательский NavType. Спасибо, Csaba Kozák! (GH-725, b/375559962)

Версия 2.8.4

13 ноября 2024 г.

Данные "androidx.navigation:navigation-*:2.8.4" опубликованы. Версия 2.8.4 содержит эти коммиты.

Новые функции

  • Из Navigation 2.9.0-alpha03: типобезопасность Navigation теперь поддерживает класс значений в качестве маршрута или типа аргумента маршрута (I9344a, b/374347483).

Исправление ошибок

Версия 2.8.3

16 октября 2024 г.

Данные "androidx.navigation:navigation-*:2.8.3" опубликованы. Версия 2.8.3 содержит эти коммиты.

Новые функции

  • Добавлены новые проверки lint для модулей navigation-common, navigation-runtime и navigation-compose, которые помогают выявлять типобезопасные маршруты, неправильно аннотированные с помощью @Serializable. Эта проверка применяется ко всем функциям расширения NavGraphBuilder и NavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816)
  • Добавлены новые проверки lint для модулей navigation-common, navigation-runtime и navigation-compose, чтобы помочь выявить типобезопасные маршруты с аргументами Enum, которые неправильно аннотированы с помощью @Keep. Эта проверка применяется ко всем функциям расширения NavGraphBuilder и NavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)

Исправление ошибок

  • Исправлена ошибка, из-за которой новые правила lint, добавленные в Navigation 2.8.*, вызывали ошибку Obsolete custom lint check при попытке запустить lint с плагином Android Gradle версии 8.4 или более поздней (I1be3d, b/368070326, b/371463741).

Известные проблемы

  • При попытке запустить Lint 16 (AGP 8.7) или более поздней версии с проверкой навигации будет возникать ошибка Obsolete custom lint check. (b/371926651)

Версия 2.8.2

2 октября 2024 г.

Данные "androidx.navigation:navigation-*:2.8.2" опубликованы. Версия 2.8.2 содержит эти коммиты.

Новые функции

  • Типобезопасность навигации теперь поддерживает сериализуемые классы, которые включают Double, Double?, DoubleArray, DoubleArray?, List<Double> и List<Double>?, без необходимости использовать пользовательский NavType. (I570eb, Ibc4c0, I37461, I5bed4, b/359245753)

Исправление ошибок

  • Улучшено сообщение об ошибке, возникающей, когда Навигации не удается сопоставить аргумент маршрута с NavType. Теперь сообщение содержит название аргумента, полное название аргумента и полное название маршрута. (Id8416, b/346264232)

Версия 2.8.1

18 сентября 2024 г.

Данные "androidx.navigation:navigation-*:2.8.1" опубликованы. Версия 2.8.1 содержит эти коммиты.

Новые функции

  • Добавлено новое правило lint, которое обеспечивает использование функции popBackStack, принимающей материализованный тип класса, при попытке popBackStack с помощью типобезопасных API. (Ief161, b/358095343)

Исправление ошибок

  • Теперь для навигации требуется, чтобы маршрут, переданный в startDestination NavGraph, содержал значения для всех обязательных аргументов, включая аргументы, которые не могут иметь значение null и не имеют значения по умолчанию. (I18e74, b/362594265)
  • В Navigation Safe Args добавлена поддержка строк, не допускающих значения NULL, поэтому значения "null" будут обрабатываться и сохраняться в пакете как есть. Это отличается от существующего поведения, когда значения "null" обрабатываются в объект NULL. Это изменение касается только типов String, не допускающих значения NULL. Строки, допускающие значение NULL, остаются без изменений. (I08b4a, b/348936238)
  • Теперь на NavDestination можно ссылаться только с помощью ссылки на контент, которая была явно добавлена в целевой объект. Это также означает, что вы можете перейти к маршруту пункта назначения только с помощью перегрузки функции navigate, которая принимает строковый маршрут. Это устраняет уязвимость, которая позволяла создавать ссылки на контент, ведущие на потенциально защищенную целевую страницу. (Ie30e6)

Обновление зависимостей

  • Navigation Safe Args теперь зависит от Kotlin 1.9.24, а не от Kotlin 2.X, поэтому разработчикам не нужно обновлять версию. (a4129a)
  • Navigation Compose теперь зависит от Compose 1.7.2.

Версия 2.8.0

4 сентября 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0" опубликованы. Версия 2.8.0 содержит эти коммиты.

Важные изменения, внесенные в версию 2.7.0

Типобезопасность Navigation Kotlin DSL

  • Навигация теперь обеспечивает типобезопасность для Kotlin DSL (используется Navigation Compose) с помощью сериализации Kotlin, что позволяет определять пункты назначения в графе навигации через типобезопасные объекты и классы данных:
    // Define a home destination that doesn't take any arguments
    @Serializable
    object Home

    // Define a profile destination that takes an ID
    @Serializable
    data class Profile(val id: String)

    // Now define your NavHost using type safe objects
    NavHost(navController, startDestination = Home) {
        composable<Home> {
            HomeScreen(onNavigateToProfile = { id ->
                navController.navigate(Profile(id))
            })
        }
        composable<Profile> { backStackEntry ->
            val profile: Profile = backStackEntry.toRoute()
            ProfileScreen(profile)
        }
    }

Дополнительную информацию можно найти в записи блога Navigation Compose meet Type Safety.

Предпросмотр для жеста "Назад" в Navigation Compose

  • Navigation Compose теперь поддерживает предпросмотр для жеста "Назад" в приложении благодаря новым API SeekableTransitionState из compose-animation. Это позволяет использовать жест "Назад", чтобы увидеть предыдущий пункт назначения с вашим пользовательским переходом, прежде чем решить, зафиксировать ли транзакцию с помощью завершенного жеста или отменить.

Composable-функция Navigation Fragment

  • Добавлен новый артефакт navigation-fragment-compose, который включает альтернативу ComposableNavHostFragment для NavHostFragment, позволяющую добавлять composable-функции в XML-файлы навигации. Каждый пункт назначения composable должен быть выражен как метод верхнего уровня без аргументов @Composable, полное имя которого используется в качестве атрибута android:name для каждого пункта назначения. При переходе к одному из этих пунктов назначения создается содержащий фрагмент для отображения composable-функции.
  // In HomeScreen.kt
  @Composable
  fun HomeScreen() {
    // Your Composable content here
  }

  // In your navigation.xml
  <composable
    android:id="@+id/home_screen"
    android:name="com.example.HomeScreenKt\$HomeScreen" />

Другие изменения

  • Navigation Compose теперь зависит от Compose 1.7.0.
  • В Navigation теперь есть новый класс CollectionNavType<T>, подкласс NavType<T> для аргументов на основе коллекций, таких как списки, массивы и карты. Все массивы NavType по умолчанию (IntArrayType, LongArrayType, FloatArrayType, BoolArrayType и StringArrayType) теперь наследуются от этого нового класса.
  • В NavType теперь есть встроенная поддержка списков Int, String, Boolean, Float и Long.

Версия 2.8.0-rc01

21 августа 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0-rc01" опубликованы. Версия 2.8.0-rc01 содержит эти коммиты.

Исправление ошибок

  • Исправлен сбой навигации при передаче классов Enum верхнего уровня в качестве типобезопасных аргументов. (I0ba76, b/358137294)
  • Navigation 2.8 теперь корректно работает с SDK 34 и не перейдет на SDK 35 до выпуска версии 2.9 вместе с остальными библиотеками AndroidX. (b/358798728)

Версия 2.8.0-beta07

7 августа 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0-beta07" опубликованы. Версия 2.8.0-beta07 содержит эти коммиты.

Известные проблемы

  • Из-за ошибки b/358137294 по умолчанию поддерживаются только перечисления, вложенные в другой класс. Перечисления верхнего уровня будут поддерживаться в следующем выпуске.

Исправление ошибок

  • При навигации к дублирующимся или общим пунктам назначения приоритет будет отдаваться ближайшему подходящему пункту назначения из текущего местоположения на графике. (Ic89a4, b/352006850)
  • В навигацию в Safe Args добавлен новый NavType.EnumType. Это означает, что для типов Enum больше не требуются специальные NavType. Обратите внимание, что SerialName Enum должно быть полным именем по умолчанию. (I66d22, b/346475493)
  • В Safe Args для навигации добавлена встроенная поддержка типов аргументов, допускающих значение NULL, включая Int?, Long?, Float?, Boolean? и Enum<*>?. (I32d13,I1c580,Ifba66,I978b0,Ide076 , b/351994237)
  • Теперь startDestination NavGraph будет использовать значения аргументов по умолчанию, если маршрут startDestination, переданный в NavGraph, точно равен startDestination.route. I13762, b/354046047

Версия 2.8.0-beta06

24 июля 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0-beta06" опубликованы. Версия 2.8.0-beta06 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой проверки WrongStartDestinationType не проверяли объекты-компаньоны в переданном типе класса, в результате чего не удавалось обнаружить ошибку. (I92b09)

Версия 2.8.0-beta05

10 июля 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0-beta05" опубликованы. Версия 2.8.0-beta05 содержит эти коммиты.

Исправление ошибок

  • Исправлен сбой навигации singleTop, когда вложенные NavGraphs используют один и тот же маршрут startDestination. (I17b94, b/294408596)

Версия 2.8.0-beta04

26 июня 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0-beta04" опубликованы. Версия 2.8.0-beta04 содержит эти коммиты.

Исправление ошибок

  • В Navigation теперь поддерживается навигация с пустыми строками в аргументах пути. (Ic5dbd, b/339481310)
  • Улучшено сообщение об ошибке для пользовательских сериализаторов, объявленных непосредственно в полях класса с помощью @Serializable(with =...), чтобы уточнить, что эта функция в настоящее время не поддерживается. (I052b0, b/341319151)
  • SavedStateHandleFactory Тестовый API теперь можно использовать в тестах, не связанных с Android, но для этого потребуется Robolectric, чтобы поддерживать синтаксический анализ аргументов с помощью пакетов. (I76cdc, b/340966212)
  • Исправлен сбой, возникавший при восстановлении состояния после завершения процесса и возобновления работы приложения, в котором используется типобезопасная навигация в Compose. (Ia8f38, b/341801005)
  • Исправлена ошибка в Navigation Compose, из-за которой после отмены предпросмотра для жеста "Назад" NavBackStackEntry, к которому возвращается пользователь, не возвращается в состояние жизненного цикла RESUMED. Это также гарантирует, что возвращающийся пункт назначения правильно анимируется обратно, а не встает на место после броска. (I97a0c, b/346608857)
  • При использовании предпросмотра для жеста "Назад" с Navigation Compose у всплывающего пункта назначения теперь будет правильный z-порядок, корректно анимируемый поверх входящего пункта назначения. (I2077b, b/345993681)

Версия 2.8.0-beta03

12 июня 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0-beta03" опубликованы. Версия 2.8.0-beta03 содержит эти коммиты.

Изменения в API

  • В CollectionNavType появился новый абстрактный метод emptyCollection(). Переопределите этот метод, чтобы обрабатывать пустую коллекцию, переданную в качестве аргумента. (Ie4d84, b/341723133)

Исправление ошибок

  • Добавлена документация по NavType.serializeAsValue и serializeAsValues, в которой подчеркивается, что конечные выходные данные должны быть закодированы в формате URI. (Ida6bd, b/344943214)
  • Исправлена ошибка, возникающая при вызове toRoute<T> с нулевым аргументом CollectionNavType. При навигации с нулевым значением CollectionNavType выходным аргументом будет значение по умолчанию, объявленное в вашем сериализуемом классе, или возвращаемое значение emptyCollection(), если значения по умолчанию нет. (I84158, Id630f, b/342672856)

Версия 2.8.0-beta02

29 мая 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0-beta02" опубликованы. Версия 2.8.0-beta02 содержит эти коммиты.

Исправление ошибок

  • Исправлен сбой ClassCastException при использовании NavBackStackEntry.toRoute с настраиваемым NavType, допускающим значение NULL. (I1c29b, b/342239473)
  • Исправлены проблемы с восстановлением состояния обратного стека навигации, возникавшие при попытке восстановить запись обратного стека, недоступную по идентификатору из текущего пункта назначения. Поскольку маршруты поддерживаются идентификаторами, это также повлияло на пункты назначения, созданные с помощью маршрутов. Это также устраняет сбой, вызванный вызовом clearBackStack(), который имел ту же основную проблему. (I423c3, b/339908057)

Версия 2.8.0-beta01

14 мая 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0-beta01" опубликованы. Версия 2.8.0-beta01 содержит эти коммиты.

Изменения в API

  • SavedStateHandle.toRoute() теперь принимает параметр typeMap для пользовательских типов аргументов. Ie39fb, b/339026523
  • В navigation-testing добавлен тестовый API для создания SavedStateHandle из сериализуемого объекта Kotlin. (Id4867, b/339080702)

Исправление ошибок

  • Добавлена документация по отсутствующим параметрам для функций Navigation Kotlin DSL. (I26a36)

Версия 2.8.0-alpha08

1 мая 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0-alpha08" опубликованы. Версия 2.8.0-alpha08 содержит эти коммиты.

Safe Args в Navigation Compose

Эта функция использует Kotlin Serialization, чтобы вы могли определять целевые страницы в графе навигации с помощью типобезопасных объектов и классов данных:

  // Define a home destination that doesn't take any arguments
  @Serializable
  object Home

  // Define a profile destination that takes an ID
  @Serializable
  data class Profile(val id: String)

  // Now define your NavHost using type safe objects
  NavHost(navController, startDestination = Home) {
      composable<Home> {
          HomeScreen(onNavigateToProfile = { id ->
              navController.navigate(Profile(id))
          })
      }
      composable<Profile> { backStackEntry ->
          val profile: Profile = backStackEntry.toRoute()
          ProfileScreen(profile)
      }
  }

Дополнительную информацию можно найти в записи блога Navigation Compose meet Type Safety.

Новые функции

  • Артефакт navigation-fragment-compose теперь предоставляет локальную композицию LocalFragment для composable-функций в ComposableFragment. (If35e5)
  • В NavType теперь есть встроенная поддержка списков Int, String, Boolean, Float и Long. (I4b6dd, Ia914c, b/188693139)

Версия 2.8.0-alpha07

17 апреля 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0-alpha07" опубликованы. Версия 2.8.0-alpha07 содержит эти коммиты.

Новые функции

  • Добавлен новый артефакт navigation-fragment-compose, который включает альтернативу ComposableNavHostFragment для NavHostFragment, позволяющую добавлять пункты назначения composable в XML-файлы навигации. Каждый пункт назначения composable должен быть выражен как метод верхнего уровня без аргументов @Composable, полное имя которого используется в качестве атрибута android:name для каждого пункта назначения. При переходе к одному из этих пунктов назначения создается содержащий фрагмент для отображения composable-функции. (I0ef2e, b/265480755)

    // In HomeScreen.kt
    @Composable
    fun HomeScreen() {
      // Your Composable content here
    }
    
    // In your navigation.xml
    <composable
      android:id="@+id/home_screen"
      android:name="com.example.HomeScreenKt\$HomeScreen" />
    

Изменения в API

  • Продолжается поддержка Safe Args в Navigation Compose с использованием подхода на основе сериализации Kotlin. Эти API не завершены и помечены аннотацией ExperimentalSafeArgsApi. Эта аннотация будет удалена, когда в одном из будущих выпусков будет полностью реализован весь API. (Iefd95, I409c8, I5b5ac, I7e753, I960f8, I3eabd, I8ed5a, Ied2c9, I9b73c, I554db, Ib3aba, Ia668d, b/188693139)

Версия 2.8.0-alpha06

3 апреля 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0-alpha06" опубликованы. Версия 2.8.0-alpha06 содержит эти коммиты.

Изменения в API

Исправление ошибок

  • NavHost теперь использует Alignment.TopStart в качестве аргумента contentAlignment по умолчанию. Это соответствует значению по умолчанию для AnimatedContent и исправляет некоторые случаи неожиданного масштабирования при переходе от центра. (I09e72, b/330111602)
  • При использовании Navigation Compose и жеста "Назад" NavHost теперь корректно завершает пользовательский переход, а не сразу закрывается. (I99017, b/327292110)

Версия 2.8.0-alpha05

20 марта 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0-alpha05" опубликованы. Версия 2.8.0-alpha05 содержит эти коммиты.

Новые функции

  • Теперь вы можете передавать аргументы в startDestination NavGraph напрямую в маршруте startDestination, не полагаясь на defaultValue. Это также относится к вложенным объектам NavGraph startDestinations. (I0e0b5, b/109505019, b/188693139)

Изменения в API

  • Добавлен новый абстрактный класс CollectionNavType<T>, подкласс NavType<T> для аргументов на основе коллекций, таких как списки, массивы и карты. (Ic6d63, b/188693139)
  • Все массивы NavType по умолчанию (IntArrayType, LongArrayType, FloatArrayType, BoolArrayType и StringArrayType) теперь имеют тип CollectionNavType (Idcf79, b/188693139).
  • В NavType теперь есть новый открытый API valueEquals, который определяет, равны ли два значения одного типа. (I6cb97, b/327229511)

Исправление ошибок

  • Параметры запроса в ссылках на контент теперь позволяют использовать значения в виде фигурных скобок вокруг имени аргумента (например, {argName}) в качестве допустимых значений для строкового NavTypes. Это устраняет проблему, из-за которой такое значение считалось недопустимым (или отсутствующим) для всех типов. (I18302, b/327274038)
  • Функции NavController, поддерживающие маршруты, например navigate или popBackStack, теперь могут правильно сопоставлять маршруты, заполненные аргументами массива NavTypes. (Iea805, b/327229511)

Версия 2.8.0-alpha04

6 марта 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0-alpha04" опубликованы. Версия 2.8.0-alpha04 содержит эти коммиты.

Новые функции

  • Теперь вы можете указать SizeTranform для переходов в Navigation Compose, определив их как часть инициализации для функций composable и/или navigation. (I91062, b/296912651)

Исправление ошибок

  • Исправлена ошибка, из-за которой NavHost в Compose Navigation не показывал переход при использовании системной кнопки "Назад" без жеста. (Iceeae, b/325998468)

Версия 2.8.0-alpha03

21 февраля 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0-alpha03" опубликованы. Версия 2.8.0-alpha03 содержит эти коммиты.

Изменения в API

  • NavBackStackEntry.savedStateHandle теперь помечен как @MainThread, поскольку он использует код, который в любом случае должен находиться в основном потоке. (Ibb988, b/299523245)

Исправление ошибок

  • Исправлена ошибка в навигации, из-за которой NavGraph ViewModel DESTROYED слишком рано, так как ViewModel связанной записи не был частью сохраненного состояния. (Ib6bb7, b/317581849)

Обновление зависимостей

Версия 2.8.0-alpha02

7 февраля 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0-alpha02" опубликованы. Версия 2.8.0-alpha02 содержит эти коммиты.

Новые функции

  • Navigation Compose теперь поддерживает предпросмотр для жеста "Назад" в приложении благодаря новым API SeekableTransitionState из compose-animation. Это позволяет использовать жест "Назад", чтобы увидеть предыдущий пункт назначения с вашим пользовательским переходом, прежде чем решить, зафиксировать ли транзакцию с помощью завершенного жеста или отменить. (I8b8e9)

Версия 2.8.0-alpha01

24 января 2024 г.

Данные "androidx.navigation:navigation-*:2.8.0-alpha01" опубликованы. Версия 2.8.0-alpha01 содержит эти коммиты.

Исправление ошибок

  • Исправлена утечка BackStackState, из-за которой несколько вызовов saveState в пункте назначения приводили к сохранению нескольких состояний, но восстановить можно было только первое. (I598b0, b/309559751)
  • Исправлена ошибка, из-за которой аргументы, не являющиеся строками, неправильно отображались при использовании вспомогательных элементов NavigationUI для заполнения заголовков панелей приложений. (#636, b/316676794)

Обновление зависимостей

  • Navigation Compose теперь зависит от Compose 1.7.0-alpha01, что устраняет проблему, которая могла вызвать неожиданную анимацию масштабирования. (b/297258205)

Внешний вклад

  • Благодарим SimonMarquis за исправление ошибки отображения аргументов, не являющихся строками, при использовании вспомогательных функций NavigationUI для заполнения заголовков панелей приложений.

Версия 2.7.7

Версия 2.7.7

7 февраля 2024 г.

Данные "androidx.navigation:navigation-*:2.7.7" опубликованы. Версия 2.7.7 содержит эти коммиты.

Исправление ошибок

  • Перенесено из Navigation 2.8.0-alpha01: исправлена утечка BackStackState, из-за которой несколько вызовов saveState() в одном NavBackStackEntry приводили к сохранению нескольких состояний, но восстановить можно было только первое. (I598b0, b/309559751)
  • Перенесено из Navigation 2.8.0-alpha01. Исправлена ошибка, из-за которой аргументы, не являющиеся строками, отображались неправильно при использовании вспомогательных функций NavigationUI для заполнения заголовков панелей приложений. (#636, b/316676794)

Внешний вклад

  • Благодарим SimonMarquis за исправление ошибки отображения аргументов, не являющихся строками, при использовании вспомогательных функций NavigationUI для заполнения заголовков панелей приложений.

Версия 2.7.6

Версия 2.7.6

13 декабря 2023 г.

Данные "androidx.navigation:navigation-*:2.7.6" опубликованы. Версия 2.7.6 содержит эти коммиты.

Исправление ошибок

  • Функция NavGraph equals() теперь правильно учитывает узлы другого графа, а не только вызывающего. Это гарантирует, что графы с узлами, у которых разные идентификаторы, больше не будут считаться равными (I401cb, b/311414915).

Версия 2.7.5

Версия 2.7.5

1 ноября 2023 г.

Данные "androidx.navigation:navigation-*:2.7.5" опубликованы. Версия 2.7.5 содержит эти коммиты.

Повышение производительности

  • Значительно улучшена производительность (как с точки зрения времени, так и с точки зрения количества выделений) сравнения двух графиков. Это означает, что вызовы, такие как setGraph, которые внутренне сравнивают новый граф с существующим, выполняются намного быстрее и приводят к меньшему количеству пропущенных кадров. Благодарим Michał Z за тщательный анализ, который помог нам улучшить работу функции. (I6ad62)
  • Теперь NavHost будет отображать начальный пункт назначения при первом проходе композиции, а не ждать второго прохода для чтения обновленного состояния. (I439a7, b/304852206)

Исправление ошибок

  • Исправлена ошибка, из-за которой обратный стек извлекался, если вы вызывали setGraph несколько раз с одним и тем же графом, только если в графе был пункт назначения, содержащий ссылку для действия, связывающую два пункта назначения. (Ieaed7)
  • Диалоговые окна, которые были открыты и закрыты в быстрой последовательности, больше не будут попадать в список NavController.visibleEntries. (I67586, b/287969970)
  • Если запись извлекается, а затем меняется конфигурация, то ViewModel записи будет очищаться, если saveState имеет значение false. (Idf242, b/298164648)
  • Исправлена ошибка, из-за которой NavController мог обрабатывать одну и ту же ссылку на контент несколько раз, если обратный стек был полностью пуст до изменения конфигурации или вызова setGraph, только когда у входящего намерения был установлен флаг FLAG_ACTIVITY_NEW_TASK. (I73c7f)

Обновления зависимостей

  • Навигация с помощью фрагментов теперь зависит от Fragment 1.6.2. Это устраняет проблему, из-за которой экземпляры ViewModel вложенных фрагментов не очищались при вызове clearBackStack.

Версия 2.7.4

Версия 2.7.4

4 октября 2023 г.

Данные "androidx.navigation:navigation-*:2.7.4" опубликованы. Версия 2.7.4 содержит эти коммиты.

Новые функции

  • Добавлена поддержка popUpTo для использования маршрутов с аргументами, чтобы можно было вернуться к определенной записи, в которой используются именно эти аргументы. Это соответствует поддержке, реализованной в popBackStack. (I731f4, b/299255572)

Исправление ошибок

  • Исправлена ошибка, из-за которой при прерывании навигации другой навигацией с помощью popUpTo происходил сбой FragmentNavigator. (I3c848, b/301887045)
  • Исправлена ошибка, из-за которой при нажатии системной кнопки "Назад" currentDestination не обновлялся в соответствии с отображаемым фрагментом. (Id0d6c, b/289877514)
  • Жизненный цикл DialogFragment теперь будет правильно переходить в состояние RESUMED, когда диалоговое окно над ним закрыто. (I88f0d, b/301811387)

Версия 2.7.3

Версия 2.7.3

20 сентября 2023 г.

Данные "androidx.navigation:navigation-*:2.7.3" опубликованы. Версия 2.7.3 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка в навигации с фрагментами, из-за которой список visibleEntries содержал неверные записи. (I5caa9, b/288520638)
  • Исправлена ошибка, из-за которой целевой объект Floating Window (например, Dialogs, Bottomsheets и т.д.) не получал обратный вызов жизненного цикла RESUMED. (I3b866, b/287505132)

Версия 2.7.2

Версия 2.7.2

6 сентября 2023 г.

Данные "androidx.navigation:navigation-*:2.7.2" опубликованы. Версия 2.7.2 содержит эти коммиты.

Исправление ошибок

  • Навигация теперь зависит от Lifecycle 2.6.2. Это исправляет взаимодействие между rememberSaveable и NavHost в Navigation Compose, из-за которого состояние rememberSaveable пунктов назначения и любые экземпляры SavedStateHandle, принадлежащие ViewModel, не восстанавливались должным образом после завершения и повторного создания процесса. (b/298059596, b/289436035)
  • Исправлена ошибка, из-за которой при одновременном показе нескольких диалоговых окон в Navigation Compose частично скрытые окна (например, не верхнее) находились в состоянии жизненного цикла CREATED, а не STARTED. (aosp/2728520, b/289257213)
  • Исправлена ошибка, из-за которой при одновременном показе нескольких диалоговых окон в Navigation Compose закрытие верхнего окна приводило к тому, что новое верхнее окно застревало в состоянии жизненного цикла STARTED вместо того, чтобы правильно переходить в состояние RESUMED. (aosp/2629401, b/286371387)
  • Navigation Safe Args больше не создает экземпляр задачи, если она не выполняется. (I0e385, b/260322841)

Обновление зависимостей

  • Navigation Compose теперь зависит от Compose 1.5.1.

Версия 2.7.1

Версия 2.7.1

23 августа 2023 г.

Данные "androidx.navigation:navigation-*:2.7.1" опубликованы. Версия 2.7.1 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка в Navigation with Compose, из-за которой при использовании Scaffold могла возникать ошибка при попытке доступа к Lifecycle.State.DESTROYED ViewModel. (I1dc11, b/268422136)

Версия 2.7.0

Версия 2.7.0

9 августа 2023 г.

Данные "androidx.navigation:navigation-*:2.7.0" опубликованы. Версия 2.7.0 содержит эти коммиты.

Важные изменения с версии 2.6.0

Анимации из Accompanist

Теперь, когда AnimatedContent работает стабильно, мы смогли перенести код из Accompanist Navigation Animation обратно в Navigation Compose.

Это означает, что все возможности настройки пользовательских переходов, которые были в AnimatedNavHost, напрямую поддерживаются в NavHost.

В Accompanist Navigation Animation больше не будет изменений, и скоро мы официально прекратим поддержку этой библиотеки. Мы также опубликуем инструкции по обратному переходу на Navigation Compose. Если вы уже используете последнюю альфа-версию Accompanist (0.31.2-alpha), то вам нужно будет выполнить действия, описанные в руководстве по переносу, в обратном порядке. Других изменений API не потребуется. (b/197140101)

Исправление ошибок

  • NavHost в Navigation Compose теперь правильно перехватывает системные вызовы возврата, даже если действие было остановлено и возобновлено. (Icb6de, b/279118447)

Обновления зависимостей

  • Навигация теперь зависит от Compose 1.5.0, а не 1.1.0.

Версия 2.7.0-rc01

26 июля 2023 г.

Данные "androidx.navigation:navigation-*:2.7.0-rc01" опубликованы. Версия 2.7.0-rc01 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой лямбда-выражения EnterTransition и ExitTransition, созданные как часть NavHost, могли оставаться в памяти даже после удаления NavHost из композиции. (I893d0)

Известные проблемы

  • В Navigation 2.6.x есть проблема: при навигации с popUpTo может возникнуть ошибка IllegalArgumentException. Возможно, этой ошибки можно избежать, изменив структуру графа, как описано здесь. (b/287133013)

Версия 2.7.0-beta02

28 июня 2023 г.

Данные "androidx.navigation:navigation-*:2.7.0-beta02" опубликованы. Версия 2.7.0-beta02 содержит эти коммиты.

Исправление ошибок

  • В Navigation Compose теперь используется правильный порядок по оси Z для пользовательских переходов, в которых применяется навигация с параметром popUpTo (/Ib1c3a, b/285153947).

Версия 2.7.0-beta01

7 июня 2023 г.

Данные "androidx.navigation:navigation-*:2.7.0-beta01" опубликованы. Версия 2.7.0-beta01 содержит эти коммиты.

Исправление ошибок

  • NavHost в Navigation Compose теперь правильно перехватывает системные вызовы возврата, даже если Activity был STOPPED и RESUMED. (Icb6de, b/279118447)

Версия 2.7.0-alpha01

24 мая 2023 г.

Данные "androidx.navigation:navigation-*:2.7.0-alpha01" опубликованы. Версия 2.7.0-alpha01 содержит эти коммиты.

Анимации из Accompanist

Теперь, когда AnimatedContent работает стабильно, мы смогли перенести код из Accompanist Navigation Animation обратно в Navigation Compose.

Это означает, что все возможности настройки пользовательских переходов, которые были в AnimatedNavHost, напрямую поддерживаются в NavHost.

В Accompanist Navigation Animation больше не будет изменений, и скоро мы официально прекратим поддержку этой библиотеки. Мы также опубликуем инструкции по обратному переходу на Navigation Compose. Если вы уже используете последнюю альфа-версию Accompanist (0.31.2-alpha), то вам нужно будет выполнить действия, описанные в руководстве по переносу, в обратном порядке. Других изменений API не потребуется. (b/197140101)

Исправление ошибок

  • Navigation 2.6.0-rc02. Исправлена ошибка, из-за которой при навигации с помощью popUpTo и удалении фрагмента из обратного стека без повторного создания его представления переставала работать системная кнопка "Назад". (Ieb8d4, b/281726455)

Обновления зависимостей

  • Navigation теперь зависит от Compose 1.5.0-beta01.

Версия 2.6.0

Версия 2.6.0

7 июня 2023 г.

Данные "androidx.navigation:navigation-*:2.6.0" опубликованы. Версия 2.6.0 содержит эти коммиты.

Важные изменения в Navigation SDK, начиная с версии 2.5.0

  • arguments NavBackStackEntry и arguments, переданные в OnDestinationChangedListener, теперь являются лишь копией неизменяемых аргументов, созданных при переходе к пункту назначения. Это означает, что любые изменения, внесенные в эти наборы, не будут отражены при последующих доступах к arguments или другим экземплярам OnDestinationChangedListener.
  • NavDeepLink теперь поддерживает значения по умолчанию для массивов, что позволяет поддерживать повторяющиеся параметры запроса, которые будут сопоставляться с типом массива аргумента. В NavType теперь также есть метод по умолчанию, который можно переопределить, чтобы объединить два обработанных значения.
  • Пользовательские подклассы NavType теперь могут переопределять serializeAsValue для сериализации значения в строку, что позволяет полностью инкапсулировать сериализацию и десериализацию (через parseValue) в классе NavType. Теперь StringType переопределяет этот метод, чтобы вызвать Uri.encode для заданного String.

Важные изменения в Navigation Compose с версии 2.5.0

  • При предпросмотре composable-функции с помощью NavHost теперь по умолчанию будет показываться startDestination NavGraph.
  • NavController.popBackStack(route), NavController.getBackStackEntry(route), NavController.clearBackStack(route) теперь поддерживают маршруты с частично или полностью заполненными аргументами. Обратите внимание, что аргументы должны точно совпадать с аргументами записи.
  • Попытка создать пустой объект NavDeepLink с помощью navDeepLink Kotlin DSL теперь приведет к предупреждению о том, что для ссылки на контент требуется URI, действие и/или MIME-тип.

Важные изменения в навигации с помощью фрагментов, начиная с версии 2.5.0

  • NavHostFragment больше не перехватывает нажатие системной кнопки "Назад". Это позволяет базовому компоненту FragmentManager обрабатывать системный жест "Назад". Это позволяет Fragment 1.7.0-alpha01 и более поздним версиям предоставлять анимацию предпросмотра для жеста "Назад" в приложении на устройствах Android U.
  • Если при использовании навигации с фрагментами попытаться вручную выполнить операцию FragmentTransaction, которая добавляет фрагмент в обратный стек FragmentManager, теперь будет возникать ошибка IllegalArgumentException. Фрагменты всегда следует добавлять через API navigate().
  • Если в атрибутах app:data и app:dataPattern элемента activity в XML-файле навигации в качестве плейсхолдера используется точная строка ${applicationId}, то при заполнении он будет автоматически заменен на packageName контекста.
  • Теперь FragmentNavigator использует API переходов при навигации и всплывающих окнах NavBackStackEntries. Это означает, что NavBackStackEntry Lifecycle теперь будет ждать завершения специальных эффектов входа и выхода фрагмента, прежде чем перемещать их окончательный Lifecycle.State.
  • Теперь DialogFragmentNavigator использует API переходов при навигации и всплывающих окнах NavBackStackEntries. Это означает, что NavBackStackEntry Lifecycle будет ждать, пока DialogFragment Lifecycle не перейдет на DESTROYED, прежде чем перейти на DESTROYED.
  • Теперь NavHostFragment позволяет получить NavController сразу после того, как NavHostFragment будет прикреплен к FragmentManager, а не только после onCreate().
  • Поддержка динамических модулей функций в Navigation теперь зависит от библиотеки Play Feature Delivery.
  • Navigation Safe Args теперь зависит от плагина Android Gradle версии 7.3.0. Это означает, что теперь он совместим только с версиями 7.3.0 и выше.

Важные изменения в NavigationUI, начиная с версии 2.5.0

  • При передаче идентификатора графа навигации в AppBarConfiguration (например, через Menu) NavigationUI теперь считает пунктом назначения верхнего уровня только начальный пункт назначения этого графа навигации, а не помечает неправильно каждый пункт назначения в графе как пункт назначения верхнего уровня. Передача идентификатора отдельного целевого сервиса выполняется без изменений. Та же функция доступна для вашего кода через новую функцию isTopLevelDestination в AppBarConfiguration.
  • Интеграции setupWithNavController в NavigationUI для работы с верхней панелью приложения теперь будут анализировать значения R.string для аргументов ReferenceType, найденных в android:label, и преобразовывать их в строковые значения, а не выводить автоматически сгенерированное целое число ресурса.
  • Теперь NavigationUI предоставляет журналы, если не удается выполнить навигацию с помощью выбранного MenuItem.

Версия 2.6.0-rc02

24 мая 2023 г.

Данные "androidx.navigation:navigation-*:2.6.0-rc02" опубликованы. Версия 2.6.0-rc02 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой при навигации по фрагментам с помощью popUpTo и удалении фрагмента из обратного стека без повторного создания его представления переставала работать системная кнопка "Назад". (Ieb8d4, b/281726455)

Версия 2.6.0-rc01

10 мая 2023 г.

Данные "androidx.navigation:navigation-*:2.6.0-rc01" опубликованы. Версия 2.6.0-rc01 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка в навигации с фрагментами, из-за которой удаление фрагмента с помощью navigate с popUpTo в обратном вызове жизненного цикла onResume() приводило к IllegalStateException. (I21884, b/279644470)

Версия 2.6.0-beta01

19 апреля 2023 г.

Данные "androidx.navigation:navigation-*:2.6.0-beta01" опубликованы. Версия 2.6.0-beta01 содержит эти коммиты.

Новые функции

  • NavBackStackEntry теперь предоставляет собственную реализацию toString. (Iff00b)

Исправление ошибок

  • Если при использовании навигации с фрагментами попытаться вручную выполнить операцию FragmentTransaction, которая добавляет фрагмент в обратный стек FragmentManager, теперь будет возникать ошибка IllegalArgumentException. Фрагменты всегда следует добавлять через API navigate(). (I6d38e)
  • Если в одном фрейме есть navigate, который добавляет запись, и popBackStack, который ее удаляет, то верхняя запись в обратном стеке теперь будет стабильно возвращаться в RESUMED Lifecycle.State. (Id8067, b/276495952)

Версия 2.6.0-alpha09

5 апреля 2023 г.

Данные "androidx.navigation:navigation-*:2.6.0-alpha09" опубликованы. Версия 2.6.0-alpha09 содержит эти коммиты.

Исправление ошибок

  • Исправлены проверки недопустимых маршрутов. Теперь, если NavDestination содержит NavArgument, не допускающий значение NULL, маршрут этого пункта назначения должен содержать плейсхолдеры для аргументов с тем же именем, что и у NavArgument, не допускающего значение NULL. (Ic62bf, b/274697949)
  • Переходы по ссылкам на контент, основанные на Action/MimeType, теперь будут завершаться ошибкой, если в операции перехода отсутствует ненулевой NavArgument, требуемый NavDestination, которому соответствует Action/MimeType. (Ibfa17, b/271777424)
  • Когда NavController задает граф с тем же маршрутом и пунктами назначения, что и предыдущий, он заменяет текущие узлы графа и пункты назначения обратного стека новыми экземплярами. Исправлен сбой, возникавший при использовании onLaunchSingleTop без сохранения состояния в Navigation Compose. Это также исправляет ошибку, из-за которой переход к пунктам назначения, связанным с корневым графом, создает неправильный обратный стек. (I5bc58, b/275258161, b/275407804)

Версия 2.6.0-alpha08

22 марта 2023 г.

Данные "androidx.navigation:navigation-*:2.6.0-alpha08" опубликованы. Версия 2.6.0-alpha08 содержит эти коммиты.

Новые функции

  • Теперь NavHostFragment позволяет получить NavController сразу после того, как NavHostFragment будет прикреплен к FragmentManager, а не только после onCreate(). (Ic6382, b/220186282)

Исправление ошибок

  • Исправлена ошибка NullPointerException, возникавшая при извлечении вложенного графа, который включает аргумент, не допускающий значение NULL. (6b3581, b/249988437)
  • Если вы используете системную кнопку "Назад" после перехода с помощью popUpTo, состояние NavController вернется к правильной записи. (I3a8ec, b/270447657)
  • FragmentNavigator теперь правильно извлекает записи, когда обратный стек извлекается с помощью системной кнопки "Назад" или popBackStack(), независимо от того, используются ли в транзакции эффекты для фрагмента. (I81bdf)
  • Добавление фрагментов в FragmentManager FragmentNavigator без использования навигации больше не приводит к сбою. (b17204, b/274167493)

Обновления зависимостей

Версия 2.6.0-alpha07

8 марта 2023 г.

Данные "androidx.navigation:navigation-*:2.6.0-alpha07" опубликованы. Версия 2.6.0-alpha07 содержит эти коммиты.

Исправление ошибок

  • Варианты API getBackStackEntry, popBackStack и clearBackStack, которые принимают маршруты, теперь принимают шаблоны маршрутов с аргументами и параметрами запросов, допускающими значение NULL (I22294, b/269302500).
  • Исправлена ошибка, из-за которой вызов clearBackStack() из NavController не очищал сохраненное состояние в диспетчере фрагментов, связанном с очищенным обратным стеком. (Ic1cce, b/271190202)
  • Исправлена регрессия в версии 2.6.0-alpha06, из-за которой при использовании системной кнопки "Назад" для перехода между вкладками в BottomNavigationView выделялся неверный элемент MenuItem. (I634f6, b/270447657)
  • Исправлена регрессия в версии 2.6.0-alpha06, из-за которой NavBackStackEntry не переходили в состояние RESUMED при использовании Animation. (Ib3589, b/269646882)

Версия 2.6.0-alpha06

22 февраля 2023 г.

Данные "androidx.navigation:navigation-*:2.6.0-alpha06" опубликованы. Версия 2.6.0-alpha06 содержит эти коммиты.

Новые функции

  • При предпросмотре composable-функции с помощью NavHost теперь по умолчанию будет показываться startDestination NavGraph. (I2b89f)

Изменения в API

  • Все перегрузки NavController navigate теперь аннотированы с помощью @MainThread, чтобы они вызывались в основном потоке. (I2c0b0, b/263427111)

Исправление ошибок

  • Исправлен сбой, возникавший при попытке навигации с использованием динамической навигации по фрагментам. (I3ee29, b/268360479)
  • Исправлена ошибка, из-за которой при переходе к другому фрагменту с помощью системной кнопки "Назад" на нижней панели не обновлялся выбранный элемент (If559f, b/269044426).

Известные проблемы

  • При использовании навигации с фрагментами жизненный цикл NavBackStackEntry не достигает RESUMED, если используются API Animation. (b/269646882)
  • При использовании навигации с фрагментами и навигации с помощью BottomNavigation, если вы попытаетесь восстановить обратный стек с несколькими записями, BottomMenuItem не будет обновлен правильно. (b/270447657)
  • При использовании навигации с фрагментами после восстановления состояния NavBackStackEntry Lifecycle не получает DESTROYED, когда его фрагмент DESTROYED . (b/270610768)

Версия 2.6.0-alpha05

8 февраля 2023 г.

Данные "androidx.navigation:navigation-*:2.6.0-alpha05" опубликованы. Версия 2.6.0-alpha05 содержит эти коммиты.

Новые функции

  • NavController.popBackStack(route), NavController.getBackStackEntry(route), NavController.clearBackStack(route) теперь поддерживают маршруты с частично или полностью заполненными аргументами. Обратите внимание, что аргументы должны точно совпадать с аргументами записи. (Iebd28, Ic678c, I3b37b, b/257514373)
  • Теперь FragmentNavigator использует API переходов при навигации и всплывающих окнах NavBackStackEntries. Это означает, что NavBackStackEntry Lifecycle теперь будет ждать завершения специальных эффектов входа и выхода фрагмента, прежде чем перемещать их окончательный Lifecycle.State. (I3cb19, b/238686802)
  • Теперь DialogFragmentNavigator использует API переходов при навигации и всплывающих окнах NavBackStackEntries. Это означает, что NavBackStackEntry Lifecycle будет ждать, пока DialogFragment Lifecycle не перейдет на DESTROYED, прежде чем перейти на DESTROYED. (I53ee5, b/261213893)

Изменения в API

  • В NavigatorState теперь есть API prepareForTransition, который позволяет Navigator перемещать NavBackStackEntries в промежуточные Lifecycle.State. (I42c21, b/238686802)
  • Теперь вы можете получить доступ к обратному стеку, связанному с NavGraphNavigator или ComposeNavigator, через свойство backstack. В ComposeNavigator теперь также есть обратный вызов onTransitionComplete(), который позволяет отметить NavBackStackEntry, выполнивший операцию перехода или popBackStack, как завершенный. (I02062, I718db, b/257519195)

Исправление ошибок

  • Теперь состояние навигатора будет игнорироваться, если используются API push/popWithTransition и запись уже обрабатывается. (Iadbfa, b/261213893)
  • При использовании launchSingleTop с вложенным NavGraph все пункты назначения, начиная с исходного и заканчивая startDestination, будут правильно добавлены только в верхнюю часть стека возврата. (Id4bea, b/253256629)
  • Теперь при переходе к тому же пункту назначения с флагом launchSingleTop, установленным в значение true, навигация будет правильно заменять экземпляр DialogFragment. (I45b5a, b/149572817)
  • Navigation SafeArgs больше не будет вызывать ошибку компиляции при использовании аргументов длиной ровно 19 символов. (Id60bc, b/257110095)

Версия 2.6.0-alpha04

9 ноября 2022 г.

Данные "androidx.navigation:navigation-*:2.6.0-alpha04" опубликованы. Версия 2.6.0-alpha04 содержит эти коммиты.

Новые функции

  • Пользовательские подклассы NavType теперь могут переопределять serializeAsValue для сериализации значения в строку, что позволяет полностью инкапсулировать сериализацию и десериализацию (через parseValue) в классе NavType. Теперь StringType переопределяет этот метод, чтобы вызвать Uri.encode для заданного String. (Ie5213, b/247637434)
  • Теперь NavigationUI предоставляет журналы, если не удается выполнить навигацию с помощью выбранного MenuItem. (I2af5a, b/247730357)

Исправление ошибок

  • Ссылки на контент для навигации теперь анализируются лениво, а не при инициализации графа, что может повысить производительность приложения при запуске. (Iab0ab)
  • Исправлен сбой, возникавший при переходе вверх после перехода по ссылке на контент в пункт назначения с нулевыми аргументами по умолчанию. (I51c24, b/243183636)

Обновление зависимостей

  • Поддержка динамических модулей функций в Navigation теперь зависит от библиотеки Play Feature Delivery. (Ib4ddc)
  • Navigation Safe Args теперь зависит от плагина Android Gradle версии 7.3.0. Это означает, что теперь он совместим только с версиями 7.3.0 и более поздними. (I47e49)

Версия 2.6.0-alpha03

24 октября 2022 г.

Данные "androidx.navigation:navigation-*:2.6.0-alpha03" опубликованы. Версия 2.6.0-alpha03 содержит эти коммиты.

Исправление ошибок

  • Навигация 2.5.3. NavHost больше не будет вызывать NoSuchElementException, если для Crossfade нет доступного пункта назначения. Теперь он просто пропустит композицию. (Ieb46e, b/253299416)
  • Навигация 2.5.3. Исправлена ошибка, из-за которой сохраненное состояние Compose (например, использование rememberSaveable) не забывалось и не удалялось, когда целевой объект извлекался из обратного стека. (I64949)

Обновления зависимостей

Версия 2.6.0-alpha02

5 октября 2022 г.

Данные "androidx.navigation:navigation-*:2.6.0-alpha02" опубликованы. Версия 2.6.0-alpha02 содержит эти коммиты.

Изменения в поведении

  • При передаче идентификатора графа навигации в AppBarConfiguration (например, через Menu) NavigationUI теперь считает пунктом назначения верхнего уровня только начальный пункт назначения этого графа навигации, а не помечает неправильно каждый пункт назначения в графе как пункт назначения верхнего уровня. Передача идентификатора отдельного целевого сервиса выполняется без изменений. Та же функция доступна для вашего кода через новую функцию isTopLevelDestination в AppBarConfiguration. (Ie936e, b/238496771)

Исправление ошибок

  • Компонент navigation:navigation-fragment теперь зависит от версии фрагмента 1.5.2. (I00ba4)
  • Выбранный пункт меню больше не будет обновляться при переходе к целевому объекту FloatingWindow, например диалоговому окну. (I4cde8, b/240308330)

Версия 2.6.0-alpha01

7 сентября 2022 г.

Данные "androidx.navigation:navigation-*:2.6.0-alpha01" опубликованы. Версия 2.6.0-alpha01 содержит эти коммиты.

Новые функции

  • Интеграции setupWithNavController в NavigationUI для работы с верхней панелью приложения теперь будут анализировать значения R.string для аргументов ReferenceType, найденных в android:label, и преобразовывать их в строковые значения, а не выводить автоматически сгенерированное целое число ресурса. (I5f803, b/167959935)
  • NavDeepLink теперь поддерживает значения по умолчанию для массивов, что позволяет поддерживать повторяющиеся параметры запроса, которые будут сопоставляться с типом массива аргумента. В NavType теперь также есть метод по умолчанию, который можно переопределить, чтобы объединить два обработанных значения. (Id68c3, b/209977108)
  • Если использовать точную строку ${applicationId} в качестве плейсхолдера в атрибутах app:data и app:dataPattern в элементе activity XML-файла навигации, то при заполнении плейсхолдер будет автоматически заменен на packageName контекста. (Iaabde, b/234223561)
  • Попытка создать пустой объект NavDeepLink с помощью navDeepLink Kotlin DSL теперь приведет к предупреждению о том, что для ссылки на контент требуется URI, действие и/или MIME-тип. (I08d2f, b/154038883)

Изменения в API

  • Добавлена новая функция расширения NavDestination, которая позволяет преобразовывать динамические ярлыки с аргументами в формате android:label="{arg}" в строку. Поддерживает аргументы ReferenceType, преобразуя значения R.string в строковые значения. (I07d89, b/236269380)

Изменения в поведении

  • arguments NavBackStackEntry и arguments, переданные в OnDestinationChangedListener, теперь являются лишь копией неизменяемых аргументов, созданных при переходе к пункту назначения. Это означает, что любые изменения, внесенные в эти наборы, не будут отражены при последующих доступах к arguments или другим экземплярам OnDestinationChangedListener. (I676f5)

Исправление ошибок

  • Навигация 2.5.2. Теперь динамическая навигация пытается установить целевые действия из других модулей, прежде чем перейти к ним. (Ia2c16, b/240292838)
  • Изменения в Navigation 2.5.2. Теперь при переходе к тому же пункту назначения и установке флага launchSingleTop в значение true Navigation будет правильно заменять экземпляр Fragment. (I5a2f1, b/237374580)
  • Навигация 2.5.2: исправлена ошибка IllegalStateException, возникавшая при переходе к дважды вложенному графу, у которого есть общий родительский элемент с новым целевым объектом. (I9f7cb, b/243778589)

Версия 2.5

Версия 2.5.3

24 октября 2022 г.

Данные "androidx.navigation:navigation-*:2.5.3" опубликованы. Версия 2.5.3 содержит эти коммиты.

Исправление ошибок

  • NavHost больше не будет вызывать NoSuchElementException, если нет доступного целевого сервиса для создания Crossfade. Теперь он просто пропустит композицию. (Ieb46e, b/253299416)
  • Исправлена ошибка, из-за которой сохраненное состояние Compose (например, использование rememberSaveable) не забывалось и не удалялось, когда целевой объект извлекался из обратного стека. (I64949)

Версия 2.5.2

7 сентября 2022 г.

Данные "androidx.navigation:navigation-*:2.5.2" опубликованы. Версия 2.5.2 содержит эти коммиты.

Исправление ошибок

  • Теперь динамическая навигация правильно пытается установить целевые действия из других модулей перед переходом к ним. (Ia2c16, b/240292838)
  • Теперь при переходе к тому же пункту назначения и установке для флага launchSingleTop значения true навигация будет правильно заменять экземпляр Fragment. (I5a2f1, b/237374580)
  • Исправлена ошибка IllegalStateException, возникавшая при переходе к дважды вложенному графу, у которого есть общий родительский элемент с новым извлеченным начальным пунктом назначения. (I9f7cb, b/243778589)

Обновление зависимостей

Версия 2.5.1

27 июля 2022 г.

Данные "androidx.navigation:navigation-*:2.5.1" опубликованы. Версия 2.5.1 содержит эти коммиты.

Исправление ошибок

  • Navigation Safe Args больше не будет вызывать предупреждения об устаревании в сгенерированных классах при использовании пользовательских типов аргументов, сохраненных в Bundle. (Id86ed, b/237725966)

Обновления зависимостей

Версия 2.5.0

29 июня 2022 г.

Данные "androidx.navigation:navigation-*:2.5.0" опубликованы. Версия 2.5.0 содержит эти коммиты.

Важные изменения, внесенные в версию 2.4.0

  • Интеграция CreationExtras. Теперь Navigation может предоставлять ViewModelProvider.Factory без отслеживания состояния через CreationExtras Lifecycle 2.5.0.

Navigation SafeArgs

  • В Navigation Safe Args зависимость Android Gradle Plugin обновлена до 7.0.4, поэтому совместимость с версиями AGP до 7.0 прекращена.
  • Добавлена поддержка атрибута build.gradle пространства имен, который можно использовать вместо applicationId.

Другие изменения

  • visibleEntries API больше не является экспериментальным и предоставляет функцию для получения всех записей, пункт назначения которых в настоящее время виден в соответствии с NavController.

Версия 2.5.0-rc02

15 июня 2022 г.

Данные "androidx.navigation:navigation-*:2.5.0-rc02" опубликованы. Версия 2.5.0-rc02 содержит эти коммиты.

Исправление ошибок

  • Исправлен сбой, возникавший при быстром переключении между нижними пунктами назначения в Navigation Compose NavHost. (I3979a, b/234054916)
  • Navigation SafeArgs больше не будет аварийно завершать работу при использовании applicationIdSuffix и пространства имен, если applicationId отсутствует или если applicationId и пространство имен не совпадают. (I754b1, b/233119646)
  • В NavArgument теперь есть специальная функция toString(), которая показывает внутренние значения аргумента. (I900a8)

Версия 2.5.0-rc01

11 мая 2022 г.

Данные "androidx.navigation:navigation-*:2.5.0-rc01" опубликованы. Версия 2.5.0-rc01 содержит эти коммиты.

Новые функции

  • Добавлено новое правило lint, которое предупреждает о размещении элементов <deeplink> внутри элементов <activity> в файле navigation.xml (Ic15a5, b/178403185).

Исправление ошибок

  • Области видимости composable-функций в NavHost и DialogHost теперь удаляются в ожидаемом порядке, то есть внутренние composable-функции удаляются раньше внешних. (I157e6)
  • Теперь в SafeArgs для навигации используется PathSensitivity.RELATIVE в ArgumentsGenerationTask, чтобы разрешить перемещение кеша. Это означает, что запись кеша теперь можно повторно использовать из сборки CI в локальную сборку. (I5f67c, b/173420454)
  • Правило линтинга UnrememberedGetBackStackEntryDetector было обновлено, чтобы вызов remember, окружающий вызов getBackStackEntry(), также передавал объект NavBackStackEntry в качестве ключа (Ib7081, b/227382831).

Версия 2.5.0-beta01

20 апреля 2022 г.

Данные "androidx.navigation:navigation-*:2.5.0-beta01" опубликованы. Версия 2.5.0-beta01 содержит эти коммиты.

Исправление ошибок

  • Теперь DialogNavigator использует popWithTransition при выполнении вызова dismiss(). Исправлено состояние гонки при использовании ViewModel в целевом объекте dialog, которое приводило к ошибке IllegalStateException при закрытии диалогового окна с помощью системной кнопки "Назад" или нажатия за пределами окна. (Id7376, b/226552301)

Обновления зависимостей

  • Навигация теперь зависит от Lifecycle 2.5.0-beta01, что устраняет IllegalStateException при вложении одного NavHost в другой NavHost на неосновной вкладке нижней панели навигации при использовании нескольких обратных стеков.

Версия 2.5.0-alpha04

6 апреля 2022 г.

Данные "androidx.navigation:navigation-*:2.5.0-alpha04" опубликованы. Версия 2.5.0-alpha04 содержит эти коммиты.

Изменения в API

  • visibleEntries больше не является экспериментальной функцией. (I4829f, b/225394514)

Исправление ошибок

  • NavHost теперь зависит от visibleEntries из NavController, чтобы определить, какие записи нужно составить. Это означает, что при использовании вложенного NavHost внутренний NavHost теперь должен правильно анимироваться. (I4ba2b, b/225394514)
  • visibleEntries StateFlow, предоставляемый NavController, теперь основан на максимальном статусе жизненного цикла записи, а не на текущем. Это означает, что даже если жизненный цикл хоста navController опустится ниже STARTED, список видимых записей останется прежним. (I9e2a8, b/225394514)
  • Теперь SavedStateViewFactory поддерживает использование CreationExtras, даже если он был инициализирован с помощью SavedStateRegistryOwner. Если указаны дополнительные параметры, инициализированные аргументы игнорируются. (I6c43b, b/224844583)
  • Теперь NavDeepLink может анализировать URI с одним параметром запроса без значения. (I0efe8, b/148905489)
  • Пустая строка теперь считается допустимым аргументом в ссылках на контент. (I70a0d, b/217399862)
  • Navigation Safe Args больше не будет аварийно завершать работу при использовании пространств имен и отсутствии AndroidManifest.xml. (I17ccf, b/227229815)

Версия 2.5.0-alpha03

23 февраля 2022 г.

Данные "androidx.navigation:navigation-*:2.5.0-alpha03" опубликованы. Версия 2.5.0-alpha03 содержит эти коммиты.

Изменения в API

  • Теперь вы можете передать CreationExtras в by navGraphViewModels, чтобы создать ViewModel. (I29217, b/217618359)

Исправление ошибок

  • NavDeepLinks теперь правильно поддерживает закодированные символы новой строки, встроенные в URI маршрутов и ссылок на контент. (I513d1, b/217815060)
  • CreationExtras теперь будет работать корректно при использовании с NavBackStackEntries для создания ViewModel. (I69161, b/217617710)
  • Navigation Safe Args теперь поддерживает использование пространства имен, определенного в build.gradle, вместо пакета в AndroidManifest. (I659ef, b/217414933)

Версия 2.5.0-alpha02

9 февраля 2022 г.

Данные "androidx.navigation:navigation-*:2.5.0-alpha02" опубликованы. Версия 2.5.0-alpha02 содержит эти коммиты.

Исправление ошибок

  • Навигация 2.4.1. Теперь NavHostFragment будет правильно устанавливать OnBackPressedDispatcher при использовании привязки представлений с вложенными графами. (Ifbb51, b/214577959)
  • Навигация 2.4.1. При использовании ссылок на контент в нескольких вложенных элементах NavGraph обратный стек теперь будет правильно включать промежуточные начальные пункты назначения. (I504c0, b/214383060)

Версия 2.5.0-alpha01

26 января 2022 г.

Данные "androidx.navigation:navigation-*:2.5.0-alpha01" опубликованы. Версия 2.5.0-alpha01 содержит эти коммиты.

Новые функции

Исправление ошибок

  • Исправлена ошибка, из-за которой при попытке получить доступ к ViewModel, созданному с помощью by navGraphViewModels() из onCreate() фрагмента, возникала ошибка IllegalStateException. (I8a14d)
  • NavDeepLink больше не будет декодировать аргументы дважды, а значит, в пункт назначения будут передаваться правильные аргументы. (I31b0a, b/210711399)

Safe Args

  • Safe Args теперь зависит от плагина Android Gradle версии 7.0.4. Это означает, что Navigation Safe Args больше не будет совместим с версиями Android Studio до 7.0, но теперь совместим с плагином Android Gradle версии 7.1.0 и выше. (I41c88, b/213086135, b/207670704)

Версия 2.4.2

Версия 2.4.2

6 апреля 2022 г.

Данные "androidx.navigation:navigation-*:2.4.2" опубликованы. Версия 2.4.2 содержит эти коммиты.

Исправление ошибок

  • Бэкпорт из Navigation 2.5.0-alpha03: NavDeepLinks теперь правильно поддерживает закодированные символы новой строки, встроенные в URI маршрутов и ссылок на контент. (I513d1, b/217815060)
  • Перенесено из Navigation 2.5.0-alpha03: Navigation SafeArgs теперь поддерживает использование пространства имен, определенного в build.gradle, вместо пакета в AndroidManifest. (I659ef, b/217414933)
  • Бэкпорт из Navigation 2.5.0-alpha04: Navigation Safe Args больше не будет аварийно завершать работу при использовании пространств имен и отсутствии AndroidManifest.xml. (I17ccf, b/227229815)
  • Перенесено из Navigation 2.5.0-alpha04: пустые строки теперь считаются допустимыми аргументами в ссылках на контент. (I70a0d, b/217399862)

Версия 2.4.1

Версия 2.4.1

9 февраля 2022 г.

Данные "androidx.navigation:navigation-*:2.4.1" опубликованы. Версия 2.4.1 содержит эти коммиты.

Исправление ошибок

  • Теперь NavHostFragment будет правильно устанавливать OnBackPressedDispatcher при использовании привязки представлений с вложенными графами. (Ifbb51, b/214577959)
  • При использовании ссылок на контент через несколько вложенных NavGraph обратный стек теперь будет правильно включать промежуточные начальные целевые страницы. (I504c0, b/214383060)
  • Перенесено из Navigation 2.5.0-alpha01. Устранена проблема, из-за которой при доступе к ViewModel, созданному с помощью by navGraphViewModels(), из onCreate() фрагмента возникала ошибка IllegalStateException. (I8a14d)
  • Перенесено из Navigation 2.5.0-alpha01: NavDeepLink больше не декодирует аргументы дважды, то есть в конечный пункт назначения передаются правильно декодированные аргументы. (I31b0a, b/210711399)
  • Бэкпорт из Navigation 2.5.0-alpha01: Safe Args теперь зависит от плагина Android Gradle версии 7.0.4. Это означает, что Navigation Safe Args больше не будет совместим с версиями Android Studio до 7.0, но теперь совместим с плагином Android Gradle версии 7.1.0 и выше. (I41c88, b/213086135, b/207670704)

Версия 2.4.0

Версия 2.4.0

26 января 2022 г.

Данные "androidx.navigation:navigation-*:2.4.0" опубликованы. Версия 2.4.0 содержит эти коммиты.

Важные изменения, внесенные в версию 2.3.0

  • Все артефакты навигации были переписаны на Kotlin. Это улучшило допустимость значения NULL для классов, использующих обобщения (например, подклассы NavType). Все функции-расширения Kotlin, которые раньше были частью артефактов -ktx, перенесены в соответствующие основные артефакты. Объекты -ktx будут по-прежнему публиковаться, но они будут пустыми.
  • Артефакт navigation-fragment теперь содержит встроенную реализацию двухпанельного макета через новый AbstractListDetailFragment. Этот фрагмент использует SlidingPaneLayout для управления панелью списка (которую предоставляет ваш подкласс) и панелью подробностей, которая использует NavHostFragment в качестве своей реализации, как показано в нашем примере реализации.
  • Метод currentBackStackEntryAsFlow() в NavController предоставляет Flow, который срабатывает при каждом изменении текущего NavBackStackEntry. Этот процесс можно использовать в качестве альтернативы ручному управлению OnDestinationChangedListener.
  • Теперь NavController позволяет получить список всех видимых экземпляров NavBackStackEntry в виде StateFlow с помощью экспериментального свойства visibleEntries.
  • Теперь можно расширить класс NavType, чтобы создавать собственные типы NavType. Специальные типы поддерживаются только при программном создании графа навигации, например с помощью Navigation Graph Kotlin DSL.
  • В Navigation теперь есть API findStartDestination() и getHierarchy(), которые можно использовать для реализации собственного NavigationUI. findStartDestination() – это функция расширения для NavGraph, которая находит фактический начальный пункт назначения, отображаемый при переходе к графу, даже если startDestination сам по себе является вложенным NavGraph. getHierarchy() – это функция в NavDestination, которая позволяет проверить, находится ли целевой объект в иерархии другого объекта.

    val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }
    
  • Методы NavigationUI, которые принимали BottomNavigationView, теперь принимают его надкласс, представленный в Material 1.4.0, NavigationBarView. Это позволяет использовать эти методы с NavigationRailView.

  • При заполнении элемента <action> с помощью XML атрибуты анимации могут использовать атрибуты, извлеченные из вашей темы с помощью синтаксиса app:enterAnim="?attr/transitionEnter".

  • Теперь Safe Args генерирует метод fromSavedStateHandle() для каждого класса NavArgs. (#122, b/136967621)

    class HomeViewModel(savedStateHandle: SavedStateHandle) : ViewModel() {
      // Create a HomeDestinationArgs class with type safe accessors for each argument
      // defined on your destination
      private val args = HomeDestinationArgs.fromSavedStateHandle(savedStateHandle)
    }
    

Маршруты навигации и Kotlin DSL

В предыдущих версиях Navigation у каждого пункта назначения был постоянный целочисленный идентификатор, который позволял отличить его от других пунктов назначения и navigate() к нему напрямую или с помощью действия. Этот подход по-прежнему актуален и полезен, особенно если вы определяете граф навигации в XML и можете использовать автоматически созданные константы R.id или Safe Args (которые используют эти константы для создания кода во время сборки). Однако система уникальных целых чисел не отражает семантическое значение и выразительность, необходимые для поддержки полностью динамических графов, созданных программно во время выполнения с помощью Navigation Kotlin DSL.

В этом выпуске представлен новый вариант уникальной идентификации пункта назначения на графе навигации по его маршруту. Маршрут – это String, определяющий уникальный путь к пункту назначения. Все методы Kotlin DSL, которые принимали идентификатор пункта назначения, теперь устарели и заменены эквивалентным API, который принимает маршрут.

Каждый маршрут должен рассматриваться как часть пути Uri, определяющего целевую страницу, например home, profile/{userId}, profile/{userId}/friends и т. д. Если идентификатор целевой страницы связан с определенным контентом, эти динамические аргументы должны быть частью маршрута и соответствовать тем же правилам, что и неявные ссылки на контент.

Все API NavController, которые раньше принимали только идентификатор, теперь имеют перегрузку, принимающую маршрут String. Это касается следующих стран: navigate(), popBackStack(), popUpTo() и getBackStackEntry().

Это повлияло на работу API:

  • Свойство Kotlin popUpTo в Kotlin DSL устарело и заменено на popUpToId.
  • Поддержка API getStartDestination() прекращена. Вместо него используйте getStartDestinationId().

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

Navigation Compose

Артефакт navigation-compose обеспечивает интеграцию между компонентом навигации и Jetpack Compose. В качестве пунктов назначения в приложении используются функции @Composable.

В этой версии внесены следующие изменения:

  • NavHost – composable-функция, которая позволяет создавать граф навигации с помощью Kotlin DSL, используя целевые страницы composable и dialog, а также поддерживает дополнительные навигаторы, например из Accompanist Navigation Material.
  • Обязательная поддержка кроссфейдинга между целевыми страницами. Accompanist Navigation Animation можно использовать для управления переходами входа и выхода с помощью экспериментальных API Compose.
  • Определение области действия Lifecycle для каждого составного пункта назначения. Каждый пункт назначения достигает состояния RESUMED только после завершения всех переходов в него и сразу же переходит в состояние STARTED, когда начинаются переходы из него. Это позволяет избежать проблем с IllegalStateException и мультитачем, поскольку вызов navigate выполняется, только когда Lifecycle находится в состоянии RESUMED.
  • Определение области действия ViewModel (с помощью API viewModel() библиотеки Lifecycle ViewModel Compose 2.4.0 или hiltViewModel() библиотеки Hilt Navigation Compose 1.0.0) на уровне целевой страницы. Это позволяет сохранить область действия при изменении конфигурации и нахождении в обратном стеке (когда Composable-контент удаляется), а также получить сигнал в onCleared() ViewModel, который указывает на окончательное удаление и очистку состояния, связанного с этим NavBackStackEntry.
  • Область действия состояния rememberSaveable на уровне пункта назначения, обеспечивающая автоматическое сохранение и восстановление всего состояния composable-функции при возврате к пункту назначения.
  • Полная поддержка сохранения и восстановления состояния NavController и его целевой страницы после завершения процесса и повторного создания.
  • Автоматическая интеграция с системной кнопкой "Назад".
  • Поддержка передачи аргументов, прикрепления ссылок на контент к целевым страницам и возврата результата на предыдущие целевые страницы.

  • Специальные вспомогательные функции Compose в rememberNavController() и currentBackStackEntryAsState(), позволяющие поднимать состояние и подключать NavController к composable-функциям за пределами NavHost (например, к нижней панели навигации).

val navController = rememberNavController()
Scaffold { innerPadding ->
    NavHost(navController, "home", Modifier.padding(innerPadding)) {
        composable("home") {
            // This content fills the area provided to the NavHost
            HomeScreen()
        }
        dialog("detail_dialog") {
            // This content will be automatically added to a Dialog() composable
            // and appear above the HomeScreen or other composable destinations
            DetailDialogContent()
        }
    }
}

Подробную информацию можно найти в руководстве по навигации в Compose.

Несколько обратных стеков

NavController отвечает за управление обратным стеком пунктов назначения, добавляя пункты назначения в обратный стек, когда вы navigate() к ним, и удаляя их, когда вы вызываете popBackStack() или нажимаете системную кнопку "Назад". Существующий класс NavOptions и интеграция с элементами <action> в XML-файле графа навигации были расширены для поддержки сохранения и восстановления обратного стека.

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

Базовые API для сохранения и восстановления состояния доступны через несколько интерфейсов:

  • В XML-файле навигации элемент <action> теперь может использовать логические атрибуты app:popUpToSaveState и app:restoreState, чтобы сохранять состояние любых пунктов назначения, извлеченных с помощью app:popUpTo, и восстанавливать состояние, связанное с пунктом назначения, переданным как app:destination:

    <action
      android:id=”@+id/swap_stack”
      app:destination=”@id/second_stack”
      app:restoreState=”true”
      app:popUpTo=”@id/first_stack_start_destination”
      app:popUpToSaveState=”true” />
    
  • В navOptions Kotlin DSL вы можете добавить логические свойства restoreState и saveState в построитель popUpTo:

    // Use the navigate() method that takes a navOptions DSL Builder
    navController.navigate(selectedBottomNavRoute) {
      launchSingleTop = true
      restoreState = true
      popUpTo(navController.graph.findStartDestination().id) {
        saveState = true
      }
    }
    
  • При создании объекта NavOptions вручную с помощью NavOptions.Builder вы можете использовать setRestoreState() и новую перегрузку для setPopUpTo(), которая принимает дополнительный параметр saveState.

    NavOptions navOptions = new NavOptions.Builder()
      .setLaunchSingleTop(true)
      .setRestoreState(true)
      .setPopUpTo(NavGraph.findStartDestination(navController.getGraph()).getId(),
        false, // inclusive
        true) // saveState
      .build();
    navController.navigate(selectedBottomNavId, null, navOptions);
    
  • Теперь в программные вызовы popBackStack() можно включать дополнительный параметр saveState.

  • Чтобы очистить состояние, сохраненное с помощью popBackStack() или popUpToSaveState, используйте метод clearBackStack().

В любом случае NavController сохранит и восстановит состояние каждого NavBackStackEntry, включая все экземпляры ViewModel, относящиеся к целевому объекту навигации. API Navigator были обновлены, чтобы каждый Navigator мог сохранять и восстанавливать свое состояние.

Изменения в поведении

  • Теперь NavDeepLinkBuilder добавляет PendingIntent.FLAG_IMMUTABLE в PendingIntent, возвращаемый createPendingIntent(). Это обеспечивает корректную работу API при таргетинге на Android 12.
  • Навигация теперь зависит от Lifecycle 2.3.1. Методы setGraph(), popBackStack(), navigateUp() и navigate(), которые обновляют NavBackStackEntry Lifecycle, теперь помечены как @MainThread. Это позволяет согласовать навигацию с принудительным применением основного потока, представленным в Lifecycle 2.3.0.
  • Теперь при проверке ссылок на контент определяется, все ли обязательные аргументы (без значений по умолчанию) присутствуют в Uri.
  • NavDeepLink Теперь при обработке аргументов знак решетки, как и вопросительный знак, считается разделителем между сегментами пути. Это предотвращает распространение аргумента за пределы знака решетки.
  • При создании действий код Kotlin, сгенерированный из Safe Args, теперь помещает аргументы без значений по умолчанию перед аргументами со значениями по умолчанию в качестве параметров.
  • При создании аргументов Safe Args теперь помещает параметры без значений по умолчанию перед параметрами со значениями по умолчанию.
  • Safe-Args теперь зависит от плагина Android Gradle 4.2.0. Это означает, что вы больше не должны получать предупреждение об использовании applicationIdTextResource.

Известные проблемы

  • Исправлено в Navigation 2.5.0-alpha01: доступ к ViewModel, созданному через by navGraphViewModels(), из onCreate() фрагмента будет завершаться ошибкой IllegalStateException. (b/213504272)
  • Исправлено в Navigation 2.5.0-alpha01: Safe Args 2.4.0 несовместим с плагином Android Gradle 7.1.0 и более поздними версиями. (b/213086135)
  • При использовании ссылок на контент с несколькими вложенными графами навигации не создается полный стек возврата. (b/214383060)

Версия 2.4.0-rc01

15 декабря 2021 г.

Данные "androidx.navigation:navigation-*:2.4.0-rc01" опубликованы. Версия 2.4.0-rc01 содержит эти коммиты.

Изменения в поведении

  • Теперь при обработке аргументов NavDeepLink знаки решетки и вопросительные знаки считаются разделителями аргументов. (I21309, b/180042703)

Исправление ошибок

  • Ссылки на контент больше не будут игнорировать аргументы со значениями, совпадающими с названием плейсхолдера. (If8017, b/207389470)
  • NavController больше не будет аварийно завершать работу при извлечении вложенного пункта назначения с помощью переходов после восстановления NavController. (I0f7c9, b/205021623)
  • Если используется недопустимый параметр startDestination, в сообщении об ошибке теперь по умолчанию будет указываться маршрут до начального пункта назначения, если он доступен. (I86b9d, b/208041894)

Исправление ошибок в Navigation Compose

  • Исправлен потенциальный сбой, вызванный быстрым переключением между начальным пунктом назначения и другим пунктом назначения с помощью элементов нижнего меню навигации. (Ic8976, b/208887901)
  • Теперь целевые страницы диалоговых окон правильно восстанавливаются в верхней части экрана после изменения конфигурации или завершения процесса. (I4c0dc, b/207386169)
  • Исправлена ошибка, из-за которой не удавалось получить ViewModel из NavBackStackEntry диалогового окна, когда оно было закрыто. (I6b96d, b/206465487)
  • Исправлена ошибка, из-за которой при использовании пунктов назначения activity с NavHost в Navigation Compose происходили бесконечные рекомпозиции. (I8f64c)
  • Исправлена утечка в Navigation Compose, из-за которой после изменения конфигурации или завершения процесса сохранялась ссылка на старый объект activity. (I4efcb, b/204905432)

Исправление ошибок в Safe Args

  • SafeArgs больше не дает сбой при попытке восстановить пользовательские массивы Parcelable после завершения процесса. (I618e8, b/207315994)
  • Исправлена ошибка в Safe Args, из-за которой логические массивы не могли иметь значение null. (I8c396, b/174787525)

Версия 2.4.0-beta02

3 ноября 2021 г.

Данные "androidx.navigation:navigation-*:2.4.0-beta02" опубликованы. Версия 2.4.0-beta02 содержит эти коммиты.

Изменения в API

  • При обработке явных и неявных ссылок на контент теперь автоматически добавляется флаг saveState при переходе к другому графу. Это обеспечивает правильную работу кода, например NavigationUI.setupWithNavController, и кода, использующего несколько обратных стеков. (Ic8807)

Изменения в поведении

  • Шаблоны ссылок на контент теперь компилируются в NavDeepLink, а не во время инфляции. Это должно ускорить загрузку графов навигации, содержащих ссылки на контент. (b8d257, b/184149935)

Исправление ошибок

  • Исправлена ошибка, из-за которой NavBackStackEntries перемещались в Lifecycle.State.CREATED после перехода к Lifecycle.State.STARTED, когда NavHost добавлялся непосредственно в setContent() действия. (Ia5ac1, b/203536683)
  • Исправлено состояние гонки, при котором удаление пункта назначения DialogFragment из обратного стека до того, как диалоговое окно было фактически показано, не приводило к его закрытию. Это вызывало сбой, когда пользователь вручную закрывал ошибочное диалоговое окно. (I687e5)
  • Исправлена ошибка, из-за которой API onNavDestinationSelected в NavigationUI возвращал true, даже если вы не navigate() к этому графу навигации. Теперь он использует ту же логику, что и setupWithNavController, чтобы выбирать только MenuItem, связанные с текущим целевым сервисом, используя hierarchy целевого сервиса. (I2b053)

Версия 2.4.0-beta01

27 октября 2021 г.

Данные "androidx.navigation:navigation-*:2.4.0-beta01" опубликованы. Версия 2.4.0-beta01 содержит эти коммиты.

Новые функции

  • Теперь вы можете использовать by navGraphViewModel с маршрутом вместо идентификатора, чтобы улучшить поддержку Navigation Kotlin DSL с фрагментами. (I901e3, b/201446416)

Изменения в API

  • API visibleEntries теперь является экспериментальным. (I93f6f)

Исправление ошибок

  • ViewModels больше не будут уничтожаться, когда переходы прерываются при навигации между одними и теми же экранами (Id52d8, b/200817333).
  • Для аргументов NavDeepLink, допускающих значение NULL, больше не требуется значение по умолчанию при добавлении ссылок на контент в NavDestination. (I5aad4, b/201320030)
  • Объекты NavBackStackEntry с разными жизненными циклами больше не считаются равными. Это означает, что NavHost будет правильно перекомпоновывать все пункты назначения при навигации с помощью singleTop и при повторном выборе элементов нижнего меню. (I1b351, b/196997433)
  • Исправлена ошибка в AbstractListDetailFragment, из-за которой атрибуты layout_width и layout_weight на панели списка, возвращаемой onCreateListPaneView(), обрабатывались неправильно или игнорировались. (f5fbf3)
  • Визуальное состояние целевых страниц диалоговых окон теперь правильно синхронизируется с состоянием DialogFragmentNavigator. Это означает, что при вызове асинхронного API dismiss() для DialogFragment теперь правильно очищаются все целевые страницы диалоговых окон, расположенные выше закрытого диалогового окна. Это не влияет на случаи, когда вы используете popUpTo или popBackStack(), чтобы закрыть диалоговое окно. (I77ba2)
  • В AbstractAppBarOnDestinationChangedListener теперь показываются более понятные сообщения об ошибках для onDestinationChanged(). (Ie742d)

Версия 2.4.0-alpha10

29 сентября 2021 г.

Данные "androidx.navigation:navigation-*:2.4.0-alpha10" опубликованы. Версия 2.4.0-alpha10 содержит эти коммиты.

Новые функции

  • NavController теперь позволяет получить список всех видимых экземпляров NavBackStackEntry через StateFlow visibleEntries (Ia964e).
  • Теперь rememberNavController() принимает необязательный набор экземпляров Navigator, которые будут добавлены в возвращаемый NavController, чтобы лучше поддерживать необязательные навигаторы, например из Accompanist Navigation Material. (I4619e)

Исправление ошибок

  • Динамическая навигация больше не будет аварийно завершать работу при повторном создании Activity. (Ifa6a3, b/197942869)
  • Исправлена ошибка, связанная с системной кнопкой "Назад", которая возникала только после возврата к целевой composable-функции, содержащей NavHost. (3ed148, b/195668143)
  • SafeArgs теперь генерирует аргументы для fromBundle() и fromSavedStateHandle() в правильном порядке параметров. (I824a8, b/200059831)

Версия 2.4.0-alpha09

15 сентября 2021 г.

Данные "androidx.navigation:navigation-*:2.4.0-alpha09" опубликованы. Версия 2.4.0-alpha09 содержит эти коммиты.

Новые функции

  • Теперь вы можете использовать метод clearBackStack(), чтобы очистить любое состояние, сохраненное с помощью popBackStack() или popUpToSaveState. (I80a0f)
  • Теперь вы можете передать список аргументов и/или ссылок на контент в конструктор вложенного графа навигации, и они будут автоматически добавлены в результирующий граф. (I8a470, b/182545357)

Изменения в API

  • Функция Kotlin DSL navArgument теперь входит в navigation-common, а не в navigation-compose. Чтобы продолжить использовать эту функцию, вам нужно будет обновить импорт. (I1d095)

Изменения в поведении

  • При создании аргументов Safe Args теперь помещает параметры без значений по умолчанию перед параметрами со значениями по умолчанию. (I89709, b/198493585)

Исправление ошибок

  • При использовании Navigation Compose NavGraphs будут DESTROYED только после того, как все их дочерние элементы будут DESTROYED. (I86552, b/198741720)
  • Аргументам NavDeepLink, допускающим значение null, больше не требуется значение по умолчанию. (Ia14ef, b/198689811)
  • Вызов setGraph() с новым графом теперь также очищает все сохраненные обратные стеки в дополнение к предыдущему поведению извлечения обратного стека. (I97f96)
  • Исправлена ошибка, из-за которой экземпляры OnDestinationChangedListener и currentBackStackEntryFlow не получали уведомления при использовании launchSingleTop. (Iaaebc)

Обновления зависимостей

Версия 2.4.0-alpha08

1 сентября 2021 г.

Данные "androidx.navigation:navigation-*:2.4.0-alpha08" опубликованы. Версия 2.4.0-alpha08 содержит эти коммиты.

Новые функции

  • Теперь можно расширить класс NavType, чтобы создавать собственные типы NavType. Специальные типы поддерживаются только при программном создании графа навигации, например с помощью Navigation Graph Kotlin DSL. (I78440, b/196871885)

Изменения в поведении

  • При создании действий код Kotlin, сгенерированный из Safe Args, теперь помещает аргументы без значений по умолчанию перед аргументами со значениями по умолчанию в качестве параметров. (Idb697, b/188855904)
  • Теперь при проверке ссылок на контент определяется, все ли обязательные аргументы (без значений по умолчанию) присутствуют в Uri. (#204, b/185527157)

Исправление ошибок

  • Использование getBackStackEntry и previousBackStackEntry внутри composable() в сочетании с remember() больше не будет вызывать исключение из-за отсутствия пункта назначения в обратном стеке. (I75138, b/194313238)
  • Navigation Compose теперь правильно выполняет рекомпозицию при изменении аргументов обратного стека и использовании launchSingleTop=true. (Iebd69, b/186392337)
  • При вызове setGraph с графом, содержащим 13 или 29 пунктов назначения, больше не будет возникать ошибка ArrayIndexOutOfBoundsException. (I1a9f1, b/195171984)
  • Генератор SafeArgs Java больше не должен вызывать предупреждения lint при создании классов Args. (I1a666, b/185843837)

Внешний вклад

  • Благодарим ospixd за то, что ссылки на контент проверяют наличие всех обязательных аргументов (без значений по умолчанию) в Uri. (#204, b/185527157)

Версия 2.4.0-alpha07

18 августа 2021 г.

Данные "androidx.navigation:navigation-*:2.4.0-alpha07" опубликованы. Версия 2.4.0-alpha07 содержит эти коммиты.

Исправление ошибок

  • Navigation Compose теперь правильно сохраняет состояние после изменения конфигурации и при изменении графиков при использовании функции множественного обратного стека. (If5a3d, b/195141957)
  • Повторный выбор той же вкладки при использовании Navigation Compose с несколькими обратными стеками больше не приводит к появлению пустого экрана. (I860dc, b/194925622)
  • NavHost теперь отслеживает изменения в Lifecycle.State NavBackStackEntry, поэтому использование NavHost во фрагменте будет правильно перекомпоновано при изменении жизненного цикла, а не приведет к появлению пустого экрана. (I4eb85, b/195864489)
  • Исправлена ошибка, из-за которой закрытие DialogFragment не приводило к корректному обновлению состояния NavController после повторного создания действия (например, после изменения конфигурации). (Icd72b)
  • Исправлена ошибка, из-за которой при закрытии диалогового окна не обновлялась обработка системной кнопки "Назад" в NavController. Это могло привести к тому, что NavController перехватывал нажатие кнопки "Назад", даже если в обратном стеке не было элементов для закрытия. (If3b34)
  • Safe-args теперь автоматически генерирует метод toSavedStateHandle для аргументов, которые можно использовать для тестирования кода ViewModel. (If1e2d, b/193353880)

Версия 2.4.0-alpha06

4 августа 2021 г.

Данные "androidx.navigation:navigation-*:2.4.0-alpha06" опубликованы. Версия 2.4.0-alpha06 содержит эти коммиты.

Изменения в API

  • Методы requireSlidingPaneLayout() и requireDetailPaneNavHostFragment() в AbstractListDetailFragment переименованы в getSlidingPaneLayout() и getDetailPaneNavHostFragment() соответственно. (I34a08)

Изменения в поведении

  • При навигации с анимацией (например, Crossfade) Lifecycle нового пункта назначения будет достигать RESUMED только после завершения анимации. (If0543, b/172112072, b/194301889)
  • NavHost в Navigation Compose теперь задает граф как часть первой композиции. (Ieb7be)

Исправление ошибок

  • При удалении последнего пункта назначения из графа навигации больше не возникает ошибка ClassCastException. (If0543, b/172112072, b/194301889)
  • Исправлена ошибка NullPointerException, которая возникала при добавлении ссылки на контент без Uri и навигации по маршруту или ссылке на контент. (938a0c, b/193805425)
  • Исправлена ошибка в Navigation Compose, из-за которой NavBackStackEntry со ссылкой на контент не переходил в состояние RESUMED. (I192c5)
  • Исправлена ошибка, из-за которой при удалении целевой страницы диалогового окна не обновлялась обработка системной кнопки "Назад" в NavController. В результате NavController мог перехватывать нажатие кнопки "Назад", даже если в обратном стеке не было элементов для удаления. (aosp/1782668)

Версия 2.4.0-alpha05

21 июля 2021 г.

Данные "androidx.navigation:navigation-*:2.4.0-alpha05" опубликованы. Версия 2.4.0-alpha05 содержит эти коммиты.

Изменения в поведении

  • NavHost Navigation Compose теперь всегда использует перекрестное затухание при навигации по пунктам назначения. (I07049, b/172112072)
  • Теперь вы можете вносить изменения в граф NavHost. Графы с одинаковыми startDestination и destinations в графе будут считаться равными и не будут очищать обратный стек NavController. (I0b8db, b/175392262)

Исправление ошибок

  • Исправлена ошибка NoSuchElementException, возникавшая при вызове popBackStack() из LifecycleObserver, прикрепленного к NavBackStackEntry, из-за повторных обновлений состояния NavController. (I64621)
  • Теперь AbstractListDetailFragment позволяет полностью удалить SlidingPaneLayout из APK, если AbstractListDetailFragment не используется. (I611ad)
  • NavGraph и NavDestination теперь переопределяют метод equals, поэтому два объекта с одинаковыми значениями будут считаться равными. (I166eb, b/175392262)

Версия 2.4.0-alpha04

1 июля 2021 г.

Данные "androidx.navigation:navigation-*:2.4.0-alpha04" опубликованы. Версия 2.4.0-alpha04 содержит эти коммиты.

Новые функции

  • Артефакт navigation-fragment теперь содержит встроенную реализацию двухпанельного макета через новый AbstractListDetailFragment. Этот фрагмент использует SlidingPaneLayout для управления панелью списка (которую предоставляет ваш подкласс) и панелью подробностей, которая использует NavHostFragment в качестве своей реализации, как показано в нашем примере реализации. (Iac4be, b/191276636)
  • NavHost объекта navigation-compose теперь поддерживает целевые сервисы dialog в дополнение к целевым сервисам composable. Каждый из этих целевых диалогов будет показан в Composable-функции Dialog, плавающей над текущей целевой страницей composable. (I011d0)
val navController = rememberNavController()
    Scaffold { innerPadding ->
        NavHost(navController, "home", Modifier.padding(innerPadding)) {
            composable("home") {
                // This content fills the area provided to the NavHost
                HomeScreen()
            }
            dialog("detail_dialog") {
                // This content will be automatically added to a Dialog() composable
                // and appear above the HomeScreen or other composable destinations
                DetailDialogContent()
            }
        }
    }

Изменения в API

  • Функция add в NavigatorState переименована в push. Все текущие вызовы add() нужно будет заменить на push(). (Ie89fc, b/172112072)
  • Специальные экземпляры Navigator теперь могут использовать API pushWithTransaction и popWithTransition в NavigatorState, чтобы асинхронно добавлять или удалять целевые страницы. Обратите внимание, что эти API пока не используются ни в одном из включенных навигаторов. (Ic4d7c, b/172112072)

Изменения в поведении

  • Теперь NavDeepLinkBuilder добавляет PendingIntent.FLAG_IMMUTABLE в PendingIntent, возвращаемый createPendingIntent(). Это обеспечивает корректную работу API при таргетинге на Android 12. (If8c52)

Исправление ошибок

  • Исправлена ошибка в <include-dynamic>, из-за которой аргументы, переданные в граф, не передавались корректно в динамически включенный граф. (I3e115)
  • Исправлена ошибка NullPointerException, возникавшая при переходе к пункту назначения с использованием аргумента string[] со значением по умолчанию @null. (I1fbe8)
  • Добавлены правила ProGuard для @Navigator.Name, исправляющие ошибки при использовании R8 3.1 в полном режиме. (I2add9, b/191654433)
  • SafeArgs больше не будет выдавать ошибку при сборке приложения с версиями Kotlin до 1.5.0. (Icd1ff, b/190739257)

Версия 2.4.0-alpha03

16 июня 2021 г.

Данные "androidx.navigation:navigation-*:2.4.0-alpha03" опубликованы. Версия 2.4.0-alpha03 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой для перехода к включенному динамическому графу требовалось два вызова navigate(). (I7785c, b/188859835)
  • Исправлена регрессия, появившаяся в Navigation 2.4.0-alpha01, из-за которой setupActionBarWithNavController() не удалял значок "Вверх", когда вы находились на целевой странице верхнего уровня. (I5d443, b/189868637)
  • Исправлена ошибка IllegalStateException при вызове popBackStack() после извлечения корневого графа NavController. (I2a330, b/190265699)
  • Правила ProGuard для by navArgs() теперь корректно применяются при использовании navigation-common или любых артефактов, которые от него зависят. (I68800, b/190082521)
  • Объект OnDestinationChangedListener, который вызывает navigate() при первом получении обратного вызова, теперь правильно получает второй обратный вызов с пунктом назначения, к которому он перешел. (Ie5f9e, b/190228815)
  • Safe Args больше не дает сбоев при использовании с динамическими модулями функций и AGP 7.0+ (I69518, b/189966576).

Известная проблема

  • При использовании Gradle 6.7.0 Safe Args будет выдавать ошибку Unable to find method ‘’java.lang.String kotlin.text.CarsKt.titleCase(char, java.util.Locale)’’ из-за зависимости от более старой версии Kotlin. Чтобы обойти эту проблему, обновите Gradle до версии 7.0. (b/190739257)

Версия 2.4.0-alpha02

2 июня 2021 г.

Данные "androidx.navigation:navigation-*:2.4.0-alpha02" опубликованы. Версия 2.4.0-alpha02 содержит эти коммиты.

Новые функции

  • Маршруты теперь поддерживаются для пунктов назначения Activity, Fragment и Dialog, а также во всем DynamicNavigation Kotlin DSL. (Ib5544, Ia617b, I22f96, b/188914648, b/188901565)
  • В NavigationUI временно добавлены экспериментальные API, позволяющие отказаться от сохранения состояния. Хотя сохранение состояния всегда является правильным поведением, все ещё используются устаревшие библиотеки (например, сохраненные фрагменты), которые не поддерживаются при сохранении состояния. Это дает приложениям возможность постепенно отказаться от неподдерживаемых API. (Idf93c)
  • В Navigation теперь есть API findDestination() и getHierarchy(), которые можно использовать для реализации собственного NavigationUI. findDestination() – это функция расширения для NavGraph, которая находит пункт назначения в графе. getHierarchy() – это функция в NavDestination, которая позволяет проверить, находится ли заданный пункт назначения в иерархии другого (I2932f, b/188183365).

    val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }
    
  • Методы NavigationUI, которые принимали BottomNavigationView, были обновлены и теперь принимают его надкласс, представленный в Material 1.4.0, NavigationBarView. Это позволяет использовать эти методы с NavigationRailView. (Ib0b36, b/182938895)

  • При заполнении элемента <action> с помощью XML атрибуты анимации могут использовать атрибуты, извлеченные из вашей темы с помощью синтаксиса app:enterAnim="?attr/transitionEnter". (I07bc1, b/178291654)

Изменения в API

  • Конструкторы Kotlin DSL, использующие идентификатор, устарели и должны быть заменены конструкторами, использующими маршруты (I85b42, b/188816479) (I9f58f, b/188816479).

Исправление ошибок

  • Теперь DialogFragmentNavigator использует API NavigatorState.pop(), чтобы сообщать NavController о том, что диалоговое окно закрыто нажатием системной кнопки "Назад" или кликом за пределами окна. Это позволяет синхронизировать состояние NavController с состоянием Navigator. (I2ead9)
  • При использовании обратного вызова onDestinationChanged для изменения списка OnDestinationChangedListeners навигация больше не выдает ConcurrentModificationException. (Ib1707, b/188860458)

  • Safe Args больше не дает сбоев при попытке сгенерировать свойства направления в Kotlin. (Id2416, b/188564435)

  • Метод setId в NavDestination теперь правильно аннотирован с помощью @IdRes, поэтому он принимает только идентификаторы ресурсов. (I69b80)

  • Целочисленный параметр findNode теперь равен resId вместо resid. (I7711d)

Обновление зависимостей

  • Safe-Args теперь зависит от плагина Android Gradle 4.2.0. Это означает, что вы больше не должны получать предупреждение об использовании applicationIdTextResource. (I6d67b, b/172824579)

Версия 2.4.0-alpha01

18 мая 2021 г.

Данные "androidx.navigation:navigation-*:2.4.0-alpha01" опубликованы. Версия 2.4.0-alpha01 содержит эти коммиты.

Новые функции

  • Метод currentBackStackEntryAsFlow() в NavController предоставляет Flow, который срабатывает при каждом изменении текущего NavBackStackEntry. Этот процесс можно использовать в качестве альтернативы ручному управлению OnDestinationChangedListener. (I19c4a, #89, b/163947280)

Несколько обратных стеков

NavController отвечает за управление обратным стеком пунктов назначения, добавляя пункты назначения в обратный стек, когда вы navigate() к ним, и удаляя их, когда вы вызываете popBackStack() или нажимаете системную кнопку "Назад". Существующий класс NavOptions и интеграция с записями <action> в XML-файле графа навигации были расширены для поддержки сохранения и восстановления обратного стека. (b/80029773)

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

Базовые API для сохранения и восстановления состояния доступны через несколько интерфейсов:

  • В XML-файле навигации элемент <action> теперь может использовать логические атрибуты app:popUpToSaveState и app:restoreState, чтобы сохранять состояние любых пунктов назначения, извлеченных с помощью app:popUpTo, и восстанавливать состояние, связанное с пунктом назначения, переданным как app:destination:

    <action
      android:id=”@+id/swap_stack”
      app:destination=”@id/second_stack”
      app:restoreState=”true”
      app:popUpTo=”@id/first_stack_start_destination”
      app:popUpToSaveState=”true” />
    
  • В navOptions Kotlin DSL вы можете добавить логические свойства restoreState и saveState в построитель popUpTo:

    // Use the navigate() method that takes a navOptions DSL Builder
    navController.navigate(selectedBottomNavRoute) {
      launchSingleTop = true
      restoreState = true
      popUpTo(navController.graph.startDestinationId) {
        saveState = true
      }
    }
    
  • При создании объекта NavOptions вручную с помощью NavOptions.Builder вы можете использовать setRestoreState() и новую перегрузку для setPopUpTo(), которая принимает дополнительный параметр saveState.

    NavOptions navOptions = new NavOptions.Builder()
      .setLaunchSingleTop(true)
      .setRestoreState(true)
      .setPopUpTo(navController.getGraph().getStartDestinationId(),
        false, // inclusive
        true) // saveState
      .build();
    navController.navigate(selectedBottomNavId, null, navOptions);
    
  • Теперь в программные вызовы popBackStack() можно включать дополнительный параметр saveState.

В любом случае NavController сохранит и восстановит состояние каждого NavBackStackEntry, включая все экземпляры ViewModel, относящиеся к целевому объекту навигации. API Navigator были обновлены, чтобы каждый Navigator мог сохранять и восстанавливать свое состояние.

Класс ComposeNavigator, используемый для целевых страниц composable в Navigation Compose, а также классы FragmentNavigator и DynamicFragmentNavigator, используемые для целевых страниц <fragment> в Navigation с фрагментами, были обновлены для использования новых API Navigator и поддержки сохранения и восстановления состояния.

Маршруты навигации

Маршрут – это String, который однозначно определяет пункт назначения. Раньше эта концепция использовалась только в Navigation Compose, а теперь она стала частью основных API навигации. Это альтернатива использованию целочисленных идентификаторов при создании графа с помощью Navigation Kotlin DSL. (b/172823546)

Все API, которые раньше принимали только идентификатор, теперь имеют перегрузку, принимающую маршрут String. Это касается следующих стран: navigate(), popBackStack(), popUpTo() и getBackStackEntry().

Это повлияло на работу API:

  • Свойство popUpTo kotlin в Kotlin DSL устарело и заменено на popUpToId. (I59c73, b/172823546)
  • Поддержка API getStartDestination() прекращена. Вместо него используйте getStartDestinationId(). (I0887f, b/172823546)

Разработчикам, которые переходят с предыдущих версий Navigation Compose на Navigation Compose 2.4.0-alpha01, больше не нужно импортировать следующие методы расширения:

import androidx.navigation.compose.navigation
import androidx.navigation.compose.createGraph
import androidx.navigation.compose.getBackStackEntry
import androidx.navigation.compose.navigate
import androidx.navigation.compose.popUpTo

Аргумент KEY_ROUTE заменен свойством route в NavDestination, что позволяет вызывать navBackStackEntry.destination.route напрямую.

Изменения в API

  • Все артефакты навигации были переписаны на Kotlin. Это улучшило допустимость значения NULL для классов, использующих обобщения (например, подклассы NavType). Все функции-расширения Kotlin, которые раньше были частью артефактов -ktx, перенесены в соответствующие основные артефакты. Объекты -ktx будут по-прежнему публиковаться, но они будут пустыми. (b/184292145)
  • Теперь NavDeepLinkBuilder поддерживает добавление нескольких разных пунктов назначения в созданный обратный стек. (I3ee0d, b/147913689)
  • Добавлены фабричные функции для DynamicNavHostFragment (Icd515, b/175222619).
  • Уникальный идентификатор NavBackStackEntry теперь доступен в общедоступном API. (Ie033a)
  • Поля name и argument, а также функции деструктуризации NamedNavArgument теперь являются общедоступными. (#174, b/181320559)
  • Добавлено новое расширение NavBackStackEntry#provideToCompositionLocals, которое предоставляет NavBackStackEntry соответствующим локальным композициям. (#175, b/187229439)

Safe Args

  • Теперь Safe Args генерирует метод fromSavedStateHandle() для каждого класса NavArgs. (#122, b/136967621)

    class HomeViewModel(savedStateHandle: SavedStateHandle) : ViewModel() {
      // Create a HomeDestinationArgs class with type safe accessors for each argument
      // defined on your destination
      private val args = HomeDestinationArgs.fromSavedStateHandle(savedStateHandle)
    }
    
  • Обновлен плагин Safe Args, чтобы он зависел от KotlinPoet 1.8.0. (#172, b/183990444)

Изменения в поведении

  • Навигация теперь зависит от Lifecycle 2.3.1. Методы setGraph(), popBackStack(), navigateUp() и navigate(), которые обновляют NavBackStackEntry Lifecycle, теперь помечены как @MainThread. Это позволяет согласовать навигацию с принудительным применением основного потока, представленным в Lifecycle 2.3.0. (b/171125856)
  • При анализе аргументов Enum из ссылок на контент теперь не учитывается регистр. Это позволяет сопоставлять ссылки на контент, например http://www.example.com/red, со ссылками на контент www.example.com/{color}, даже если значение enum – RED. (#152, b/135857840)

Совместимость с Compose

  • androidx.navigation:navigation-compose:2.4.0-alpha01 совместим только с Compose версии 1.0.0-beta07 и выше.

Исправление ошибок

  • Исправлена ошибка, из-за которой плейсхолдеры конечных аргументов имели приоритет над ссылками на контент с совпадающим точным суффиксом. (#153, b/184072811)
  • NavHostFragment теперь поддерживает пользовательские навигаторы, которые используют тот же @Navigator.Name("dialog"), что и DialogFragmentNavigator по умолчанию. (Ib1c2c, b/175979140)
  • Улучшено поведение метода NavigatorProvider#addNavigator. Теперь его повторный вызов с тем же экземпляром не вызывает проблем. (#176, b/187443146)

Внешние взносы

  • Благодарим simonschiller за создание поддержки Safe Args, генерирующей метод fromSavedStateHandle() для каждого класса NavArgs. (#122, b/136967621)
  • Спасибо Bradleycorn за то, что теперь при синтаксическом анализе аргументов Enum из ссылок на контент не учитывается регистр. (#152, b/135857840)
  • Благодарим пользователя osipxd за исправление ошибки, из-за которой плейсхолдеры аргументов в конце имели приоритет над ссылками на контент с совпадающим точным суффиксом. (#153, b/184072811)
  • Благодарим tatocaster за обновление Safe Args для зависимости от KotlinPoet 1.8.0. (#172, b/183990444)
  • Спасибо jossiwolf за то, что сделал поля name и argument и функции деструктуризации NamedNavArgument общедоступными. (#174, b/181320559)
  • Благодарим jossiwolf за добавление нового расширения NavBackStackEntry#provideToCompositionLocals, которое предоставляет NavBackStackEntry соответствующим локальным композициям. (#175, b/187229439)
  • Благодарим jossiwolf за улучшение поведения NavigatorProvider#addNavigator, благодаря которому повторный вызов с тем же экземпляром не вызывает проблем. (#176, b/187443146)

Версия 1.0.0-alpha10

7 апреля 2021 г.

Данные "androidx.navigation:navigation-compose:1.0.0-alpha10" опубликованы. Версия 1.0.0-alpha10 содержит эти коммиты.

Изменения в API

  • NavHost теперь принимает Modifier, который передается в composable-контейнер, содержащий целевые composable-функции. (I85aca, b/175125483)

Исправление ошибок

  • NavHost теперь работает, даже если OnBackPressedDispatcherOwner не найден, например при предварительном просмотре NavHost. (I7d8b4)
  • Navigation Compose теперь зависит от Navigation 2.3.5. Это устраняет проблему, возникающую при использовании BackHandler в целевом объекте NavHost. (I7e63b, b/182284739)

Версия 1.0.0-alpha09

10 марта 2021 г.

Данные "androidx.navigation:navigation-compose:1.0.0-alpha09" опубликованы. Версия 1.0.0-alpha09 содержит эти коммиты.

Изменения в API

  • Теперь LocalViewModelStoreOwner.current возвращает допускающий значение NULL ViewModelStoreOwner, чтобы было проще определить, доступен ли ViewModelStoreOwner в текущей композиции. API, которым требуется ViewModelStoreOwner, например viewModel() и NavHost, по-прежнему вызывают исключение, если ViewModelStoreOwner не задан. (Idf39a)

Исправление ошибок

  • Navigation Compose теперь зависит от Navigation 2.3.4, в которой исправлена ошибка, возникавшая при попытке задать тот же объект ViewModelStore после того, как был задан граф. (I65c24, b/177825470)

Версия 1.0.0-alpha08

24 февраля 2021 г.

Данные "androidx.navigation:navigation-compose:1.0.0-alpha08" опубликованы. Версия 1.0.0-alpha08 содержит эти коммиты.

Новые функции

  • NavHost теперь заполняет LocalSavedStateRegistryOwner CompositionLocal с помощью NavBackStackEntry этого пункта назначения, гарантируя, что любое состояние, непосредственно сохраненное в SavedStateRegistry, будет сохранено и восстановлено вместе с пунктом назначения. (I435d7, b/179469431)

Версия 1.0.0-alpha07

10 февраля 2021 г.

Данные "androidx.navigation:navigation-compose:1.0.0-alpha07" опубликованы. Версия 1.0.0-alpha07 содержит эти коммиты.

Обновления зависимостей

  • Navigation Compose теперь зависит от Lifecycle ViewModel Compose 1.0.0-alpha01, чтобы обеспечить поддержку viewModel() для пунктов назначения composable. (I7a374)
  • NavHost теперь использует новый LocalOnBackPressedDispatcherOwner из Activity-Compose 1.3.0-alpha01, чтобы получить OnBackPressedDispatcher, заданный в NavController. (I65b12)

Версия 1.0.0-alpha06

28 января 2021 г.

Данные "androidx.navigation:navigation-compose:1.0.0-alpha06" опубликованы. Версия 1.0.0-alpha06 содержит эти коммиты.

Изменения в API

  • Добавлен метод расширения getBackStackEntry(route: String) для NavController, который возвращает связанный объект NavBackStackEntry. (If8931)

Версия 1.0.0-alpha05

13 января 2021 г.

Данные "androidx.navigation:navigation-compose:1.0.0-alpha05" опубликованы. Версия 1.0.0-alpha05 содержит эти коммиты.

Обновлено для зависимости от Compose 1.0.0-alpha10.

Версия 1.0.0-alpha04

16 декабря 2020 г.

Данные "androidx.navigation:navigation-compose:1.0.0-alpha04" опубликованы. Версия 1.0.0-alpha04 содержит эти коммиты.

  • Обновлено для совместимости с Compose 1.0.0-alpha09.

Версия 1.0.0-alpha03

2 декабря 2020 г.

Данные "androidx.navigation:navigation-compose:1.0.0-alpha03" опубликованы. Версия 1.0.0-alpha03 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой popBackStack() и navigateUp() не работали после изменения конфигурации или завершения и повторного создания процесса. (Icea47, b/173281473)
  • Переход к вложенному графу в NavHost теперь работает правильно. (I0948d, b/173647694)

Версия 1.0.0-alpha02

11 ноября 2020 г.

Данные "androidx.navigation:navigation-compose:1.0.0-alpha02" опубликованы. Версия 1.0.0-alpha02 содержит эти коммиты.

Изменения в API

  • Navigation Compose теперь поддерживает NavOptions для использования операций popUpTo и launchSingleTop (If96c3, b/171468994).
  • Добавлена функция навигации, которая принимает маршрут вместо идентификатора, что позволяет создавать вложенные графы в Navigation Compose DSL. (I1661d)
  • В списке параметров для NavHost startDestination теперь указывается перед маршрутом (Ie620e).
  • Теперь вы можете создать граф, используя маршрут в качестве начального пункта назначения за пределами composable-функции NavHost. (Iceb75)

Версия 1.0.0-alpha01

28 октября 2020 г.

Данные "android.navigation:navigation-compose:1.0.0-alpha01" опубликованы. Версия 1.0.0-alpha01 содержит эти коммиты.

Новые функции

Артефакт navigation-compose обеспечивает интеграцию между компонентом навигации и Jetpack Compose. В качестве пунктов назначения в приложении используются функции @Composable.

В этой версии доступны следующие возможности:

  • NavHost – composable-функция, которая позволяет создать граф навигации с помощью Kotlin DSL.
  • Область действия жизненного цикла, ViewModel и запомненного состояния на уровне целевой страницы.
  • Автоматическая интеграция с системной кнопкой "Назад".
  • Поддержка передачи аргументов, прикрепления ссылок на контент к целевым страницам и возврата результата на предыдущие целевые страницы.
  • Специальные вспомогательные функции Compose в rememberNavController() и currentBackStackEntryAsState(), позволяющие поднимать состояние и подключать NavController к composable-функциям за пределами NavHost (например, к нижней панели навигации).

Подробную информацию можно найти в руководстве по навигации в Compose.

Версия 2.3.5

Версия 2.3.5

7 апреля 2021 г.

Данные "androidx.navigation:navigation-*:2.3.5" опубликованы. Версия 2.3.5 содержит эти коммиты.

Новые функции

  • При навигации с помощью NavDeepLinkRequest или Uri теперь можно получить доступ к Uri, действию и MIME-типу в целевом пункте назначения, получив намерение из аргументов через KEY_DEEP_LINK_INTENT. Это отражает функциональность, уже доступную для внешних ссылок на контент. (I975c3, b/181521877)

Исправление ошибок

  • OnBackPressedCallbacks, добавленные в диспетчер с NavBackStackEntry в качестве LifecycleOwner, теперь правильно перехватывают нажатие кнопки "Назад" после того, как жизненный цикл объекта activity переходит в состояние STOPPED, а затем STARTED (Iff94f, b/182284739).
  • При синтаксическом анализе домена ссылки на контент теперь не учитывается регистр, поэтому www.example.com соответствует и www.example.com, и www.Example.com. Обратите внимание, что в названиях параметров запроса регистр по-прежнему учитывается. (#144, b/153829033)
  • Исправлена ошибка NullPointerException, которая могла возникать, когда у пункта назначения было несколько аргументов по умолчанию, не допускающих значение NULL, и вы переходили к этому пункту назначения, переопределяя только подмножество этих аргументов. (aosp/1644827)

Обновления зависимостей

  • Плагин Navigation Safe Args Gradle теперь зависит от плагина Kotlin Gradle 1.4.31. (aosp/1661058, b/181156413)

Внешний вклад

  • Спасибо bentrengrove за pull-запрос, благодаря которому синтаксический анализ домена ссылки на контент стал нечувствительным к регистру. (#144, b/153829033)

Версия 2.3.4

Версия 2.3.4

10 марта 2021 г.

Данные "androidx.navigation:navigation-*:2.3.4" опубликованы. Версия 2.3.4 содержит эти коммиты.

Новые функции

  • Аргументы ReferenceType теперь могут быть правильно обработаны, если они отправлены как часть URI ссылки на контент. Поддерживаются как необработанные целочисленные значения, так и шестнадцатеричные значения с префиксом 0x. (#127, b/179166693)
  • Теперь android:defaultValue для аргумента с app:argType="float" поддерживает целочисленные значения по умолчанию, что позволяет использовать android:defaultValue="0" вместо 0.0. (#117, b/173766247)

Исправление ошибок

  • Исправлена ошибка, из-за которой установка зависала при использовании поддержки динамических функций в Navigation. (Ib27a7, b/169636207)
  • Вызов setViewModelStore или setLifecycleOwner с тем же объектом, который уже был задан, теперь будет холостой операцией (Idf491, b/177825470).
  • Теперь Safe-Args добавляет аннотации подавления в нужные методы при использовании Java. (I8fbc5, b/179463137)

Внешние взносы

  • Благодарим JvmName за pull-запрос, который позволил обеспечить корректную обработку аргументов ReferenceType, отправляемых в составе URI ссылки на контент. (#127, b/179166693)
  • Спасибо tatocaster за pull-запрос, позволяющий использовать defaultValue для аргумента с app:argType=”float”, который теперь поддерживает целочисленные значения по умолчанию. (#117, b/173766247)

Версия 2.3.3

Версия 2.3.3

27 января 2021 г.

Данные "androidx.navigation:navigation-*:2.3.3" опубликованы. Версия 2.3.3 содержит эти коммиты.

Исправление ошибок

  • Устранена ошибка, из-за которой происходил сбой, если NavBackStackEntry удалялся до того, как его Lifecycle перемещался в CREATED. (Ie3ba3)
  • Исправлена регрессия, вызванная ошибкой b/171364502, из-за которой переход к действию со значением ресурса анимации 0 вызывал ошибку ResourceNotFoundException. (I7aedb, b/176819931)

Версия 2.3.2

Версия 2.3.2

2 декабря 2020 г.

Данные "androidx.navigation:navigation-*:2.3.2" опубликованы. Версия 2.3.2 содержит эти коммиты.

Исправление ошибок

  • Исправлена регрессия в NavigationUI, из-за которой при использовании целевой страницы <activity> с onNavDestinationSelected не удавалось перейти к объекту activity. (I22e34, b/171364502)
  • Исправлена ошибка, из-за которой при использовании navigation-dynamic-features-fragment происходил многократный переход к недавно установленному целевому сервису. (aosp/1486056, b/169636207)
  • Исправлена ошибка, из-за которой аргументы по умолчанию не отправлялись в экземпляры OnDestinationChangedListener при использовании launchSingleTop. (I2c5cb)
  • Исправлена ошибка, из-за которой при переходе к вложенному графу навигации не создавался новый экземпляр графа в обратном стеке. (Ifc831)
  • Исправлена ошибка, из-за которой при использовании navigate() с popUpTo, удаляющим последний пункт назначения в графе навигации, сам граф навигации не уничтожался и не удалялся из обратного стека сразу. (I910a3)
  • В Navigation SafeArgs теперь используется KotlinPoet версии 1.7.2, в которой добавлена поддержка режима явного API Kotlin. (I918b5)
  • Теперь NavHostFragment.findNavController(Fragment) также проверяет корневое представление DialogFragment в дополнение к существующим проверкам иерархии Fragment и иерархии View Fragment. Это позволяет тестировать фрагменты диалогов, в которых используется навигация с помощью FragmentScenario и Navigation.setViewNavController(). (I69e0d)

Версия 2.3.1

Версия 2.3.1

14 октября 2020 г.

Данные "androidx.navigation:navigation-*:2.3.1" опубликованы. Версия 2.3.1 содержит эти коммиты.

Новые функции

  • Ресурсы Animator по умолчанию добавлены в Navigation UI и рекомендуются вместо ресурсов анимации по умолчанию. (b/167430145)
  • NavOptions теперь переопределяет методы hashcode и equals (b/161586466).
  • Теперь в навигации текущий пункт назначения указывается в IllegalArgumentException "Нет пункта назначения с идентификатором", что должно упростить отладку для разработчиков. (b/168311416)

Исправление ошибок

  • Safe Args больше не будет переносить строку возврата, даже если сгенерированное имя класса аргумента длиннее 100 символов. (b/168584987)

Изменения в зависимостях

  • navigation-ui теперь зависит от DrawerLayout 1.1.1, что позволяет NavigationUI открывать панель даже при использовании LOCK_MODE_LOCKED_CLOSED или LOCK_MODE_LOCKED_OPEN. (b/162253907)
  • Safe Args теперь зависит от KotlinPoet 1.6.0 (aosp/1435911).
  • Safe Args теперь зависит от AGP 4.0.1 (aosp/1442337).

Версия 2.3.0

Версия 2.3.0

24 июня 2020 г.

Данные "androidx.navigation:navigation-*:2.3.0" опубликованы. Версия 2.3.0 содержит эти коммиты.

Основные изменения по сравнению с версией 2.2.0

  • Интеграция модулей функций. Артефакты navigation-dynamic-features-runtime и navigation-dynamic-features-fragment позволяют переходить к пунктам назначения, определенным в модулях функций, и при необходимости автоматически устанавливать эти модули. Подробнее о том, как использовать модули функций для навигации…
  • Тестирование навигации. Артефакт navigation-testing предоставляет TestNavHostController, который позволяет задать текущий пункт назначения и проверить обратный стек после операций навигации. Подробнее о тестировании навигации…
  • Возврат результата. Класс NavBackStackEntry, связанный с каждым пунктом назначения в обратном стеке навигации, теперь позволяет получить доступ к объекту SavedStateHandle, который подходит для хранения небольших объемов сохраненного состояния, связанного с определенной записью обратного стека. Подробнее о том, как вернуть результат в предыдущий пункт назначения…
  • Поддержка Openable в NavigationUI. Все случаи использования DrawerLayout в NavigationUI заменены на более общий интерфейс Openable, добавленный в CustomView 1.1.0 и реализованный DrawerLayout в DrawerLayout 1.1.0.
  • Поддержка действий и MIME-типов в ссылках на контент. Теперь ссылки на контент поддерживают не только app:uri, но и app:action и app:mimeType. Теперь NavController поддерживает навигацию по любой комбинации этих полей с помощью нового класса NavDeepLinkRequest. Подробнее о том, как использовать NavDeepLinkRequest для навигации…

Известные проблемы

  • Поддержка действий со ссылками на контент и MIME-типов пока недоступна в Manifest Merger. Пока эта работа не будет завершена, элементы <intent-filter>, созданные на основе элемента <nav-graph> в манифесте, не будут включать MIME-тип в элементе <data> или пользовательский элемент <action>. Вам нужно вручную добавить в манифест подходящий элемент <intent-filter>.

Версия 2.3.0-rc01

10 июня 2020 г.

Данные "androidx.navigation:navigation-*:2.3.0-rc01" опубликованы. Версия 2.3.0-rc01 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка NullPointerException, возникавшая при замене экземпляра целевой страницы без аргументов другим экземпляром с аргументами с помощью singleTop. (b/158006669)
  • Все исключения destination is unknown, создаваемые NavController, теперь содержат дополнительные сведения для отладки, которые помогают определить состояние NavController. (b/157764916)

Версия 2.3.0-beta01

20 мая 2020 г.

Данные "androidx.navigation:navigation-*:2.3.0-beta01" опубликованы. Версия 2.3.0-beta01 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой Lifecycle NavBackStackEntry не обновлялся должным образом после завершения процесса. (b/155218371)
  • Экземпляры OnDestinationChangedListener, зарегистрированные до вызова setGraph(), теперь корректно отправляют восстановленный пункт назначения после завершения процесса. (b/155218371)
  • При использовании singleTop аргументы NavBackStackEntry теперь обновляются правильно и отправляются во все экземпляры OnDestinationChangeListener. (b/156545508)

Обновления зависимостей

Версия 2.3.0-alpha06

29 апреля 2020 г.

Данные "androidx.navigation:navigation-*:2.3.0-alpha06" опубликованы. Версия 2.3.0-alpha06 содержит эти коммиты.

Новые функции

  • Теперь ссылки на контент поддерживают не только app:uri, но и app:action и app:mimeType. NavController теперь поддерживает навигацию по любой комбинации этих полей через новый класс NavDeepLinkRequest. (b/136573074, b/135334841)

Изменения в API

  • Значительно расширена поддержка Kotlin DSL для пунктов назначения динамической навигации. (b/148969800)

Исправление ошибок

  • Исправлена ошибка, из-за которой намерения ссылок на контент игнорировались при использовании вложенного целевого URL. (b/154532067)

Версия 2.3.0-alpha05

15 апреля 2020 г.

Данные "androidx.navigation:navigation-*:2.3.0-alpha05" опубликованы. Версия 2.3.0-alpha05 содержит эти коммиты.

Новые функции

  • Для динамических включений графа с помощью <include-dynamic> больше не нужно указывать app:graphPackage. Будет использоваться значение по умолчанию, если добавить суффикс moduleName к applicationId после точки. Если вам нужно настроить graphPackage, теперь поддерживается плейсхолдер ${applicationId}. (b/152696768)
  • В Navigation Graph Kotlin DSL теперь есть defaultArguments Map для действий, что позволяет задавать значения по умолчанию для элементов <action> в XML-файлах навигации. (b/150345605)

Исправление ошибок

  • Из Navigation 2.2.2: исправлена ошибка IllegalStateException, возникавшая при переходе по ссылке на контент к начальному пункту назначения графа, если в объекте Activity было несколько экземпляров NavHostFragment. (b/147378752)

Обновление зависимостей

Версия 2.3.0-alpha04

18 марта 2020 г.

Данные "androidx.navigation:navigation-*:2.3.0-alpha04" опубликованы. Версия 2.3.0-alpha04 содержит эти коммиты.

Новые функции

  • Добавлена поддержка действий модуля функций и целевых фрагментов в Navigation Kotlin DSL. (b/148969800)

Изменения в API

  • Класс DynamicExtras больше не использует шаблон Builder и теперь может быть создан напрямую. (aosp/1253671)
  • Теперь в конструкторе DynamicActivityNavigator используется Context, а не Activity. (aosp/1250252)

Исправление ошибок

  • NavigationUI больше не игнорирует пустые ярлыки (т.е. целевые сервисы с android:label=””) и теперь правильно задает заголовок в виде пустой строки. (b/148679860)

Обновления зависимостей

  • Артефакты динамических функций навигации теперь зависят от Play Core 1.6.5. (b/149556401)

Версия 2.3.0-alpha03

4 марта 2020 г.

Данные "androidx.navigation:navigation-*:2.3.0-alpha03" опубликованы. Версия 2.3.0-alpha03 содержит эти коммиты.

Изменения в API

  • Вместо конкретного класса DrawerLayout в AppBarConfiguration теперь используется интерфейс Openable, представленный в CustomView 1.1.0-alpha02 (который DrawerLayout реализует начиная с DrawerLayout 1.1.0-alpha04). Это позволяет использовать собственные реализации Openable с NavigationUI. (b/129030452)

Исправление ошибок

  • Правила ProGuard для navigation-common-ktx теперь корректно сохраняют только используемые классы NavArgs, а не все экземпляры NavArgs. (b/150213558)

Изменения в зависимостях

  • Navigation теперь зависит от Core 1.1.0, а не от Core 1.2.0. Это сделано для того, чтобы разработчикам не приходилось переходить на новую зависимость, когда Navigation не зависит от новых API в Core 1.2.0.

Версия 2.3.0-alpha02

19 февраля 2020 г.

Данные "androidx.navigation:navigation-*:2.3.0-alpha02" опубликованы. Версия 2.3.0-alpha02 содержит эти коммиты.

Новые функции

  • Теперь NavBackStackEntry позволяет получить доступ к SavedStateHandle, который подходит для хранения небольших объемов сохраненного состояния, связанного с определенной записью обратного стека. Пример использования приведен в разделе Возврат результата. (b/79672220)

Изменения в API

  • Добавлены удобные методы getCurrentBackStackEntry() и getPreviousBackStackEntry(), которые упрощают получение NavBackStackEntry для текущего и предыдущего пунктов назначения. (b/79672220)

Исправление ошибок

  • Теперь navigateUp() передает аргументы текущего пункта назначения и KEY_DEEP_LINK_INTENT предыдущему пункту назначения при запуске приложения в собственном стеке задач. (b/147456890)

Изменения в зависимостях

  • Теперь навигация зависит от Core 1.2.0.

Версия 2.3.0-alpha01

5 февраля 2020 г.

Данные "androidx.navigation:navigation-*:2.3.0-alpha01" опубликованы. Версия 2.3.0-alpha01 содержит эти коммиты.

Новые функции

  • Новый артефакт navigation-testing предоставляет класс TestNavHostController. Этот класс позволяет не использовать макет NavController при тестировании навигации, а задать текущий пункт назначения и проверить обратный стек после операций навигации. (b/140884273)
  • Новый компонент navigation-dynamic-features-fragment (и его транзитивная зависимость navigation-dynamic-features-runtime) позволяет включать пункты назначения или целые графы навигации (через <include-dynamic>) из модулей функций, обеспечивая беспроблемную установку модулей функций по запросу при переходе к этим пунктам назначения. Подробнее о том, как использовать модули функций для навигации… (b/132170186)

Исправление ошибок

  • Navigation 2.2.1. Ссылки на контент без параметров запроса теперь корректно игнорируют любые параметры запроса, а не добавляют их к элементам {argument} или не соответствуют ссылке на контент. (b/147447512)
  • Навигация 2.2.1. Правила ProGuard для navigation-ui (DrawerArrowDrawable) обновлены, чтобы android.enableJetifier=true не требовалось. (b/147610424)
  • Из навигации 2.2.1. Модуль navigation-common-ktx теперь имеет уникальное название пакета манифеста, а не такое же, как у navigation-runtime-ktx. (aosp/1141947)

Обновление зависимостей

Версия 2.2.2

Версия 2.2.2

15 апреля 2020 г.

Данные "androidx.navigation:navigation-*:2.2.2" опубликованы. Версия 2.2.2 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка IllegalStateException, возникавшая при использовании ссылок на контент для перехода к начальному пункту назначения графа, если в Activity было несколько экземпляров NavHostFragment. (b/147378752)
  • NavigationUI больше не игнорирует пустые ярлыки (т.е. целевые сервисы с android:label=””) и теперь правильно задает заголовок в виде пустой строки. Ранее эта функция была выпущена в Navigation 2.3.0-alpha04. (b/148679860)
  • Правила ProGuard для navigation-common-ktx теперь корректно сохраняют только используемые классы NavArgs, а не все экземпляры NavArgs. Ранее эта функция была выпущена в Navigation 2.3.0-alpha03. (b/150213558

Обновление зависимостей

Версия 2.2.1

Версия 2.2.1

5 февраля 2020 г.

Данные "androidx.navigation:navigation-*:2.2.1" опубликованы. Версия 2.2.1 содержит эти коммиты.

Исправление ошибок

  • Ссылки на контент без параметров запроса теперь корректно игнорируют любые параметры запроса, а не добавляют их к конечным элементам {argument} и не вызывают несоответствие ссылке на контент. (b/147447512)
  • Правила ProGuard для DrawerArrowDrawable (navigation-ui) были обновлены, чтобы android.enableJetifier=true не требовалось. (b/147610424)
  • Теперь у модуля navigation-common-ktx уникальное название пакета манифеста, а не такое же, как у navigation-runtime-ktx. (aosp/1141947)

Обновление зависимостей

Версия 2.2.0

Версия 2.2.0

22 января 2020 г.

Данные "androidx.navigation:navigation-*:2.2.0" опубликованы. Коммиты, вошедшие в версию 2.2.0

Важные изменения, внесенные после версии 2.1.0

  • NavBackStackEntry. Теперь вы можете вызвать NavController.getBackStackEntry(), передав идентификатор целевой страницы или граф навигации в обратном стеке. Возвращенный объект NavBackStackEntry предоставляет управляемый навигацией LifecycleOwner, ViewModelStoreOwner (тот же, что возвращает NavController.getViewModelStoreOwner()) и SavedStateRegistryOwner, а также аргументы, используемые для запуска этого пункта назначения.
  • Интеграция Lifecycle ViewModel SavedState. SavedStateViewModelFactory теперь является фабрикой по умолчанию при использовании by navGraphViewModels() или конструктора ViewModelProvider с ViewModelStoreOwner, возвращенным NavController.getBackStackEntry() или NavController.getViewModelStoreOwner().
  • Поддержка параметров запроса для ссылок на контент. Теперь ссылки на контент поддерживают параметры запроса в другом порядке. Аргументы, у которых есть значение по умолчанию или которые могут иметь значение null, теперь необязательны при сопоставлении ссылок на контент.
  • Улучшенная поддержка анимации. В NavHostFragment теперь используется FragmentContainerView из Fragment 1.2.0, что устраняет проблемы с порядком анимации по оси Z и отправкой вставок окон во фрагменты.

Версия 2.2.0-rc04

18 декабря 2019 г.

Данные "androidx.navigation:navigation-*:2.2.0-rc04" опубликованы. Версия 2.2.0-rc04 содержит эти коммиты.

Исправление ошибок

  • Анимации затухания, используемые по умолчанию в navigation-ui, приведены в соответствие с анимациями затухания в Fragment 1.2.0-rc04. (b/145769814)

Версия 2.2.0-rc03

4 декабря 2019 г.

Данные "androidx.navigation:navigation-*:2.2.0-rc03" опубликованы. Версия 2.2.0-rc03 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой при синтаксическом анализе ссылок на контент с параметрами запроса и аргументом в качестве последней части пути обрабатывался только один символ аргумента. (b/144554689)
  • Исправлена ошибка синтаксического анализа ссылок на контент, из-за которой необязательные параметры получали значение "@null" вместо null. (b/141613546)
  • NavHostFragment теперь правильно восстанавливает график после изменения конфигурации при использовании с FragmentContainerView. (b/143752103)

Изменения в зависимостях

  • Теперь Navigation зависит от Lifecycle 2.2.0-rc03, Lifecycle ViewModel SavedState 1.0.0-rc03, Activity 1.1.0-rc03 и Fragment 1.2.0-rc03 (где применимо).

Версия 2.2.0-rc02

7 ноября 2019 г.

Данные "androidx.navigation:navigation-*:2.2.0-rc02" опубликованы. Версия 2.2.0-rc02 содержит эти коммиты.

Изменения в зависимостях

  • Теперь навигация зависит от androidx.lifecycle 2.2.0-rc02.

Версия 2.2.0-rc01

23 октября 2019 г.

Версия androidx.navigation:navigation-*:2.2.0-rc01 выпущена без изменений по сравнению с 2.2.0-beta01. Версия 2.2.0-rc01 содержит эти коммиты.

Версия 2.2.0-beta01

9 октября 2019 г.

Данные "androidx.navigation:navigation-*:2.2.0-beta01" опубликованы. Версия 2.2.0-beta01 содержит эти коммиты.

Новые функции

  • NavDestination и его подклассы теперь переопределяют toString(), чтобы предоставлять более полезную информацию при отладке. (b/141264986)

Изменения в поведении

  • Дополнительные параметры запроса теперь игнорируются при сопоставлении ссылок на контент, а не приводят к ошибке. (b/141482822)

Исправление ошибок

  • Исправлена ошибка, из-за которой аргументы в пути ссылки на контент игнорировались, если также были указаны параметры запроса. (b/141505755)
  • Расширение Kotlin navArgs() для Activity теперь показывает более понятное сообщение об ошибке, если нет дополнительных данных. (b/141408999)
  • Классы Java Directions, созданные с помощью Safe Args, теперь содержат значения по умолчанию. (b/141099045)
  • Классы Java Args, созданные с помощью Safe Args, теперь содержат значения по умолчанию. (b/140123727)
  • При использовании Toolbar NavigationUI больше не анимирует изменение текста при переходе между двумя целевыми страницами верхнего уровня. (b/140848160)

Версия 2.2.0-alpha03

18 сентября 2019 г.

Данные "androidx.navigation:navigation-*:2.2.0-alpha03" опубликованы. Версия 2.2.0-alpha03 содержит эти коммиты.

Изменения в поведении

  • Вызов setViewModelStore() после вызова setGraph теперь приводит к IllegalStateException. Это значение всегда должно задаваться NavHost в рамках начальной настройки, чтобы у всех экземпляров NavBackStackEntry было согласованное хранилище для экземпляров ViewModel. (aosp/1111821)

Исправление ошибок

  • Исправлена ошибка ConcurrentModificationException, возникавшая при использовании экземпляров ViewModel, прикрепленных к нескольким разным экземплярам ViewModelStore в области навигационного графа. (aosp/1112257)

Версия 2.2.0-alpha02

5 сентября 2019 г.

Данные "androidx.navigation:navigation-*:2.2.0-alpha02" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.

Новые функции

  • Ссылки на контент с параметрами запроса теперь поддерживают изменение порядка параметров запроса. Аргументы, имеющие значение по умолчанию или допускающие значение NULL, теперь необязательны при сопоставлении ссылок на контент. (b/133273839)
  • Теперь вы можете вызвать NavController.getBackStackEntry(), передав идентификатор пункта назначения или граф навигации в обратном стеке. Возвращенный объект NavBackStackEntry предоставляет управляемый навигацией LifecycleOwner, ViewModelStoreOwner (тот же, что возвращает NavController.getViewModelStoreOwner()) и SavedStateRegistryOwner, а также аргументы, используемые для запуска этого пункта назначения. (aosp/1101691, aosp/1101710)

Исправление ошибок

  • Исправлена ошибка, из-за которой при добавлении NavHostFragment в ViewPager2 возникала ошибка IllegalArgumentException. (b/133640271)
  • NavInflater теперь не вызывает getResourceName() без необходимости, что ускоряет время заполнения до 40 %. (b/139213740)

Версия 2.2.0-alpha01

7 августа 2019 г.

Данные "androidx.navigation:navigation-*:2.2.0-alpha01" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.

Новые функции

  • SavedStateViewModelFactory теперь является фабрикой по умолчанию при использовании by navGraphViewModels() или конструктора ViewModelProvider с ViewModelStoreOwner, возвращенным NavController.getViewModelStoreOwner(). (b/135716331)

Изменения в API

Исправление ошибок

  • NavHostFragment теперь использует FragmentContainerView, что устраняет проблемы с порядком анимации по оси Z и отправкой вставок окон во фрагменты. (b/137310379)

Версия 2.1.0

Версия 2.1.0

5 сентября 2019 г.

Данные "androidx.navigation:navigation-*:2.1.0" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.

Важные изменения, внесенные в версию 2.0.0

  • Привязка ViewModel к графу навигации. Теперь вы можете создавать ViewModel, привязанные к уровню графа навигации, с помощью делегата свойства by navGraphViewModels() для пользователей Kotlin, использующих библиотеки -ktx, или с помощью API getViewModelStoreOwner(), добавленного в NavController. Подробнее об обмене данными, связанными с интерфейсом, между целевыми страницами…
  • Диалоговые окна. Теперь вы можете создавать пункты назначения <dialog>, которые будут показывать DialogFragment при navigate к ним. NavHostFragment по умолчанию поддерживает целевые страницы диалоговых окон. Подробнее о том, как создать пункт назначения из DialogFragment…
  • Навигация по URI. Теперь вы можете navigate с помощью Uri, который использует <deepLink>, добавленный в пункт назначения, чтобы перейти к нему. Подробнее о навигации с помощью URI…
  • NavHostController. API, используемые специально для создания пользовательского NavHost, были перенесены в NavHostController, что позволяет реализациям подключать свои NavController к хостингу LifecycleOwner, OnBackPressedDispatcher и ViewModelStore.

Версия 2.1.0-rc01

7 августа 2019 г.

Данные "androidx.navigation:navigation-*:2.1.0-rc01" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.

Изменения в API

  • Устаревший API getViewModelStore() в NavController, представленный в 2.1.0-alpha02, был удален. (aosp/1091021)

Версия 2.1.0-beta02

19 июля 2019 г.

Данные "androidx.navigation:*:2.1.0-beta02" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.

Исправление ошибок

  • Удалена непреднамеренная зависимость jacoco, которая была добавлена в версии 2.1.0-beta01. (b/137782950)

Версия 2.1.0-beta01

17 июля 2019 г.

Данные "androidx.navigation:*:2.1.0-beta01" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.

Новые функции

  • NavigationUI теперь анимирует удаление кнопки "Вверх" при использовании setupWithNavController() с Toolbar или CollapsingToolbarLayout. (b/131403621)

Исправление ошибок

  • Исправлена проблема с синхронизацией при использовании нескольких NavHostFragment с одним контейнером с помощью findNavController(). (b/136021571)

Версия 2.1.0-alpha06

2 июля 2019 г.

Данные "androidx.navigation:*:2.1.0-alpha06" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.

Новые функции

  • Атрибут app:navGraph, используемый NavHostFragment, теперь перемещен в артефакт navigation-runtime. Специальные навигаторы, которые можно добавить через XML, должны использовать этот атрибут для интеграции с панелью хоста редактора навигации. (b/133880955)

Изменения в API

  • API getViewModelStore() в NavController больше не поддерживается. Вместо него используется новый метод getViewModelStoreOwner(), который возвращает ViewModelStoreOwner. (aosp/987010)
  • Реализация целевых страниц с плавающими окнами, таких как целевые страницы <dialog>, была обобщена в интерфейс маркера FloatingWindow, который теперь реализуют все целевые страницы <dialog>. Методы NavigationUI для взаимодействия с верхней панелью приложения теперь игнорируют пункты назначения FloatingWindow. (b/133600763)

Изменения в поведении

  • Теперь навигация правильно синхронизирует свое состояние с тем, что видно на экране при использовании пункта назначения <dialog>. В результате Navigation теперь автоматически извлекает пункты назначения <dialog>, когда вы переходите к пункту назначения, не являющемуся диалоговым окном или действием, например к пункту назначения <fragment>. (b/134089818)

Исправление ошибок

  • Теперь при обработке ссылки на контент в приложении "Навигация" не воспроизводится анимация, которая возникает при повторном создании действия. Это позволяет устранить визуальную вспышку. (b/130362979)
  • Исправлена ошибка, из-за которой обратный стек навигации не синхронизировался при извлечении фрагмента во время добавления начального фрагмента. (b/133832218)

Версия 2.1.0-alpha05

5 июня 2019 г.

Данные "androidx.navigation:*:2.1.0-alpha05" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.

Изменения в API

  • API, связанные с хостом, в NavController были переименованы и перемещены в новый подкласс NavController – NavHostController. (aosp/966091)
  • Метод setHostOnBackPressedDispatcherOwner() класса NavController заменен методом setOnBackPressedDispatcher() класса NavHostController. Теперь перед его вызовом необходимо вызвать метод setLifecycleOwner(). (aosp/965409)
  • Теперь в NavHostController есть метод enableOnBackPressed(boolean), который заменяет класс NavHostOnBackPressedManager, ранее возвращаемый методом setHostOnBackPressedDispatcherOwner(). (aosp/966091)

Исправление ошибок

  • Исправлена ошибка, из-за которой обратный стек был некорректным после навигации по URI. (b/132509387)
  • Ссылки на контент, которые автоматически обрабатываются NavController, теперь активируются только один раз. (b/132754763)

Версия 2.1.0-alpha04

16 мая 2019 г.

Данные "androidx.navigation:*:2.1.0-alpha04" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.

Исправление ошибок

  • NavHostFragment правильно учитывает app:defaultNavHost при перехвате событий системной кнопки "Назад", исправляя регрессию в Navigation 2.1.0-alpha03. b/132077777
  • DialogFragmentNavigator теперь корректно обрабатывает операции popBackStack() и navigateUp(). b/132576764
  • Исправлена ошибка IllegalStateException: unknown destination during restore, возникавшая при многократном переходе между вложенными графами. b/131733658

Версия 2.1.0-alpha03

7 мая 2019 г.

Данные "androidx.navigation:*:2.1.0-alpha03" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.

Известные проблемы

  • NavHostFragment продолжает перехватывать нажатие системной кнопки "Назад", несмотря на использование app:defaultNavHost="false" b/132077777

Новые функции

  • Теперь вы можете создавать пункты назначения (<dialog>), которые будут показывать DialogFragment, когда вы navigate к ним. NavHostFragment по умолчанию поддерживает целевые страницы диалоговых окон. b/80267254
  • Теперь вы можете не только вызывать navigate с идентификатором ресурса или экземпляром NavDirections, но и выполнять навигацию с помощью Uri, который использует <deepLink>, добавленный в пункт назначения, для перехода к правильному пункту назначения. b/110412864

Изменения в поведении

  • Анимации по умолчанию, предоставляемые NavigationUI, были ускорены с 400 до 220 мс, чтобы соответствовать скорости анимации по умолчанию для действий и фрагментов. b/130055522

Изменения в API

  • Метод createFragmentNavigator() класса NavHostFragment объявлен устаревшим, а его функциональность перенесена в новый метод onCreateNavController(), чтобы было понятнее, что это правильная точка входа для добавления пользовательских навигаторов при создании подкласса NavHostFragment. b/122802849
  • В NavDestination добавлен метод hasDeepLink(), позволяющий проверить, может ли заданный Uri быть обработан этим пунктом назначения или, в случае NavGraph, любым пунктом назначения на графе навигации. b/117437718

Исправление ошибок

  • Аргументы по умолчанию теперь корректно передаются в экземпляры OnDestinationChangedListener. b/130630686
  • NavHostFragment теперь перехватывает системные события "Назад" с помощью OnBackPressedDispatcher, что устраняет проблему при условной навигации в методах жизненного цикла фрагмента при возврате к фрагменту. b/111598096
  • Для Safe Args android:defaultValue=”@null” с неуказанным app:argType теперь правильно определяется как аргумент string. b/129629192

Версия 2.1.0-alpha02

3 апреля 2019 г.

Данные "androidx.navigation:*:2.1.0-alpha02" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.

Новые функции

  • Теперь вы можете создавать ViewModel, ограниченные уровнем графа навигации, с помощью делегата свойства by navGraphViewModels() для пользователей Kotlin или с помощью API getViewModelStore(), добавленного в NavController. b/111614463

Изменения в API

  • Теперь вы можете добавить app:targetPackage в целевой сервис <activity>, чтобы ограничить название пакета сопоставления. Поддерживает app:targetPackage="${applicationId}" для ограничения пакета идентификатором вашего приложения. b/110975456

Исправление ошибок

  • android:name для целевых страниц <activity> больше не преобразуется в класс во время развертывания, что предотвращает возникновение исключений ClassNotFoundException при использовании динамических функций. b/124538597

Версия 2.1.0-alpha01

19 марта 2019 г.

Это первый альфа-выпуск Navigation 2.1.0.

Изменения в зависимостях

  • Теперь навигация зависит от androidx.core:core:1.0.1 и androidx.fragment:fragment:1.1.0-alpha05. В этом выпуске также удалена зависимость от androidx.legacy:legacy-support-core-utils:1.0.0. b/128632612

Изменения в API

  • Добавлен новый метод Navigation.createNavigateOnClickListener(NavDirections), который можно использовать вместо создания прослушивателя кликов с идентификатором ресурса и объектом Bundle. b/127631752
  • Поддержка FragmentNavigator.instantiateFragment прекращена. Теперь в реализации по умолчанию для создания экземпляров фрагментов используется FragmentFactory. b/119054429

Исправление ошибок

  • Навигация больше не отправляет нулевой Bundle, когда к пункту назначения прикреплены аргументы. Это исправляет проблему при использовании android:defaultValue="@null". b/128531879
  • Safe Args теперь зависит от KotlinPoet 1.1.0, что устраняет проблему с очень длинными названиями пакетов. b/123654948

Версия 2.0.0

Версия 2.0.0

14 марта 2019 г.

Версия 2.0.0 навигации выпущена без изменений по сравнению с версией 2.0.0-rc02.

Версия 2.0.0-rc02

6 марта 2019 г.

В Navigation 2.0.0-rc02 добавлены новые артефакты с идентификатором группы androidx.navigation, а зависимости заменены на эквиваленты AndroidX.

Поведение версии 2.0.0-rc02 идентично поведению Navigation 1.0.0-rc02. Чтобы перейти с версии 1.0.0-rc02, вам не нужно вносить изменения в код. Достаточно обновить зависимости, чтобы они соответствовали новым зависимостям.

Чтобы использовать версии Navigation 2.X, ваш проект должен быть перенесен в AndroidX. Стабильная версия Navigation 1.0 будет последней, в которой используются зависимости библиотеки поддержки.Все последующие версии будут основаны на AndroidX и стабильной версии 2.0.

Зависимости до AndroidX

Для версий Navigation до AndroidX включите следующие зависимости:

dependencies {
    def nav_version = "1.0.0"

    implementation "android.arch.navigation:navigation-fragment:$nav_version" // For Kotlin use navigation-fragment-ktx
    implementation "android.arch.navigation:navigation-ui:$nav_version" // For Kotlin use navigation-ui-ktx
}

Для Safe Args добавьте следующий classpath в файл build.gradle верхнего уровня:

buildscript {
    repositories {
        google()
    }
    dependencies {
        classpath "android.arch.navigation:navigation-safe-args-gradle-plugin:1.0.0"
    }
}

Версия 1.0.0

Версия 1.0.0

14 марта 2019 г.

Версия 1.0.0 навигации выпущена без изменений по сравнению с версией 1.0.0-rc02.

Версия 1.0.0-rc02

26 февраля 2019 г.

Это второй релиз-кандидат для стабильной версии Navigation 1.0.0. В этом выпуске содержится ряд исправлений ошибок.

Исправление ошибок

  • Исправлена ошибка, из-за которой popBackStack() игнорировался, если у корневого графа не было идентификатора. b/126251695
  • navigateUp() теперь корректно обрабатывает возврат к задаче приложения, если он вызывается после обработки ссылки на контент без FLAG_ACTIVITY_NEW_TASK. b/126082008
  • Исправлена ошибка, из-за которой в ActivityNavigator.applyPopAnimationsToPendingTransition не применялась правильная анимация выхода. b/126237567
  • Код Kotlin, сгенерированный Safe Args, теперь правильно экранирует ключевые слова Kotlin, такие как in и fun, в названии пакета, связанного с классом R. b/126020455

Версия 1.0.0-rc01

21 февраля 2019 г.

Это релиз-кандидат для стабильной версии Navigation 1.0.0. В этой версии исправлена одна ошибка.

Исправление ошибок

  • Исправлена ошибка, возникавшая при использовании фрагментов и операций навигации singleTop. b/124294805

Версия 1.0.0-beta02

12 февраля 2019 г.

В этой версии исправлены ошибки и внесены небольшие улучшения.

Новые функции

  • Теперь вы можете использовать 0 как android:defaultValue для аргументов reference. b/124248602

Изменения в поведении

  • Точные совпадения ссылок на контент теперь имеют приоритет над ссылками на контент с совпадениями .* или аргументов. b/123969518

Исправление ошибок

  • popBackStack() и navigateUp теперь корректно возвращают false при извлечении последнего пункта назначения из обратного стека. Это исправляет регрессию, появившуюся в 1.0.0-beta01. b/123933201
  • Теперь при восстановлении сохраненного состояния экземпляра Navigation правильно задает ClassLoader, что позволяет избежать проблем при использовании собственных классов в сохраненном состоянии Navigator или в аргументах, отправляемых в NavDestination. b/123893858
  • Классы NavArgs, созданные Safe Args, больше не вызывают сбоев при восстановлении аргумента Parcelable[] из сохраненного состояния экземпляра. b/123963545
  • Safe Args теперь правильно удаляет ненужные сгенерированные классы Kotlin. b/124120883

Версия 1.0.0-beta01

4 февраля 2019 г.

Это первый бета-выпуск Navigation API. Ожидается, что до следующей версии он будет работать стабильно, если не возникнет критических проблем. В этой версии исправлены ошибки и внесены изменения в работу.

Изменения в поведении

  • Теперь навигация гарантирует, что значения аргументов по умолчанию обрабатываются одинаково во время выполнения и через Safe Args. В результате только аргументы с app:argType="reference" могут иметь значение по умолчанию, указывающее на другой ресурс (например, @color/colorPrimary). Попытка использовать значение по умолчанию со ссылкой и другим app:argType приведет к исключению при анализе XML-файла навигации. b/123551990
  • Safe Args теперь зависит от плагина Android Gradle 3.3.0. aosp/888413
  • Safe Args теперь зависит от Kotlin 1.3.20 aosp/888414

Исправление ошибок

  • Safe Args теперь можно использовать в библиотеках и модулях функций во всех версиях плагина Android Gradle. b/121304903
  • Исправлена регрессия, из-за которой одна операция popBackStack() удаляла из верхней части обратного стека все копии целевой страницы, а не только одну. b/123552990
  • Исправлена ошибка, из-за которой состояние FragmentNavigator не синхронизировалось с состоянием NavController, что приводило к IllegalStateException при попытке восстановить обратный стек. b/123803044
  • Исправлена ошибка, из-за которой стрелка назад, обрабатываемая NavigationUI, не появлялась при использовании ProGuard с обфускацией. b/123449431
  • Код, сгенерированный Safe Args, теперь правильно обрабатывает использование app:argType, указывающего на статический внутренний класс в формате .OuterClass$InnerClass. b/123736741
  • Код Java, созданный Safe Args, теперь правильно обрабатывает глобальные действия и глубоко вложенные пункты назначения. b/123347762

Версия 1.0.0-alpha11

23 января 2019 г.

Это выпуск 1.0.0-alpha10 с исправлением ошибки, связанной с Safe Args.

Исправление ошибок

  • Исправлена ошибка, из-за которой Safe Args не удавалось импортировать класс Directions, связанный с глобальными действиями. b/123307342

Версия 1.0.0-alpha10

23 января 2019 г.

Известные проблемы

  • Safe Args не может импортировать класс Directions, связанный с глобальными действиями. b/123307342

В этой версии есть критические изменения API. Подробная информация о них приведена в разделе Критические изменения ниже.

Новые функции

  • Пользователи Kotlin теперь могут использовать делегат свойства by navArgs(), чтобы получить ссылку на класс NavArgs, созданный Safe Args, в Activity или Fragment. b/122603367
  • Теперь Safe Args позволяет генерировать код Kotlin с помощью плагина androidx.navigation.safeargs.kotlin. Код Kotlin создается специально для модулей Kotlin с использованием аргументов по умолчанию и неизменяемых классов вместо шаблона Builder, который по-прежнему доступен в предыдущем плагине androidx.navigation.safeargs. b/110263087

Изменения в поведении

  • Теперь при выборе совпадающих ссылок на контент предпочтение отдается тем, у которых больше совпадающих аргументов. b/118393029
  • Вызов setGraph() в NavController теперь сбрасывает обратный стек. b/111450672
  • Неизвестные ссылки на контент больше не вызывают ошибку IllegalStateException, а игнорируются. Это позволяет устранить проблемы с вложенными или множественными объектами NavHostFragment. b/121340440

Критические изменения

  • Метод NavOptions.applyPopAnimationsToPendingTransition() для применения анимации к Activity перенесен в ActivityNavigator. b/122413117
  • Safe Args теперь не дублирует идентичные классы для действий без аргументов. Тип возвращаемого значения для методов без аргументов в сгенерированных классах NavDirections теперь NavDirections. b/123233147
  • У классов Directions, созданных с помощью Safe Args, больше нет общедоступного конструктора. Теперь вы можете взаимодействовать только со сгенерированными статическими методами. b/123031660
  • У классов NavDirections, созданных с помощью Safe Args, больше нет общедоступного конструктора. Их можно создавать только с помощью статических методов в созданных классах Directions. b/122963206
  • Возвращенный товар Bundle из заказа getArguments() продавца NavDirections теперь отмечен как @NonNull, а не @Nullable. b/123243957

Исправление ошибок

  • Теперь NavDeepLinkBuilder корректно обрабатывает несколько одновременных вызовов PendingIntent для одного и того же пункта назначения, используя переданные вами аргументы для определения уникальности. b/120042732
  • NavController теперь корректно обрабатывает операции popBackStack() при использовании вложенного NavHostFragment или других дочерних фрагментов с обратным стеком. b/122770335
  • NavigationUI теперь правильно задает описание контента для кнопки "Вверх". b/120395362
  • Классы Directions, созданные с помощью Safe Args, теперь корректно обрабатывают глобальные действия, у которых тот же идентификатор, что и у действия в пункте назначения. b/122962504
  • Классы NavDirections, созданные Safe Args, теперь имеют равные значения hashCode(), когда equals() возвращает значение true. b/123043662
  • Теперь FragmentNavigator выдает более понятное сообщение об ошибке, если вы пытаетесь выполнить пользовательскую FragmentTransactions для FragmentManager в NavHostFragment. Всегда используйте getChildFragmentManager(). b/112927148

Версия 1.0.0-alpha09

18 декабря 2018 г.

В этой версии есть критические изменения API. Подробная информация о них приведена в разделе Критические изменения ниже.

Мы решили прекратить разработку артефакта android.arch.navigation:navigation-testing. Хотя этот метод полезен для внутреннего тестирования NavController, мы настоятельно рекомендуем использовать альтернативные стратегии тестирования, например имитацию экземпляра NavController, чтобы убедиться, что выполняются правильные вызовы navigate(). Этот подход подробно обсуждается в докладе Single Activity на AndroidDevSummit 2018. Мы также планируем подготовить дополнительную документацию по тестированию с помощью Navigation.

Новые функции

  • MenuItem с menuCategory="secondary" больше не будут извлекать обратный стек при использовании с методами NavigationUI. b/120104424
  • Теперь AppBarConfiguration позволяет задать резервный экземпляр OnNavigateUpListener, который будет вызываться, когда navController.navigateUp() возвращает false. b/79993862 b/120690961

Критические изменения

  • При использовании <argument> с argType="reference" Navigation больше не анализирует ссылку, а предоставляет идентификатор необработанного ресурса. b/111736515
  • onNavDestinationSelected() теперь по умолчанию возвращается к начальному пункту назначения графа навигации, что соответствует методам setup. Добавьте menuCategory="secondary" в MenuItem, чтобы избежать извлечения из обратного стека. aosp/852869
  • Методы fromBundle() сгенерированных классов Args теперь принимают ненулевое значение Bundle вместо допустимого значения NULL Bundle aosp/845616.

Исправление ошибок

  • Аргументы теперь правильно анализируются из ссылок на контент как правильный argType, а не всегда как строки. b/110273284
  • Теперь навигация правильно экспортирует общедоступные ресурсы. b/121059552
  • Safe Args теперь совместим с плагином Android Gradle 3.4 Canary 4 и более поздними версиями. b/119662045

Версия 1.0.0-alpha08

6 декабря 2018 г.

В этой версии есть критические изменения API. Подробная информация о них приведена в разделе Критические изменения ниже.

Новые функции

  • Ярлыки целевых страниц, используемые с методами NavigationUI, теперь будут автоматически заменять экземпляры {argName} в android:label правильным аргументом. b/80267266
  • Навигация теперь зависит от библиотеки поддержки версии 28.0.0. b/120293333

Критические изменения

  • OnNavigatedListener has been renamed to OnDestinationChangedListener b/118670572
  • OnDestinationChangedListener теперь также передает Bundle аргументов. aosp/837142
  • Удалены атрибуты app:clearTask и app:launchDocument и связанные с ними методы. Используйте app:popUpTo с корнем графа, чтобы удалить все пункты назначения из обратного стека. b/119628354
  • ActivityNavigator.Extras теперь использует шаблон Builder и позволяет устанавливать любые флаги Intent.FLAG_ACTIVITY_. aosp/828140
  • NavController.onHandleDeepLink переименован в handleDeepLink. aosp/836063
  • Многие классы и методы, не предназначенные для создания подклассов, например NavOptions, NavInflater, NavDeepLinkBuilder и AppBarConfiguration, стали final. aosp/835681
  • Удален устаревший метод NavHostFragment.setGraph(). aosp/835684
  • Удален устаревший метод NavigationUI.navigateUp(DrawerLayout, NavController). aosp/835684
  • Создание фрагментов перенесено в FragmentNavigator, что упрощает делегирование создания фрагментов в FragmentFactory. b/119054429
  • Конструктор для NavGraphNavigator больше не принимает Context aosp/835340
  • NavigatorProvider теперь является классом, а не интерфейсом. Функциональность NavigatorProvider, возвращаемого getNavigatorProvider(), не изменилась. aosp/830660
  • Ресурс NavDestination.navigate() уже удален. Вместо этого вызовите navigate() для Navigator. aosp/830663
  • Значительный рефакторинг Navigator, устраняющий необходимость в OnNavigatorNavigatedListener. Вместо этого navigate возвращает NavDestination, к которому был выполнен переход.
  • Экземпляры Navigator больше не могут отправлять события POP в NavController. Рекомендуем использовать OnBackPressedCallback, чтобы перехватывать нажатия кнопки "Назад" и вызывать navController.popBackStack(). aosp/833716

Исправление ошибок

  • popUpTo теперь работает стабильно, когда целевым является элемент <navigation>. b/116831650
  • Исправлен ряд ошибок, которые приводили к возникновению IllegalArgumentException при использовании вложенных графов: b/118713731 b/113611083 b/113346925 b/113305559
  • Атрибут dataPattern целевых страниц <activity> теперь будет заполнять аргументы из аргументов, не являющихся строками, путем вызова toString(). b/120161365

Safe Args

  • Safe Args поддерживает сериализуемые объекты, включая значения Enum. Для типов Enum можно задать значение по умолчанию, используя литерал enum без названия класса (например, app:defaultValue="READ"). b/111316353
  • Safe Args поддерживает массивы всех поддерживаемых типов. b/111487504
  • Safe Args теперь игнорирует подпапки каталогов ресурсов. b/117893516
  • Safe Args добавляет аннотации @Override там, где это необходимо. b/117145301

Версия 1.0.0-alpha07

29 октября 2018 г.

Новые функции

  • Новый класс AppBarConfiguration позволяет настраивать, какие пункты назначения считаются пунктами назначения верхнего уровня. Подробную информацию вы найдете в обновленной документации. b/117333663
  • Теперь вы можете передавать аргументы в начальный пункт назначения графа. b/110300470
  • Ссылки на контент теперь поддерживают специальные схемы с точками, дефисами и знаками плюса. b/112806402

Критические изменения

  • Модуль navigation-testing-ktx был объединен с модулем navigation-testing artifact и больше не будет публиковаться.
  • Артефакт navigation-testing теперь зависит от стандартной библиотеки Kotlin. API был изменен, чтобы лучше соответствовать соглашениям Kotlin, но вы можете продолжать использовать его для тестов, написанных на Java.
  • Графы навигации, зарегистрированные в манифесте метаданных, больше не поддерживаются. b/118355937
  • Действия больше нельзя прикреплять к целевым страницам <activity>. aosp/785539

Исправление ошибок

  • Ссылки на контент теперь корректно анализируют параметры запроса. b/110057514
  • Теперь в целевых действиях правильно применяются все анимации входа и выхода. b/117145284
  • Исправлена ошибка, приводившая к сбоям после изменения конфигурации при использовании собственных навигаторов. b/110763345

Safe Args

  • Safe Args теперь имеет фиксированную зависимость от плагина Android Gradle версии 3.2.1. b/113167627
  • Теперь можно генерировать маршруты для внутренних классов. b/117407555
  • Исправлена ошибка, из-за которой не удавалось создать маршруты к графу <include>. b/116542123

Версия 1.0.0-alpha06

20 сентября 2018 г.

Новые функции

Изменения в API

  • Критическое изменение. Метод Navigator navigate() теперь принимает параметр Navigator.Extras.
  • Метод getGraph() NavController теперь NonNull b/112243286.

Исправление ошибок

  • NavigationUI.setupWithNavController() больше не пропускает просмотры, если используется с просмотрами из отдельных целевых сервисов b/111961977
  • Navigator onSaveState() теперь вызывается только один раз b/112627079.

Safe Args

  • Классы Directions для пункта назначения навигации теперь расширяют родительский класс Directions, если он существует b/79871405.
  • В классах Directions и Args теперь есть полезная реализация toString() b/111843389.

Версия 1.0.0-alpha05

10 августа 2018 г.

Исправление ошибок

  • Исправлена ошибка, из-за которой стек возврата работал неправильно. b/111907708
  • Исправлена ошибка в equals() сгенерированных классов Args. b/111450897
  • Исправлена ошибка сборки в Safe Args. b/109409713
  • Исправлена ошибка, из-за которой идентификаторы ресурсов не преобразовывались в имена Java (b/111602491).
  • Исправлены сообщения об ошибках, связанных с допустимостью значения NULL в плагине Safe Args.
  • Добавлены отсутствующие аннотации о допустимости значения NULL.

Версия 1.0.0-alpha04

19 июля 2018 г.

В Navigation 1.0.0-alpha04 и связанном с ним плагине Safe Args gradle внесен ряд изменений в API и поведение, а также исправлены ошибки.

Изменения в API и поведении

  • NavHostFragment всегда будет устанавливать текущий фрагмент в качестве основного фрагмента навигации, гарантируя, что дочерние менеджеры фрагментов будут извлечены до извлечения внешнего NavController b/111345778.

Safe Args

  • Критическое изменение. app:type заменено на app:argType, чтобы избежать конфликтов с другими библиотеками, например ConstraintLayout 2.0.0-alpha1 b/111110548.
  • Сообщения об ошибках из Safe Args теперь кликабельны b/111534438.
  • Классы Args теперь подтверждают, что атрибуты NonNull не равны null b/111451769
  • В классы, созданные с помощью NavDirections и Args, добавлены дополнительные аннотации NonNull b/111455455 b/111455456.

Исправление ошибок

  • Исправлена ошибка, из-за которой системная кнопка "Назад" не работала после перехода по ссылке на контент в целевой фрагмент (b/111515685).

Версия 1.0.0-alpha03

12 июля 2018 г.

В Navigation 1.0.0-alpha03 и связанном с ним плагине Safe Args gradle внесен ряд изменений в API и поведение, а также исправлены ошибки.

Изменения в API и поведении

  • Добавлен метод NavigationUI.setupWithNavController для панели инструментов b/109868820.
  • Добавлен метод NavigationUI.setupWithNavController для CollapsingToolbarLayout b/110887183.
  • Теперь popBackStack() возвращает значение false, если обратный стек пуст или в нем нет указанного идентификатора целевой страницы (b/110893637).
  • FragmentNavigator теперь игнорирует операции навигации после того, как FragmentManager сохранил состояние, что позволяет избежать исключений "Can not perform this action after onSaveInstanceState" (b/110987825).

Safe Args

  • Критическое изменение. Небуквенно-цифровые символы в названиях действий и аргументов будут заменены верблюжьим регистром в соответствующих названиях методов NavDirections.
    • Например, DemoController.index станет setDemoControllerIndex b/79995048.
    • Например, action_show_settings станет actionShowSettings b/79642240
  • Критическое изменение. Теперь аргументы по умолчанию считаются ненулевыми. Чтобы разрешить нулевые значения для аргументов string и parcelable, добавьте app:nullable="true" b/79642307.
  • Теперь вы можете использовать app:type="long" с defaultValues в формате "123L" b/79563966.
  • Теперь поддерживаются аргументы Parcelable, использующие полное имя класса для app:type. Единственное поддерживаемое значение по умолчанию – "@null" b/79563966.
  • Классы Args теперь реализуют equals() и hashCode() b/79642246
  • Плагин Safe Args теперь можно применять к проектам библиотек b/80036553.
  • Плагин Safe Args теперь можно применять к проектам функций b/110011752.

Исправление ошибок

  • Исправлены ошибки, возникавшие при навигации во время выполнения методов жизненного цикла фрагмента b/109916080.
  • Исправлены ошибки, возникавшие при многократной навигации по вложенным графикам b/110178671.
  • Исправлены ошибки, возникавшие при использовании setPopUpTo с первым пунктом назначения на графике b/109909461.
  • Устранена проблема, из-за которой все значения app:defaultValue передавались как строки b/110710788.
  • Инструмент aapt2, входящий в состав плагина Android Gradle 3.2 Beta 01, теперь добавляет правила сохранения для каждого атрибута android:name в XML-файлах навигации b/79874119.
  • Устранена утечка памяти при замене FragmentNavigator по умолчанию b/110900142.

Версия 1.0.0-alpha02

7 июня 2018 г.

Изменения в поведении

  • Теперь в доме "FragmentNavigator" используется setReorderingAllowed(true). b/109826220

  • Теперь Navigation декодирует URL аргументов, полученных из URL ссылок на контент. b/79982454

Исправление ошибок

  • Исправлена ошибка IllegalStateException, возникающая при вызове навигации из методов жизненного цикла фрагмента. b/79632233

  • Для устранения мерцания при использовании анимации Navigation теперь зависит от Support Library 27.1.1. b/80160903

  • Исправлена ошибка IllegalArgumentException, возникавшая при использовании defaultNavHost="true" в качестве дочернего фрагмента. b/79656847

  • Исправлена ошибка StackOverflowError при использовании NavDeepLinkBuilder. b/109653065

  • Исправлена ошибка IllegalArgumentException, возникавшая при возврате к вложенному графу. b/80453447

  • Исправлена ошибка с перекрывающимися фрагментами при использовании launchSingleTop. b/79407969

  • Теперь Navigation создает правильный синтетический обратный стек для вложенных графов. b/79734195

  • NavigationUI теперь выделяет правильный элемент при использовании вложенного графа в качестве MenuItem. b/109675998

Изменения в API

  • Атрибут clearTask для действий и связанный с ним API в NavOptions больше не поддерживаются. b/80338878

  • Атрибут launchDocument для действий и связанный с ним API в NavOptions больше не поддерживаются. b/109806636

Версия 1.0.0-alpha01

8 мая 2018 г.

Navigation – фреймворк для создания навигации в приложении. Первая версия – 1.0.0-alpha01.