Начать

Для начала работы с Navigation 3 добавьте библиотеку в свой проект вместе со всеми вспомогательными библиотеками. Используйте следующую таблицу, чтобы решить, какие библиотеки следует добавить:

Артефакты

Имя	Что это делает	Артефакт
Библиотека времени выполнения Navigation 3	Основной API навигации 3. Включает NavEntry , EntryProvider и соответствующий DSL.	androidx.navigation3:navigation3-runtime
Библиотека пользовательского интерфейса Navigation 3	Предоставляет классы для отображения контента, включая NavDisplay и Scene .	androidx.navigation3:navigation3-ui
Жизненный цикл ViewModel для навигации 3	Позволяет ограничить область видимости ViewModel элементами, находящимися в стеке возврата.	androidx.lifecycle:lifecycle-viewmodel-navigation3
Адаптивные макеты Material 3 для Navigation 3	Предоставляет адаптивные макеты (стратегии сцен, сцены и определения метаданных) для использования с NavDisplay.	androidx.compose.material3.adaptive:adaptive-navigation3
Сериализация KotlinX	Позволяет сериализовать навигационные клавиши.	Плагин: org.jetbrains.kotlin.plugin.serialization Библиотека: org.jetbrains.kotlinx:kotlinx-serialization-core

Настройка проекта

Чтобы добавить библиотеку Navigation 3 в существующий проект, добавьте следующее в файл libs.versions.toml :

[versions]
nav3Core = "1.0.0"
lifecycleViewmodelNav3 = "2.10.0"
kotlinSerialization = "2.2.21"
kotlinxSerializationCore = "1.9.0"
material3AdaptiveNav3 = "1.3.0-alpha05"

[libraries]
# Core Navigation 3 libraries
androidx-navigation3-runtime = { module = "androidx.navigation3:navigation3-runtime", version.ref = "nav3Core" }
androidx-navigation3-ui = { module = "androidx.navigation3:navigation3-ui", version.ref = "nav3Core" }

# Optional add-on libraries
androidx-lifecycle-viewmodel-navigation3 = { module = "androidx.lifecycle:lifecycle-viewmodel-navigation3", version.ref = "lifecycleViewmodelNav3" }
kotlinx-serialization-core = { module = "org.jetbrains.kotlinx:kotlinx-serialization-core", version.ref = "kotlinxSerializationCore" }
androidx-material3-adaptive-navigation3 = { group = "androidx.compose.material3.adaptive", name = "adaptive-navigation3", version.ref = "material3AdaptiveNav3" }

[plugins]
# Optional plugins
jetbrains-kotlin-serialization = { id = "org.jetbrains.kotlin.plugin.serialization", version.ref = "kotlinSerialization"}

Кроме того, обновите SDK компиляции до версии 36 или более поздней:

[versions]
compileSdk = "36"

Добавьте следующее в файл сборки вашего приложения: app/build.gradle.kts :

plugins {
    ...
    // Optional, provides the @Serialize annotation for autogeneration of Serializers.
    alias(libs.plugins.jetbrains.kotlin.serialization)
}

dependencies {
    ...
    implementation(libs.androidx.navigation3.ui)
    implementation(libs.androidx.navigation3.runtime)
    implementation(libs.androidx.lifecycle.viewmodel.navigation3)
    implementation(libs.androidx.material3.adaptive.navigation3)
    implementation(libs.kotlinx.serialization.core)
}