навигация3

Navigation 3 — это новая библиотека навигации, разработанная для работы с Compose.
Последнее обновление Стабильный релиз Предварительная версия для выпуска Бета-версия Альфа-версия
29 июля 2026 г. 1.1.5 - - 1.2.0-alpha07

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

Чтобы добавить зависимость от navigation3, необходимо добавить репозиторий Google Maven в ваш проект. Для получения дополнительной информации ознакомьтесь с информацией в репозитории Google Maven .

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

Groovy

dependencies {
    implementation "androidx.navigation3:navigation3-runtime:1.2.0-alpha07"
    implementation "androidx.navigation3:navigation3-ui:1.2.0-alpha07"
}

Kotlin

dependencies {
    implementation("androidx.navigation3:navigation3-runtime:1.2.0-alpha07")
    implementation("androidx.navigation3:navigation3-ui:1.2.0-alpha07")
}

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

Обратная связь

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

Создать новую задачу

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

Для этого артефакта отсутствуют примечания к выпуску.

Версия 1.2.0-alpha07

29 июля 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.2.0-alpha07 . Версия 1.2.0-alpha07 содержит следующие коммиты .

Изменения в API

  • Добавлен абстрактный класс WrappedMatchResult для обертывания другого класса DeepLinkMatcher.MatchResult . Это позволяет настраивать результаты поиска, накладывая их поверх уже имеющихся. ( I7d4dc , b/470282247 )

  • Добавлен новый класс BackStackMatcher , который принимает два параметра: экземпляр сопоставителя и лямбда-функцию-конструктор, предоставляющую результат совпадения входного сопоставителя и возвращающую стек возврата. В случае успешного совпадения BackStackMatcher возвращает BackStackMatchResult , который расширяет WrappedMatchResult и содержит исходный результат совпадения вместе со стеком возврата, построенным с помощью лямбда-функции. Класс BackStackMatcher можно создать только с помощью новой функции расширения DeepLinkMatcher.withBackStack . ( Ibf987 , b/470282247 )

  • Добавлен абстрактный класс DeepLinkSerializer , расширяющий KSerializer для кодирования и декодирования value : T как String . DeepLinkSerializer можно использовать для сериализации не примитивных аргументов глубоких ссылок. Совместим с rememberSaveable и rememberNavBackStack . ( Id3c9f , b/470282247 )

  • DeepLinkMatcher добавлен второй параметр типа out R : DeepLinkMatcher.MatchResult<T> , позволяющий разработчикам получать доступ к свойствам подкласса MatchResult возвращаемого методом DeepLinkMatcher.match() без приведения типов. ( I693d3 , b/470282247 )

  • Верхняя граница T DeepLinkMatcher.MatchResult's изменилась с Any? на Any . ( I6bf1a )

  • Поле uri в конструкторе DeepLinkRequest теперь по умолчанию имеет значение null. Вторичный uriString в конструкторе переименован в uri . ( Ia0f14 , b/522194187 )

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

  • Теперь ResultEffect использует rememberUpdatedState для захвата последнего лямбда- onResult . ( I7d2a3 , b/531709234 )
  • Исправлена ​​ошибка сопоставления глубоких ссылок для пустых сегментов пути. Если тип аргумента — String, пустой путь будет рассматриваться как пустая строка. В противном случае пустой путь будет рассматриваться как отсутствие значения и будет использоваться значение по умолчанию. Если значение по умолчанию отсутствует, сопоставление завершится неудачей. ( I56575 , b/535298128 )
  • Добавлена ​​поддержка пустых значений запроса в DeepLinkRequest.uri . Если аргумент имеет тип String, пустое значение будет рассматриваться как буквальная пустая строка. В противном случае пустое значение рассматривается как отсутствие значения, и сопоставление будет пытаться использовать значение по умолчанию. Если значения по умолчанию нет, сопоставление завершится неудачей. ( I30343 , b/535127459 )
  • Теперь EntryProvider отдает приоритет сопоставлению на основе экземпляров ключей, а не типов ключей. ( Ib5ec9 , b/533331924 )
  • SceneState теперь корректно вычисляет предыдущие сцены, начиная с самой верхней сцены, не являющейся наложением. ( I91915 , b/513630541 )

Версия 1.2.0-alpha06

15 июля 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.2.0-alpha06 . Версия 1.2.0-alpha06 содержит следующие коммиты .

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

  • Исправлена ​​документация UriDeepLinkMatcher по фрагментам URI, чтобы уточнить, что фрагменты с подстановочными знаками будут соответствовать любому входному значению, но это значение не будет извлекаться в качестве аргументов. ( I5ad9b , b/524677091 )
  • Исправлена ​​ошибка, из-за которой UriDeepLinkMatcher не мог сопоставить запрос, если шаблон URI не содержал схему или не начинался с двойной косой черты. Например, www.example.com/home теперь будет соответствовать http://www.example.com/home . ( Ia6b65 , b/522791926 )

Версия 1.2.0-alpha05

1 июля 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.2.0-alpha05 . Версия 1.2.0-alpha05 содержит следующие коммиты .

