Навигация
androidx.navigation
androidx.navigation.compose
androidx.navigation.dynamicfeatures
androidx.navigation.dynamicfeatures.fragment
androidx.navigation.dynamicfeatures.fragment.ui
androidx.navigation.fragment
androidx.navigation.fragment.compose
androidx.navigation.testing
androidx.navigation.ui
| Последнее обновление | Основная версия | Релиз-кандидат | Бета-версия | Альфа-версия |
|---|---|---|---|---|
| 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.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. При переходе к действию с помощьюdataPatternActivityNavigatorтеперь пытается закодировать значение аргумента с помощью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, то естьcomposable<YourScreen>теперь имеют нереифицированные версии, которые напрямую принимают экземплярKClass(Ia7eed, Id2879, Ibf244, I17d79, Id09d2, I54696, Ia47be, I93281, Ic1bf0, Iba4ee, If56a5, Icf969, I67644, I6f788, b/382094941, b/366291612, b/381938808).
В таблице ниже приведены 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: исправлена ошибкаNavDestinationNullPointerExceptionпри обновлении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) - При переходе к действию с помощью
dataPatternActivityNavigatorтеперь будет пытаться закодировать значение аргумента с помощьюNavTypeаргумента. (I1a71d, b/383616432)
Версия 2.8.5
11 декабря 2024 г.
Данные "androidx.navigation:navigation-*:2.8.5" опубликованы. Версия 2.8.5 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой
NavHostмог вызывать исключение внутриPredictiveBackHandler, если обратный стек сокращался до одной записи и в том же фрейме запускался системный возврат. (I1a429, b/375343407) - Исправлена ошибка
NavDestinationNullPointerException, возникавшая при обновлении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.9.0-alpha01. Попытка использоватьNavController, который ранее былDESTROYED, теперь приведет кIllegalStateException. (I520da, b/369616172)
Версия 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)
Исправление ошибок
- Теперь для навигации требуется, чтобы маршрут, переданный в
startDestinationNavGraph, содержал значения для всех обязательных аргументов, включая аргументы, которые не могут иметь значение 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. Обратите внимание, чтоSerialNameEnumдолжно быть полным именем по умолчанию. (I66d22, b/346475493) - В Safe Args для навигации добавлена встроенная поддержка типов аргументов, допускающих значение NULL, включая
Int?,Long?,Float?,Boolean?иEnum<*>?. (I32d13,I1c580,Ifba66,I978b0,Ide076 , b/351994237) - Теперь
startDestinationNavGraphбудет использовать значения аргументов по умолчанию, если маршрут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
- Завершена работа по поддержке типобезопасности во время компиляции для Navigation Compose и пользователей Navigation Kotlin DSL на основе Kotlin Serialization. Ранее экспериментальные API теперь стабильны. (Iea94d, I0eb0d, I873b7, I3a64b, I6c3a2, I11f0b, Ic3032, I8d394, I95710, Ice060, Id0e55, I45f8b, Idcdaf, If5380, I08b23, Ia5c59, b/188693139)
Эта функция использует 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
- Начата поддержка Safe Args в Navigation Compose с использованием подхода, основанного на сериализации Kotlin. Эти API не завершены и помечены аннотацией
ExperimentalSafeArgsApi. Эта аннотация будет удалена, когда в одном из будущих выпусков будет полностью реализован весь API. (I644e7, I98896, I2a1c5, I43a51, I836a1, Ic5eec, I39407, I24e41, If9e14, Ibb13e, If44d3, Icb70f, I8972f, I1d432, Icf32b, I20a14, I262aa, I7de99, I35990, I1033d, b/188693139)
Исправление ошибок
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 содержит эти коммиты.
Новые функции
- Теперь вы можете передавать аргументы в
startDestinationNavGraphнапрямую в маршрутеstartDestination, не полагаясь наdefaultValue. Это также относится к вложенным объектамNavGraphstartDestinations. (I0e0b5, b/109505019, b/188693139)
Изменения в API
- Добавлен новый абстрактный класс
CollectionNavType<T>, подклассNavType<T>для аргументов на основе коллекций, таких как списки, массивы и карты. (Ic6d63, b/188693139) - Все массивы
NavTypeпо умолчанию (IntArrayType,LongArrayType,FloatArrayType,BoolArrayTypeиStringArrayType) теперь имеют типCollectionNavType(Idcf79, b/188693139). - В
NavTypeтеперь есть новый открытый APIvalueEquals, который определяет, равны ли два значения одного типа. (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)
Исправление ошибок
- Исправлена ошибка в навигации, из-за которой
NavGraphViewModelDESTROYEDслишком рано, так какViewModelсвязанной записи не был частью сохраненного состояния. (Ib6bb7, b/317581849)
Обновление зависимостей
- Navigation Compose теперь зависит от Compose 1.7.0-alpha03.
Версия 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 содержит эти коммиты.
Исправление ошибок
- Функция
NavGraphequals()теперь правильно учитывает узлы другого графа, а не только вызывающего. Это гарантирует, что графы с узлами, у которых разные идентификаторы, больше не будут считаться равными (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.DESTROYEDViewModel. (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
argumentsNavBackStackEntryиarguments, переданные вOnDestinationChangedListener, теперь являются лишь копией неизменяемых аргументов, созданных при переходе к пункту назначения. Это означает, что любые изменения, внесенные в эти наборы, не будут отражены при последующих доступах кargumentsили другим экземплярамOnDestinationChangedListener.NavDeepLinkтеперь поддерживает значения по умолчанию для массивов, что позволяет поддерживать повторяющиеся параметры запроса, которые будут сопоставляться с типом массива аргумента. ВNavTypeтеперь также есть метод по умолчанию, который можно переопределить, чтобы объединить два обработанных значения.- Пользовательские подклассы
NavTypeтеперь могут переопределятьserializeAsValueдля сериализации значения в строку, что позволяет полностью инкапсулировать сериализацию и десериализацию (черезparseValue) в классеNavType. ТеперьStringTypeпереопределяет этот метод, чтобы вызватьUri.encodeдля заданногоString.
Важные изменения в Navigation Compose с версии 2.5.0
- При предпросмотре composable-функции с помощью
NavHostтеперь по умолчанию будет показыватьсяstartDestinationNavGraph. NavController.popBackStack(route),NavController.getBackStackEntry(route),NavController.clearBackStack(route)теперь поддерживают маршруты с частично или полностью заполненными аргументами. Обратите внимание, что аргументы должны точно совпадать с аргументами записи.- Попытка создать пустой объект
NavDeepLinkс помощьюnavDeepLinkKotlin DSL теперь приведет к предупреждению о том, что для ссылки на контент требуется URI, действие и/или MIME-тип.
Важные изменения в навигации с помощью фрагментов, начиная с версии 2.5.0
NavHostFragmentбольше не перехватывает нажатие системной кнопки "Назад". Это позволяет базовому компонентуFragmentManagerобрабатывать системный жест "Назад". Это позволяет Fragment1.7.0-alpha01и более поздним версиям предоставлять анимацию предпросмотра для жеста "Назад" в приложении на устройствах Android U.- Если при использовании навигации с фрагментами попытаться вручную выполнить операцию
FragmentTransaction, которая добавляет фрагмент в обратный стекFragmentManager, теперь будет возникать ошибкаIllegalArgumentException. Фрагменты всегда следует добавлять через APInavigate(). - Если в атрибутах
app:dataиapp:dataPatternэлемента activity в XML-файле навигации в качестве плейсхолдера используется точная строка${applicationId}, то при заполнении он будет автоматически заменен наpackageNameконтекста. - Теперь
FragmentNavigatorиспользует API переходов при навигации и всплывающих окнахNavBackStackEntries. Это означает, чтоNavBackStackEntryLifecycleтеперь будет ждать завершения специальных эффектов входа и выхода фрагмента, прежде чем перемещать их окончательныйLifecycle.State. - Теперь
DialogFragmentNavigatorиспользует API переходов при навигации и всплывающих окнахNavBackStackEntries. Это означает, чтоNavBackStackEntryLifecycleбудет ждать, покаDialogFragmentLifecycleне перейдет на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. Фрагменты всегда следует добавлять через APInavigate(). (I6d38e) - Если в одном фрейме есть
navigate, который добавляет запись, иpopBackStack, который ее удаляет, то верхняя запись в обратном стеке теперь будет стабильно возвращаться вRESUMEDLifecycle.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)- Добавление фрагментов в
FragmentManagerFragmentNavigatorбез использования навигации больше не приводит к сбою. (b17204, b/274167493)
Обновления зависимостей
- Теперь навигация зависит от Lifecycle
2.6.1. (586fe7) - Теперь навигация зависит от SavedState
1.2.1. (078e4e) - Теперь для навигации требуется ProfileInstaller
1.3.0. (512f0c)
Версия 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теперь по умолчанию будет показыватьсяstartDestinationNavGraph. (I2b89f)
Изменения в API
- Все перегрузки
NavControllernavigateтеперь аннотированы с помощью@MainThread, чтобы они вызывались в основном потоке. (I2c0b0, b/263427111)
Исправление ошибок
- Исправлен сбой, возникавший при попытке навигации с использованием динамической навигации по фрагментам. (I3ee29, b/268360479)
- Исправлена ошибка, из-за которой при переходе к другому фрагменту с помощью системной кнопки "Назад" на нижней панели не обновлялся выбранный элемент (If559f, b/269044426).
Известные проблемы
- При использовании навигации с фрагментами жизненный цикл
NavBackStackEntryне достигаетRESUMED, если используются APIAnimation. (b/269646882) - При использовании навигации с фрагментами и навигации с помощью
BottomNavigation, если вы попытаетесь восстановить обратный стек с несколькими записями,BottomMenuItemне будет обновлен правильно. (b/270447657) - При использовании навигации с фрагментами после восстановления состояния
NavBackStackEntryLifecycleне получает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. Это означает, чтоNavBackStackEntryLifecycleтеперь будет ждать завершения специальных эффектов входа и выхода фрагмента, прежде чем перемещать их окончательныйLifecycle.State. (I3cb19, b/238686802) - Теперь
DialogFragmentNavigatorиспользует API переходов при навигации и всплывающих окнахNavBackStackEntries. Это означает, чтоNavBackStackEntryLifecycleбудет ждать, покаDialogFragmentLifecycleне перейдет наDESTROYED, прежде чем перейти наDESTROYED. (I53ee5, b/261213893)
Изменения в API
- В
NavigatorStateтеперь есть APIprepareForTransition, который позволяет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)
Обновления зависимостей
- Теперь навигация зависит от Fragment
1.5.4. (Icd424)
Версия 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с помощьюnavDeepLinkKotlin DSL теперь приведет к предупреждению о том, что для ссылки на контент требуется URI, действие и/или MIME-тип. (I08d2f, b/154038883)
Изменения в API
- Добавлена новая функция расширения
NavDestination, которая позволяет преобразовывать динамические ярлыки с аргументами в форматеandroid:label="{arg}"в строку. Поддерживает аргументыReferenceType, преобразуя значенияR.stringв строковые значения. (I07d89, b/236269380)
Изменения в поведении
argumentsNavBackStackEntry и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.2зависит от фрагмента1.5.2. (aosp/2178734)
Версия 2.5.1
27 июля 2022 г.
Данные "androidx.navigation:navigation-*:2.5.1" опубликованы. Версия 2.5.1 содержит эти коммиты.
Исправление ошибок
Navigation Safe Argsбольше не будет вызывать предупреждения об устаревании в сгенерированных классах при использовании пользовательских типов аргументов, сохраненных вBundle. (Id86ed, b/237725966)
Обновления зависимостей
- Библиотека Navigation теперь зависит от Lifecycle
2.5.1. (Ib4451) - Библиотека Navigation теперь зависит от Activity
1.5.1. (I3efe8) - Библиотека Navigation теперь зависит от Fragment
1.5.1. (I56177)
Версия 2.5.0
29 июня 2022 г.
Данные "androidx.navigation:navigation-*:2.5.0" опубликованы. Версия 2.5.0 содержит эти коммиты.
Важные изменения, внесенные в версию 2.4.0
- Интеграция CreationExtras. Теперь
Navigationможет предоставлятьViewModelProvider.Factoryбез отслеживания состояния черезCreationExtrasLifecycle2.5.0.
Navigation SafeArgs
- В
Navigation Safe ArgsзависимостьAndroid Gradle Pluginобновлена до7.0.4, поэтому совместимость с версиями AGP до7.0прекращена. - Добавлена поддержка атрибута build.gradle пространства имен, который можно использовать вместо applicationId.
Другие изменения
visibleEntriesAPI больше не является экспериментальным и предоставляет функцию для получения всех записей, пункт назначения которых в настоящее время виден в соответствии с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) visibleEntriesStateFlow, предоставляемый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 содержит эти коммиты.
Новые функции
NavBackStackEntryтеперь интегрируется с ViewModel CreationExtras, представленным в Lifecycle2.5.0-alpha01. (Ib9fe2, b/207012490)
Исправление ошибок
- Исправлена ошибка, из-за которой при попытке получить доступ к
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, теперь принимают его надкласс, представленный в Material1.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(с помощью APIviewModel()библиотеки Lifecycle ViewModel Compose2.4.0илиhiltViewModel()библиотеки Hilt Navigation Compose1.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” />В
navOptionsKotlin 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(), которые обновляютNavBackStackEntryLifecycle, теперь помечены как@MainThread. Это позволяет согласовать навигацию с принудительным применением основного потока, представленным в Lifecycle2.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. Это означает, что при вызове асинхронного APIdismiss()для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через StateFlowvisibleEntries(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)
Обновления зависимостей
- Navigation Compose теперь зависит от Activity Compose 1.3.1. (I05829)
- Navigation Compose теперь зависит от Lifecycle ViewModel Compose
2.4.0-beta01. (Ib86a3)
Версия 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.StateNavBackStackEntry, поэтому использование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 содержит эти коммиты.
Изменения в поведении
NavHostNavigation 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теперь могут использовать APIpushWithTransactionи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.0Safe 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, были обновлены и теперь принимают его надкласс, представленный в Material1.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использует APINavigatorState.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” />В
navOptionsKotlin 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:
- Свойство
popUpTokotlin в 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(), которые обновляютNavBackStackEntryLifecycle, теперь помечены как@MainThread. Это позволяет согласовать навигацию с принудительным применением основного потока, представленным в Lifecycle2.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)
Navigation Compose версии 1.0.0
Версия 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возвращает допускающий значение NULLViewModelStoreOwner, чтобы было проще определить, доступен ли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теперь заполняетLocalSavedStateRegistryOwnerCompositionLocal с помощью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, добавленный в CustomView1.1.0и реализованныйDrawerLayoutв DrawerLayout1.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 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой
LifecycleNavBackStackEntryне обновлялся должным образом после завершения процесса. (b/155218371) - Экземпляры
OnDestinationChangedListener, зарегистрированные до вызоваsetGraph(), теперь корректно отправляют восстановленный пункт назначения после завершения процесса. (b/155218371) - При использовании
singleTopаргументыNavBackStackEntryтеперь обновляются правильно и отправляются во все экземплярыOnDestinationChangeListener. (b/156545508)
Обновления зависимостей
- Артефакт
NavigationUIтеперь зависит от CustomView1.1.0-rc01и DrawerLayout1.1.0-rc01. (aosp/1309696)
Версия 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 теперь есть
defaultArgumentsMapдля действий, что позволяет задавать значения по умолчанию для элементов<action>в XML-файлах навигации. (b/150345605)
Исправление ошибок
- Из Navigation 2.2.2: исправлена ошибка
IllegalStateException, возникавшая при переходе по ссылке на контент к начальному пункту назначения графа, если в объекте Activity было несколько экземпляровNavHostFragment. (b/147378752)
Обновление зависимостей
- Теперь навигация зависит от Fragment
1.2.4. (aosp/1277325) - Динамическая навигация теперь зависит от Play Core
1.7.2. (aosp/1282257)
Версия 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, представленный в CustomView1.1.0-alpha02(которыйDrawerLayoutреализует начиная с DrawerLayout1.1.0-alpha04). Это позволяет использовать собственные реализацииOpenableсNavigationUI. (b/129030452)
Исправление ошибок
- Правила ProGuard для
navigation-common-ktxтеперь корректно сохраняют только используемые классыNavArgs, а не все экземплярыNavArgs. (b/150213558)
Изменения в зависимостях
- Navigation теперь зависит от Core
1.1.0, а не от Core1.2.0. Это сделано для того, чтобы разработчикам не приходилось переходить на новую зависимость, когда Navigation не зависит от новых API в Core1.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)
Обновление зависимостей
- Navigation
2.2.1. Navigation2.2.1теперь зависит от Lifecycle ViewModel SavedState2.2.0и Fragment1.2.1.
Версия 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
Обновление зависимостей
- Теперь навигация зависит от Fragment
1.2.4. (aosp/1277325)
Версия 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)
Обновление зависимостей
- Navigation
2.2.1теперь зависит от Lifecycle ViewModel SavedState2.2.0и Fragment1.2.1.
Версия 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, приведены в соответствие с анимациями затухания в Fragment1.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 SavedState1.0.0-rc03, Activity1.1.0-rc03и Fragment1.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) - При использовании
ToolbarNavigationUIбольше не анимирует изменение текста при переходе между двумя целевыми страницами верхнего уровня. (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
- Навигация
2.1.0-rc01. Удален устаревший APIgetViewModelStore()вNavController, представленный в2.1.0-alpha02. (aosp/1091021)
Исправление ошибок
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, или с помощью APIgetViewModelStoreOwner(), добавленного в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при перехвате событий системной кнопки "Назад", исправляя регрессию в Navigation2.1.0-alpha03. b/132077777DialogFragmentNavigatorтеперь корректно обрабатывает операции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 или с помощью APIgetViewModelStore(), добавленного в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/122770335NavigationUIтеперь правильно задает описание контента для кнопки "Вверх". 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вместо допустимого значения NULLBundleaosp/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
Критические изменения
OnNavigatedListenerhas been renamed toOnDestinationChangedListenerb/118670572OnDestinationChangedListenerтеперь также передаетBundleаргументов. aosp/837142- Удалены атрибуты
app:clearTaskиapp:launchDocumentи связанные с ними методы. Используйтеapp:popUpToс корнем графа, чтобы удалить все пункты назначения из обратного стека. b/119628354 ActivityNavigator.Extrasтеперь использует шаблонBuilderи позволяет устанавливать любые флагиIntent.FLAG_ACTIVITY_. aosp/828140NavController.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больше не принимаетContextaosp/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 г.
Новые функции
- Добавлена поддержка переходов с общими элементами для фрагментов и объектов Activity b/79665225. Подробнее о том, как реализовать навигацию с помощью компонента Navigation Architecture…
- При выборе элемента в
NavigationViewтеперь закрывается любой содержащий его нижний экран b/112158843.
Изменения в API
- Критическое изменение. Метод Navigator
navigate()теперь принимает параметрNavigator.Extras. - Метод
getGraph()NavController теперьNonNullb/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, добавлены дополнительные аннотации
NonNullb/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станетsetDemoControllerIndexb/79995048. - Например,
action_show_settingsстанетactionShowSettingsb/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.