برای شروع با Navigation 3، کتابخانه را به همراه هر کتابخانه پشتیبانی کننده به پروژه خود اضافه کنید. از جدول زیر استفاده کنید تا تصمیم بگیرید کدام کتابخانه ها را اضافه کنید.
مصنوعات
نام | کاری که انجام می دهد | مصنوع |
---|---|---|
کتابخانه زمان اجرا ناوبری 3 | Core Navigation 3 API. شامل | androidx.navigation3:navigation3-runtime |
کتابخانه UI Navigation 3 | کلاس هایی را برای نمایش محتوا، از جمله | androidx.navigation3:navigation3-ui |
ViewModel Lifecycle for Navigation 3 | به ViewModels اجازه می دهد تا به ورودی های پشته باز شود. | androidx.lifecycle:lifecycle-viewmodel-navigation3 |
طرحبندی تطبیقی متریال 3 برای Navigation 3 | طرحبندیهای تطبیقی (استراتژیهای صحنه، صحنهها و تعاریف ابرداده) را برای استفاده با NavDisplay ارائه میدهد. | androidx.compose.material3.adaptive:adaptive-navigation3 در ساخت های اسنپ شات موجود است |
اجازه می دهد تا کلیدهای ناوبری سریال شوند. | پلاگین: org.jetbrains.kotlin.plugin.serialization کتابخانه: org.jetbrains.kotlinx:kotlinx-serialization-core |
راه اندازی پروژه
برای افزودن کتابخانه Navigation 3 به پروژه موجود خود، موارد زیر را به libs.versions.toml
خود اضافه کنید:
[versions]
nav3Core = "1.0.0-alpha01"
lifecycleViewmodelNav3 = "1.0.0-alpha01"
kotlinSerialization = "2.1.21"
kotlinxSerializationCore = "1.8.1"
material3AdaptiveNav3 = "1.0.0-SNAPSHOT"
[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" }
# Note: The Material3 adaptive layouts library for Navigation 3 is currently
# only available in snapshot builds. Follow the instructions at androidx.dev to
# add the snapshot builds repository to your project.
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)
}