Новый API

  • Добавлен API rememberResultEventBus , который возвращает объект ResultEventBus , который можно передать в rememberResultEventBusNavEntryDecorator . Это позволяет вынести ResultEventBus за пределы ResultEventBusNavEntryDecorator . ( Ia655b , b/516995400 )

DeepLinkRequest

  • Добавлены два конструктора, совместимых с KMP: один принимает DeepLinkUri, а другой — необработанный строковый URI. ( I3c088 , b/513200887 , b/522194187 )
  • (Только для Android) Добавлен конструктор, принимающий Intent . ( Ia0498 , b/513200887 , b/522194187 )
  • Все конструкторы имеют дополнительное поле extras для Map<String, Any> позволяющее прикрепить дополнительную информацию запроса. ( If81d5 , b/513200887 )
  • Добавлен новый DSL-класс requestExtras , обеспечивающий типобезопасный способ построения карты дополнительных данных. DSL предоставляет функцию put для сохранения пар RequestExtrasKey в Any . Функция расширения Map<String, Any>.get(key) может использоваться для чтения из карты с помощью RequestExtrasKey ( I5091c , b/513200887 ).
  • (Только для Android) Добавлены функции ActionExtrasKey и actionExtra для создания карты дополнительных материалов с помощью ActionExtrasKey . ( Id0c90 , [b/513200887]
  • Добавлены функции MimeTypeExtrasKey и mimeTypeExtra для создания карты дополнительных данных с использованием MimeTypeExtrasKey . ( I85131 , b/513200887 )

DeepLinkMatcher

  • Добавлены функции DeepLinkMatcher.mimeTypeFilter и DeepLinkMatcher.actionFilter для создания DeepLinkMatcher.Filters , которые фильтруют DeepLinkRequest по mimeType или action (только для Android). Оба фильтра сопоставляют строки по равенству и нечувствительны к регистру. ( Ie7e67 , b/513191950 )

Изменения в API

DeepLinkRequest

  • Удалите фабричную функцию fromAction . Для создания запроса, связанного с действием, используйте новое поле DeepLinkRequest.extras . ( Id0c90 , b/513200887 )
  • Удалена фабричная функция fromMimeType . Для создания запроса, связанного с MIME-типом, используйте новое поле DeepLinkRequest.extras . ( I85131 , b/513200887 )
  • (Только для Android) Удалено fromIntent функции фабрики Intent. Заменено новым конструктором, который принимает Intent и карту extras. ( Ia0498 , b/513200887 , b/522194187 )
  • Удалены фабричные функции fromUri и fromUriString . Вместо них добавлены новые конструкторы, принимающие либо DeepLinkUri , либо необработанный строковый URI. ( Id5b6f , b/522194187 )
  • DeepLinkMatcher , DeepLinkMatcher.MatchResult и их подклассы теперь принимают ковариантный тип T (out T), так что для иерархических ключей не потребуется приведение типов, как это делается с классами Matcher. ( I1e453 , b/525094876 )
  • Параметр `map` конструктора UriMatchResult для аргументов теперь по умолчанию имеет значение `pash`. ( I3acdd )
  • Абстрактный класс DeepLinkMatcher.Filter теперь является функциональным интерфейсом. Поле конструктора filter удалено и вместо этого должно передаваться непосредственно в подкласс. ( I9eb7d , b/522194187 )

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

  • Исправлена ​​ошибка, из-за которой извлеченная запись немедленно исчезала при извлечении записи, содержащей вложенные метаданные со значениями лямбда-функций. ( Idb872 , b/520494430 )
  • Исправлена ​​ошибка UriDeepLinkMatcher из-за которой он возвращает значение null UriMatchResult вместо генерации исключения MissingFieldException при отсутствии необходимых аргументов во время сопоставления. ( I5322f , b/524663005 )
  • Объект UriDeeplinkMatcher содержащий URI со схемой https, может быть сопоставлен только с запросами, которые также имеют схему https. ( Ibfe22 , b/522304329 )
  • Исправлена ​​ошибка UriDeepLinkMatcher из-за которой он корректно определял схему http как положительное совпадение с https при сопоставлении DeepLinkRequest с UriDeepLinkMatcher . ( I3a62b , b/518804264 )
  • Теперь компаратор DeepLinkMatcher.MatchResult по умолчанию возвращает 0, если два результата равны. ( I48ddb , b/518841353 )
  • Теперь UriDeepLinkMatcher будет возвращать значение null UriMatchResult вместо того, чтобы выбрасывать исключение, если запрос на сопоставление не удается из-за отсутствия необходимых аргументов. ( I669a7 , b/470282247 , b/512923412 )

Версия 1.2.0-alpha04

3 июня 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.2.0-alpha04 . Версия 1.2.0-alpha04 содержит следующие коммиты .

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

  • Исправлена ​​ошибка анимации наложений, из-за которой вложенные наложения, такие как ModalBottomSheet неожиданно переанимировались при удалении наложений, расположенных над ними. ( Ia2b9e , b/502624496 )

Версия 1.2.0-alpha03

19 мая 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.2.0-alpha03 . Версия 1.2.0-alpha03 содержит следующие коммиты .

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

В Navigation 3 теперь поддерживаются прямые ссылки с помощью DeepLinkRequest и DeepLinkMatcher :

  • DeepLinkRequest это запрошенная глубокая ссылка, содержащая DeepLinkUri и необязательный mimeType или action (только для Android). Вместе с новым классом существуют вспомогательные функции для создания экземпляра с uri , mimeType или action . Платформа Android также имеет вспомогательную функцию для формирования запроса из Intent. ( Iaaac9 , b/470282247 )

    val uriOnlyRequest = DeepLinkRequest.fromUriString("https://sampledeeplink.com/home")
val uriAndMimeRequest = DeepLinkRequest.fromUriString(
  "https://sampledeeplink.com/user/profile?id=123",
  "image/png"
)

  • DeepLinkMatcher представляет собой глубокую ссылку, которая может быть сопоставлена ​​с DeepLinkRequest . Каждый экземпляр сопоставления связан с ключом навигации, поддерживающим эту глубокую ссылку. Ключ навигации может быть связан с несколькими сопоставлениями. Вызов DeepLinkMatcher.match вернет MatchResult , содержащий связанный ключ навигации, если сопоставление прошло успешно. Существует две реализации DeepLinkMatcher по умолчанию: UriDeepLinkMatcher для сопоставления глубоких ссылок на основе URI и StaticKeyDeepLinkMatcher для сопоставления глубоких ссылок только с DeepLinkMatcher.Filter , которые соответствуют логическому значению ( Boolean ). ( I3798e , b/470282247 )

  • UriDeepLinkMatcher это реализация DeepLinkMatcher с заданными параметрами, которая обрабатывает глубокие ссылки, сопоставляя DeepLinkUri с сериализуемым ключом навигации. Она поддерживает аргументы глубоких ссылок в виде примитивных типов или коллекций примитивных типов, таких как списки, массивы и множества. ( I1520b , b/470282247 )

    @Serializable
data class UserKey(val id: Int): NavKey

// declare a deep link supported by UserKey
val userMatcher = UriDeepLinkMatcher(
  uriPattern = "www.sampledeeplink.com/user?userId={id}",
  serializer = serializer<UserKey>()
)

// handle a requested deep link with fallback key
val key = userMatcher.match(deepLinkRequest)?.key ?: HomeKey

  • Добавлен DeepLinkUri , который представляет собой мультиплатформенную версию android.net.Uri для Kotlin ( Id4725 , b/470282247 ).

Изменения в API

  • Обновлена ​​версия compileSdk 37 чтобы соответствовать compileSdk Compose.

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

  • Исправлена IllegalArgumentException в AnimatedBottomSheetSample при отображении нескольких наложений. Пример SceneStrategy теперь будет корректно вычислять последнюю сцену, не являющуюся OverlayScene , и отображать её под всеми сценами наложений. ( If2281 , b/506733412 )
  • Обновлена ​​зависимость NavigationEvent до версии 1.1.1, что удаляет неактивный NavigationEventHandler в режиме проверки, позволяя включить функцию предиктивного возврата в предварительных просмотрах Android Studio. ( I487fd )

Версия 1.2.0-alpha02

22 апреля 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.2.0-alpha02 . Версия 1.2.0-alpha02 содержит следующие коммиты .

Изменения в API

  • Переименуйте onBack в onBackCompleted и добавьте onBackCancelled в NavigationBackHandler для поддержки обработки отмененных жестов возврата назад. ( I92741 )
  • Добавлен NavigationBackHandler для упрощения обработки жестов возврата назад и предиктивного возврата при использовании SceneState . Это позволит разработчикам проще создавать пользовательские компоненты интерфейса, поддерживающие стандартную навигацию назад и предиктивные жесты, без ручного вычисления разницы стека возврата. ( I6a055 )
  • Добавьте rememberNavigationEventState для упрощения связи SceneState с предиктивной обработкой возврата. ( Iae49c )

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

  • Добавлен API ResultEventBus , позволяющий передавать результаты между NavEntries с помощью LocalResultEventBus , предоставляемого новым ResultEventBusNavEntryDecorator . Переданные результаты могут быть оценены как состояние с помощью ResultEventBus#conflateAsState или как поток результатов с помощью ResultEffect .

Версия 1.2.0-alpha01

8 апреля 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.2.0-alpha01 . Версия 1.2.0-alpha01 содержит следующие коммиты .

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

  • Доступ к LocalNavAnimatedContentScope из OverlayScene больше не будет вызывать IllegalStateException , поскольку OverlayScenes теперь получают LocalAnimatedContentScope который ничего не делает. ( I2f00c , b/486067688 )

Версия 1.1.5

29 июля 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.1.5 . Версия 1.1.5 содержит следующие коммиты .

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

  • В DSL entryProvider теперь отдается приоритет NavEntry созданному с использованием экземпляра ключа, например entry(key = userKey) { ... } , над NavEntry , созданным с использованием класса ключа, такого как entry<UserKey>{ ... } . ( Ib5ec9 , b/533331924 )

Версия 1.1.4

1 июля 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.1.4 . Версия 1.1.4 содержит следующие коммиты .

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

  • Исправлена ​​ошибка, из-за которой извлеченная запись немедленно исчезала при извлечении записи, содержащей вложенные метаданные со значениями лямбда-функций. ( Idb872 , b/520494430 )

Версия 1.1.3

17 июня 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.1.3 . Версия 1.1.3 содержит следующие коммиты .

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

  • Исправлена ​​ошибка анимации наложений, из-за которой вложенные наложения, такие как ModalBottomSheet неожиданно переанимировались при удалении наложений, расположенных над ними. ( Ia2b9e , b/502624496 )

  • Обновлена ​​зависимость NavigationEvent до версии 1.1.2, что позволило удалить неактивный NavigationEventHandler в режиме проверки кода и включить функцию «Предсказательное возвращение назад» в предварительных версиях Android Studio.

Версия 1.1.2

19 мая 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.1.2 . Версия 1.1.2 содержит следующие коммиты .

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

  • Обновлена ​​зависимость NavigationEvent до версии 1.1.1, что позволило удалить неактивный NavigationEventHandler в режиме проверки кода и включить функцию «Предсказательное возвращение назад» в предварительных версиях Android Studio.

Версия 1.1.1

22 апреля 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.1.1 . Версия 1.1.1 содержит следующие коммиты .

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

  • Доступ к LocalNavAnimatedContentScope из OverlayScene больше не будет вызывать IllegalStateException , поскольку OverlayScenes теперь получают LocalAnimatedContentScope который ничего не делает. ( I2f00c , b/486067688 )

Версия 1.1.0

8 апреля 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.1.0 . Версия 1.1.0 содержит следующие коммиты .

Версия 1.1.0 теперь стабильна!

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

Общие элементы между сценами — Navigation3 теперь поддерживает обработку сцен как объектов общих элементов. Это означает, что при смене сцен можно обеспечить плавный переход. Включить эту функцию можно, передав SharedTransitionScope либо в NavDisplay , либо в rememberSceneState .

SceneDecoratorStrategy — Введение функции SceneDecoratorStrategy для поддержки таких сценариев использования, как оформление сцен общими компонентами пользовательского интерфейса или совместное использование состояния между сценами.

NavMetadata DSL - Navigation3 теперь предоставляет новый типобезопасный DSL для метаданных. DSL использует новый интерфейс MetadataKey , который позволяет определять типы ключей и значений, которые необходимо передавать в карту метаданных. Также добавлены новые NavMetadataKeys для переходов NavDisplay , чтобы их можно было использовать с новым DSL для метаданных для добавления переходов в NavDisplay .

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

Другие изменения : - NavDisplay и rememberSceneState теперь принимают List<SceneStrategy> вместо прежнего единственного параметра SceneStrategy , который был связан с помощью then инфикса. - Теперь вы можете динамически добавлять метаданные с учетом ключа записи через DSL EntryProvider .

Версия 1.1.0-rc01

25 марта 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.1.0-rc01 . Версия 1.1.0-rc01 содержит следующие коммиты .

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

  • Теперь NavDisplay гарантирует, что Lifecycle элементов, отображаемых под наложениями, ограничен значением STARTED . Это обеспечивает дальнейшую работу API, таких как dropUnlessResumed при использовании диалоговых окон. ( If209f , b/483966071 )
  • Исправлена ​​ошибка в NavDisplay , из-за которой переключение между одними и теми же экранами и прерывание анимации между ними могли приводить к неправильному порядку отображения экранов по оси Z. ( I4d491 , b/459419800 )

Версия 1.1.0-beta01

11 марта 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.1.0-beta01 . Версия 1.1.0-beta01 содержит следующие коммиты .

Версия 1.1.0-alpha05

25 февраля 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.1.0-alpha05 . Версия 1.1.0-alpha05 содержит следующие коммиты .

Изменения в API

  • Теперь NavDisplay и rememberSceneState принимают List<SceneStrategy> вместо прежнего единственного параметра SceneStrategy , который был связан с помощью then инфикса. Это более точно соответствует List<SceneDecoratorStrategy<T>> , который уже принимают обе эти функции API. Предыдущие функции API устарели. ( I78b2c , b/482108465 )
  • Добавлен оператор #contains для проверки наличия в карте метаданных заданного NavMetadataKey . ( Ic30db , b/485311895 )
  • Добавлен ключ NavMetadataKey DialogKey для DialogSceneStrategy для использования с DSL метаданных. ( Ic7a26 , b/483388817 )

Версия 1.1.0-alpha04

11 февраля 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.1.0-alpha04 . Версия 1.1.0-alpha04 содержит следующие коммиты .

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

  • В Navigation3 теперь доступен новый типобезопасный DSL для метаданных. DSL использует новый интерфейс MetadataKey , позволяющий определять типы ключей и значений, которые необходимо передавать в карту метаданных. Также добавлены новые NavMetadataKey для переходов NavDisplay , которые можно использовать с новым DSL metadata , чтобы добавлять переходы в NavDisplay . ( Ic10ef , Ic049c , b/476213928 )

Изменения в API

  • Интерфейс OverlayScene получил новый приостанавливающий коллбэк onRemoved . Этот коллбэк вызывается после удаления ключа, связанного со сценой, из стека возврата, но до того, как сцена покинет композицию. Это позволяет анимациям выхода, вызываемым внутри onRemoved , завершиться до того, как сцена наложения будет удалена из композиции. ( I29a72 , b/440558061 )
  • SceneStrategy функция декорирования выделена в новый класс SceneDecoratorStrategy . Этот новый интерфейс следует использовать для декорирования сцен. Появились новые API для NavDisplay и rememberSceneState , позволяющие добавлять SceneDecoratorStrategies . ( If9385 , b/477669607 , b/477670333 )

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

  • Исправлена ​​ошибка, из-за которой передача SharedTransitionLayout в NavDisplay или rememberSceneState и использование OverlayScene приводили к сбою, поскольку использование SharedTransitionLayout работает только с NavEntries , которые отображаются как часть AnimatedContent , а OverlayScene отображаются в отдельных окнах. ( I1bb76 , b/478664101 )

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

  • Начиная с Navigation3 1.0.1: Navigation3 теперь зависит от NavigationEvent 1.0.2. Это исправляет ошибку IllegalStateException возникающую при использовании NavDisplay во время предварительного просмотра AndroidStudio . ( Id7212 , b/477149762 )

Версия 1.1.0-alpha03

28 января 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.1.0-alpha03 . Версия 1.1.0-alpha03 содержит следующие коммиты .

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

  • Теперь вы можете динамически добавлять метаданные с учетом ключа записи через DSL EntryProvider . ( I942fb , b/474416976 )

Версия 1.1.0-alpha02

14 января 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.1.0-alpha02 . Версия 1.1.0-alpha02 содержит следующие коммиты .

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

  • SceneStrategy теперь поддерживается вложенность сцен с помощью новой функции calculatedScene(Scene) . Это означает, что SceneStrategy можно настраивать для предоставления дополнительной функциональности другим сценам. ( I5df7c , b/440333896 )

Версия 1.1.0-alpha01

3 декабря 2025 г.

Выпущена версия androidx.navigation3:navigation3-*:1.1.0-alpha01 . Версия 1.1.0-alpha01 содержит следующие коммиты .

Изменения в API

  • Navigation3 теперь поддерживается обработка сцен как объектов с общими свойствами. Это означает, что при смене сцен можно обеспечить плавный переход. Включить эту функцию можно, передав SharedTransitionScope либо в NavDisplay , либо в rememberSceneState . ( I15868 )

Версия 1.0

Версия 1.0.1

11 февраля 2026 г.

Выпущена версия androidx.navigation3:navigation3-*:1.0.1 . Версия 1.0.1 содержит следующие коммиты .

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

  • Теперь Navigation3 зависит от NavigationEvent 1.0.2. Это исправляет ошибку IllegalStateException возникающую при использовании NavDisplay во время предварительного просмотра AndroidStudio . ( Id7212 , b/477149762 )

Версия 1.0.0

19 ноября 2025 г.

Выпущена версия androidx.navigation3:navigation3-*:1.0.0 . Версия 1.0.0 содержит следующие коммиты .

Представляем Navigation3!

  • Библиотека Navigation3 теперь стабильна! Navigation3 — это подход к навигации, основанный на AndroidX Compose.
  • Для получения более подробной информации ознакомьтесь с нашим сообщением в блоге , посетите раздел ресурсов и попробуйте рецепты .

Версия 1.0.0-rc01

5 ноября 2025 г.

Выпущена версия androidx.navigation3:navigation3-*:1.0.0-rc01 . Версия 1.0.0-rc01 содержит следующие коммиты .

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

  • Теперь NavDisplay устанавливает LocalLifecycleOwner на уровне Scene , что позволяет авторам сцен определять, завершились ли все переходы, проверяя, что Lifecycle.State имеет RESUMED . Поведение LocalLifecycleOwner на уровне NavEntry остается неизменным: он по-прежнему ограничен значением STARTED , если переход находится в процессе, и дополнительно ограничен значением CREATED если этот NavEntry был удален из стека возврата и находится в процессе анимации. ( I03113 , b/454045829 )

Версия 1.0.0-beta01

22 октября 2025 г.

Выпущена версия androidx.navigation3:navigation3-*:1.0.0-beta01 . Версия 1.0.0-beta01 содержит следующие коммиты .

Изменения в API

  • Теперь у SceneStrategyScope есть только публичный конструктор без аргументов, подходящий для тестирования вашей SceneStrategy и возвращаемой Scene по отдельности. Для более сложных случаев использования, пожалуйста, используйте rememberSceneState() . ( I8440c , b/451679047 )

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

  • Исправлена ​​ошибка бесконечного цикла при последовательном использовании SceneStrategy с then . ( Iba3f0 , b/450323470 )
  • Исправлено мерцание экрана при перестановке backStack , передаваемого в NavDisplay , и использовании анимаций. ( Ief7b5 , b/450967248 )

Версия 1.0.0-alpha11

8 октября 2025 г.

Выпущена версия androidx.navigation3:navigation3-*:1.0.0-alpha11 . Версия 1.0.0-alpha11 содержит следующие коммиты .

Изменения в API

  • Метод calculateScene в SceneStrategy больше не имеет @Composable . Вместо этого, рассмотрите возможность переноса этой работы в конструктор вашего метода SceneStrategy (т.е. в метод rememberMySceneStrategy() ), который позволяет полностью определить время жизни любых значений rememberSaveable или операторов key remember на основе правильных значений. ( If1733 , b/448709506 )
  • Параметр onBack для SceneStrategy.calculateScene перемещен в новую область видимости получателя SceneStrategyScope , чтобы сделать более понятным, что это необязательный параметр, и предоставить точку расширения для будущих функций Navigation3. ( I3aea3 , b/448460407 )
  • Функция onBack передаваемая в NavDisplay и SceneStrategy больше не предоставляет параметр count: Int указывающий, когда следует удалять несколько элементов. Вместо этого функция () -> Unit теперь будет вызываться несколько раз подряд в редких случаях, когда ваша сцена запрашивает удаление нескольких элементов. ( Idedb5 , b/446989346 )
  • Удалите класс NavEntryWrapper и замените его функциональность финальным классом NavEntry с новым вторичным конструктором, который принимает объект NavEntry с новым содержимым. Это позволит продолжить поддержку обертывания записи новым содержимым. ( I7da2a , b/444447130 )
  • Функция navEntryDecorator , которая создает и возвращает объект NavEntryDecorator , была удалена и заменена классом NavEntryDecorator , который теперь является публичным и открытым для наследования. ( If81f8 , b/444447434 , b/447381176 )
  • SavedStateNavEntryDecorator был переименован в SaveableStateHolderNavEntryDecorator поскольку он декорирует элементы с помощью SaveableStateHolder . Кроме того, декоратор был преобразован из функции в класс, поскольку по своей сути он является фабрикой для NavEntryDecorator . ( Ie6013 , b/447381176 )
  • Для пользовательских дисплеев, использующих SceneState в качестве альтернативы NavDisplay больше не требуется использовать локальную переменную композиции LocalEntriesToRenderInCurrentScene , которая теперь является внутренней. ( Ic40ef , b/414668196 )
  • Удалены SceneSetupNavEntryDecorator и rememberSceneSetupNavEntryDecorator() из публичного API. Теперь эта функциональность включена по умолчанию без необходимости ее ручного добавления. ( Ieae42 , b/444479133 )
  • Теперь NavEntry , DialogScene , SinglePaneScene и SceneState реализуют интерфейс equals. ( I96121 )
  • В интерфейсе сцены появилось новое поле метаданных для добавления метаданных, специфичных для сцены, к NavDisplay. Это позволяет сцене переопределять метаданные в NavDisplay , например, для переходов. ( I1fd96 , b/443955625 )
  • Упростите сигнатуру rememberNavBackStack , удалив избыточный параметр типа generic. Теперь функция принимает vararg elements: NavKey . ( I03e45 )
  • Анимации по умолчанию для NavDisplay теперь являются частью общего API, что позволяет вызывать их со всех платформ. ( I71af9 , b/447147159 )
  • Переименуйте EntryProviderBuilder в EntryProviderScope , чтобы точно отразить, что класс представляет собой Kotlin DSL, предоставляющий область видимости для создания NavEntries . ( Ia7465 )

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

  • Функция rememberNavBackStack() теперь обеспечивает полиморфную сериализацию для NavKey и требует наличия пользовательской SavedStateConfiguration , настроенной для корректного восстановления состояния. Документация KDoc была обновлена, чтобы отразить требование о том, что все подтипы NavKey должны быть зарегистрированы в предоставленном модуле SerializersModule. ( I6de37 , I782f2 , b/446664383 )

Версия 1.0.0-alpha10

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

Выпущена версия androidx.navigation3:navigation3-*:1.0.0-alpha10 . Версия 1.0.0-alpha10 содержит следующие коммиты .

Изменения в API

  • Добавлена ​​новая перегрузка NavDisplay , которая принимает список NavEntry<T> , помеченных атрибутом rememberDecoratedNavEntries . ( I4025b , b/441940314 )
  • Перенесено DialogScene в новый пакет. ( Ia5840 )
  • Удалите публичный API DecorateNavEntry . Вместо этого используйте rememberDecoratedNavEntries , чтобы обернуть NavEntry списком декораторов. ( Id8c09 )
  • В Navigation3 UI теперь доступны новые свойства transitionSpec по умолчанию. ( Ibcabd )
  • Добавлен новый объект SceneState для управления сценами. Он также предоставляет новую перегрузку NavDisplay , которая принимает SceneState и NavigationEventState . ( Idfb46 , b/444479133 )
  • Теперь NavDisplay позволяет настраивать переходы в зависимости от того, в какую Scene вы переходите и из какой, анализируя currentState и targetState Transition . ( I906cc , b/443872322 )
  • NavigationEventInfo теперь является abstract class а не interface . Обновите все пользовательские реализации, чтобы они наследовали от этого класса (например, data class MyInfo : NavigationEventInfo() ). ( I1e59c , b/444734264 )
  • API обработчиков navigationevent-compose обновлены. NavigationEventHandler и NavigationBackHandler (и их варианты) теперь поддерживают новую перегрузку, которая принимает поднятое состояние NavigationEventState . Простые перегрузки (принимающие currentInfo ) сохранены и теперь используют эту новую модель состояния внутри. ( Ic3251 , b/444734264 )
  • Все API-интерфейсы сцен были перенесены из navigation3-ui в navigation3-runtime. Это означает, что теперь они доступны на всех платформах, поддерживаемых navigation3-runtime. ( I431d0 , b/444449993 )
  • Добавлена ​​новая перегрузка rememberDecoratedNavEntries , которая принимает список NavEntry для декорирования. Элементы ввода уже могут быть декорированы другими декораторами элементов. ( I5a034 , b/444230270 )
  • Удалить параметры типа подстановки navigation3 ( I02540 )
  • Улучшена обработка обобщенных типов для DSL entryProvider . Если ранее вы импортировали androidx.navigation3.runtime.entry , теперь это не требуется. ( I299fc )
  • Ограничьте использование перегрузки NavBackStackSerializer основанной на рефлексии, только платформами Android. Это предотвратит неявные ошибки сериализации во время выполнения на платформах, отличных от Android, путем принудительного использования явной перегрузки SavedStateConfiguration в многоплатформенном коде. ( I73313 , b/420443609 )
  • Сделайте свойство ` swipeEdge объекта ` NavigationEvent @IntDef ( `Icee54` , b/443950342` )
  • Ограничьте сериализацию NavBackStack только Android. Это предотвратит сбои во время выполнения на платформах, отличных от Android. Для сохранения состояния на нескольких платформах используйте перегрузку rememberNavBackStack с явным указанием SavedStateConfiguration . ( I1e418 , b/420443609 )

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

  • Исправлена ​​ошибка, приводящая к сбою во время предиктивной возврата, когда вложенный NavDisplay имеет только одну дочернюю запись. ( I2cdc0 , b/441933162 )

Версия 1.0.0-alpha09

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

Выпущена версия androidx.navigation3:navigation3-*:1.0.0-alpha09 . Версия 1.0.0-alpha09 содержит следующие коммиты .

Изменения в API

  • Объект DecoratedNavEntryProvider был заменен на rememberDecoratedNavEntries , который создает и возвращает NavEntries, декорированные списком предоставленных декораторов ( I0fe1c , b/441328236 ).
  • Теперь NavBackStack является универсальным типом по отношению к NavKey . Это позволяет приложениям и библиотекам определять собственные типы клавиш для своих стеков возврата, а не ограничиваться только NavKey . ( I4d190 , Iad2f4 , b/420443609 )
  • NavBackStack теперь имеет атрибут @kotlinx.serialization.Serializable , что позволяет сохранять и восстанавливать состояние навигации после завершения процесса и изменения конфигурации без лишнего шаблонного кода. ( I2c3cf , b/420443609 )
  • RememberNavBackStack была перенесена в commonMain , чтобы гарантировать её доступность на всех целевых платформах. ( Id69e7 , b/420443609 )

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

  • Теперь NavDisplay корректно перемещает каждый отдельный элемент NavEntry в нужное Lifecycle.State . ( I30aac , b/440145700 )
  • Исправлена ​​ошибка, из-за которой NavDisplay игнорировал любой вложенный NavigationEventDispatcherOwner , установленный через LocalNavigationEventDispatcherOwner из библиотеки NavigationEvent . ( I6224a )

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

Версия 1.0.0-alpha08

27 августа 2025 г.

Выпущена версия androidx.navigation3:navigation3-*:1.0.0-alpha08 . Версия 1.0.0-alpha08 содержит следующие коммиты .

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

  • Добавлены новые цели Kotlin MultiPlatform (KMP) для артефактов Navigation3 Runtime . Теперь Navigation3 Runtime поддерживает следующие платформы: JVM (Android и Desktop), нативные приложения (Linux, iOS, watchOS, macOS, MinGW) и веб-приложения (JavaScript, WasmJS). ( I55078 , b/424410398 , b/419294028 , b/419046226 ). Примечание: это не предоставляет цели KMP для артефакта Navigation3 UI . На других платформах вам потребуется реализовать собственный NavDisplay . Если вы хотите, чтобы это поддерживалось, пожалуйста, проголосуйте в этом вопросе на Jetbrains и следите за прогрессом в добавлении поддержки там.
  • Объект NavDisplayInfo теперь является публичным и может использоваться для получения списка видимых элементов из NavDisplay . ( Ibc91f )

Изменения в API

  • Добавлен новый NavBackStackSerializer , который можно использовать совместно с rememberNavBackStack для восстановления состояния. rememberNavBackStack() теперь также принимает SavedStateConfiguration , который можно использовать для предоставления собственной конфигурации. ( I2f4d2 , I4cd58 , b/420443609 )

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

  • Исправлена ​​ошибка, из-за которой при навигации некорректно срабатывали события жизненного цикла. ( I8bf6d , b/425901162 , b/434109022 )

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

  • В версии I8bf6d была обнаружена ошибка, из-за которой жизненные циклы основывались на сценах, а не на отдельных элементах, что нарушало работу жизненного цикла в тех случаях, когда key предоставленный NavEntry не является String или ваш NavEntry не переопределил contentKey и не присвоил ему значение key (обратите внимание, что это гарантирует возможность сохранения ключа в Bundle ). Эта ошибка исправлена ​​в следующем релизе. ( b/440145700 )

Версия 1.0.0-alpha07

13 августа 2025 г.

Выпущена версия androidx.navigation3:navigation3-*:1.0.0-alpha07 . Версия 1.0.0-alpha07 содержит следующие коммиты .

Обновление MinSdk

Изменения в API

  • Теперь SavedStateNavEntryDecorator использует SaveableStateRegistry , встроенный в SaveableStateProvider , для сохранения и восстановления состояний. ( If8d9a )
  • В параметр predictivePopTransitionSpec теперь передается край свайпа, что позволяет настраивать переход в зависимости от того, с какого края пользователь начал жест «Предиктивный возврат». ( I753a8 )

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

  • Исправлена ​​ошибка, из-за которой пользовательские сцены бесконечно пересчитывались, поскольку последняя сцена не запоминалась. ( I7ba84 , b/418153031 )

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

Версия 1.0.0-alpha06

30 июля 2025 г.

Выпущена версия androidx.navigation3:navigation3-*:1.0.0-alpha06 . Версия 1.0.0-alpha06 содержит следующие коммиты .

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

Версия 1.0.0-alpha05

2 июля 2025 г.

Выпущена версия androidx.navigation3:navigation3-*:1.0.0-alpha05 . Версия 1.0.0-alpha05 содержит следующие коммиты .

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

  • Состояние NavEntry теперь строго зависит от текущего списка декораторов, переданных в NavDisplay . Это означает, что в случае наличия нескольких стеков возврата следует менять местами декораторы вдоль стеков возврата, чтобы сохранить состояние NavEntry в стеке возврата. В противном случае состояния будут очищены, как если бы элементы были удалены (вместо обмена). ( I7a759 , b/428033667 )

Версия 1.0.0-alpha04

18 июня 2025 г.

Выпущена версия androidx.navigation3:navigation3-*:1.0.0-alpha04 . Версия 1.0.0-alpha04 содержит следующие коммиты .

Изменения в API

  • NavEntry.content теперь является приватным. Для вызова содержимого NavEntry используйте новый API NavEntry.Content() , для вызова которого больше не требуется параметр key . ( Icd0fd , b/420991203 )
  • NavEntry.key теперь является приватным полем. Объект NavEntry и его соответствующие состояния должны идентифицироваться новым полем contentKey , которое генерируется из новой лямбда- contentKeyFactory и по умолчанию представляет собой сохраняемый хеш, сгенерированный из NavEntry.key ( I81a6c , b/422001357 , b/420991203 I2d7d4 , b/420991203 , b/422841812 ).

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

  • Теперь Navigation3 зависит от нового артефакта androidx.navigationevent.compose .

Версия 1.0.0-alpha03

4 июня 2025 г.

Выпущена версия androidx.navigation3:navigation3-*:1.0.0-alpha03 . Версия 1.0.0-alpha03 содержит следующие коммиты .

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

  • Navigation3 больше не будет очищать состояния декораторов для backStacks , которые были заменены другим экземпляром backStack . ( I28a42 , b/415076044 )

Версия 1.0.0-alpha02

23 мая 2025 г.

Выпущена версия androidx.navigation3:navigation3-*:1.0.0-alpha02 . Версия 1.0.0-alpha02 содержит следующие коммиты .

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

  • Исправлена ​​ошибка в SavedStateNavEntryDecorator , которая вызывала конфликты для разных классов данных с одинаковыми значениями свойств. ( b/418070648 , Iff4775 )
  • Исправлена ​​ошибка с отсутствующим классом, которая приводила к сбоям при запуске без явного указания зависимостей. ( b/419049149 , I4b4ed )

Версия 1.0.0-alpha01

20 мая 2025 г.

androidx.navigation3:navigation3-*:1.0.0-alpha01 is released. Version 1.0.0-alpha01 contains these commits .

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

Navigation3 is a new navigation library built specifically to handle Jetpack Compose in-app navigation. The androidx.navigation3.runtime artifact provides the building blocks, while the androidx.navigation3.ui artifact provides the UI layer via the NavDisplay API. Developers can provide their own state directly to the NavDisplay composable function, which changes the content based on changes in the developer state.

@Serialiable object Home : NavKey
@Serialiable object Chat : NavKey

val backStack = rememberNavBackStack(Home)

NavDisplay(backStack, entryProvider = entryProvider {
  entry<Home> {
    Column {
      Text(“Home”)
      Button(onClick = { backStack.add(Chat) } ) {
        Text(“Go to Chat”)
      } 
    }
  }
  entry<Chat> { /* My Composable Content */ }
})

For more information, see the Navigation3 guide .