ناوبری

ناوبری، چارچوبی برای پیمایش بین «مقصدها» در یک برنامه اندروید است که یک API سازگار را فراهم می‌کند، چه مقصدها به صورت Fragment، Activity یا سایر کامپوننت‌ها پیاده‌سازی شده باشند.
آخرین به‌روزرسانی انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
۵ نوامبر ۲۰۲۵ ۲.۹.۶ - - -

اعلام وابستگی‌ها

برای افزودن وابستگی به Navigation، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Google's Maven را مطالعه کنید.

وابستگی‌های مربوط به مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

Groovy

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.9.6"

  // 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"
}

Kotlin

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

dependencies {
  val nav_version = "2.9.6"

  // 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")
}

آرگ‌های ایمن

To add Safe Args to your project, include the following classpath in your top level build.gradle file:

Groovy

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

Kotlin

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

You must also apply one of two available plugins.

To generate Java language code suitable for Java or mixed Java and Kotlin modules, add this line to your app or module's build.gradle file:

Groovy

plugins {
  id 'androidx.navigation.safeargs'
}

Kotlin

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

Alternatively, to generate Kotlin code suitable for Kotlin-only modules add:

Groovy

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

Kotlin

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

You must have android.useAndroidX=true in your gradle.properties file as per Migrating to AndroidX.

برای اطلاعات بیشتر در مورد استفاده از افزونه‌های کاتلین، به مستندات ktx مراجعه کنید.

برای اطلاعات بیشتر در مورد وابستگی‌ها، به بخش «افزودن وابستگی‌های ساخت» مراجعه کنید.

بازخورد

بازخورد شما به بهبود Jetpack کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه ۲.۹

نسخه ۲.۹.۶

۵ نوامبر ۲۰۲۵

androidx.navigation:navigation-*:2.9.6 منتشر شد. نسخه 2.9.6 شامل این کامیت‌ها است.

رفع اشکالات

  • افزونه‌ی Navigation SafeArgs به APIهای مدرن افزونه‌ی اندروید Gradle منتقل شده است که باید سازگاری آن را با تمام نسخه‌های AGP 8.4.2+ تضمین کند. در نتیجه‌ی این تغییرات، دایرکتوری خروجی برای فایل‌های تولید شده توسط افزونه به محل پیش‌فرض ارائه شده توسط AGP تغییر یافته است. ( Ie09d6 ، I7c431 ، b/203559535 ، b/293920476 ، b/269532448 ، b/443261197 )
  • افزونه‌ی Navigation SafeArgs دیگر نیازی به تنظیم ویژگی useAndroidX هنگام استفاده با AGP 9.0.0-alpha04+ نخواهد داشت. ( I6c3a4 ، b/444746731 ، b/443106400 )

نسخه ۲.۹.۵

۲۴ سپتامبر ۲۰۲۵

androidx.navigation:navigation-*:2.9.5 منتشر شد. نسخه 2.9.5 شامل این کامیت‌ها است.

رفع اشکالات

  • آرگومان‌های امن ناوبری اکنون می‌توانند پشتیبانی AGP 9.0 را برای کاتلین داخلی مدیریت کنند. ( I1d9d76 )

به‌روزرسانی وابستگی

  • افزونه‌ی Navigation Safe Args اکنون به افزونه‌ی اندروید Gradle نسخه ۸.۴.۲ ( b/431847270 , I5932a ) وابسته است.

نسخه ۲.۹.۴

۱۰ سپتامبر ۲۰۲۵

androidx.navigation:navigation-*:2.9.4 منتشر شد. نسخه 2.9.4 شامل این کامیت‌ها است.

رفع اشکالات

  • جلوگیری از خرابی هنگامی که یک رویداد back پیش‌بینی‌کننده در اواسط فریم پس از غیرفعال شدن handler در انتقال NavHost ارائه می‌شود. ( I5667c ، b/384186542 )

نسخه ۲.۹.۳

۳۰ ژوئیه ۲۰۲۵

androidx.navigation:navigation-*:2.9.3 منتشر شد. نسخه 2.9.3 شامل این کامیت‌ها است.

رفع اشکالات

  • خطایی در NavController که هنگام استفاده از OnDestinationChangedListeners باعث ایجاد ConcurrentModificationException می‌شد، برطرف شد. ( If7406 ، b/417784831 )
  • خطایی که هنگام استفاده از navigate(uri, navOptions,navigationExtras) ‎ رخ می‌داد و در آن موارد اضافی نادیده گرفته می‌شدند، برطرف شد. ( I67fb7 , b/430336813 )

نسخه ۲.۹.۲

۱۶ ژوئیه ۲۰۲۵

androidx.navigation:navigation-*:2.9.2 منتشر شد. نسخه 2.9.2 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکلی که باعث می‌شد ورودی پس از بسته شدن پنجره‌ی بالای ورودی، از سر گرفته نشود، برطرف شد ( Idb20e ، b/418746335 )
  • خطای MissingFieldException هنگام تست SavedStateHandle با مسیرهای type safe هنگام استفاده از NavTypes سفارشی برطرف شد. ( I2f843 ، b/421002511 )

نسخه ۲.۹.۱

۲ ژوئیه ۲۰۲۵

androidx.navigation:navigation-*:2.9.1 منتشر شد. نسخه 2.9.1 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکلی که باعث می‌شد NavEntries هایی که با استفاده از single top نمونه‌سازی می‌شدند، هرگز در Lifecycle.State خود از CREATED فراتر نروند، برطرف شد. ( I043ba , b/421095236 )

نسخه ۲.۹.۰

۷ مه ۲۰۲۵

androidx.navigation:navigation-*:2.9.0 منتشر شد. نسخه 2.9.0 شامل این کامیت‌ها است.

تغییرات مهم از زمان ۲.۸.۰

  • اکشن‌های آرگومان‌های امن ناوبری (Navigation Safe Args) اکنون با حاشیه‌نویسی @CheckResult تولید می‌شوند تا از استفاده آنها اطمینان حاصل شود.

رابط کاربری پنل پشتیبانی

  • ناوبرهای سفارشی اکنون می‌توانند مقاصد خود را به عنوان پیاده‌سازی رابط SupportingPane علامت‌گذاری کنند که به NavController نشان می‌دهد که این مقاصد در کنار سایر مقاصد نمایش داده خواهند شد. به عنوان مثال، با استفاده از این رابط، می‌توان چندین مقصد را همزمان RESUMED .

چندسکویی کاتلین را بنویسید

  • ناوبری اکنون یک تابع رایج جدید NavController.handleDeepLink() ارائه می‌دهد که به جای Intent یک NavDeepLinkRequest می‌گیرد. این به پلتفرم‌هایی غیر از اندروید اجازه می‌دهد تا به درستی لینک‌های عمیق را مدیریت کنند. با تشکر از کنستانتین تسخوربوف!
  • ناوبری اکنون NavUri ارائه می‌دهد، یک تابع تجزیه‌گر رایج جدید که یک API سازگار با URI اندروید در سایر پلتفرم‌ها است. این امر ایجاد URI را به روشی مستقل از پلتفرم ممکن می‌سازد. با تشکر از کنستانتین تسخوربوف!

توابع ایمن نوع

  • APIهای نوع امن که قبلاً فقط از طریق متدهای reified ، یعنی composable<YourScreen> قابل دسترسی بودند، اکنون نسخه‌های اصلاح‌نشده‌ای دارند که مستقیماً یک نمونه KClass را می‌پذیرند.
  • ایمنی نوع ناوبری اکنون از کلاس‌های مقداری به عنوان یک مسیر یا به عنوان نوع آرگومان یک مسیر پشتیبانی می‌کند.

نسخه ۲.۹.۰-rc01

۲۳ آوریل ۲۰۲۵

androidx.navigation:navigation-*:2.9.0-rc01 منتشر شد. نسخه 2.9.0-rc01 شامل این کامیت‌ها است.

رفع اشکالات

  • تمام اهداف پلتفرم‌های غیراندرویدی از ناوبری جت‌پک حذف شدند زیرا این اهداف در واقع کار نمی‌کنند. اکنون به جای آنها، stubهای مربوط به پلتفرم‌های مختلف ارائه می‌شوند. ( I2877d )

نسخه ۲.۹.۰-بتا۰۱

۹ آوریل ۲۰۲۵

androidx.navigation:navigation-*:2.9.0-beta01 منتشر شد. نسخه 2.9.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • API رایج parseStringAsNavUri به یک تابع کارخانه‌ای NavUri تغییر یافته است که یک رشته (String) می‌گیرد. ( I4db6e , b/403616316 )

به‌روزرسانی‌های وابستگی

  • این کتابخانه اکنون سطح زبان Kotlin 2.0 را هدف قرار می‌دهد و به KGP 2.0.0 یا جدیدتر نیاز دارد. ( Idb6b5 )

نسخه ۲.۹.۰-alpha09

۲۶ مارس ۲۰۲۵

androidx.navigation:navigation-*:2.9.0-alpha09 منتشر شد. نسخه 2.9.0-alpha09 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • ماژول navigation-testing اکنون علاوه بر اندروید، از دسکتاپ، لینوکس، macOS و iOS نیز پشتیبانی می‌کند. ( I2b770 ، b/398265336 )
  • NavType اکنون علاوه بر اندروید، روی دسکتاپ، لینوکس، macOS و iOS نیز پشتیبانی می‌شود. ( I297d8 )

نسخه ۲.۹.۰-آلفا۰۸

۱۲ مارس ۲۰۲۵

androidx.navigation:navigation-*:2.9.0-alpha08 منتشر شد. نسخه 2.9.0-alpha08 شامل این کامیت‌ها است.

رفع اشکالات

  • از ناوبری 2.8.9 : مشکل رگرسیون موجود در ناوبری ۲.۸.۸ که برای تطبیق، نیاز به تطابق دقیق یک لینک عمیق با تمام فیلدهای یک درخواست یا قصد لینک عمیق داشت، برطرف شد. این امر باعث می‌شد لینک‌های عمیقی که حاوی تطابق‌های جزئی فیلدها بودند و فیلدهای دیگری نداشتند، دیگر کار نکنند. ( Ie5e36 , b/399826566 )

مشارکت خارجی

  • تابع تجزیه‌گر رایج جدید برای ایجاد NavUri . با تشکر از کنستانتین تسخوربوف! ( If0a6a )

نسخه ۲.۹.۰-آلفا۰۷

۲۶ فوریه ۲۰۲۵

androidx.navigation:navigation-*:2.9.0-alpha07 منتشر شد. نسخه 2.9.0-alpha07 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکلی که باعث می‌شد تلاش برای saveState با pop غیر فراگیر منجر به مقدار null savedState شود که می‌توانست باعث خرابی در هنگام بازیابی شود، برطرف شد. ( I9f3e8 , b/395091644 )
  • از ناوبری ۲.۸.۸ : مشکل تطبیق NavDeepLink که در آن یک لینک عمیق و یک درخواست لینک عمیق باید دقیقاً از نظر uri، action و mime مطابقت داشته باشند، برطرف شده است. اگر فقط یک یا دو فیلد مطابقت داشته باشند، تطبیق دیگر مجاز نیست. ( I3b029 ، b/395712033 )
  • از ناوبری ۲.۸.۸ : اشکالی که باعث می‌شد مسیرهای دارای مسیرهای wildcard با لینک عمیق اضافه شده مطابقت نداشته باشند، برطرف شد ( I7ea92 ، b/389970341 )

مشارکت خارجی

  • APIهای navigation-common، navigation-runtime و navigation-compose را به پلتفرم مشترک استخراج کنید. با تشکر از کنستانتین تسخوریبوف! ( I1e626 ، Ica76f ، Idf479 )

مشکلات شناخته شده

  • به دلیل کار روی رفع مشکل b/395712033 ، به اشتباه از deeplinkها خواسته می‌شود که تمام فیلدهای مشابه با درخواست deeplink و/یا Intent را داشته باشند. از deeplinkها فقط باید خواسته شود که فیلدهایی که دارند مطابقت داشته باشند و فیلدهای غیرمرتبط باید نادیده گرفته شوند. این مشکل در نسخه بعدی به عنوان بخشی از b/399826566 برطرف شده است.

نسخه ۲.۹.۰-alpha06

۱۲ فوریه ۲۰۲۵

androidx.navigation:navigation-*:2.9.0-alpha06 منتشر شد. نسخه 2.9.0-alpha06 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • اقدامات مربوط به آرگومان‌های امن ناوبری اکنون با حاشیه‌نویسی @CheckResult ایجاد می‌شوند تا از استفاده آنها اطمینان حاصل شود. ( I14d4c ، b/356323084 )

رفع اشکالات

  • خطایی در NavController که در آن حالت‌های backStack به اشتباه تلاش می‌کردند تا در یک آرایه بازیابی شوند، در حالی که در یک لیست ذخیره شده بودند، برطرف شد. ( Idfb9b )
  • از ناوبری 2.8.7 : آرگومان‌های ایمن ناوبری اکنون از مقصدهای قابل ترکیب پشتیبانی می‌کنند. ( I35320 ، b/362791955 )

نسخه ۲.۹.۰-آلفا۰۵

۲۹ ژانویه ۲۰۲۵

androidx.navigation:navigation-*:2.9.0-alpha05 منتشر شد. نسخه 2.9.0-alpha05 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکلی که باعث ایجاد انیمیشن مقیاس غیرمنتظره هنگام استفاده از Navigation Compose می‌شد را برطرف کنید. ( I480f4 ، b/353294030 )
  • از Navigation 2.8.6 : برچسب‌های NavDestination که از طریق XML ارائه می‌شوند، از طریق NavType.get تجزیه می‌شوند تا از رعایت منطق سفارشی NavType اطمینان حاصل شود. ( I7ec2f ، b/388100796 )
  • از ناوبری 2.8.6 : هنگام پیمایش به فعالیت با dataPattern ، ActivityNavigator اکنون سعی می‌کند مقدار arg را با NavType آرگومان کدگذاری کند. ( I16376 ، b/383616432 )
  • از ناوبری 2.8.5 : مشکلی که باعث ایجاد انیمیشن مقیاس غیرمنتظره هنگام استفاده از Navigation Compose و فراخوانی navigation در همان فریمی که انیمیشن فعلی در حال پایان است، می‌شد، برطرف شد. ( I26cb1 ، b/353294030 )

نسخه ۲.۹.۰-آلفا۰۴

۱۱ دسامبر ۲۰۲۴

androidx.navigation:navigation-*:2.9.0-alpha04 منتشر شد. نسخه 2.9.0-alpha04 شامل این کامیت‌ها است.

ویژگی‌های جدید

جدول زیر APIهای اصلاح‌شده و 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 مختص کاتلین برای ایمنی نوع، از منابع جاوا پنهان است. ( Ic640c ، b/364634035 )

رفع اشکالات

  • از Navigation 2.8.5 : مشکلی که باعث می‌شد NavHost در صورت کاهش پشته به ۱ ورودی و فعال شدن یک system back در همان فریم، بتواند یک استثنا درون PredictiveBackHandler ایجاد کند، برطرف شد. ( I1a429 ، b/375343407 )
  • از ناوبری 2.8.5 : خطای NavDestination NullPointerException هنگام به‌روزرسانی startDestination گراف برطرف شد. ( I99421 ، b/361560785 )

مشارکت خارجی

  • از ناوبری 2.8.5 : ایمنی نوع ناوبری اکنون List<Enum> به عنوان نوع آرگومان یک مسیر بدون نیاز به هیچ NavType سفارشی پشتیبانی می‌کند. با تشکر از Csaba Kozák ! ( GH-725 ، b/375559962 )

نسخه ۲.۹.۰-آلفا۰۳

۱۳ نوامبر ۲۰۲۴

androidx.navigation:navigation-*:2.9.0-alpha03 منتشر شد. نسخه 2.9.0-alpha03 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • ایمنی نوع ناوبری اکنون از کلاس‌های مقداری به عنوان یک مسیر یا به عنوان نوع آرگومان یک مسیر پشتیبانی می‌کند. ( I9344a ، b/374347483 )

رفع اشکالات

  • خطای ConcurrentModificationException که می‌توانست زمانی رخ دهد که یک LifecycleObserver متصل به یک NavBackStackEntry ، زمانی که LifecycleOwner میزبان مانند Activity یا Fragment حاوی، وضعیت چرخه عمر خود را تغییر می‌دهد، باعث ایجاد تغییر در back stack شود، برطرف شد ( Ia9494 ).

نسخه ۲.۹.۰-آلفا۰۲

۳۰ اکتبر ۲۰۲۴

androidx.navigation:navigation-*:2.9.0-alpha02 منتشر شد. نسخه 2.9.0-alpha02 شامل این کامیت‌ها است.

مشارکت خارجی

  • متد رایج جدید NavController.handleDeepLink(request: NavDeepLinkRequest) . با تشکر از کنستانتین تسخوریبوف! ( I3e228 )

نسخه ۲.۹.۰-آلفا۰۱

۱۶ اکتبر ۲۰۲۴

androidx.navigation:navigation-*:2.9.0-alpha01 منتشر شد. نسخه 2.9.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • ناوبرهای سفارشی اکنون می‌توانند مقاصد خود را به عنوان پیاده‌سازی رابط SupportingPane علامت‌گذاری کنند که به NavController نشان می‌دهد که این مقاصد در کنار سایر مقاصد نمایش داده خواهند شد. با استفاده از این رابط، به عنوان مثال، می‌توان چندین مقصد را همزمان RESUMED . ( Id5559 )
  • از Navigation 2.8.3 : بررسی‌های جدید lint برای ماژول‌های navigation-common ، navigation-runtime و navigation-compose اضافه شده است تا به شناسایی هرگونه مسیر type-safe که به درستی با @Serializable حاشیه‌نویسی نشده‌اند، کمک کند. این بررسی برای همه توابع افزونه NavGraphBuilder و NavDeepLinkBuilder اعمال می‌شود. ( I4a259 ، I95402 ، Ie601a ، Id8c6e ، I28bda ، b/362725816 )
  • از Navigation 2.8.3 : بررسی‌های جدید lint برای ماژول‌های navigation-common ، navigation-runtime و navigation-compose اضافه شده است تا به شناسایی هرگونه مسیر type-safe با آرگومان‌های Enum که به درستی با @Keep حاشیه‌نویسی نشده‌اند، کمک کند. این بررسی برای همه توابع افزونه NavGraphBuilder و NavDeepLinkBuilder اعمال می‌شود. ( I4a259 ، I95402 ، Ie601a ، Id8c6e ، I2b46f ، b/358687142 )

تغییرات رفتاری

  • تلاش برای استفاده از NavController که قبلاً DESTROYED شده است، اکنون باعث ایجاد IllegalStateException می‌شود. ( I520da , b/369616172 )

رفع اشکالات

  • کلاس Enum را به‌روزرسانی کنید تا در صورت پاک شدن کلاس Enum در نسخه‌های کوچک‌شده، از حاشیه‌نویسی @Keep استفاده شود. ( I90e79 ، b/358137294 )

مشکلات شناخته شده

  • مشکلی در قوانین جدید lint که در Navigation 2.8.* اضافه شده‌اند وجود دارد که هنگام تلاش برای اجرای lint با افزونه Android Gradle نسخه ۸.۴ به بالا، باعث خطای Obsolete custom lint check می‌شود. ( b/368070326 , b/371463741 )

نسخه ۲.۸

نسخه ۲.۸.۹

۱۲ مارس ۲۰۲۵

androidx.navigation:navigation-*:2.8.9 منتشر شد. نسخه 2.8.9 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکل رگرسیون موجود در ناوبری نسخه ۲.۸.۸ که برای تطبیق، نیاز به تطابق دقیق یک لینک عمیق با تمام فیلدهای یک درخواست یا قصد لینک عمیق داشت، برطرف شد. این امر باعث می‌شد لینک‌های عمیقی که شامل تطابق‌های جزئی فیلدها بودند و فیلدهای دیگری نداشتند، دیگر کار نکنند. ( Ie5e36 , b/399826566 )

نسخه ۲.۸.۸

۲۶ فوریه ۲۰۲۵

androidx.navigation:navigation-*:2.8.8 منتشر شد. نسخه 2.8.8 شامل این کامیت‌ها است.

رفع اشکالات

  • اشکالی که باعث می‌شد مسیرهای دارای مسیرهای wildcard با لینک عمیق اضافه شده مطابقت نداشته باشند، برطرف شد. ( I7ea92 ، b/389970341 )
  • مشکل تطبیق NavDeepLink که در آن یک لینک عمیق و یک درخواست لینک عمیق باید دقیقاً از نظر uri، action و mime مطابقت داشته باشند، برطرف شده است. اگر فقط یک یا دو فیلد مطابقت داشته باشند، تطبیق دیگر مجاز نیست. ( I3227f ، b/395712033 )

مشکلات شناخته شده

  • به دلیل کار روی رفع مشکل b/395712033 ، به اشتباه از deeplinkها خواسته می‌شود که تمام فیلدهای مشابه با درخواست deeplink و/یا Intent را داشته باشند. از deeplinkها فقط باید خواسته شود که فیلدهایی که دارند مطابقت داشته باشند و فیلدهای غیرمرتبط باید نادیده گرفته شوند. این مشکل در نسخه بعدی به عنوان بخشی از b/399826566 برطرف شده است.

نسخه ۲.۸.۷

۱۲ فوریه ۲۰۲۵

androidx.navigation:navigation-*:2.8.7 منتشر شد. نسخه 2.8.7 شامل این کامیت‌ها است.

رفع اشکالات

  • آرگومان‌های امن ناوبری اکنون از مقصدهای قابل ترکیب پشتیبانی می‌کنند. ( I35320 ، b/362791955 )

نسخه ۲.۸.۶

۲۹ ژانویه ۲۰۲۵

androidx.navigation:navigation-*:2.8.6 منتشر شد. نسخه 2.8.6 شامل این کامیت‌ها است.

رفع اشکالات

  • برچسب‌های NavDestination که از طریق XML ارائه می‌شوند، از طریق NavType.get تجزیه و تحلیل می‌شوند تا از رعایت منطق سفارشی NavType اطمینان حاصل شود. ( Id366d ، b/388100796 )
  • هنگام پیمایش به فعالیت با dataPattern ، ActivityNavigator اکنون سعی می‌کند مقدار arg را با NavType آرگومان کدگذاری کند. ( I1a71d ، b/383616432 )

نسخه ۲.۸.۵

۱۱ دسامبر ۲۰۲۴

androidx.navigation:navigation-*:2.8.5 منتشر شد. نسخه 2.8.5 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکلی که باعث می‌شد NavHost در صورت کاهش تعداد ورودی‌های پشته به ۱ و فعال شدن یک سیستم برگشتی در همان فریم، یک استثنا در داخل PredictiveBackHandler ایجاد کند، برطرف شد. ( I1a429 ، b/375343407 )
  • خطای NavDestination NullPointerException هنگام به‌روزرسانی startDestination گراف برطرف شد. ( I99421 ، b/361560785 )
  • مشکلی که باعث می‌شد هنگام استفاده از Navigation Compose و فراخوانی navigation در همان فریمی که انیمیشن فعلی در حال پایان است، انیمیشن مقیاس غیرمنتظره‌ای ایجاد شود، برطرف شد ( I26cb1 ، b/353294030 ).
  • خطای ConcurrentModificationException که می‌توانست زمانی رخ دهد که یک LifecycleObserver متصل به یک NavBackStackEntry ، زمانی که LifecycleOwner میزبان مانند Activity یا Fragment حاوی، وضعیت چرخه عمر خود را تغییر می‌دهد، باعث ایجاد تغییر در back stack شود، برطرف شد ( Ia9494 ).

مشارکت خارجی

  • ایمنی نوع ناوبری اکنون از List<Enum> به عنوان نوع آرگومان یک مسیر بدون نیاز به هیچ NavType سفارشی پشتیبانی می‌کند. با تشکر از Csaba Kozák ! ( GH-725 ، b/375559962 )

نسخه ۲.۸.۴

۱۳ نوامبر ۲۰۲۴

androidx.navigation:navigation-*:2.8.4 منتشر شد. نسخه 2.8.4 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • از ناوبری 2.9.0-alpha03 : ایمنی نوع ناوبری اکنون از کلاس مقداری به عنوان مسیر یا به عنوان نوع آرگومان یک مسیر ( I9344a ، b/374347483 ) پشتیبانی می‌کند.

رفع اشکالات

  • از Navigation 2.9.0-alpha01 : تلاش برای استفاده از NavController که قبلاً DESTROYED شده است، اکنون باعث ایجاد IllegalStateException می‌شود. ( I520da ، b/369616172 )

نسخه ۲.۸.۳

۱۶ اکتبر ۲۰۲۴

androidx.navigation:navigation-*:2.8.3 منتشر شد. نسخه 2.8.3 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • بررسی‌های جدید lint برای ماژول‌های navigation-common ، navigation-runtime و navigation-compose اضافه شده است تا به شناسایی هرگونه مسیر type-safe که به درستی با @Serializable حاشیه‌نویسی نشده‌اند، کمک کند. این بررسی برای همه توابع افزونه NavGraphBuilder و NavDeepLinkBuilder اعمال می‌شود. ( I4a259 ، I95402 ، Ie601a ، Id8c6e ، I28bda ، b/362725816 )
  • بررسی‌های جدید lint برای ماژول‌های navigation-common ، navigation-runtime و navigation-compose اضافه شده است تا به شناسایی هرگونه مسیر type-safe با آرگومان‌های Enum که به درستی با @Keep حاشیه‌نویسی نشده‌اند، کمک کند. این بررسی برای همه توابع افزونه NavGraphBuilder و NavDeepLinkBuilder اعمال می‌شود. ( I4a259 ، I95402 ، Ie601a ، Id8c6e ، I2b46f ، b/358687142 )

رفع اشکالات

  • مشکلی که باعث می‌شد قوانین جدید lint که در Navigation 2.8.* اضافه شده بودند، هنگام تلاش برای اجرای lint با افزونه Android Gradle نسخه ۸.۴ به بالا، خطای Obsolete custom lint check را نشان دهند، برطرف شد. ( I1be3d , b/368070326 , b/371463741 )

مشکلات شناخته شده

  • هنگام تلاش برای اجرای lint با Lint 16 (AGP 8.7) یا بالاتر، navigation lint خطای Obsolete custom lint check را نشان می‌دهد. ( b/371926651 )

نسخه ۲.۸.۲

۲ اکتبر ۲۰۲۴

androidx.navigation:navigation-*:2.8.2 منتشر شد. نسخه 2.8.2 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • ایمنی نوع ناوبری اکنون از کلاس‌های Serializable که شامل Double ، Double? DoubleArray ، DoubleArray? List<Double> و List<Double>? هستند، بدون نیاز به هیچ NavType سفارشی پشتیبانی می‌کند. ( I570eb ، Ibc4c0 ، I37461 ، I5bed4 ، b/359245753 )

رفع اشکالات

  • پیام خطای مربوط به زمانی که Navigation نتواند آرگومان یک مسیر را به NavType نگاشت کند، بهبود یافته است. پیام خطای جدید شامل نام آرگومان، نام کامل آرگومان و نام کامل مسیر خواهد بود. ( Id8416 ، b/346264232 )

نسخه ۲.۸.۱

۱۸ سپتامبر ۲۰۲۴

androidx.navigation:navigation-*:2.8.1 منتشر شد. نسخه 2.8.1 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • یک قانون lint جدید اضافه شد تا از استفاده از تابع popBackStack که هنگام تلاش برای popBackStack با استفاده از APIهای type-safe، یک نوع کلاس اصلاح‌شده می‌گیرد، اطمینان حاصل شود. ( Ief161 ، b/358095343 )

رفع اشکالات

  • اکنون ناوبری مستلزم آن است که مسیری که به startDestination یک NavGraph ارسال می‌شود، شامل مقادیر تمام آرگومان‌های مورد نیاز باشد، که شامل آرگومان‌هایی می‌شود که غیرقابل تهی هستند و مقدار پیش‌فرض ندارند. ( I18e74 ، b/362594265 )
  • آرگومان‌های امن ناوبری، پشتیبانی از رشته‌های غیرتهی‌پذیر را اضافه کرده‌اند، به طوری که مقادیر "تهی" تجزیه و به همان صورت در بسته ذخیره می‌شوند. این با رفتار موجود که در آن مقادیر "تهی" به یک شیء تهی تجزیه می‌شدند، متفاوت است. این تغییر فقط برای انواع رشته‌ای غیرتهی‌پذیر اعمال می‌شود. رشته‌های تهی‌پذیر بدون تغییر باقی می‌مانند. ( I08b4a , b/348936238 )
  • یک NavDestination دیگر نمی‌تواند به صورت deeplink به آن متصل شود، مگر از طریق یک deep link که به طور صریح به مقصد اضافه شده باشد. این همچنین به این معنی است که شما فقط می‌توانید با استفاده از تابع navigation overload که یک string route می‌گیرد، به مسیر یک مقصد پیمایش کنید. این آسیب‌پذیری که امکان deep link به یک مقصد بالقوه محافظت‌شده را فراهم می‌کرد، برطرف می‌کند. ( Ie30e6 )

به‌روزرسانی وابستگی

  • آرگومان‌های امن ناوبری اکنون به جای کاتلین ۲.X به کاتلین ۱.۹.۲۴ وابسته هستند و تضمین می‌کنند که توسعه‌دهندگان مجبور به به‌روزرسانی نشوند. ( a4129a )
  • ناوبری Compose اکنون به Compose 1.7.2 بستگی دارد.

نسخه ۲.۸.۰

۴ سپتامبر ۲۰۲۴

androidx.navigation:navigation-*:2.8.0 منتشر شد. نسخه 2.8.0 شامل این کامیت‌ها است.

تغییرات مهم از زمان ۲.۷.۰

ناوبری کاتلین DSL - ایمنی نوع

  • اکنون Navigation با استفاده از Kotlin Serialization، قابلیت type-safety را برای Kotlin DSL (که توسط Navigation Compose استفاده می‌شود) فراهم می‌کند تا به شما امکان دهد از طریق اشیاء و کلاس‌های داده type-safe، مقاصد را در گراف navigation خود تعریف کنید: 
    // 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 مراجعه کنید.

ناوبری، نوشتن، پیش‌بینی، بازگشت

  • ناوبری Compose اکنون از طریق APIهای جدید SeekableTransitionState از compose-animation، پشتیبانی از بازگشت درون‌برنامه‌ای پیش‌بینی‌کننده را ارائه می‌دهد. این به شما امکان می‌دهد قبل از تصمیم‌گیری برای انجام تراکنش از طریق حرکت تکمیل‌شده یا لغو، از حرکت بازگشت برای دیدن مقصد قبلی با Transition سفارشی خود استفاده کنید.

قطعه ناوبری قابل ترکیب

  • یک مصنوع جدید navigation-fragment-compose اضافه شده است که شامل یک جایگزین ComposableNavHostFragment برای NavHostFragment است که به شما امکان می‌دهد مقصدهای قابل ترکیب را به فایل‌های Navigation XML خود اضافه کنید. هر مقصد composable باید به صورت یک متد @Composable سطح بالا و بدون آرگومان بیان شود که نام کامل آن به عنوان ویژگی android:name در هر مقصد استفاده می‌شود. هنگام پیمایش به یکی از این مقصدها، یک قطعه حاوی برای نمایش محتوای قابل ترکیب ایجاد می‌شود. 
  // 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" />

سایر تغییرات

  • ناوبری Compose اکنون به Compose 1.7.0 بستگی دارد.
  • اکنون Navigation یک کلاس جدید CollectionNavType<T> ارائه می‌دهد، که زیرکلاسی از NavType<T> برای آرگومان‌های مبتنی بر مجموعه مانند لیست، آرایه‌ها، نقشه‌ها است. اکنون همه آرایه‌های پیش‌فرض NavType ( IntArrayType ، LongArrayType ، FloatArrayType ، BoolArrayType و StringArrayType ) از این کلاس جدید ارث‌بری می‌کنند.
  • NavType اکنون از لیست‌های Int، String، Boolean، Float و Long به صورت داخلی پشتیبانی می‌کند.

نسخه ۲.۸.۰-rc01

۲۱ آگوست ۲۰۲۴

androidx.navigation:navigation-*:2.8.0-rc01 منتشر شد. نسخه 2.8.0-rc01 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع مشکل از کار افتادن نوار ناوبری هنگام ارسال کلاس‌های Enum سطح بالا به عنوان آرگومان‌های type safe ( I0ba76 ، b/358137294 )
  • ناوبری ۲.۸ اکنون به درستی با SDK 34 کار می‌کند و تا زمان انتشار نسخه ۲.۹ به همراه بقیه کتابخانه‌های AndroidX به SDK 35 منتقل نخواهد شد. ( b/358798728 )

نسخه ۲.۸.۰-بتا۰۷

۷ آگوست ۲۰۲۴

androidx.navigation:navigation-*:2.8.0-beta07 منتشر شد. نسخه 2.8.0-beta07 شامل این کامیت‌ها است.

مشکلات شناخته شده

  • با توجه به b/358137294 ، فقط Enumهایی که در کلاس دیگری تو در تو قرار دارند، به صورت پیش‌فرض پشتیبانی می‌شوند. Enumهای سطح بالا در نسخه بعدی پشتیبانی خواهند شد.

رفع اشکالات

  • هنگام پیمایش به مقصدهای تکراری یا مشترک، پیمایش با اولویت رفتن به نزدیکترین مقصد منطبق از موقعیت فعلی در نمودار انجام می‌شود. ( Ic89a4 , b/352006850 )
  • پیمایش در آرگومان‌های امن اکنون یک NavType.EnumType جدید اضافه کرده است. این بدان معناست که انواع Enum دیگر نیازی به NavType های سفارشی ندارند. توجه داشته باشید که SerialName مربوط به Enum باید نام کاملاً واجد شرایط پیش‌فرض باشد. ( I66d22 ، b/346475493 )
  • پیمایش در آرگومان‌های امن، پشتیبانی داخلی برای انواع آرگومان‌های تهی‌پذیر از جمله Int? Long? Float? Boolean? و Enum<*>? ( I32d13 ، I1c580 ، Ifba66 ، I978b0 ، Ide076 ، b/351994237 ) اضافه کرده است.
  • startDestination در NavGraph اکنون از مقادیر آرگومان پیش‌فرض استفاده خواهد کرد اگر مسیر startDestination ارسالی به NavGraph دقیقاً برابر با startDestination.route باشد. ( I13762 , b/354046047 )

نسخه ۲.۸.۰-بتا۰۶

۲۴ ژوئیه ۲۰۲۴

androidx.navigation:navigation-*:2.8.0-beta06 منتشر شد. نسخه 2.8.0-beta06 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکلی که باعث می‌شد بررسی‌های lint WrongStartDestinationType ، اشیاء Companion را روی نوع کلاس ارسالی بررسی نکنند و باعث می‌شد lint نتواند خطا را تشخیص دهد، برطرف شد. ( I92b09 )

نسخه ۲.۸.۰-بتا۰۵

۱۰ ژوئیه ۲۰۲۴

androidx.navigation:navigation-*:2.8.0-beta05 منتشر شد. نسخه 2.8.0-beta05 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع مشکل از کار افتادن ناوبری singleTop navigation crash) زمانی که NavGraphs تودرتو، مسیر startDestination یکسانی را به اشتراک می‌گذارند. ( I17b94 , b/294408596 )

نسخه ۲.۸.۰-بتا۰۴

۲۶ ژوئن ۲۰۲۴

androidx.navigation:navigation-*:2.8.0-beta04 منتشر شد. نسخه 2.8.0-beta04 شامل این کامیت‌ها است.

رفع اشکالات

  • ناوبری اکنون از پیمایش با رشته‌های خالی در آرگومان‌های مسیر پشتیبانی می‌کند. ( Ic5dbd ، b/339481310 )
  • پیام خطا برای سریالایزرهای سفارشی که مستقیماً از طریق @Serializable(with =...) روی فیلدهای کلاس تعریف می‌شوند، بهبود یافته تا روشن شود که این ویژگی در حال حاضر پشتیبانی نمی‌شود. ( I052b0 , b/341319151 )
  • API تست SavedStateHandleFactory اکنون می‌تواند در تست‌های غیر اندروید استفاده شود، اما به Robolectric نیاز دارد تا از تجزیه آرگومان با Bundles پشتیبانی کند. ( I76cdc ، b/340966212 )
  • مشکل از کار افتادن برنامه در حالت بازیابی هنگام از سرگیری برنامه پس از مرگ فرآیند با استفاده از ناوبری ایمن از نوع در نوشتن ( Ia8f38 ، b/341801005 ) برطرف شد.
  • مشکلی در Navigation Compose که پس از لغو Predictive Back Gesture، NavBackStackEntry که کاربر به آن برمی‌گردد، هرگز به حالت چرخه حیات RESUMED برنمی‌گردد، برطرف شد. این همچنین تضمین می‌کند که مقصد بازگشتی به جای اینکه پس از یک پرش به جای خود برگردد، به درستی انیمیشن می‌شود. ( I97a0c ، b/346608857 )
  • هنگام استفاده از بازگشت پیش‌بینی‌کننده با Navigation Compose، مقصدی که ظاهر می‌شود، اکنون دارای ترتیب z مناسب خواهد بود و به درستی روی مقصد ورودی متحرک‌سازی می‌شود. ( I2077b ، b/345993681 )

نسخه ۲.۸.۰-بتا۰۳

۱۲ ژوئن ۲۰۲۴

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> با آرگومان null CollectionNavType برطرف شد. هنگام پیمایش با CollectionNavType null، آرگومان خروجی مقدار پیش‌فرض اعلام شده در کلاس Serializable شما یا مقدار بازگشتی emptyCollection() در صورت عدم وجود مقدار پیش‌فرض خواهد بود. ( I84158 ، Id630f ، b/342672856 )

نسخه ۲.۸.۰-بتا۰۲

۲۹ مه ۲۰۲۴

androidx.navigation:navigation-*:2.8.0-beta02 منتشر شد. نسخه 2.8.0-beta02 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع مشکل خطای ClassCastException هنگام استفاده از NavBackStackEntry.toRoute با یک NavType سفارشی nullable ( I1c29b ، b/342239473 )
  • مشکلات بازیابی وضعیت پشته ناوبری که هنگام تلاش برای بازیابی ورودی پشته که از طریق شناسه از مقصد فعلی قابل دسترسی نیست، ایجاد می‌شد، برطرف شد. از آنجایی که مسیرها توسط شناسه‌ها پشتیبانی می‌شوند، مقصدهای ساخته شده با مسیرها نیز تحت تأثیر قرار می‌گرفتند. این همچنین خرابی ناشی از فراخوانی clearBackStack() را که مشکل اساسی مشابهی داشت، برطرف می‌کند. ( I423c3 ، b/339908057 )

نسخه ۲.۸.۰-بتا۰۱

۱۴ مه ۲۰۲۴

androidx.navigation:navigation-*:2.8.0-beta01 منتشر شد. نسخه 2.8.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • SavedStateHandle.toRoute() اکنون برای انواع آرگومان‌های سفارشی، یک پارامتر typeMap دریافت می‌کند. ( Ie39fb ، b/339026523 )
  • یک API تست به navigation-testing اضافه شد تا یک SavedStateHandle از یک شیء Kotlin Serializable ایجاد کند. ( Id4867 ، b/339080702 )

رفع اشکالات

  • اسناد پارامتر گمشده برای توابع ناوبری کاتلین DSL اضافه شده است. ( I26a36 )

نسخه ۲.۸.۰-آلفا۰۸

۱ مه ۲۰۲۴

androidx.navigation:navigation-*:2.8.0-alpha08 منتشر شد. نسخه 2.8.0-alpha08 شامل این کامیت‌ها است.

آرگومان‌های ایمن در ناوبری (Navigation) و آهنگسازی (Compose)

این قابلیت از سریال‌سازی کاتلین استفاده می‌کند تا به شما امکان دهد مقاصد را در نمودار ناوبری خود از طریق اشیاء و کلاس‌های داده‌ی ایمن از نوع تعریف کنید:

  // 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 )

نسخه ۲.۸.۰-alpha07

۱۷ آوریل ۲۰۲۴

androidx.navigation:navigation-*:2.8.0-alpha07 منتشر شد. نسخه 2.8.0-alpha07 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • یک مصنوع جدید navigation-fragment-compose اضافه می‌کند که شامل یک جایگزین ComposableNavHostFragment برای NavHostFragment است که به شما امکان می‌دهد مقصدهای composable را به فایل‌های Navigation XML خود اضافه کنید. هر مقصد composable باید به صورت یک متد @Composable سطح بالا و بدون آرگومان بیان شود که نام کامل آن به عنوان ویژگی android:name در هر مقصد استفاده می‌شود. هنگام پیمایش به یکی از این مقصدها، یک قطعه حاوی برای نمایش محتوای قابل ترکیب ایجاد می‌شود. ( 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

  • پشتیبانی از آرگومان‌های امن در Navigation Compose با استفاده از رویکردی مبتنی بر سریال‌سازی کاتلین ادامه دارد. این APIها هنوز تکمیل نشده‌اند و با حاشیه‌نویسی ExperimentalSafeArgsApi علامت‌گذاری شده‌اند. این حاشیه‌نویسی پس از تکمیل کل سطح API در نسخه‌های آینده حذف خواهد شد. ( Iefd95 ، I409c8 ، I5b5ac ، I7e753 ، I960f8 ، I3eabd ، I8ed5a ، Ied2c9 ، I9b73c ، I554db ، Ib3aba ، Ia668d ، b/188693139 )

نسخه ۲.۸.۰-alpha06

۳ آوریل ۲۰۲۴

androidx.navigation:navigation-*:2.8.0-alpha06 منتشر شد. نسخه 2.8.0-alpha06 شامل این کامیت‌ها است.

تغییرات API

  • پشتیبانی از آرگومان‌های امن در Navigation Compose با استفاده از رویکردی مبتنی بر سریال‌سازی کاتلین آغاز شده است. این 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 )

نسخه ۲.۸.۰-آلفا۰۵

۲۰ مارس ۲۰۲۴

androidx.navigation:navigation-*:2.8.0-alpha05 منتشر شد. نسخه 2.8.0-alpha05 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • اکنون می‌توانید آرگومان‌ها را مستقیماً در مسیر startDestination از NavGraph و بدون تکیه بر defaultValue ارسال کنید. این امر در مورد startDestinations تو startDestination تو NavGraph نیز صدق می‌کند. ( I0e0b5 , b/109505019 , b/188693139 )

تغییرات API

  • کلاس انتزاعی جدید CollectionNavType<T> اضافه شد، که زیرکلاسی از NavType<T> برای آرگومان‌های مبتنی بر مجموعه مانند لیست، آرایه‌ها، نقشه‌ها است. ( Ic6d63 , b/188693139 )
  • تمام آرایه‌های پیش‌فرض NavType ( IntArrayType ، LongArrayType ، FloatArrayType ، BoolArrayType و StringArrayType ) اکنون از نوع CollectionNavType ( Idcf79 ، b/188693139 ) هستند.
  • NavType اکنون یک API باز جدید valueEquals ارائه می‌دهد که تعیین می‌کند آیا دو مقدار از یک نوع با یکدیگر برابر هستند یا خیر. ( I6cb97 ، b/327229511 )

رفع اشکالات

  • پارامترهای پرس‌وجو در پیوندهای عمیق اکنون مقادیری را به شکل آکولاد در اطراف نام آرگومان (یعنی {argName} ) به عنوان مقادیر معتبر برای NavTypes مبتنی بر رشته مجاز می‌دانند. این مشکل را برطرف می‌کند که در آن چنین مقداری برای همه نوع‌ها نامعتبر (یا فاقد مقدار) در نظر گرفته می‌شد. ( I18302 ، b/327274038 )
  • توابع NavController که از مسیرهایی مانند navigate یا popBackStack پشتیبانی می‌کنند، اکنون می‌توانند مسیرهای پر شده با آرگومان‌های Array NavTypes را به درستی مطابقت دهند. ( Iea805 ، b/327229511 )

نسخه ۲.۸.۰-آلفا۰۴

۶ مارس ۲۰۲۴

androidx.navigation:navigation-*:2.8.0-alpha04 منتشر شد. نسخه 2.8.0-alpha04 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • اکنون می‌توانید SizeTranform را برای انتقال‌های خود در Navigation Compose با تعریف آنها به عنوان بخشی از مقداردهی اولیه برای توابع composable و/یا navigation مشخص کنید. ( I91062 , b/296912651 )

رفع اشکالات

  • مشکلی که باعث می‌شد NavHost در Compose Navigation هنگام استفاده از System Back بدون اشاره، نتواند به درستی انتقال را نشان دهد، برطرف شد. ( Iceeae ، b/325998468 )

نسخه ۲.۸.۰-alpha03

۲۱ فوریه ۲۰۲۴

androidx.navigation:navigation-*:2.8.0-alpha03 منتشر شد. نسخه 2.8.0-alpha03 شامل این کامیت‌ها است.

تغییرات API

  • NavBackStackEntry.savedStateHandle اکنون به عنوان @MainThread علامت‌گذاری شده است، زیرا از کدی استفاده می‌کند که در هر صورت باید در thread اصلی باشد. ( Ibb988 , b/299523245 )

رفع اشکالات

  • مشکلی در ناوبری که باعث می‌شد ViewModelهای NavGraph خیلی زود DESTROYED ، زیرا ViewModel مربوط به ورودی مربوطه بخشی از حالت ذخیره شده نبود، برطرف شد. ( Ib6bb7 , b/317581849 )

به‌روزرسانی وابستگی

نسخه ۲.۸.۰-آلفا۰۲

۷ فوریه ۲۰۲۴

androidx.navigation:navigation-*:2.8.0-alpha02 منتشر شد. نسخه 2.8.0-alpha02 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • Navigation Compose now provides support for Predictive in-app back via the new SeekableTransitionState APIs from compose-animation. This allows you to use the back gesture to see the previous destination with your custom Transition before deciding to either commit the transaction via the completed gesture or cancel. ( I8b8e9 )

Version 2.8.0-alpha01

۲۴ ژانویه ۲۰۲۴

androidx.navigation:navigation-*:2.8.0-alpha01 is released. Version 2.8.0-alpha01 contains these commits.

رفع اشکالات

  • Fixed BackStackState leak where multiple saveState calls on a destination would result in multiple states to be saved, but only the first one could be restored. ( I598b0 , b/309559751 )
  • Fixed an issue where non-String arguments would not be properly displayed when using the NavigationUI helpers to populate the title of app bars. ( #636 , b/316676794 )

Dependency Update

مشارکت خارجی

  • Thanks SimonMarquis for fixing the display issue for non-String arguments when using the NavigationUI helpers to populate the title of app bars.

Version 2.7.7

Version 2.7.7

۷ فوریه ۲۰۲۴

androidx.navigation:navigation-*:2.7.7 is released. Version 2.7.7 contains these commits.

رفع اشکالات

  • Backported from Navigation 2.8.0-alpha01 : Fixed BackStackState leak where multiple saveState() calls on a single NavBackStackEntry would result in multiple states being saved, but only the first saved state could be restored. ( I598b0 , b/309559751 )
  • Backported from Navigation 2.8.0-alpha01 : Fixed an issue where non-String arguments would not be properly displayed when using the NavigationUI helpers to populate the title of app bars. ( #636 , b/316676794 )

مشارکت خارجی

  • Thanks SimonMarquis for fixing the display issue for non-String arguments when using the NavigationUI helpers to populate the title of app bars.

Version 2.7.6

Version 2.7.6

۱۳ دسامبر ۲۰۲۳

androidx.navigation:navigation-*:2.7.6 is released. Version 2.7.6 contains these commits.

رفع اشکالات

  • The NavGraph equals() function now correctly considers the nodes of the other graph instead of just the calling one. This will ensure that graphs that have nodes with different ids will no longer be considered equal ( I401cb , b/311414915 )

Version 2.7.5

Version 2.7.5

۱ نوامبر ۲۰۲۳

androidx.navigation:navigation-*:2.7.5 is released. Version 2.7.5 contains these commits.

بهبود عملکرد

  • Greatly improved the performance (both in terms of time and number of allocations) of comparing two graphs. This means that calls such as setGraph which internally compare the new graph to the existing one are much faster and result in fewer skipped frames. Thank you Michał Z for the thorough analysis that led to this improvement. ( I6ad62 )
  • NavHost will now render the start destination on the first composition pass instead of needing to wait for the second pass to read updated state. ( I439a7 , b/304852206 )

رفع اشکالات

  • Fixed an issue where your back stack would be popped if you called setGraph more than once with the exact same graph only if there was a destination in your graph that contained an action linking two destinations. ( Ieaed7 )
  • Dialogs that were navigated to and dismissed in quick succession will no longer leak into the list of NavController.visibleEntries . ( I67586 , b/287969970 )
  • When an entry is popped followed by a configuration change, the entry's ViewModel will now be cleared properly if saveState is false. ( Idf242 , b/298164648 )
  • Fixed an issue where NavController could handle the same deep link more than once if the back stack was entirely empty before a configuration change or call to setGraph only when the incoming Intent had the FLAG_ACTIVITY_NEW_TASK flag set. ( I73c7f )

به‌روزرسانی‌های وابستگی

  • Navigation with Fragments now depends on Fragment 1.6.2 , fixing an issue where the ViewModel instances of nested fragments would not be cleared when calling clearBackStack .

Version 2.7.4

Version 2.7.4

۴ اکتبر ۲۰۲۳

androidx.navigation:navigation-*:2.7.4 is released. Version 2.7.4 contains these commits.

ویژگی‌های جدید

  • Added support for popUpTo to use routes with arguments to allow popping back to a specific entry that uses those exact arguments, matching the support found in popBackStack . ( I731f4 , b/299255572 )

رفع اشکالات

  • Fix issue where interrupting a navigate with another navigate with popUpTo will cause FragmentNavigator to crash. ( I3c848 , b/301887045 )
  • Fixed issue where system back press caused the currentDestination to not be updated correctly to match the displayed Fragment. ( Id0d6c , b/289877514 )
  • DialogFragment lifecycle will now properly move to RESUMED state when the dialog above it is dismissed. ( I88f0d , b/301811387 )

Version 2.7.3

Version 2.7.3

۲۰ سپتامبر ۲۰۲۳

androidx.navigation:navigation-*:2.7.3 is released. Version 2.7.3 contains these commits.

رفع اشکالات

  • Fixed an issue in Navigation with Fragments that caused the visibleEntries list to contain incorrect entries. ( I5caa9 , b/288520638 )
  • Fixed an issue that caused Floating Window destination (ie Dialogs , Bottomsheets , etc) to never get a RESUMED Lifecycle callback. ( I3b866 , b/287505132 )

Version 2.7.2

Version 2.7.2

۶ سپتامبر ۲۰۲۳

androidx.navigation:navigation-*:2.7.2 is released. Version 2.7.2 contains these commits.

رفع اشکالات

  • Navigation now depends on Lifecycle 2.6.2 , fixing an interaction between rememberSaveable and Navigation Compose's NavHost that would cause the rememberSaveable state of destinations and any ViewModel owned SavedStateHandle instances from being properly restored after process death and recreation. ( b/298059596 , b/289436035 )
  • Fixed an issue when showing multiple dialogs in Navigation Compose simultaneously where the partially obscured dialogs (eg, not the topmost dialog) would be in the CREATED Lifecycle state rather than the STARTED state. ( aosp/2728520 , b/289257213 )
  • Fixed an issue when showing multiple dialogs in Navigation Compose simultaneously where dismissing the topmost dialog would cause the new topmost dialog to be stuck in the STARTED Lifecycle state rather than correctly moving to RESUMED . ( aosp/2629401 , b/286371387 )
  • Navigation Safe Args no longer instantiates its task eagerly if it is not actually being executed. ( I0e385 , b/260322841 )

Dependency Update

  • Navigation Compose now depends on Compose 1.5.1.

Version 2.7.1

Version 2.7.1

۲۳ آگوست ۲۰۲۳

androidx.navigation:navigation-*:2.7.1 is released. Version 2.7.1 contains these commits.

رفع اشکالات

  • Fixed an issues in Navigation with Compose where when using a Scaffold it was possible to get an error for trying to access a Lifecycle.State.DESTROYED ViewModel . ( I1dc11 , b/268422136 )

نسخه ۲.۷.۰

نسخه ۲.۷.۰

۹ آگوست ۲۰۲۳

androidx.navigation:navigation-*:2.7.0 is released. Version 2.7.0 contains these commits.

Important changes since 2.6.0

Animations from Accompanist

Now that AnimatedContent is stable, we were able to move the code from Accompanist Navigation Animation back into Navigation Compose itself.

This means all of the support for setting custom transitions that existed in AnimatedNavHost is directly supported in NavHost .

No additional changes will be made to Accompanist Navigation Animation and we'll be formally deprecating it soon, along with guidance on how to migrate back to Navigation Compose itself, but it'll be the inverse of the migration guide with no other API changes required if you're already using the latest Accompanist alpha ( 0.31.2-alpha ). ( b/197140101 )

رفع اشکالات

  • NavHost in Navigation Compose now correctly intercepts system back calls even after the Activity has been STOPPED and RESUMED. ( Icb6de , b/279118447 )

به‌روزرسانی‌های وابستگی

  • Navigation now depends on Compose 1.5.0 up from 1.1.0 .

Version 2.7.0-rc01

۲۶ ژوئیه ۲۰۲۳

androidx.navigation:navigation-*:2.7.0-rc01 is released. Version 2.7.0-rc01 contains these commits.

رفع اشکالات

  • Fixed an issue where the EnterTransition and ExitTransition lambdas created as part of the NavHost could potentially remain in memory even after the NavHost is removed from composition. ( I893d0 )

مشکلات شناخته شده

  • There is an issue from Navigation 2.6.x that when navigating with popUpTo it is possible to cause an IllegalArgumentException . It is possible that this exception can be avoided by restructuring your graph, similar to the advice suggested here . ( b/287133013 )

Version 2.7.0-beta02

۲۸ ژوئن ۲۰۲۳

androidx.navigation:navigation-*:2.7.0-beta02 is released. Version 2.7.0-beta02 contains these commits.

رفع اشکالات

  • Navigation Compose now has the right z-order for custom transitions that use navigate with the popUpTo option.( /Ib1c3a , b/285153947 )

Version 2.7.0-beta01

۷ ژوئن ۲۰۲۳

androidx.navigation:navigation-*:2.7.0-beta01 is released. Version 2.7.0-beta01 contains these commits.

رفع اشکالات

  • NavHost in Navigation Compose now correctly intercepts system back calls even after the Activity has been STOPPED and RESUMED . ( Icb6de , b/279118447 )

Version 2.7.0-alpha01

۲۴ مه ۲۰۲۳

androidx.navigation:navigation-*:2.7.0-alpha01 is released. Version 2.7.0-alpha01 contains these commits.

Animations from Accompanist

Now that AnimatedContent is stable, we were able to move the code from Accompanist Navigation Animation back into Navigation Compose itself.

This means all of the support for setting custom transitions that existed in AnimatedNavHost is directly supported in NavHost .

No additional changes will be made to Accompanist Navigation Animation and we'll be formally deprecating it soon, along with guidance on how to migrate back to Navigation Compose itself, but it'll be the inverse of the migration guide with no other API changes required if you're already using the latest Accompanist alpha ( 0.31.2-alpha ). ( b/197140101 )

رفع اشکالات

  • From Navigation 2.6.0-rc02 : Fixed an issue with Navigation in Fragments where navigating with popUpTo and popping a fragment off the back stack without recreating its view would cause system back to stop working. ( Ieb8d4 , b/281726455 )

به‌روزرسانی‌های وابستگی

  • Navigation now depends on Compose 1.5.0-beta01 .

نسخه ۲.۶.۰

نسخه ۲.۶.۰

۷ ژوئن ۲۰۲۳

androidx.navigation:navigation-*:2.6.0 is released. Version 2.6.0 contains these commits.

Important changes to Navigation since 2.5.0

  • NavBackStackEntry 's arguments and the arguments passed to an OnDestinationChangedListener are now only a copy of the immutable arguments that were created when you navigated to the destination. This means any changes made to those Bundles will not be reflected in subsequent accesses to the arguments or other OnDestinationChangedListener instances.
  • NavDeepLink now supports default values for arrays, which allows support for repeated query params that will map to the argument's array type. NavType also now includes a default method which can be overridden to combine two parsed values.
  • Custom subclasses of NavType can now override serializeAsValue to serialize a value into a String, allowing both serialization and deserialization (via parseValue ) to be entirely encapsulated in the NavType class. StringType now overrides this method to call Uri.encode on the given String .

Important changes to Navigation Compose since 2.5.0

  • When previewing a composable with NavHost , it will now show the NavGraph's startDestination by default.
  • NavController.popBackStack(route) , NavController.getBackStackEntry(route) , NavController.clearBackStack(route) now all support routes with arguments partially or fully filled in. Note that the arguments have to be an exact match with the entry's arguments.
  • Attempting to create an empty NavDeepLink using the navDeepLink Kotlin DSL will now result in a lint warning indicating that a deep link needs an uri, action, and/or mimetype to be valid.

Important changes to Navigation with Fragments since 2.5.0

  • NavHostFragment no longer intercepts the system back button itself. This allows the underlying FragmentManager to handle system back. This allows Fragment 1.7.0-alpha01 and higher to provide an In-App Predictive Back animation on Android U devices.
  • When using Navigation with Fragments, attempting to manually do a FragmentTransaction that adds a fragment to the FragmentManager 's back stack will now throw an IllegalArgumentException . You should always add fragments via the navigate() API.
  • When using the exact string ${applicationId} as the placeholder in the app:data and app:dataPattern attributes in the activity element of a navigation XML file, the placeholder will be automatically filled in with the packageName of the context upon inflation.
  • The FragmentNavigator now uses the transition APIs when navigating and popping NavBackStackEntries . This means that the NavBackStackEntry Lifecycle will now wait for the entering and exiting fragment special effects to complete before moving their final Lifecycle.State .
  • The DialogFragmentNavigator now uses the transition APIs when navigating and popping NavBackStackEntries . This means that the NavBackStackEntry Lifecycle will now wait for the DialogFragment Lifecycle to move to DESTROYED before moving to DESTROYED itself.
  • NavHostFragment now allows you to retrieve the NavController as soon as the NavHostFragment is attached to the FragmentManager , rather than only after onCreate() .
  • Navigation's support for Dynamic Feature Modules now depend on the granular Play Feature Delivery Library.
  • Navigation Safe Args now depends on Android Gradle Plugin version 7.3.0. This means it is now only compatible with versions 7.3.0+.

Important changes to NavigationUI since 2.5.0

  • When passing the ID of a navigation graph to AppBarConfiguration (such as via a Menu ), NavigationUI now only considers the start destination of that navigation graph as a top level destination, rather than incorrectly marking every destination within the graph as a top level destination. The behavior of passing the ID of an individual destination is unchanged. This same functionality is available to your own code via the new isTopLevelDestination function on AppBarConfiguration .
  • The setupWithNavController integrations in NavigationUI for working with the top app bar will now parse R.string values for ReferenceType arguments found in your android:label into their String values instead of outputting the auto-generated resource integer.
  • NavigationUI now provides logs when it fails to navigate via a selected MenuItem .

Version 2.6.0-rc02

۲۴ مه ۲۰۲۳

androidx.navigation:navigation-*:2.6.0-rc02 is released. Version 2.6.0-rc02 contains these commits.

رفع اشکالات

  • Fixed an issue with Navigation in Fragments where navigating with popUpTo and popping a fragment off the back stack without recreating its view would cause system back to stop working. ( Ieb8d4 , b/281726455 )

Version 2.6.0-rc01

۱۰ مه ۲۰۲۳

androidx.navigation:navigation-*:2.6.0-rc01 is released. Version 2.6.0-rc01 contains these commits.

رفع اشکالات

  • Fixed an issue in Navigation with fragments where removing a fragment via navigate with popUpTo in its onResume() lifecycle callback would cause an IllegalStateException . ( I21884 , b/279644470 )

Version 2.6.0-beta01

۱۹ آوریل ۲۰۲۳

androidx.navigation:navigation-*:2.6.0-beta01 is released. Version 2.6.0-beta01 contains these commits.

ویژگی‌های جدید

  • NavBackStackEntry now provides a custom toString implementation. ( Iff00b )

رفع اشکالات

  • When using Navigation with Fragments, attempting to manually do a FragmentTransaction that adds a fragment to the FragmentManager 's back stack will now throw an IllegalArgumentException . You should always add fragments via the navigate() API. ( I6d38e )
  • When there is a navigate that adds an entry and a popBackStack that removes it in the same frame, the resulting top entry on the back stack will now consistently make it back to the RESUMED Lifecycle.State . ( Id8067 , b/276495952 )

Version 2.6.0-alpha09

۵ آوریل ۲۰۲۳

androidx.navigation:navigation-*:2.6.0-alpha09 is released. Version 2.6.0-alpha09 contains these commits.

رفع اشکالات

  • Fixed checks for invalid route such that if a NavDestination contains non-nullable NavArgument , this destination's route must contain placeholders for args named the same as the non-nullable NavArgument . ( Ic62bf , b/274697949 )
  • Deeplink navigations based on Action/MimeType will now fail if the navigation operation is missing a non-nullable NavArgument required by the NavDestination that the Action/MimeType matches with. ( Ibfa17 , b/271777424 )
  • When NavController sets a graph with the same route and destinations as the previous graph, it now properly replaces its current graph nodes and its back stack destinations with new instances. This fixes a crash when using onLaunchSingleTop without saving state in Navigation Compose. This also fixes an error where navigating to destinations associated with the root graph builds and incorrect back stack. ( I5bc58 , b/275258161 , b/275407804 )

Version 2.6.0-alpha08

۲۲ مارس ۲۰۲۳

androidx.navigation:navigation-*:2.6.0-alpha08 is released. Version 2.6.0-alpha08 contains these commits.

ویژگی‌های جدید

  • NavHostFragment now allows you to retrieve the NavController as soon as the NavHostFragment is attached to the FragmentManager , rather than only after onCreate() . ( Ic6382 , b/220186282 )

رفع اشکالات

  • Fixed a NullPointerException when popping a nested graph that includes a non-nullable argument. ( 6b3581 , b/249988437 )
  • When using system back after doing a navigate with popUpTo , the state of the NavController will pop to the correct entry. ( I3a8ec , b/270447657 )
  • FragmentNavigator will now properly pop entries when the back stack is popped via system back or popBackStack() and whether or not the transaction uses effects for the fragment. ( I81bdf )
  • Adding fragments to the FragmentNavigator 's FragmentManager without using navigation will no longer cause a crash. ( b17204 , b/274167493 )

به‌روزرسانی‌های وابستگی

Version 2.6.0-alpha07

۸ مارس ۲۰۲۳

androidx.navigation:navigation-*:2.6.0-alpha07 is released. Version 2.6.0-alpha07 contains these commits.

رفع اشکالات

  • The getBackStackEntry , popBackStack , clearBackStack API variants that take routes now take route patterns with nullable arguments and nullable query params ( I22294 , b/269302500 )
  • Fixed an issue where calling clearBackStack() from the NavController would not clear the saved state in the fragment manager associated with the cleared back stack. ( Ic1cce , b/271190202 )
  • Fixed a regression in 2.6.0-alpha06 that caused the wrong MenuItem in the BottomNavigationView to be highlighted when using System back between tabs. ( I634f6 , b/270447657 )
  • Fixed regression in 2.6.0-alpha06 that caused NavBackStackEntry s not to be moved to the RESUMED state when using Animation s. ( Ib3589 , b/269646882 )

Version 2.6.0-alpha06

۲۲ فوریه ۲۰۲۳

androidx.navigation:navigation-*:2.6.0-alpha06 is released. Version 2.6.0-alpha06 contains these commits.

ویژگی‌های جدید

  • When previewing a composable with NavHost , it will now show the NavGraph's startDestination by default. ( I2b89f )

تغییرات API

  • All NavController navigate overloads are now annotated with @MainThread to ensure that they are called on the main thread. ( I2c0b0 , b/263427111 )

رفع اشکالات

  • Fixed a crash when attempting to navigate while using Dynamic Fragment Navigation. ( I3ee29 , b/268360479 )
  • Fixed bug where navigating to another fragment via system back button does not update bottom bar to the correct selected item ( If559f , b/269044426 )

مشکلات شناخته شده

  • When using Navigation with Fragments, the NavBackStackEntry 's Lifecycle fails to reach RESUMED when using Animation APIs. ( b/269646882 )
  • When using Navigation with Fragments, and navigating with BottomNavigation , if you attempt to restore a back stack with multiple entries, the BottomMenuItem is not correctly updated. ( b/270447657 )
  • When using Navigation with Fragments, after restoring the state the NavBackStackEntry Lifecycle does not get DESTROYED when its fragment is DESTROYED . ( b/270610768 )

Version 2.6.0-alpha05

۸ فوریه ۲۰۲۳

androidx.navigation:navigation-*:2.6.0-alpha05 is released. Version 2.6.0-alpha05 contains these commits.

ویژگی‌های جدید

  • NavController.popBackStack(route) , NavController.getBackStackEntry(route) , NavController.clearBackStack(route) now all support routes with arguments partially or fully filled in. Note that the arguments have to be an exact match with the entry's arguments. ( Iebd28 , Ic678c , I3b37b , b/257514373 )
  • The FragmentNavigator now uses the transition APIs when navigating and popping NavBackStackEntries . This means that the NavBackStackEntry Lifecycle will now wait for the entering and exiting fragment special effects to complete before moving their final Lifecycle.State . ( I3cb19 , b/238686802 )
  • The DialogFragmentNavigator now uses the transition APIs when navigating and popping NavBackStackEntries . This means that the NavBackStackEntry Lifecycle will now wait for the DialogFragment Lifecycle to move to DESTROYED before moving to DESTROYED itself. ( I53ee5 , b/261213893 )

تغییرات API

  • NavigatorState now provides the prepareForTransition API to allow Navigator s to move NavBackStackEntries to intermediate Lifecycle.State s. ( I42c21 , b/238686802 )
  • You can now access the back stack associated with a NavGraphNavigator or a ComposeNavigator via a backstack property. ComposeNavigator also now exposes the onTransitionComplete() callback to mark a NavBackStackEntry that has executed a navigate or popBackStack operation as complete. ( I02062 , I718db , b/257519195 )

رفع اشکالات

  • Navigator state will now no-op when using the push/popWithTransition APIs and the entry is already being handled. ( Iadbfa , b/261213893 )
  • When using launchSingleTop with a nested NavGraph all destinations starting from original destination to its startDestination will only be properly added to the top of the backstack. ( Id4bea , b/253256629 )
  • Navigation will now properly replace the DialogFragment instance when navigating to the same destination with the launchSingleTop flag set to true. ( I45b5a , b/149572817 )
  • Navigation SafeArgs will no longer cause a compilation error when using arguments that are exactly 19 characters long. ( Id60bc , b/257110095 )

Version 2.6.0-alpha04

۹ نوامبر ۲۰۲۲

androidx.navigation:navigation-*:2.6.0-alpha04 is released. Version 2.6.0-alpha04 contains these commits.

ویژگی‌های جدید

  • Custom subclasses of NavType can now override serializeAsValue to serialize a value into a String, allowing both serialization and deserialization (via parseValue ) to be entirely encapsulated in the NavType class. StringType now overrides this method to call Uri.encode on the given String . ( Ie5213 , b/247637434 )
  • NavigationUI now provides logs when it fails to navigate via a selected MenuItem . ( I2af5a , b/247730357 )

رفع اشکالات

  • Navigation deep links are now parsed lazily instead of on graph initialization which could improve app performance at start up. ( Iab0ab )
  • Fixed crash caused by navigating up after deep linking to a destination with null default arguments. ( I51c24 , b/243183636 )

Dependency Update

  • Navigation's support for Dynamic Feature Modules now depend on the granular Play Feature Delivery Library. ( Ib4ddc )
  • Navigation Safe Args now depends on Android Gradle Plugin version 7.3.0. This means it is now only compatible with versions 7.3.0+. ( I47e49 )

Version 2.6.0-alpha03

۲۴ اکتبر ۲۰۲۲

androidx.navigation:navigation-*:2.6.0-alpha03 is released. Version 2.6.0-alpha03 contains these commits.

رفع اشکالات

  • From Navigation 2.5.3 : NavHost will no longer cause a NoSuchElementException when there is no destination available for the Crossfade to compose. It will now just skip the composition. ( Ieb46e , b/253299416 )
  • From Navigation 2.5.3 : Fixed an issue where saved Compose state (eg, usages of rememberSaveable ) were not being forgotten and removed when a destination was popped off the back stack. ( I64949 )

به‌روزرسانی‌های وابستگی

Version 2.6.0-alpha02

۵ اکتبر ۲۰۲۲

androidx.navigation:navigation-*:2.6.0-alpha02 is released. Version 2.6.0-alpha02 contains these commits.

تغییرات رفتاری

  • When passing the ID of a navigation graph to AppBarConfiguration (such as via a Menu ), NavigationUI now only considers the start destination of that navigation graph as a top level destination, rather than incorrectly marking every destination within the graph as a top level destination. The behavior of passing the ID of an individual destination is unchanged. This same functionality is available to your own code via the new isTopLevelDestination function on AppBarConfiguration . ( Ie936e , b/238496771 )

رفع اشکالات

  • The navigation:navigation-fragment component now depends on Fragment version 1.5.2 . ( I00ba4 )
  • The selected menu item will no longer be updated when navigating to a FloatingWindow destination such as a dialog. ( I4cde8 , b/240308330 )

Version 2.6.0-alpha01

۷ سپتامبر ۲۰۲۲

androidx.navigation:navigation-*:2.6.0-alpha01 is released. Version 2.6.0-alpha01 contains these commits.

ویژگی‌های جدید

  • The setupWithNavController integrations in NavigationUI for working with the top app bar will now parse R.string values for ReferenceType arguments found in your android:label into their String values instead of outputting the auto-generated resource integer. ( I5f803 , b/167959935 )
  • NavDeepLink now supports default values for arrays, which allows support for repeated query params that will map to the argument's array type. NavType also now includes a default method which can be overridden to combine two parsed values. ( Id68c3 , b/209977108 )
  • When using the exact string ${applicationId} as the placeholder in the app:data and app:dataPattern attributes in the activity element of a navigation XML file, the placeholder will be automatically filled in with the packageName of the context upon inflation. ( Iaabde , b/234223561 )
  • Attempting to create an empty NavDeepLink using the navDeepLink Kotlin DSL will now result in a lint warning indicating that a deep link needs an uri, action, and/or mimetype to be valid. ( I08d2f , b/154038883 )

تغییرات API

  • Added new NavDestination extension function to parse dynamic labels with arguments in the form of android:label="{arg}" into String. Supports ReferenceType arguments by parsing R.string values into their String values. ( I07d89 , b/236269380 )

تغییرات رفتاری

  • NavBackStackEntry's arguments and the arguments passed to an OnDestinationChangedListener are now only a copy of the immutable arguments that were created when you navigated to the destination. This means any changes made to those Bundles will not be reflected in subsequent accesses to the arguments or other OnDestinationChangedListener instances. ( I676f5 )

رفع اشکالات

  • From Navigation 2.5.2 : Dynamic Navigation now properly attempts to install Activity destinations from other modules before navigating to them. ( Ia2c16 , b/240292838 )
  • From Navigation 2.5.2 : Navigation will now properly replace the Fragment instance when navigating to the same destination and setting the launchSingleTop flag to true. ( I5a2f1 , b/237374580 )
  • From Navigation 2.5.2 : Fixed IllegalStateException caused by navigating to a double nested graph that shares a parent with a new popped start destination. ( I9f7cb , b/243778589 )

Version 2.5

Version 2.5.3

۲۴ اکتبر ۲۰۲۲

androidx.navigation:navigation-*:2.5.3 is released. Version 2.5.3 contains these commits.

رفع اشکالات

  • NavHost will no longer cause a NoSuchElementException when there is no destination available for the Crossfade to compose. It will now just skip the composition. ( Ieb46e , b/253299416 )
  • Fixed an issue where saved Compose state (eg, usages of rememberSaveable ) were not being forgotten and removed when a destination was popped off the back stack. ( I64949 )

نسخه ۲.۵.۲

۷ سپتامبر ۲۰۲۲

androidx.navigation:navigation-*:2.5.2 is released. Version 2.5.2 contains these commits.

رفع اشکالات

  • Dynamic Navigation now properly attempts to install Activity destinations from other modules before navigating to them. ( Ia2c16 , b/240292838 )
  • Navigation will now properly replace the Fragment instance when navigating to the same destination and setting the launchSingleTop flag to true. ( I5a2f1 , b/237374580 )
  • Fixed IllegalStateException caused by navigating to a double nested graph that shares a parent with a new popped start destination. ( I9f7cb , b/243778589 )

Dependency Update

نسخه ۲.۵.۱

۲۷ ژوئیه ۲۰۲۲

androidx.navigation:navigation-*:2.5.1 is released. Version 2.5.1 contains these commits.

رفع اشکالات

  • Navigation Safe Args will no longer cause deprecation warnings in generated classes when using custom argument types that are saved in a Bundle . ( Id86ed , b/237725966 )

به‌روزرسانی‌های وابستگی

نسخه ۲.۵.۰

۲۹ ژوئن ۲۰۲۲

androidx.navigation:navigation-*:2.5.0 is released. Version 2.5.0 contains these commits.

Important changes since 2.4.0

  • CreationExtras Integration - Navigation now has the ability to provide a stateless ViewModelProvider.Factory via Lifecycle 2.5.0 's CreationExtras .

Navigation SafeArgs

  • Navigation Safe Args has upgraded the Android Gradle Plugin dependency to rely on 7.0.4 , dropping compatibility for AGP versions before 7.0 .
  • Added support for the namespace build.gradle attribute to be used instead of applicationId.

Other Changes

  • The visibleEntries API is no longer experimental and provides a function to retrieve all of the entries whose destination is currently visible according to the NavController .

Version 2.5.0-rc02

۱۵ ژوئن ۲۰۲۲

androidx.navigation:navigation-*:2.5.0-rc02 is released. Version 2.5.0-rc02 contains these commits.

رفع اشکالات

  • Fixed a crash caused by fast switching between bottom destinations when using the Navigation Compose NavHost . ( I3979a , b/234054916 )
  • Navigation SafeArgs will no longer crash when using an applicationIdSuffix and namespace with either no applicationId present, or when the applicationId and namespace differ. ( I754b1 , b/233119646 )
  • NavArgument now has a custom toString() function to show the internal values of the argument. ( I900a8 )

Version 2.5.0-rc01

۱۱ مه ۲۰۲۲

androidx.navigation:navigation-*:2.5.0-rc01 is released. Version 2.5.0-rc01 contains these commits.

ویژگی‌های جدید

  • Added a new lint rule to warn against placing <deeplink> elements inside <activity> elements in your navigation.xml file.( Ic15a5 , b/178403185 )

رفع اشکالات

  • Composable scopes in NavHost and DialogHost are now disposed in the expected order, ie inner composabled are disposed before outer composables. ( I157e6 )
  • Navigation SafeArgs now uses PathSensitivity.RELATIVE in the ArgumentsGenerationTask to allow for cache relocatability. This means the cache entry can now be re-used from a CI build to a local build. ( I5f67c , b/173420454 )
  • The UnrememberedGetBackStackEntryDetector lint rule has been updated to ensure that the remember call surrounding the call to getBackStackEntry() also passes in a NavBackStackEntry object as a key.( Ib7081 , b/227382831 )

Version 2.5.0-beta01

۲۰ آوریل ۲۰۲۲

androidx.navigation:navigation-*:2.5.0-beta01 is released. Version 2.5.0-beta01 contains these commits.

رفع اشکالات

  • DialogNavigator now uses popWithTransition when executing a dismiss() call. This fixes a race condition when using a ViewModel within dialog destination that would cause an IllegalStateException when dismissing the Dialog by either using system back or tapping outside of the dialog to exit. ( Id7376 , b/226552301 )

به‌روزرسانی‌های وابستگی

  • Navigation now depends on Lifecycle 2.5.0-beta01 , fixing an IllegalStateException when nesting one NavHost within another NavHost in a non-primary bottom navigation tab when using multiple back stacks.

Version 2.5.0-alpha04

۶ آوریل ۲۰۲۲

androidx.navigation:navigation-*:2.5.0-alpha04 is released. Version 2.5.0-alpha04 contains these commits.

تغییرات API

رفع اشکالات

  • NavHost now depend on visibleEntries from the NavController to determine which entries to compose. This means that when using nested NavHost the inner NavHost should now properly animate out. ( I4ba2b , b/225394514 )
  • The visibleEntries StateFlow provided by NavController is now based on the entry max Lifecycle state instead of the current Lifecycle state. This means that even if the host lifecycle of the navController goes below STARTED, the list of visible entires will remain the same. ( I9e2a8 , b/225394514 )
  • SavedStateViewFactory now supports using CreationExtras even when it was initialized with a SavedStateRegistryOwner . If extras are provided, the initialized arguments are ignored. ( I6c43b , b/224844583 )
  • NavDeepLink can now parse Uris with a single query parameter with no value. ( I0efe8 , b/148905489 )
  • Empty string are now considered as valid arguments in deep links. ( I70a0d , b/217399862 )
  • Navigation Safe Args will no longer crash when using namespaces and no AndroidManifest.xml is present. ( I17ccf , b/227229815 )

Version 2.5.0-alpha03

۲۳ فوریه ۲۰۲۲

androidx.navigation:navigation-*:2.5.0-alpha03 is released. Version 2.5.0-alpha03 contains these commits.

تغییرات API

  • You can now pass in CreationExtras to by navGraphViewModels to create a ViewModel . ( I29217 , b/217618359 )

رفع اشکالات

  • NavDeepLinks now properly support encoded new line characters embedded in routes/deep link URIs. ( I513d1 , b/217815060 )
  • CreationExtras will now work correctly when used with NavBackStackEntries to create ViewModels. ( I69161 , b/217617710 )
  • Navigation Safe Args now supports using the namespace defined in the build.gradle in place of the package in the AndroidManifest. ( I659ef , b/217414933 )

Version 2.5.0-alpha02

۹ فوریه ۲۰۲۲

androidx.navigation:navigation-*:2.5.0-alpha02 is released. Version 2.5.0-alpha02 contains these commits.

رفع اشکالات

  • From Navigation 2.4.1 : The NavHostFragment will now properly set the OnBackPressedDispatcher when using viewbinding with nested graphs. ( Ifbb51 , b/214577959 )
  • From Navigation 2.4.1 : When deep linking through multiple nested NavGraph s the back stack will now properly include intermediate start destinations. ( I504c0 , b/214383060 )

Version 2.5.0-alpha01

۲۶ ژانویه ۲۰۲۲

androidx.navigation:navigation-*:2.5.0-alpha01 is released. Version 2.5.0-alpha01 contains these commits.

ویژگی‌های جدید

رفع اشکالات

  • Fixed an issue where accessing a ViewModel created via by navGraphViewModels() from a Fragment's onCreate() would fail with an IllegalStateException . ( I8a14d )
  • NavDeepLink s will no longer unnecessarily decode args twice, meaning that the proper args are now passed to your final destination. ( I31b0a , b/210711399 )

Safe Args

  • Safe Args now depends on Android Gradle Plugin version 7.0.4. This means that Navigation Safe Args will no longer be compatible with Android Studio versions prior to 7.0, but is now compatible with Android Gradle Plugin 7.1.0 and higher. ( I41c88 , b/213086135 , b/207670704 )

Version 2.4.2

Version 2.4.2

۶ آوریل ۲۰۲۲

androidx.navigation:navigation-*:2.4.2 is released. Version 2.4.2 contains these commits.

رفع اشکالات

Version 2.4.1

Version 2.4.1

۹ فوریه ۲۰۲۲

androidx.navigation:navigation-*:2.4.1 is released. Version 2.4.1 contains these commits.

رفع اشکالات

  • The NavHostFragment will now properly set the OnBackPressedDispatcher when using viewbinding with nested graphs. ( Ifbb51 , b/214577959 )
  • When deep linking through multiple nested NavGraph s the back stack will now properly include intermediate start destinations. ( I504c0 , b/214383060 )
  • Backported from Navigation 2.5.0-alpha01 : Fixed an issue where accessing a ViewModel created via by navGraphViewModels() from a Fragment's onCreate() would fail with an IllegalStateException . ( I8a14d )
  • Backported from Navigation 2.5.0-alpha01 : NavDeepLink s no longer unnecessarily decode args twice, meaning that the properly decoded args are now passed to your final destination. ( I31b0a , b/210711399 )
  • Backported from Navigation 2.5.0-alpha01 : Safe Args now depends on Android Gradle Plugin version 7.0.4. This means that Navigation Safe Args will no longer be compatible with Android Studio versions prior to 7.0, but is now compatible with Android Gradle Plugin 7.1.0 and higher. ( I41c88 , b/213086135 , b/207670704 )

Version 2.4.0

Version 2.4.0

۲۶ ژانویه ۲۰۲۲

androidx.navigation:navigation-*:2.4.0 is released. Version 2.4.0 contains these commits.

Important changes since 2.3.0

  • All Navigation artifacts have been rewritten in Kotlin. This has improved the nullability of classes using generics (such as NavType subclasses). All Kotlin extension functions that used to be part of the -ktx artifacts have been moved to their respective main artifacts. The -ktx artifacts will continue to be published, but are completely empty.
  • The navigation-fragment artifact now contains a prebuilt implementation of a two pane layout via the new AbstractListDetailFragment . This fragment uses a SlidingPaneLayout to manage a list pane (which your subclass provides) and a detail pane, which uses a NavHostFragment as its implementation, as seen in our example implementation .
  • The currentBackStackEntryAsFlow() method on NavController provides a Flow that emits whenever the current NavBackStackEntry changes. This flow can be used as an alternative to manually managing an OnDestinationChangedListener .
  • NavController now offers the ability to retrieve a list of all visible NavBackStackEntry instances as a StateFlow via the experimental visibleEntries property.
  • It is now possible to extend the NavType class to create custom NavTypes. Custom types are supported only when building your navigation graph programmatically, such as via the Navigation Graph Kotlin DSL .

  • Navigation now provides findStartDestination() and getHierarchy() APIs that can be used to help implement custom NavigationUI. findStartDestination() is an extension function on NavGraph that will locate the actual start destination that will be displayed when you navigate to the graph, even if the startDestination is itself a nested NavGraph . getHierarchy() is a function on NavDestination that can be used to verify if a given destination is within the hierarchy of another.

    val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }

  • NavigationUI methods that took a BottomNavigationView have been updated to instead take its superclass introduced in Material 1.4.0 , NavigationBarView . This allows these methods to be used with the NavigationRailView .

  • When inflating an <action> element via XML, animation attributes can use attributes pulled from your theme using the app:enterAnim="?attr/transitionEnter" syntax.

  • Safe Args now generates a fromSavedStateHandle() method for each NavArgs class. ( #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)
}

Navigation Routes and the Kotlin DSL

Previous versions of Navigation relied on each destination having a constant integer ID that would uniquely identify it from its sibling destinations and allow you to navigate() to that destination either directly or via an action. While this continues to be valid and useful, particularly in cases where you are defining your navigation graph in XML and can use auto-generated R.id constants or Safe Args (which uses those constants to generate code at build time), this system of unique integers did not capture the semantic meaning and expressiveness needed to support fully dynamic graphs built programmatically at runtime via the Navigation Kotlin DSL .

This release introduces a new option for uniquely identifying a destination in a navigation graph by its route . A route is a String that defines the unique path to a destination. All Kotlin DSL methods that took a destination ID are now deprecated and replaced with an equivalent API that takes a route.

Each route should be treated as the 'path' part of a Uri that defines that destination, eg, home , profile/{userId} , profile/{userId}/friends , etc. When the identity of a destination is associated with a specific piece of content, those dynamic arguments should be part of the route, following the same rules as implicit deep links .

All NavController APIs that used to only take an ID now have an overload that takes a route String . This includes navigate() , popBackStack() , popUpTo() , and getBackStackEntry() .

This has had some API implications:

  • The popUpTo Kotlin property on the Kotlin DSL has been deprecated in favor of popUpToId .
  • The getStartDestination() API has been deprecated in favor of getStartDestinationId() .

Unlike when navigating by ID, navigating by route follows the same rules as implicit deep links in that you can directly navigate to any destination in any nested graph, ensuring that these routes are usable in multi-module projects without explicitly adding an externally visible deep link to each destination.

Navigation Compose

The navigation-compose artifact provides integration between the Navigation Component and Jetpack Compose . It uses @Composable functions as the destinations in your application.

This release provides:

  • A NavHost composable that allows you to construct your navigation graph via a Kotlin DSL, using composable and dialog destinations, plus support for optional Navigators such as those from Accompanist Navigation Material .
  • Mandatory support for crossfading between destinations. Accompanist Navigation Animation can be used to control the enter and exit transitions using experimental Compose APIs.
  • Scoping of a Lifecycle to each composable destination. Each destination only reaches the RESUMED state when any entering transitions finish and immediately drops to STARTED when any exiting transitions start, thus allowing you to avoid all IllegalStateException and multi-touch issues by only triggering a navigate call when the Lifecycle is RESUMED .
  • Scoping of ViewModel (via the viewModel() API of Lifecycle ViewModel Compose 2.4.0 or hiltViewModel() of Hilt Navigation Compose 1.0.0 at the destination level, providing a scope that survives configuration changes and being on the back stack (when your Composable content is otherwise disposed) and a signal in the ViewModel's onCleared() that indicates the permanent disposal and cleaning up of state associated with that NavBackStackEntry .
  • Scoping of rememberSaveable state at a destination level, ensuring that all composable state is saved and restored automatically when you return to a destination.
  • Full support for saving and restoring the state of the NavController and its destination's state after process death and recreation.
  • Automatic integration with the system back button.

  • Support for passing arguments, attaching deep links to destinations, and returning a result to previous destinations.

  • Compose specific helpers in rememberNavController() and currentBackStackEntryAsState() to allow hoisting state and connecting the NavController to composables outside of the NavHost (such as a bottom navigation bar). 

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()
        }
    }
}

See the Compose Navigation guide for more information.

Multiple back stacks

The NavController is responsible for managing the back stack of destinations, adding destinations to the back stack when you navigate() to them and removing them when you call popBackStack() or trigger the system back button. The existing NavOptions class and the integration into <action> elements in the navigation graph XML has been expanded to support saving and restoring the back stack.

As part of this change, the NavigationUI methods of onNavDestinationSelected() , BottomNavigationView.setupWithNavController() and NavigationView.setupWithNavController() now automatically save and restore the state of popped destinations, enabling support for multiple back stacks without any code changes. When using Navigation with Fragments, this is the recommended way to integrate with multiple back stacks.

The underlying APIs for saving and restoring the state are exposed via a number of surfaces:

  • In Navigation XML, the <action> element can now use the boolean attributes of app:popUpToSaveState and app:restoreState to save the state of any destinations popped via app:popUpTo and restore the state associated with the destination passed as the 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” />

  • In the navOptions Kotlin DSL , you can add the restoreState boolean property and the saveState boolean property on the popUpTo builder : 

    // Use the navigate() method that takes a navOptions DSL Builder
navController.navigate(selectedBottomNavRoute) {
  launchSingleTop = true
  restoreState = true
  popUpTo(navController.graph.findStartDestination().id) {
    saveState = true
  }
}

  • In manually building a NavOptions object via the NavOptions.Builder , you can use the setRestoreState() and new overload to setPopUpTo() that takes an additional saveState parameter. 

    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);

  • Programmatic calls to popBackStack() can now include an additional saveState parameter.

  • You can use the clearBackStack() method to clear any state that was saved with popBackStack() or popUpToSaveState .

In all cases, the NavController will save and restore the state of each NavBackStackEntry , including any navigation destination scoped ViewModel instances. The Navigator APIs have been updated to enable each Navigator to support saving and restoring their own state.

Behavior changes

  • NavDeepLinkBuilder now adds PendingIntent.FLAG_IMMUTABLE to the PendingIntent returned by createPendingIntent() , ensuring that this API works as expected when targeting Android 12.
  • Navigation now depends on Lifecycle 2.3.1 and now marks setGraph() , popBackStack() , navigateUp() , and navigate() , the methods that update the NavBackStackEntry Lifecycle , as @MainThread , aligning Navigation with the main thread enforcement introduced in Lifecycle 2.3.0 .
  • Deep links now verify that all required arguments (those without default values) are present in the Uri .
  • NavDeepLink parsed arguments now consider pound signs in the same way as question marks as a separator between path segments, preventing an argument from spanning across the pound sign.
  • When generating actions, Kotlin code generated from Safe Args now puts arguments without default values before those with default values as parameters.
  • When generating arguments, Safe Args now puts parameters without default values before those with default values.
  • Safe-Args now depends on Android Gradle Plugin 4.2.0. This means you should no longer get the using applicationIdTextResource warning.

مشکلات شناخته شده

  • Fixed in Navigation 2.5.0-alpha01 : accessing a ViewModel created via by navGraphViewModels() from a Fragment's onCreate() will fail with an IllegalStateException . ( b/213504272 )
  • Fixed in Navigation 2.5.0-alpha01 : Safe Args 2.4.0 is incompatible with Android Gradle Plugin 7.1.0 and higher. ( b/213086135 )
  • Deep linking with multiple nested nav graphs doesn't correctly create the full backstack. ( b/214383060 )

Version 2.4.0-rc01

۱۵ دسامبر ۲۰۲۱

androidx.navigation:navigation-*:2.4.0-rc01 is released. Version 2.4.0-rc01 contains these commits.

Behavior changes

  • NavDeepLink parsed arguments now consider pound signs in the same way as question marks as a separator between arguments. ( I21309 , b/180042703 )

رفع اشکالات

  • Deeplinks will no longer ignore arguments with values that are the same as the name of the placeholder. ( If8017 , b/207389470 )
  • NavController will no longer crash when popping a nested destination using transitions after the NavController has been restored. ( I0f7c9 , b/205021623 )
  • The error message when using an invalid startDestination will now default to the start destination's route if one is available. ( I86b9d , b/208041894 )

Navigation Compose Bug Fixes

  • Fixed potential crash caused by fast switching between the start destination and another destination using bottom nav menu items. ( Ic8976 , b/208887901 )
  • Dialog destination are now properly restored on top of the screen after config changes or process death. ( I4c0dc , b/207386169 )
  • Fixed an issue where attempting to retrieve a ViewModel from a dialog's NavBackStackEntry would fail when the dialog was dismissed. ( I6b96d , b/206465487 )
  • Fixed an issue when using activity destinations with Navigation Compose's NavHost that would result in infinite recompositions. ( I8f64c )
  • Fixed a leak in Navigation Compose where it was holding on to a reference of the old activity after a config change or process death. ( I4efcb , b/204905432 )

Safe Args Bug Fixes

  • SafeArgs no longer crashes when attempting to restore custom parcelable arrays after process death. ( I618e8 , b/207315994 )
  • Fixed a bug in safe args that would not allow boolean arrays to have a null value. ( I8c396 , b/174787525 )

Version 2.4.0-beta02

۳ نوامبر ۲۰۲۱

androidx.navigation:navigation-*:2.4.0-beta02 is released. Version 2.4.0-beta02 contains these commits.

تغییرات API

  • The handling of both explicit and implicit deep links now automatically adds the saveState flag when navigating to another graph, ensuring that code such as NavigationUI.setupWithNavController and code using multiple back stacks works as expected. ( Ic8807 )

تغییرات رفتاری

  • Deep link patterns are now compiled lazily in NavDeepLink instead of during inflation. This should improve the inflation time of navigation graphs that include deep links. ( b8d257 , b/184149935 )

رفع اشکالات

  • Fixed an issue where NavBackStackEntries were being pushed down to Lifecycle.State.CREATED after moving to Lifecycle.State.STARTED when the NavHost is added directly to the activity's setContent() . ( Ia5ac1 , b/203536683 )
  • Fixed a race condition where popping a DialogFragment destination off of the back stack before the dialog was actually shown would not actually dismiss the dialog, resulting in a crash when the errant dialog was manually dismissed by the user. ( I687e5 )
  • Fixed an issue where the onNavDestinationSelected API on NavigationUI would return true even if you didn't actually navigate() to that navigation graph. It now uses the same logic used internally by setupWithNavController to only select the MenuItem associated with the current destination using the hierarchy of the destination. ( I2b053 )

Version 2.4.0-beta01

۲۷ اکتبر ۲۰۲۱

androidx.navigation:navigation-*:2.4.0-beta01 is released. Version 2.4.0-beta01 contains these commits.

ویژگی‌های جدید

  • You can now use by navGraphViewModel with a route as an alternative to using an ID so as to better support using the Navigation Kotlin DSL with Fragments. ( I901e3 , b/201446416 )

تغییرات API

  • The visibleEntries API is now experimental. ( I93f6f )

رفع اشکالات

  • ViewModels will no longer be destroyed when transitions are interrupted by navigating back and forth between the same screens ( Id52d8 , b/200817333 )
  • Nullable NavDeepLink arguments no longer require a default value when adding deep links to NavDestination s. ( I5aad4 , b/201320030 )
  • NavBackStackEntries now with different Lifecycles are not longer considered equal. This means NavHost will properly recompose all destinations when doing navigation with singleTop and when reselecting bottom menu items. ( I1b351 , b/196997433 )
  • Fixed an issue with AbstractListDetailFragment that caused the layout_width and layout_weight attributes on the list pane returned by onCreateListPaneView() to be incorrectly handled or ignored. ( f5fbf3 )
  • The visual state of dialog destinations now correctly stays in sync with the DialogFragmentNavigator 's state. This means that manually calling the asynchronous dismiss() API for DialogFragment now properly clears all dialog destinations above the now dismissed dialog. This does not affect cases where you use popUpTo or popBackStack() to dismiss your dialog. ( I77ba2 )
  • AbstractAppBarOnDestinationChangedListener now has clearer error messaging for onDestinationChanged() . ( Ie742d )

Version 2.4.0-alpha10

۲۹ سپتامبر ۲۰۲۱

androidx.navigation:navigation-*:2.4.0-alpha10 is released. Version 2.4.0-alpha10 contains these commits.

ویژگی‌های جدید

  • NavController now offers the ability to retrieve a list of all visible NavBackStackEntry instances via the visibleEntries StateFlow ( Ia964e )
  • rememberNavController() now takes a optional set of Navigator instances that will be added to the returned NavController to better support optional Navigators such as those from Accompanist Navigation Material . ( I4619e )

رفع اشکالات

  • Dynamic Navigation will no longer crash when the Activity is recreated. ( Ifa6a3 , b/197942869 )
  • Fixed an issue with the system back button that occurs only after popping back to a composable destination that contains a NavHost . ( 3ed148 , b/195668143 )
  • SafeArgs now generates the arguments for fromBundle() and fromSavedStateHandle() in the proper parameter order. ( I824a8 , b/200059831 )

Version 2.4.0-alpha09

۱۵ سپتامبر ۲۰۲۱

androidx.navigation:navigation-*:2.4.0-alpha09 is released. Version 2.4.0-alpha09 contains these commits.

ویژگی‌های جدید

  • You can now use the clearBackStack() method to clear any state that was saved with popBackStack() or popUpToSaveState . ( I80a0f )
  • You can now pass in a list of arguments and/or deep links to your nested navigation graph's builder and they will automatically be added to the resulting graph. ( I8a470 , b/182545357 )

تغییرات API

  • The navArgument Kotlin DSL function is now part of navigation-common instead of navigation-compose . This will require updating imports to continue to use this function. ( I1d095 )

تغییرات رفتاری

  • When generating arguments, Safe Args now puts parameters without default values before those with default values. ( I89709 , b/198493585 )

رفع اشکالات

  • When using Navigation Compose, NavGraphs will only be DESTROYED once all their children are DESTROYED . ( I86552 , b/198741720 )
  • Nullable NavDeepLink arguments no longer require a default value. ( Ia14ef , b/198689811 )
  • Calling setGraph() with a new graph will now also clear any saved back stacks in addition to its previous behavior of popping the back stack. ( I97f96 )
  • Fixed an issue where OnDestinationChangedListener instances and the currentBackStackEntryFlow were not notified when using launchSingleTop . ( Iaaebc )

به‌روزرسانی‌های وابستگی

Version 2.4.0-alpha08

۱ سپتامبر ۲۰۲۱

androidx.navigation:navigation-*:2.4.0-alpha08 is released. Version 2.4.0-alpha08 contains these commits.

ویژگی‌های جدید

  • It is now possible to extend the NavType class to create custom NavTypes. Custom types are supported only when building your navigation graph programmatically, such as via the Navigation Graph Kotlin DSL . ( I78440 , b/196871885 )

تغییرات رفتاری

  • When generating actions, Kotlin code generated from Safe Args now puts arguments without default values before those with default values as parameters. ( Idb697 , b/188855904 )
  • Deep links now verify that all required arguments (those without default values) are present in the Uri . ( #204 , b/185527157 )

رفع اشکالات

  • Using getBackStackEntry and previousBackStackEntry inside composable(), in conjunction with remember() , will no longer cause an exception for no destination being on the back stack. ( I75138 , b/194313238 )
  • Navigation Compose now properly recomposes when changing back stack arguments and using launchSingleTop=true . ( Iebd69 , b/186392337 )
  • There will no longer be an ArrayIndexOutOfBoundsException when calling setGraph with a graph with 13 or 29 destinations. ( I1a9f1 , b/195171984 )
  • The SafeArgs java generator should no longer cause lint warnings when generating Args classes. ( I1a666 , b/185843837 )

مشارکت خارجی

  • Thanks ospixd for ensuring that deep links verify that all required arguments (those without default values) are present in the Uri . ( #204 , b/185527157 )

Version 2.4.0-alpha07

۱۸ آگوست ۲۰۲۱

androidx.navigation:navigation-*:2.4.0-alpha07 is released. Version 2.4.0-alpha07 contains these commits.

رفع اشکالات

  • Navigation Compose now properly saves state after configuration changes and when changing graphs while using the multiple back stack feature. ( If5a3d , b/195141957 )
  • Re-selecting the same tab when using navigation compose with multiple back stacks will no longer result in a blank screen. ( I860dc , b/194925622 )
  • NavHost now observes for changes in the Lifecycle.State of NavBackStackEntry s which means using a NavHost in a fragment now will properly be recomposed as the lifecycle changes instead of resulting in a blank screen. ( I4eb85 , b/195864489 )
  • Fixed an issue where dismissing a DialogFragment would not correctly update the NavController state after recreating your activity (ie, after a configuration change). ( Icd72b )
  • Fixed an issue where popping a dialog destination would not update the NavController's system back button handling, potentially causing the NavController to intercept the back button even though it does not have any back stack to pop. ( If3b34 )
  • Safe-args now automatically generates a toSavedStateHandle method for arguments which can be used to test your ViewModel code. ( If1e2d , b/193353880 )

Version 2.4.0-alpha06

۴ آگوست ۲۰۲۱

androidx.navigation:navigation-*:2.4.0-alpha06 is released. Version 2.4.0-alpha06 contains these commits.

تغییرات API

  • The requireSlidingPaneLayout() and requireDetailPaneNavHostFragment() methods on AbstractListDetailFragment have been renamed to getSlidingPaneLayout() and getDetailPaneNavHostFragment() , respectively. ( I34a08 )

تغییرات رفتاری

  • When navigating with animations (like Crossfade ), the new destination's Lifecycle will now only reach the RESUMED when the animation completes. ( If0543 , b/172112072 , b/194301889 )
  • Navigation Compose's NavHost now sets the graph as part of the first composition. ( Ieb7be )

رفع اشکالات

  • Popping the last destination of a navigation graph no longer throws a ClassCastException . ( If0543 , b/172112072 , b/194301889 )
  • Fixed a NullPointerException that would occur when adding a deep link without a Uri and navigating via a route or deep link. ( 938a0c , b/193805425 )
  • Fixed an issue in Navigation Compose where a deep linked NavBackStackEntry would not reach the RESUMED state. ( I192c5 )
  • Fixed an issue where popping a dialog destination would not update the NavController's system back button handling, potentially causing the NavController to intercept the back button even though it does not have any back stack to pop. ( aosp/1782668 )

Version 2.4.0-alpha05

۲۱ ژوئیه ۲۰۲۱

androidx.navigation:navigation-*:2.4.0-alpha05 is released. Version 2.4.0-alpha05 contains these commits.

تغییرات رفتاری

  • Navigation Compose's NavHost now always uses Crossfades when navigating through destinations. ( I07049 , b/172112072 )
  • You can now make changes to the graph of a NavHost. Graphs with the same startDestination and destinations in the graph will be considered equal and will not clear the NavController back stack. ( I0b8db , b/175392262 )

رفع اشکالات

  • Fixed a NoSuchElementException when calling popBackStack() from within a LifecycleObserver attached to a NavBackStackEntry caused by reentrant updates to the NavController's state. ( I64621 )
  • AbstractListDetailFragment now allows SlidingPaneLayout to be completely stripped from your APK when AbstractListDetailFragment is not used. ( I611ad )
  • NavGraph and NavDestination now override the equals method so two objects with the same values will be considered equal. ( I166eb , b/175392262 )

Version 2.4.0-alpha04

۱ ژوئیه ۲۰۲۱

androidx.navigation:navigation-*:2.4.0-alpha04 is released. Version 2.4.0-alpha04 contains these commits.

ویژگی‌های جدید

  • The navigation-fragment artifact now contains a prebuilt implementation of a two pane layout via the new AbstractListDetailFragment . This fragment uses a SlidingPaneLayout to manage a list pane (which your subclass provides) and a detail pane, which uses a NavHostFragment as its implementation, as seen in our example implementation . ( Iac4be , b/191276636 )
  • The NavHost of the navigation-compose artifact now supports dialog destinations in addition to composable destinations. These dialog destinations will each be shown within a Composable Dialog , floating above the current composable destination. ( 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

  • The add function in NavigatorState has been renamed to push . All current calls to add() will need to be changed to push(). ( Ie89fc , b/172112072 )
  • Custom Navigator instances can now use the pushWithTransaction and popWithTransition APIs on NavigatorState to push or pop a destination asynchronously. Note that this APIs are not yet used by any of the included navigators. ( Ic4d7c , b/172112072 )

تغییرات رفتاری

  • NavDeepLinkBuilder now adds PendingIntent.FLAG_IMMUTABLE to the PendingIntent returned by createPendingIntent() , ensuring that this API works as expected when targeting Android 12. ( If8c52 )

رفع اشکالات

  • Fixed an issue with <include-dynamic> where arguments passed to the graph would not be correctly passed to the dynamically included graph. ( I3e115 )
  • Fixed a NullPointerException when navigating to a destination using a string[] argument with a default value of @null . ( I1fbe8 )
  • Add ProGuard rules for @Navigator.Name , fixing issues when using R8 3.1 full mode. ( I2add9 , b/191654433 )
  • SafeArgs will no longer fail when building your app with Kotlin versions before 1.5.0 . ( Icd1ff , b/190739257 )

Version 2.4.0-alpha03

June 16, 2021

androidx.navigation:navigation-*:2.4.0-alpha03 is released. Version 2.4.0-alpha03 contains these commits.

رفع اشکالات

  • Fixed an issue where two navigate() calls were needed to navigate to an included dynamic graph. ( I7785c , b/188859835 )
  • Fixed a regression introduced in Navigation 2.4.0-alpha01 where setupActionBarWithNavController() would not properly remove the Up icon when you are on a top level destination. ( I5d443 , b/189868637 )
  • Fixed an IllegalStateException when calling popBackStack() after previously popping the root graph of the NavController. ( I2a330 , b/190265699 )
  • ProGuard rules for by navArgs() now properly apply when using navigation-common or any artifacts that depend on it. ( I68800 , b/190082521 )
  • An OnDestinationChangedListener that calls navigate() the first time it receives a callback now properly get a second callback with the destination it navigated to. ( Ie5f9e , b/190228815 )
  • Safe Args no longer crashes when using it with dynamic feature modules and AGP 7.0+. ( I69518 , b/189966576 )

مشکل شناخته شده

  • Safe Args will fail with an Unable to find method ''java.lang.String kotlin.text.CarsKt.titleCase(char, java.util.Locale)'' error when using Gradle 6.7.0 due to a dependency on an older version of Kotlin. This can be worked around by updating to use Gradle 7.0. ( b/190739257 )

Version 2.4.0-alpha02

۲ ژوئن ۲۰۲۱

androidx.navigation:navigation-*:2.4.0-alpha02 is released. Version 2.4.0-alpha02 contains these commits.

ویژگی‌های جدید

  • Routes are now supported for Activity, Fragment and Dialog destinations, as well as throughout the DynamicNavigation Kotlin DSL. ( Ib5544 , Ia617b , I22f96 , b/188914648 , b/188901565 )
  • NavigationUI has temporarily added experimental APIs to allow opting out of saving your state. While always saving the state is the correct behavior, there are still uses of deprecated libraries (ie retained fragments), that cannot be supported when saving the state so this gives an opportunity for apps to slowly convert away from any unsupported APIs. ( Idf93c )

  • Navigation now provides findDestination() and getHierarchy() APIs that can be used to help implement custom NavigationUI. findDestination() is an extension function on NavGraph that will locate a destination within the graph. getHierarchy() is a function on NavDestination that can be used to verify if a given destination is within the hierarchy of another.( I2932f , b/188183365 ) 

    val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }

  • NavigationUI methods that took a BottomNavigationView have been updated to instead take its superclass introduced in Material 1.4.0 , NavigationBarView . This allows these methods to be used with the NavigationRailView . ( Ib0b36 , b/182938895 )

  • When inflating an <action> element via XML, animation attributes can use attributes pulled from your theme using the app:enterAnim="?attr/transitionEnter" syntax. ( I07bc1 , b/178291654 )

تغییرات API

رفع اشکالات

  • DialogFragmentNavigator now uses the NavigatorState.pop() API to inform the NavController when a dialog is dismissed by hitting the system back button or clicking outside of it, ensuring that the NavController state is always in sync with the Navigator's state. ( I2ead9 )

  • Navigation no longer gives a ConcurrentModificationException when using manipulating the list of OnDestinationChangedListeners from with an onDestinationChanged callback. ( Ib1707 , b/188860458 )

  • Safe Args no longer crashes when attempting to generate direction properties in Kotlin. ( Id2416 , b/188564435 )

  • The setId method on NavDestination is now properly annotated with @IdRes , so it only accepts resource ids. ( I69b80 )

  • The int parameter of findNode is now resId instead of resid . ( I7711d )

Dependency Update

  • Safe-Args now depends on Android Gradle Plugin 4.2.0. This means you should no longer get the using applicationIdTextResource warning. ( I6d67b , b/172824579 )

Version 2.4.0-alpha01

۱۸ مه ۲۰۲۱

androidx.navigation:navigation-*:2.4.0-alpha01 is released. Version 2.4.0-alpha01 contains these commits.

ویژگی‌های جدید

  • The currentBackStackEntryAsFlow() method on NavController provides a Flow that emits whenever the current NavBackStackEntry changes. This flow can be used as an alternative to manually managing an OnDestinationChangedListener . ( I19c4a , #89 , b/163947280 )

Multiple back stacks

The NavController is responsible for managing the back stack of destinations, adding destinations to the back stack when you navigate() to them and removing them when you call popBackStack() or trigger the system back button. The existing NavOptions class and the integration into <action> entries in the navigation graph XML has been expanded to support saving and restoring the back stack. ( b/80029773 )

As part of this change, the NavigationUI methods of onNavDestinationSelected() , BottomNavigationView.setupWithNavController() and NavigationView.setupWithNavController() now automatically save and restore the state of popped destinations, enabling support for multiple back stacks without any code changes. When using Navigation with Fragments, this is the recommended way to integrate with multiple back stacks. ( Ie07ca )

The underlying APIs for saving and restoring the state are exposed via a number of surfaces:

  • In Navigation XML, the <action> element can now use the boolean attributes of app:popUpToSaveState and app:restoreState to save the state of any destinations popped via app:popUpTo and restore the state associated with the destination passed as the 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” />

  • In the navOptions Kotlin DSL , you can add the restoreState boolean property and the saveState boolean property on the popUpTo builder : 

    // Use the navigate() method that takes a navOptions DSL Builder
navController.navigate(selectedBottomNavRoute) {
  launchSingleTop = true
  restoreState = true
  popUpTo(navController.graph.startDestinationId) {
    saveState = true
  }
}

  • In manually building a NavOptions object via the NavOptions.Builder , you can use the setRestoreState() and new overload to setPopUpTo() that takes an additional saveState parameter. 

    NavOptions navOptions = new NavOptions.Builder()
  .setLaunchSingleTop(true)
  .setRestoreState(true)
  .setPopUpTo(navController.getGraph().getStartDestinationId(),
    false, // inclusive
    true) // saveState
  .build();
navController.navigate(selectedBottomNavId, null, navOptions);

  • Programmatic calls to popBackStack() can now include an additional saveState parameter.

In all cases, the NavController will save and restore the state of each NavBackStackEntry , including any navigation destination scoped ViewModel instances. The Navigator APIs have been updated to enable each Navigator to support saving and restoring their own state.

The ComposeNavigator used for composable destinations in Navigation Compose and the FragmentNavigator and DynamicFragmentNavigator used for <fragment> destinations in Navigation with Fragments have both been updated to use the new Navigator APIs and support saving and restoring state.

Navigation Routes

A route is a String that uniquely identifies a destination. While previously only used in Navigation Compose , this concept has now graduated to become a part of the core Navigation APIs. This provides an alternative to using integer IDs when constructing your graph through the Navigation Kotlin DSL . ( b/172823546 )

All APIs that used to only take an ID now have an overload that takes a route String . This includes navigate() , popBackStack() , popUpTo() , and getBackStackEntry() .

This has had some API implications:

  • The popUpTo kotlin property on the Kotlin DSL has been deprecated in favor of popUpToId . ( I59c73 , b/172823546 )
  • The getStartDestination() API has been deprecated in favor of getStartDestinationId() . ( I0887f , b/172823546 )

For developers upgrading from previous versions of Navigation Compose to Navigation Compose 2.4.0-alpha01 , this means that the following imports on extension methods are no longer necessary and should be removed: 

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

The KEY_ROUTE argument has been replaced with the route property on NavDestination , allowing you to call navBackStackEntry.destination.route directly.

تغییرات API

  • All Navigation artifacts have been rewritten in Kotlin. This has improved the nullability of classes using generics (such as NavType subclasses). All Kotlin extension functions that used to be part of the -ktx artifacts have been moved to their respective main artifacts. The -ktx artifacts will continue to be published, but are completely empty. ( b/184292145 )
  • NavDeepLinkBuilder now supports adding multiple distinct destinations to the generated back stack. ( I3ee0d , b/147913689 )
  • Add factory functions for DynamicNavHostFragment ( Icd515 , b/175222619 )
  • The unique ID of a NavBackStackEntry is now exposed as part of its public API. ( Ie033a )
  • The name and argument fields and destructuring functions of NamedNavArgument are now public. ( #174 , b/181320559 )
  • Introduced a new NavBackStackEntry#provideToCompositionLocals extension that provides the NavBackStackEntry to the relevant composition locals. ( #175 , b/187229439 )

Safe Args

  • Safe Args now generates a fromSavedStateHandle() method for each NavArgs class. ( #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)
}

  • Updated Safe Args to depend on KotlinPoet 1.8.0 . ( #172 , b/183990444 )

تغییرات رفتاری

  • Navigation now depends on Lifecycle 2.3.1 and now marks setGraph() , popBackStack() , navigateUp() , and navigate() , the methods that update the NavBackStackEntry Lifecycle , as @MainThread , aligning Navigation with the main thread enforcement introduced in Lifecycle 2.3.0 . ( b/171125856 )
  • Parsing Enum arguments from deep links is now case insensitive, allowing a deep link like http://www.example.com/red to match a www.example.com/{color} deep link even when the enum has the value of RED . ( #152 , b/135857840 )

Compose Compatibility

  • androidx.navigation:navigation-compose:2.4.0-alpha01 is only compatible with Compose version 1.0.0-beta07 and above.

رفع اشکالات

  • Fixed an issue where trailing argument placeholders would take precedence over deep links that have a matching exact suffix. ( #153 , b/184072811 )
  • NavHostFragment now supports custom Navigators that use the same @Navigator.Name("dialog") as the default DialogFragmentNavigator . ( Ib1c2c , b/175979140 )
  • Improved the behavior of NavigatorProvider#addNavigator to ensure that calling it repeatedly with the same instance does not cause issues. ( #176 , b/187443146 )

External Contributions

  • Thanks simonschiller for building support for Safe Args generating a fromSavedStateHandle() method for each NavArgs class. ( #122 , b/136967621 )
  • Thanks Bradleycorn for making parsing Enum arguments from deep links case insensitive. ( #152 , b/135857840 )
  • Thanks osipxd for fixing an issue where trailing argument placeholders would take precedence over deep links that have a matching exact suffix. ( #153 , b/184072811 )
  • Thanks tatocaster for updating Safe Args to depend on KotlinPoet 1.8.0 . ( #172 , b/183990444 )
  • Thanks jossiwolf for making the name and argument fields and destructuring functions of NamedNavArgument public. ( #174 , b/181320559 )
  • Thanks jossiwolf for introducing a new NavBackStackEntry#provideToCompositionLocals extension that provides the NavBackStackEntry to the relevant composition locals. ( #175 , b/187229439 )
  • Thanks jossiwolf for improved the behavior of NavigatorProvider#addNavigator to ensure that calling it repeatedly with the same instance does not cause issues. ( #176 , b/187443146 )

Version 1.0.0-alpha10

۷ آوریل ۲۰۲۱

androidx.navigation:navigation-compose:1.0.0-alpha10 is released. Version 1.0.0-alpha10 contains these commits.

تغییرات API

  • NavHost now accepts a Modifier , which is passed down to the composable container that wraps the destination composables. ( I85aca , b/175125483 )

رفع اشکالات

  • NavHost now works even when an OnBackPressedDispatcherOwner is not found, such is the case when previewing the NavHost . ( I7d8b4 )
  • Navigation Compose now depends on Navigation 2.3.5 , fixing an issue when using BackHandler inside a NavHost destination. ( I7e63b , b/182284739 )

Version 1.0.0-alpha09

۱۰ مارس ۲۰۲۱

androidx.navigation:navigation-compose:1.0.0-alpha09 is released. Version 1.0.0-alpha09 contains these commits.

تغییرات API

  • LocalViewModelStoreOwner.current now returns a nullable ViewModelStoreOwner to better determine whether a ViewModelStoreOwner is available in the current composition. APIs that require a ViewModelStoreOwner , such as viewModel() and NavHost , still throw an exception if a ViewModelStoreOwner is not set. ( Idf39a )

رفع اشکالات

  • Navigation Compose now depends on Navigation 2.3.4 which includes the fix for attempting to set the same ViewModelStore object after the graph has been set. ( I65c24 , b/177825470 )

Version 1.0.0-alpha08

۲۴ فوریه ۲۰۲۱

androidx.navigation:navigation-compose:1.0.0-alpha08 is released. Version 1.0.0-alpha08 contains these commits.

ویژگی‌های جدید

  • NavHost now populates the LocalSavedStateRegistryOwner CompositionLocal with that destination's NavBackStackEntry , ensuring that any state directly saved into the SavedStateRegistry will be saved and restored alongside the destination. ( I435d7 , b/179469431 )

Version 1.0.0-alpha07

۱۰ فوریه ۲۰۲۱

androidx.navigation:navigation-compose:1.0.0-alpha07 is released. Version 1.0.0-alpha07 contains these commits.

به‌روزرسانی‌های وابستگی

Version 1.0.0-alpha06

۲۸ ژانویه ۲۰۲۱

androidx.navigation:navigation-compose:1.0.0-alpha06 is released. Version 1.0.0-alpha06 contains these commits.

تغییرات API

  • Added a getBackStackEntry(route: String) extension method on NavController that returns the associated NavBackStackEntry . ( If8931 )

Version 1.0.0-alpha05

۱۳ ژانویه ۲۰۲۱

androidx.navigation:navigation-compose:1.0.0-alpha05 is released. Version 1.0.0-alpha05 contains these commits.

Updated to depend on Compose 1.0.0-alpha10.

Version 1.0.0-alpha04

۱۶ دسامبر ۲۰۲۰

androidx.navigation:navigation-compose:1.0.0-alpha04 is released. Version 1.0.0-alpha04 contains these commits.

  • Updated for compatibility with Compose 1.0.0-alpha09 .

Version 1.0.0-alpha03

December 2, 2020

androidx.navigation:navigation-compose:1.0.0-alpha03 is released. Version 1.0.0-alpha03 contains these commits.

رفع اشکالات

  • Fixed an issue where popBackStack() and navigateUp() would not work after a configuration change or process death and recreation. ( Icea47 , b/173281473 )
  • Navigating to a nested graph within your NavHost now works properly. ( I0948d , b/173647694 )

نسخه ۱.۰.۰-آلفا۰۲

۱۱ نوامبر ۲۰۲۰

androidx.navigation:navigation-compose:1.0.0-alpha02 is released. Version 1.0.0-alpha02 contains these commits.

تغییرات API

  • Navigation compose now support NavOptions for using popUpTo and launchSingleTop operations ( If96c3 , b/171468994 )
  • Added a navigation function that takes a route instead of an ID that allows you to construct nested graphs in the Navigation Compose DSL. ( I1661d )
  • startDestination now comes before the route in the list of a parameters for a NavHost ( Ie620e )
  • You can now create a graph using the route as a start destination outside of a NavHost composable. ( Iceb75 )

نسخه ۱.۰.۰-آلفا۰۱

۲۸ اکتبر ۲۰۲۰

android.navigation:navigation-compose:1.0.0-alpha01 is released. Version 1.0.0-alpha01 contains these commits.

ویژگی‌های جدید

The navigation-compose artifact provides integration between the Navigation Component and Jetpack Compose . It uses @Composable functions as the destinations in your application.

This initial release provides:

  • A NavHost composable that allows you to construct your navigation graph via a Kotlin DSL.
  • Scoping of lifecycle, ViewModel , and remembered state at the destination level.
  • Automatic integration with the system back button.
  • Support for passing arguments, attaching deep links to destinations, and returning a result to previous destinations.
  • Compose specific helpers in rememberNavController() and currentBackStackEntryAsState() to allow hoisting state and connecting the NavController to composables outside of the NavHost (such as a bottom navigation bar).

See the Compose Navigation guide for more information.

نسخه ۲.۳.۵

نسخه ۲.۳.۵

۷ آوریل ۲۰۲۱

androidx.navigation:navigation-*:2.3.5 is released. Version 2.3.5 contains these commits.

ویژگی‌های جدید

  • When navigating using a NavDeepLinkRequest or Uri , you can now access the Uri , action, and mime type in the resulting destination by getting the intent from arguments via KEY_DEEP_LINK_INTENT , mirroring the functionality already available for external deep linking. ( I975c3 , b/181521877 )

رفع اشکالات

  • OnBackPressedCallbacks added to a dispatcher with the NavBackStackEntry as the LifecycleOwner now properly intercept back after the Activity Lifecycle is STOPPED , then STARTED ( Iff94f , b/182284739 )
  • Deep link domain parsing is now case insensitive, ensuring that www.example.com matches both www.example.com and www.Example.com . Note that query parameter names are still case sensitive. ( #144 , b/153829033 )
  • Fixed a NullPointerException that could occur when a destination has multiple non-nullable default arguments and you navigate to that destination while only overriding a subset of those arguments. ( aosp/1644827 )

به‌روزرسانی‌های وابستگی

مشارکت خارجی

Version 2.3.4

Version 2.3.4

۱۰ مارس ۲۰۲۱

androidx.navigation:navigation-*:2.3.4 is released. Version 2.3.4 contains these commits.

ویژگی‌های جدید

  • ReferenceType arguments can now be properly parsed when sent as part of a deeplink URI. This supports both the raw integer value as well as hex values prefixed by 0x . ( #127 , b/179166693 )
  • The android:defaultValue for an argument with app:argType="float" now supports integer default values, allowing you to use android:defaultValue="0" rather than requiring the use of 0.0 . ( #117 , b/173766247 )

رفع اشکالات

  • Fix stuck installation progress when using Navigation's support for dynamic features. ( Ib27a7 , b/169636207 )
  • Calling setViewModelStore or setLifecycleOwner with the same object that has already been set will now be a no-op ( Idf491 , b/177825470 )
  • Safe-Args now adds suppress annotations on the proper methods when using java. ( I8fbc5 , b/179463137 )

External Contributions

  • Thanks JvmName for the pull request to ensure that ReferenceType arguments can now be properly parsed when sent as part of a deeplink URI. ( #127 , b/179166693 )
  • Thanks tatocaster for the pull request to allow the defaultValue for an argument with app:argType=”float” now supports integer default values. ( #117 , b/173766247 )

Version 2.3.3

Version 2.3.3

۲۷ ژانویه ۲۰۲۱

androidx.navigation:navigation-*:2.3.3 is released. Version 2.3.3 contains these commits.

رفع اشکالات

  • There is no longer a crash when popping a NavBackStackEntry before its Lifecycle is moved to CREATED . ( Ie3ba3 )
  • Fixed regression caused by b/171364502 where navigating to an activity with an animation resource value of 0 caused a ResourceNotFoundException . ( I7aedb , b/176819931 )

Version 2.3.2

Version 2.3.2

December 2, 2020

androidx.navigation:navigation-*:2.3.2 is released. Version 2.3.2 contains these commits.

رفع اشکالات

  • Fixed a regression in NavigationUI where using an <activity> destination with onNavDestinationSelected would fail to navigate to the Activity. ( I22e34 , b/171364502 )
  • Fixed an issue where navigation-dynamic-features-fragment would result in navigating to the newly installed destination multiple times. ( aosp/1486056 , b/169636207 )
  • Fixed an issue where default arguments would not be sent to OnDestinationChangedListener instances when using launchSingleTop . ( I2c5cb )
  • Fixed an issue where navigating to a nested navigation graph would not create a new graph instance on the back stack. ( Ifc831 )
  • Fixed an issue where using navigate() with a popUpTo that removed the last destination in a navigation graph would not immediately destroy and remove the navigation graph itself from the back stack. ( I910a3 )
  • Navigation SafeArgs now uses KotlinPoet version 1.7.2 which adds support for Kotlin's explicit API mode. ( I918b5 )
  • NavHostFragment.findNavController(Fragment) now also checks the root decor view of a DialogFragment in addition to the existing checks of the Fragment hierarchy and Fragment's view hierarchy. This allows you to test dialog fragments that use Navigation with FragmentScenario and Navigation.setViewNavController() . ( I69e0d )

Version 2.3.1

Version 2.3.1

۱۴ اکتبر ۲۰۲۰

androidx.navigation:navigation-*:2.3.1 is released. Version 2.3.1 contains these commits.

ویژگی‌های جدید

  • Default Animator resources have been added to Navigation UI and are recommended over the default animation resources. ( b/167430145 )
  • NavOptions now overrides the hashcode and equals methods ( b/161586466 )
  • Navigation now includes the current destination in the “No destination with ID” IllegalArgumentException, which should improve the developer debugging experience. ( b/168311416 )

رفع اشکالات

  • Safe Args will no longer wrap the return line, even if the generated argument class name is longer than 100 characters. ( b/168584987 )

Dependency Changes

  • navigation-ui now depends on DrawerLayout 1.1.1 , ensuring that NavigationUI is able to open the drawer even when using LOCK_MODE_LOCKED_CLOSED or LOCK_MODE_LOCKED_OPEN . ( b/162253907 )
  • Safe Args now depends on KotlinPoet 1.6.0 ( aosp/1435911 )
  • Safe Args now depends on AGP 4.0.1 ( aosp/1442337 )

نسخه ۲.۳.۰

نسخه ۲.۳.۰

۲۴ ژوئن ۲۰۲۰

androidx.navigation:navigation-*:2.3.0 is released. Version 2.3.0 contains these commits.

Major changes since 2.2.0

  • Feature Module integration : The navigation-dynamic-features-runtime and navigation-dynamic-features-fragment artifacts allow you to navigate to destinations that are defined in feature modules, automatically handling the installation of the feature modules as needed. See Navigate with feature modules for more information.
  • Navigation Testing : The navigation-testing artifact provides a TestNavHostController that allows you to set the current destination and verify the back stack after navigation operations. See Test Navigation for more information.
  • Returning a Result : The NavBackStackEntry associated with each destination on the Navigation back stack now allows you to access a SavedStateHandle suitable for storing small amounts of saved state that should be associated with a particular back stack entry. See Returning a result to the previous Destination for more information.
  • NavigationUI support for Openable : All usages of DrawerLayout in NavigationUI have been replaced with the more generic Openable interface added in CustomView 1.1.0 and implemented by DrawerLayout in DrawerLayout 1.1.0 .
  • Action and Mime Type support in deep links : Deep linking has been expanded to support app:action and app:mimeType in addition to the app:uri previously available. NavController now supports navigating by any combination of these fields via the new NavDeepLinkRequest class. See Navigate using NavDeepLinkRequest for more information.

مشکلات شناخته شده

  • Support for deep link actions and mime types is not yet available in Manifest Merger . Until that work is completed, any generated <intent-filter> elements from the <nav-graph> element in your manifest won't include your mime type in its <data> element or your custom <action> . You must manually add an appropriate <intent-filter> to your manifest.

Version 2.3.0-rc01

June 10, 2020

androidx.navigation:navigation-*:2.3.0-rc01 is released. Version 2.3.0-rc01 contains these commits.

رفع اشکالات

  • Fixed a NullPointerException when replacing an instance of a destination with no arguments with another instance with arguments with singleTop . ( b/158006669 )
  • All destination is unknown exceptions thrown by NavController now have additional debugging information to help determine the state of the NavController . ( b/157764916 )

Version 2.3.0-beta01

۲۰ مه ۲۰۲۰

androidx.navigation:navigation-*:2.3.0-beta01 are released. Version 2.3.0-beta01 contains these commits.

رفع اشکالات

  • Fixed an issue where the Lifecycle of the NavBackStackEntry would not be properly updated after process death. ( b/155218371 )
  • OnDestinationChangedListener instances registered before calling setGraph() are now properly sent the restored destination after a process death. ( b/155218371 )
  • When using singleTop , the NavBackStackEntry now correctly has its arguments updated and the updated arguments are sent to all OnDestinationChangeListener instances. ( b/156545508 )

به‌روزرسانی‌های وابستگی

Version 2.3.0-alpha06

۲۹ آوریل ۲۰۲۰

androidx.navigation:navigation-*:2.3.0-alpha06 is released. ( Version 2.3.0-alpha06 contains these commits. )

ویژگی‌های جدید

  • Deep linking has been expanded to support app:action and app:mimeType in addition to the app:uri previously available. NavController now supports navigating by any combination of these fields via the new NavDeepLinkRequest class. ( b/136573074 , b/135334841 )

تغییرات API

  • Greatly expanded the Kotlin DSL support for Dynamic Navigation destinations. ( b/148969800 )

رفع اشکالات

  • Fixed an issue where deep link Intents would be ignored when using a nested start destination. ( b/154532067 )

Version 2.3.0-alpha05

۱۵ آوریل ۲۰۲۰

androidx.navigation:navigation-*:2.3.0-alpha05 is released. Version 2.3.0-alpha05 contains these commits.

ویژگی‌های جدید

  • For dynamic graph includes using <include-dynamic> , you no longer need to specify app:graphPackage and a default one will be used by adding moduleName suffix to the applicationId after a dot. If you do need to customize your graphPackage , an ${applicationId} placeholder is now supported. ( b/152696768 )
  • The Navigation Graph Kotlin DSL now exposes a defaultArguments Map for actions, mirroring the ability to set default values on <action> elements in Navigation XML files. ( b/150345605 )

رفع اشکالات

  • From Navigation 2.2.2 : Fixed an IllegalStateException when deep linking to the start destination of your graph when you have multiple NavHostFragment instances in your Activity. ( b/147378752 )

به‌روزرسانی‌های وابستگی

Version 2.3.0-alpha04

۱۸ مارس ۲۰۲۰

androidx.navigation:navigation-*:2.3.0-alpha04 is released. Version 2.3.0-alpha04 contains these commits.

ویژگی‌های جدید

  • Added support for feature module activity and fragment destinations in the Navigation Kotlin DSL. ( b/148969800 )

تغییرات API

  • The DynamicExtras class no longer uses a builder pattern and can now be constructed directly. ( aosp/1253671 )
  • DynamicActivityNavigator now takes a Context in its constructor rather than an Activity . ( aosp/1250252 )

رفع اشکالات

  • NavigationUI no longer ignores empty labels (ie, a destination with android:label=”” ) and now correctly sets the title to an empty string. ( b/148679860 )

به‌روزرسانی‌های وابستگی

  • The Navigation Dynamic Features artifacts now depend on Play Core 1.6.5 . ( b/149556401 )

Version 2.3.0-alpha03

۴ مارس ۲۰۲۰

androidx.navigation:navigation-*:2.3.0-alpha03 is released. Version 2.3.0-alpha03 contains these commits.

تغییرات API

رفع اشکالات

  • The navigation-common-ktx ProGuard rules now correctly only keep the NavArgs classes that are used rather than all NavArgs instances. ( b/150213558 )

Dependency changes

  • Navigation has reverted its dependency on Core 1.2.0 and now depends on Core 1.1.0 to avoid forcing developers to move to a newer dependency when Navigation does not depend on any new APIs in Core 1.2.0 .

Version 2.3.0-alpha02

۱۹ فوریه ۲۰۲۰

androidx.navigation:navigation-*:2.3.0-alpha02 is released. Version 2.3.0-alpha02 contains these commits.

ویژگی‌های جدید

  • The NavBackStackEntry now allows you to access a SavedStateHandle suitable for storing small amounts of saved state that should be associated with a particular back stack entry. See Returning a result for an example use case. ( b/79672220 )

تغییرات API

  • Convenience methods of getCurrentBackStackEntry() and getPreviousBackStackEntry() have been added to make it easier to retrieve a NavBackStackEntry for the current and previous destinations. ( b/79672220 )

رفع اشکالات

  • navigateUp() now passes the current destination's arguments and the KEY_DEEP_LINK_INTENT to the previous destination when launching your app on your own task stack. ( b/147456890 )

Dependency changes

Version 2.3.0-alpha01

۵ فوریه ۲۰۲۰

androidx.navigation:navigation-*:2.3.0-alpha01 is released. Version 2.3.0-alpha01 contains these commits .

ویژگی‌های جدید

  • The new navigation-testing artifact provides a TestNavHostController class. This class provides an alternative to using a mock NavController when testing Navigation that allows you to set the current destination and verify the back stack after navigation operations. ( b/140884273 )
  • The new navigation-dynamic-features-fragment (and its transitive dependency, navigation-dynamic-features-runtime ) allows you to include destinations or entire navigation graphs (via <include-dynamic> ) from feature modules , providing seamless installation of on-demand feature modules when navigating to those destinations. See Navigate with feature modules for more information. ( b/132170186 )

رفع اشکالات

  • From Navigation 2.2.1 : Deep links without query parameters now correctly ignore any query parameters rather than appending them to trailing {argument} elements or not matching the deep link. ( b/147447512 )
  • From Navigation 2.2.1 : The navigation-ui ProGuard rules for DrawerArrowDrawable have been updated to ensure that android.enableJetifier=true is not required. ( b/147610424 )
  • From Navigation 2.2.1 : The navigation-common-ktx module now has a unique manifest package name instead of sharing the same manifest package name as navigation-runtime-ktx . ( aosp/1141947 )

به‌روزرسانی‌های وابستگی

نسخه ۲.۲.۲

نسخه ۲.۲.۲

۱۵ آوریل ۲۰۲۰

androidx.navigation:navigation-*:2.2.2 are released. Version 2.2.2 contains these commits.

رفع اشکالات

  • Fixed an IllegalStateException when deep linking to the start destination of your graph when you have multiple NavHostFragment instances in your Activity. ( b/147378752 )
  • NavigationUI no longer ignores empty labels (ie, a destination with android:label=”” ) and now correctly sets the title to an empty string. This was previously released in Navigation 2.3.0-alpha04 . ( b/148679860 )
  • The navigation-common-ktx ProGuard rules now correctly only keep the NavArgs classes that are used rather than all NavArgs instances. This was previously released in Navigation 2.3.0-alpha03 . ( b/150213558

به‌روزرسانی‌های وابستگی

نسخه ۲.۲.۱

نسخه ۲.۲.۱

۵ فوریه ۲۰۲۰

androidx.navigation:navigation-*:2.2.1 is released. Version 2.2.1 contains these commits .

رفع اشکالات

  • Deep links without query parameters now correctly ignore any query parameters rather than appending them to trailing {argument} elements or not matching the deep link. ( b/147447512 )
  • The navigation-ui ProGuard rules for DrawerArrowDrawable have been updated to ensure that android.enableJetifier=true is not required. ( b/147610424 )
  • The navigation-common-ktx module now has a unique manifest package name instead of sharing the same manifest package name as navigation-runtime-ktx . ( aosp/1141947 )

به‌روزرسانی‌های وابستگی

نسخه ۲.۲.۰

نسخه ۲.۲.۰

۲۲ ژانویه ۲۰۲۰

androidx.navigation:navigation-*:2.2.0 is released. Version 2.2.0 contains these commits .

Important changes since 2.1.0

  • NavBackStackEntry : You can now call NavController.getBackStackEntry() , passing in the ID of a destination or navigation graph on the back stack. The returned NavBackStackEntry provides a Navigation-driven LifecycleOwner , ViewModelStoreOwner (the same returned by NavController.getViewModelStoreOwner() ), and SavedStateRegistryOwner , in addition to providing the arguments used to start that destination.
  • Lifecycle ViewModel SavedState Integration : SavedStateViewModelFactory is now the default factory used when using by navGraphViewModels() or the ViewModelProvider constructor with a ViewModelStoreOwner returned by NavController.getBackStackEntry() or NavController.getViewModelStoreOwner() .
  • Query Parameter Support for Deep Links : Deep links with query parameters now support reordered query parameters; arguments that have a default value or are nullable are now optional when matching deep links.
  • Improved Animation Support : NavHostFragment now uses FragmentContainerView from Fragment 1.2.0 , fixing animation z-ordering issues and window insets dispatching to Fragments.

Version 2.2.0-rc04

۱۸ دسامبر ۲۰۱۹

androidx.navigation:navigation-*:2.2.0-rc04 is released. Version 2.2.0-rc04 contains these commits .

رفع اشکالات

Version 2.2.0-rc03

۴ دسامبر ۲۰۱۹

androidx.navigation:navigation-*:2.2.0-rc03 is released. Version 2.2.0-rc03 contains these commits .

رفع اشکالات

  • Fixed an issue with deep link parsing when using query parameters and an argument as the last part of the path that prevented more than one character of the final path argument from being parsed. ( b/144554689 )
  • Fixed an issue with deep link parsing where optional parameters would receive "@null" instead of null . ( b/141613546 )
  • NavHostFragment now correctly restores the graph after a configuration change when used with FragmentContainerView . ( b/143752103 )

Dependency changes

  • Navigation now depends on Lifecycle 2.2.0-rc03 , Lifecycle ViewModel SavedState 1.0.0-rc03 , Activity 1.1.0-rc03 , and Fragment 1.2.0-rc03 where appropriate.

Version 2.2.0-rc02

۷ نوامبر ۲۰۱۹

androidx.navigation:navigation-*:2.2.0-rc02 is released. Version 2.2.0-rc02 contains these commits .

Dependency changes

  • Navigation now depends on androidx.lifecycle 2.2.0-rc02 .

Version 2.2.0-rc01

October 23, 2019

androidx.navigation:navigation-*:2.2.0-rc01 is released with no changes since 2.2.0-beta01 . Version 2.2.0-rc01 contains these commits .

Version 2.2.0-beta01

۹ اکتبر ۲۰۱۹

androidx.navigation:navigation-*:2.2.0-beta01 is released. Version 2.2.0-beta01 contains these commits .

ویژگی‌های جدید

  • NavDestination and its subclasses now override toString() to provide more helpful information when debugging. ( b/141264986 )

Behavior changes

  • Extra query parameters are now ignored when matching deep links rather than causing the match to fail. ( b/141482822 )

رفع اشکالات

  • Fixed an issue where arguments in a deep link's path would be ignored if query parameters were also specified. ( b/141505755 )
  • The navArgs() Kotlin extension on Activity now has a better error message when there are no extras. ( b/141408999 )
  • Safe Args generated Directions Java classes now contain default values. ( b/141099045 )
  • Safe Args generated Args Java classes now contain default values. ( b/140123727 )
  • When using a Toolbar , NavigationUI no longer animates the text change when moving between two top level destinations. ( b/140848160 )

Version 2.2.0-alpha03

September 18, 2019

androidx.navigation:navigation-*:2.2.0-alpha03 is released. Version 2.2.0-alpha03 contains these commits .

Behavior changes

  • Calling setViewModelStore() after calling setGraph now results in an IllegalStateException . This should always be set by the NavHost as part of the initial setup to ensure that all NavBackStackEntry instances have a consistent storage for ViewModel instances. ( aosp/1111821 )

رفع اشکالات

  • Fixed a ConcurrentModificationException when using ViewModel instances attached to multiple different navigation graph scoped ViewModelStore instances. ( aosp/1112257 )

Version 2.2.0-alpha02

۵ سپتامبر ۲۰۱۹

androidx.navigation:navigation-*:2.2.0-alpha02 is released. The commits included in this version can be found here .

ویژگی‌های جدید

  • Deep links with query parameters now support reordered query parameters; arguments that have a default value or are nullable are now optional when matching deep links. ( b/133273839 )
  • You can now call NavController.getBackStackEntry() , passing in the ID of a destination or navigation graph on the back stack. The returned NavBackStackEntry provides a Navigation-driven LifecycleOwner , ViewModelStoreOwner (the same returned by NavController.getViewModelStoreOwner() ), and SavedStateRegistryOwner , in addition to providing the arguments used to start that destination. ( aosp/1101691 , aosp/1101710 )

رفع اشکالات

  • Fixed an issue where adding a NavHostFragment to ViewPager2 failed with an IllegalArgumentException . ( b/133640271 )
  • NavInflater now avoids calling getResourceName() unnecessarily, speeding up inflation time by up to 40%. ( b/139213740 )

Version 2.2.0-alpha01

۷ آگوست ۲۰۱۹

androidx.navigation:navigation-*:2.2.0-alpha01 is released. The commits included in this version can be found here .

ویژگی‌های جدید

  • SavedStateViewModelFactory is now the default factory used when using by navGraphViewModels() or the ViewModelProvider constructor with a ViewModelStoreOwner returned by NavController.getViewModelStoreOwner() . ( b/135716331 )

تغییرات API

رفع اشکالات

  • NavHostFragment now uses FragmentContainerView , fixing animation z-ordering issues and window insets dispatching to Fragments. ( b/137310379 )

نسخه ۲.۱.۰

نسخه ۲.۱.۰

۵ سپتامبر ۲۰۱۹

androidx.navigation:navigation-*:2.1.0 is released. The commits included in this version can be found here .

Important changes since 2.0.0

  • Scoping ViewModels to a navigation graph : You can now create ViewModels that are scoped at the navigation graph level using the by navGraphViewModels() property delegate for Kotlin users using the -ktx libraries or by using the getViewModelStoreOwner() API added to NavController . See Share UI-related data between destinations for more information.
  • Dialog destinations : You can now create <dialog> destinations that will show a DialogFragment when you navigate to them. NavHostFragment supports dialog destinations by default. See Create a destination from a DialogFragment for more information.
  • Navigating by Uri : You can now navigate using a Uri , which uses the <deepLink> you've added to a destination to navigate there. See Navigate using Uri for more information.
  • NavHostController : APIs used specifically for constructing a custom NavHost have been moved to NavHostController , allowing implementations to connect their NavController to the hosting LifecycleOwner , OnBackPressedDispatcher , and ViewModelStore .

Version 2.1.0-rc01

۷ آگوست ۲۰۱۹

androidx.navigation:navigation-*:2.1.0-rc01 is released. The commits included in this version can be found here .

تغییرات API

  • The deprecated getViewModelStore() API on NavController introduced in 2.1.0-alpha02 has been removed. ( aosp/1091021 )

Version 2.1.0-beta02

۱۹ ژوئیه ۲۰۱۹

androidx.navigation:*:2.1.0-beta02 is released. The commits included in this version can be found here .

رفع اشکالات

  • Removed unintentional jacoco dependency that was introduced in 2.1.0-beta01 . ( b/137782950 )

Version 2.1.0-beta01

July 17, 2019

androidx.navigation:*:2.1.0-beta01 is released. The commits included in this version can be found here .

ویژگی‌های جدید

  • NavigationUI now animates the removal of the Up button when using setupWithNavController() with a Toolbar or CollapsingToolbarLayout . ( b/131403621 )

رفع اشکالات

  • Fixed a timing issue when using multiple NavHostFragments with the same container with findNavController() . ( b/136021571 )

Version 2.1.0-alpha06

۲ ژوئیه ۲۰۱۹

androidx.navigation:*:2.1.0-alpha06 is released. The commits included in this version can be found here .

ویژگی‌های جدید

  • The app:navGraph attribute used by NavHostFragment has now been moved to the navigation-runtime artifact. Custom navigators that can be added via XML should use this attribute to gain integration with the Navigation Editor's Host panel. ( b/133880955 )

تغییرات API

  • The getViewModelStore() API on NavController has been deprecated in favor of the new getViewModelStoreOwner() method that returns a ViewModelStoreOwner . ( aosp/987010 )
  • The implementation of floating window destinations, such as <dialog> destinations, has been generalized into a marker interface, FloatingWindow , that all <dialog> destinations now implement. NavigationUI methods for interacting with the top app bar now ignore FloatingWindow destinations. ( b/133600763 )

Behavior changes

  • Navigation now correctly keeps its state in sync with what is seen on the screen when using a <dialog> destination. As a consequence, Navigation now automatically pops <dialog> destinations when you navigate to a non-dialog and non-activity destination, such as a <fragment> destination. ( b/134089818 )

رفع اشکالات

  • Navigation now suppresses the animation that occurs when recreating the activity when handling a deep link, fixing a visual flash. ( b/130362979 )
  • Fixed a bug where the Navigation back stack would be out of sync when popping a Fragment as the initial fragment is being added. ( b/133832218 )

Version 2.1.0-alpha05

June 5, 2019

androidx.navigation:*:2.1.0-alpha05 is released. The commits included in this version can be found here .

تغییرات API

  • Host related APIs on NavController have been renamed and moved to a new subclass of NavController , NavHostController . ( aosp/966091 )
  • The NavController setHostOnBackPressedDispatcherOwner() method has been replaced with NavHostController 's setOnBackPressedDispatcher() method and now requires that you call setLifecycleOwner() prior to calling it. ( aosp/965409 )
  • NavHostController now contains a enableOnBackPressed(boolean) method that replaces the NavHostOnBackPressedManager class that was previously returned by setHostOnBackPressedDispatcherOwner() . ( aosp/966091 )

رفع اشکالات

  • Fixed an issue where the back stack was not correct after navigating by URI. ( b/132509387 )
  • Deep links automatically handled by NavController now only trigger once. ( b/132754763 )

Version 2.1.0-alpha04

۱۶ مه ۲۰۱۹

androidx.navigation:*:2.1.0-alpha04 is released. The commits included in this version can be found here .

رفع اشکالات

  • NavHostFragment correctly respects app:defaultNavHost when intercepting the system Back button events, fixing a regression in Navigation 2.1.0-alpha03 . b/132077777
  • DialogFragmentNavigator now correctly handles popBackStack() and navigateUp() operations. b/132576764
  • Fixed an IllegalStateException: unknown destination during restore issue when repeatedly navigating between nested graphs. b/131733658

Version 2.1.0-alpha03

۷ مه ۲۰۱۹

androidx.navigation:*:2.1.0-alpha03 is released. The commits included in this version can be found here .

مشکلات شناخته شده

  • NavHostFragment continues to intercept the system Back button despite using app:defaultNavHost="false" b/132077777

ویژگی‌های جدید

  • You can now create <dialog> destinations that will show a DialogFragment when you navigate to them. NavHostFragment supports dialog destinations by default. b/80267254
  • In addition to calling navigate with a resource id or a NavDirections instance, you can now navigate via a Uri , which uses the <deepLink> you've added to a destination to navigate to the correct destination. b/110412864

Behavior changes

  • The default animations provided by NavigationUI have been sped up from 400ms to 220ms to match the default animation speed of activities and fragments. b/130055522

تغییرات API

  • The createFragmentNavigator() method of NavHostFragment has been deprecated and its functionality moved to the new onCreateNavController() method to make it more clear that this is the correct entry point of adding custom Navigators when subclassing NavHostFragment . b/122802849
  • A hasDeepLink() method has been added to NavDestination to allow you to check if a given Uri can be handled by that destination or, in the case of a NavGraph , any destination in the navigation graph. b/117437718

رفع اشکالات

  • Default arguments are now correctly passed to OnDestinationChangedListener instances. b/130630686
  • NavHostFragment now intercepts system Back events using the OnBackPressedDispatcher , fixing an issue when doing conditional navigation in Fragment lifecycle methods upon returning to a Fragment. b/111598096
  • For Safe Args, an android:defaultValue=”@null” with an unspecified app:argType is now properly inferred as a string argument. b/129629192

Version 2.1.0-alpha02

April 3, 2019

androidx.navigation:*:2.1.0-alpha02 is released. The commits included in this version can be found here .

ویژگی‌های جدید

  • You can now create ViewModels that are scoped at a navigation graph level via the by navGraphViewModels() property delegate for Kotlin users or by using the getViewModelStore() API added to NavController . b/111614463

تغییرات API

  • You can now add an app:targetPackage to an <activity> destination to limit the matching package name. It supports app:targetPackage="${applicationId}" for restricting the package to your own application id. b/110975456

رفع اشکالات

  • The android:name for <activity> destinations is no longer parsed into a Class at inflation time, preventing ClassNotFoundExceptions when using dynamic features. b/124538597

Version 2.1.0-alpha01

March 19, 2019

This is the first alpha release of Navigation 2.1.0 .

Dependency changes

  • Navigation now depends on androidx.core:core:1.0.1 and androidx.fragment:fragment:1.1.0-alpha05 . This release also removes the dependency on androidx.legacy:legacy-support-core-utils:1.0.0 . b/128632612

تغییرات API

  • A new Navigation.createNavigateOnClickListener(NavDirections) method has been added as an alternative to creating a click listener with a resource ID and Bundle. b/127631752
  • FragmentNavigator.instantiateFragment is now deprecated. The default implementation now uses FragmentFactory to instantiate Fragments. b/119054429

رفع اشکالات

  • Navigation no longer sends a null Bundle when there are arguments attached to a destination, fixing an issue when using android:defaultValue="@null" . b/128531879
  • Safe Args now depends on KotlinPoet 1.1.0, fixing an issue with extremely long package names. b/123654948

نسخه ۲.۰.۰

نسخه ۲.۰.۰

۱۴ مارس ۲۰۱۹

Navigation 2.0.0 is released with no changes from 2.0.0-rc02 .

Version 2.0.0-rc02

۶ مارس ۲۰۱۹

Navigation 2.0.0-rc02 provides new artifacts with the androidx.navigation group ID and changes its dependencies to the AndroidX equivalents.

The behavior of 2.0.0-rc02 is identical to behavior to Navigation 1.0.0-rc02 and no changes to your code should be required to update from 1.0.0-rc02 besides updating your dependencies to match the new dependencies .

Your project must have migrated to AndroidX to use 2.X releases of Navigation. Navigation 1.0 stable will be the last release using the Support Library dependencies; all future development beyond 1.0 will be based on AndroidX and build upon the 2.0 stable release.

Pre-AndroidX Dependencies

For the pre-AndroidX versions of Navigation, include these dependencies: 

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
}

For Safe args , add the following classpath in your top level build.gradle file 

buildscript {
    repositories {
        google()
    }
    dependencies {
        classpath "android.arch.navigation:navigation-safe-args-gradle-plugin:1.0.0"
    }
}

نسخه ۱.۰.۰

نسخه ۱.۰.۰

۱۴ مارس ۲۰۱۹

Navigation 1.0.0 is released with no changes from 1.0.0-rc02 .

Version 1.0.0-rc02

۲۶ فوریه ۲۰۱۹

This is the second release candidate for Navigation's 1.0.0 stable release. This release contains a number of bug fixes.

رفع اشکالات

  • Fixed an issue where popBackStack() would be ignored if the root graph did not have an ID b/126251695
  • navigateUp() now correctly handles navigating back to your app's task when called after handling a deep link without FLAG_ACTIVITY_NEW_TASK b/126082008
  • Fixed an issue with ActivityNavigator.applyPopAnimationsToPendingTransition not applying the correct pop exit animation b/126237567
  • Kotlin code generated by Safe Args now properly escapes Kotlin keywords such as in and fun in the package name associated with the R class. b/126020455

نسخه ۱.۰.۰-rc01

۲۱ فوریه ۲۰۱۹

This is a release candidate for Navigation's 1.0.0 stable release. This release contains one bug fix.

رفع اشکالات

  • Fixed an issue when using Fragments and singleTop navigation operations b/124294805

Version 1.0.0-beta02

۱۲ فوریه ۲۰۱۹

This release includes a number of minor improvements and important bug fixes.

ویژگی‌های جدید

  • You can now use 0 as an android:defaultValue for reference arguments. b/124248602

Behavior changes

  • Exact deep link matches are now prioritized over deep links with .* or argument matches. b/123969518

رفع اشکالات

  • popBackStack() and navigateUp now correctly return false when popping the last destination on the back stack, fixing a regression introduced in 1.0.0-beta01 . b/123933201
  • Navigation now correctly sets the ClassLoader during restoration of saved instance state, avoiding issues when using custom classes in Navigator saved state or in arguments sent to a NavDestination . b/123893858
  • Safe Args generated NavArgs classes no longer crash when restoring a Parcelable[] argument from saved instance state. b/123963545
  • Safe Args now properly cleans up unnecessary generated Kotlin classes. b/124120883

نسخه ۱.۰.۰-بتا۰۱

۴ فوریه ۲۰۱۹

This is the first beta release of Navigation; moving forward, the Navigation API is expected to stay stable until the next version unless there is a critical problem. This release contains some bug fixes and behavior changes.

Behavior changes

  • Navigation now ensures that argument default values are treated identically at runtime and through Safe Args. As a consequence, only arguments with an app:argType="reference" can have a default value point to another resource (for example, @color/colorPrimary ). Attempting to use a reference default value with a different app:argType will result in an exception when parsing the navigation XML. b/123551990
  • Safe Args now depends on Android Gradle Plugin 3.3.0 aosp/888413
  • Safe Args now depends on Kotlin 1.3.20 aosp/888414

رفع اشکالات

  • Safe Args can now be used in library and feature modules on all versions of the Android Gradle Plugin. b/121304903
  • Fixed a regression that would cause a single popBackStack() operation to pop all copies of a destination off the top of the back stack, rather than just a single destination at a time. b/123552990
  • Fixed an issue where the FragmentNavigator state would desynchronize with the NavController 's state, causing an IllegalStateException when attempting to restore the back stack. b/123803044
  • Fixed an issue where the NavigationUI handled back arrow would not appear when using ProGuard with obfuscation. b/123449431
  • The code generated by Safe Args now properly handles using an app:argType pointing to a static inner class in the format .OuterClass$InnerClass . b/123736741
  • The Java code generated by Safe Args now properly handles global actions and deeply nested destinations. b/123347762

Version 1.0.0-alpha11

۲۳ ژانویه ۲۰۱۹

This is a hotfix release of 1.0.0-alpha10 that fixes an issue with Safe Args.

رفع اشکالات

  • Fixes an issue where Safe Args would fail to import the Directions class associated with global actions. b/123307342

Version 1.0.0-alpha10

۲۳ ژانویه ۲۰۱۹

مشکلات شناخته شده

  • Safe Args fails to import the Directions class associated with global actions. b/123307342

This release contains breaking API changes; please see the Breaking Changes section below.

ویژگی‌های جدید

  • Kotlin users can now use the by navArgs() property delegate to lazily get a reference to a Safe Args generated NavArgs class in an Activity or Fragment . b/122603367
  • Safe Args now allows you to generate Kotlin code by applying the androidx.navigation.safeargs.kotlin plugin. The Kotlin code is built specifically for Kotlin only modules, using default arguments and immutable classes over the builder pattern that is still available via the previous androidx.navigation.safeargs plugin. b/110263087

تغییرات رفتاری

  • Matching deep links are now biased towards the deep link that has the most matching arguments. b/118393029
  • Calling setGraph() on a NavController will now reset the back stack. b/111450672
  • Unknown deep links no longer throw an IllegalStateException , but are ignored, fixing issues with nested or multiple NavHostFragment s. b/121340440

Breaking Changes

  • The NavOptions.applyPopAnimationsToPendingTransition() method for applying pop animations to an Activity has been moved to ActivityNavigator . b/122413117
  • Safe Args now avoids duplicating identical classes for actions without arguments. The return type for no argument methods in generated NavDirections classes is now NavDirections . b/123233147
  • Safe Args generated Directions classes no longer have a public constructor - you should only be interacting with the generated static methods. b/123031660
  • Safe Args generated NavDirections classes no longer have a public constructor - they should only be generated via the static methods in the generated Directions classes. b/122963206
  • The returned Bundle from NavDirections ' getArguments() is now marked as @NonNull rather than @Nullable . b/123243957

رفع اشکالات

  • NavDeepLinkBuilder now correctly handles multiple simultaneous PendingIntent s to the same destination by using the arguments you pass in to determine the uniqueness. b/120042732
  • NavController now correctly handles popBackStack() operations when using a nested NavHostFragment or other child Fragments with a back stack. b/122770335
  • NavigationUI now correctly sets the content description of the Up button. b/120395362
  • Safe Args generated Directions classes now correctly handle global actions that have the same id as an action on a destination. b/122962504
  • Safe Args generated NavDirections classes now correctly have equal hashCode() values when equals() would return true. b/123043662
  • FragmentNavigator now throws a better error message if you attempt to do custom FragmentTransactions on the NavHostFragment 's FragmentManager . You should always use getChildFragmentManager() . b/112927148

Version 1.0.0-alpha09

۱۸ دسامبر ۲۰۱۸

This release contains breaking API changes; please see the Breaking Changes section below.

We have chosen not to continue development of the android.arch.navigation:navigation-testing artifact. While it has proven helpful for internal testing of NavController , we strongly recommend alternate testing strategies, such as mocking the NavController instance in order to verify that the correct navigate() calls are being done. This approach is discussed in detail in the Single Activity talk at AndroidDevSummit 2018 and we'll be working on additional documentation specifically around testing with Navigation.

ویژگی‌های جدید

  • MenuItem s with menuCategory="secondary" will no longer pop the back stack when used with NavigationUI methods. b/120104424
  • AppBarConfiguration now allows you to set a fallback OnNavigateUpListener instance which will be called when navController.navigateUp() returns false . b/79993862 b/120690961

Breaking Changes

  • When using an <argument> with an argType="reference" , Navigation no longer parses the reference, instead providing the raw resource ID itself. b/111736515
  • onNavDestinationSelected() now pops back to the start destination of your navigation graph by default, making them consistent with the setup methods. Add menuCategory="secondary" to your MenuItem to avoid popping the back stack. aosp/852869
  • The fromBundle() methods of generated Args classes now take a non-null Bundle instead of a nullable Bundle aosp/845616

رفع اشکالات

  • Arguments are now properly parsed from deep links as the correct argType instead of always as strings b/110273284
  • Navigation now correctly exports its public resources b/121059552
  • Safe Args is now compatible with Android Gradle Plugin 3.4 Canary 4 and higher b/119662045

Version 1.0.0-alpha08

December 6, 2018

This release contains breaking API changes; please see the Breaking Changes section below.

ویژگی‌های جدید

  • Destination labels, when used with NavigationUI methods, will now automatically replace {argName} instances in your android:label with the correct argument b/80267266
  • Navigation now depends on Support Library 28.0.0 b/120293333

Breaking Changes

  • OnNavigatedListener has been renamed to OnDestinationChangedListener b/118670572
  • OnDestinationChangedListener now also passes the Bundle of arguments aosp/837142
  • The app:clearTask and app:launchDocument attributes and their associated methods have been removed. Use app:popUpTo with the root of your graph to remove all destinations from your back stack. b/119628354
  • ActivityNavigator.Extras now uses a Builder pattern and adds the ability to set any Intent.FLAG_ACTIVITY_ flags aosp/828140
  • NavController.onHandleDeepLink has been renamed to handleDeepLink aosp/836063
  • Many classes and methods not meant for subclassing, such as NavOptions , NavInflater , NavDeepLinkBuilder , and AppBarConfiguration , have been made final aosp/835681
  • The deprecated NavHostFragment.setGraph() method has been removed aosp/835684
  • The deprecated NavigationUI.navigateUp(DrawerLayout, NavController) method has been removed. aosp/835684
  • Fragment creation has been moved to FragmentNavigator , making it easier to delegate Fragment creation to a FragmentFactory . b/119054429
  • The constructor for NavGraphNavigator no longer takes a Context aosp/835340
  • NavigatorProvider is now a class, rather than an interface. The NavigatorProvider returned by getNavigatorProvider() has not changed its functionality. aosp/830660
  • NavDestination.navigate() has been removed. Call navigate() on the Navigator instead. aosp/830663
  • Significant refactoring of Navigator , removing the need for OnNavigatorNavigatedListener and instead having navigate return the NavDestination that was navigated to.
  • Navigator instances can no longer send pop events to the NavController . Consider using a OnBackPressedCallback to intercept back button presses and call navController.popBackStack() . aosp/833716

رفع اشکالات

  • popUpTo now works consistently when the destination is a <navigation> element b/116831650
  • Fixed a number of bugs that resulted in an IllegalArgumentException when using nested graphs b/118713731 b/113611083 b/113346925 b/113305559
  • The dataPattern attribute of <activity> destinations will now populate arguments from non-String arguments by calling toString() b/120161365

Safe Args

  • Safe Args supports Serializable objects, including Enum values. Enum types can set a default value by using the enum literal without the class name (eg app:defaultValue="READ" ) b/111316353
  • Safe Args supports arrays of all supported types b/111487504
  • Safe Args now ignores subfolders of resource directories b/117893516
  • Safe Args adds @Override annotations where appropriate b/117145301

Version 1.0.0-alpha07

۲۹ اکتبر ۲۰۱۸

ویژگی‌های جدید

Breaking Changes

  • The navigation-testing-ktx module has been folded into the navigation-testing artifact and will no longer be published.
  • The navigation-testing artifact now has a dependency on the Kotlin standard library. The API has been changed to be more consistent with Kotlin conventions, but you can continue to use it for tests written in Java.
  • Metadata manifest registered navigation graphs are no longer supported. b/118355937
  • Actions can no longer be attached to <activity> destinations. aosp/785539

رفع اشکالات

  • Deep links now correctly parse query parameters. b/110057514
  • Activity destinations now correctly apply all enter and exit animations. b/117145284
  • Fixed crash that occurs after configuration changes when using custom Navigators. b/110763345

Safe Args

  • Safe args now have a fixed dependency on Android Gradle Plugin 3.2.1. b/113167627
  • Directions can now be generated for inner classes. b/117407555
  • Fixed an issue with generating Directions to an <include> graph. b/116542123

Version 1.0.0-alpha06

۲۰ سپتامبر ۲۰۱۸

ویژگی‌های جدید

تغییرات API

  • Breaking Change: The Navigator navigate() method now takes a Navigator.Extras parameter.
  • NavController's getGraph() method is now NonNull b/112243286

رفع اشکالات

  • NavigationUI.setupWithNavController() no longer leaks views if used with views from individual destinations b/111961977
  • Navigator onSaveState() is now only called once b/112627079

Safe Args

  • Navigation destination Directions classes now extend their parent's Directions class if it exists b/79871405
  • Directions and Args classes now have a useful toString() implementation b/111843389

Version 1.0.0-alpha05

۱۰ آگوست ۲۰۱۸

رفع اشکالات

  • Fix a bug which cause incorrect backstack behavior. b/111907708
  • Fix a bug in equals() of Generated Args classes. b/111450897
  • Fix a build failure in Safe Args. b/109409713
  • Fix a conversion from resource identifiers to java names b/111602491
  • Fix error messages about nullability in Safe Args plugin.
  • Add missing nullability annotations.

Version 1.0.0-alpha04

۱۹ ژوئیه ۲۰۱۸

Navigation 1.0.0-alpha04 and the associated Safe Args gradle plugin contains a number of API changes, behavior changes, and bug fixes.

API / Behavior Changes

  • NavHostFragment will always set the current Fragment as the primary navigation fragment, ensuring that child fragment managers are popped before the outer NavController is popped b/111345778

Safe Args

  • Breaking Change: app:type has been changed to app:argType to avoid conflicts with other libraries such as ConstraintLayout 2.0.0-alpha1 b/111110548
  • Error messages from Safe Args are now clickable b/111534438
  • Args classes now confirms that NonNull attributes are actually not null b/111451769
  • Additional NonNull annotations have been added to NavDirections and Args generated classes b/111455455 b/111455456

رفع اشکالات

  • Fixed an issue with the system back button after deep linking to a fragment destination b/111515685

Version 1.0.0-alpha03

July 12, 2018

Navigation 1.0.0-alpha03 and the associated Safe Args gradle plugin contains a number of API changes, behavior changes, and bug fixes.

API / Behavior Changes

  • A NavigationUI.setupWithNavController method for Toolbar has been added b/109868820
  • A NavigationUI.setupWithNavController method for CollapsingToolbarLayout has been added b/110887183
  • popBackStack() now returns false when the back stack is empty or when the given destination ID is not in the back stack b/110893637
  • FragmentNavigator now ignores navigation operations after FragmentManager has saved state, avoiding “Can not perform this action after onSaveInstanceState” exceptions b/110987825

Safe Args

  • Breaking Change: Non-alphanumeric characters in action and argument names will be replaced by camel casing in the respective NavDirections method names
    • Eg DemoController.index will become setDemoControllerIndex b/79995048
    • Eg action_show_settings will become actionShowSettings b/79642240
  • Breaking Change: Arguments are now considered non-null by default. To allow null values on string and parcelable arguments, add app:nullable="true" b/79642307
  • You can now use app:type="long" with defaultValues in the form of “123L” b/79563966
  • Parcelable arguments are now supported, using a fully qualified class name for app:type . The only default value supported is "@null" b/79563966
  • Args classes now implement equals() and hashCode() b/79642246
  • The Safe Args plugin can now be applied to library projects b/80036553
  • The Safe Args plugin can now be applied to feature projects b/110011752

رفع اشکالات

  • Fixed issues when navigating during Fragment lifecycle methods b/109916080
  • Fixed issues when navigating through nested graphs multiple times b/110178671
  • Fixed issues when using setPopUpTo with the first destination in the graph b/109909461
  • Fixed issue where all app:defaultValue values were being passed as Strings b/110710788
  • aapt2 bundled with Android Gradle Plugin 3.2 Beta 01 now adds keep rules for every android:name attribute in Navigation XML files b/79874119
  • Fixed memory leak when replacing the default FragmentNavigator b/110900142

نسخه ۱.۰.۰-آلفا۰۲

۷ ژوئن ۲۰۱۸

تغییرات رفتاری

  • FragmentNavigator now uses setReorderingAllowed(true) . b/109826220

  • Navigation now URLDecodes arguments parsed from deep links URLs. b/79982454

رفع اشکالات

  • Fixed an IllegalStateException when calling navigate from Fragment lifecycle methods. b/79632233

  • Navigation now depends on Support Library 27.1.1 to fix flickering when using animations. b/80160903

  • Fixed an IllegalArgumentException when using defaultNavHost="true" as a child fragment. b/79656847

  • Fixed a StackOverflowError when using NavDeepLinkBuilder. b/109653065

  • Fixed an IllegalArgumentException when navigating back to a nested graph. b/80453447

  • Fixed an issue with overlapping Fragments when using launchSingleTop . b/79407969

  • Navigation now builds the correct synthetic back stack for nested graphs. b/79734195

  • NavigationUI will now highlight the correct item when using a nested graph as a MenuItem . b/109675998

تغییرات API

  • The clearTask attribute for actions and the associated API in NavOptions has been deprecated. b/80338878

  • The launchDocument attribute for actions and the associated API in NavOptions has been deprecated. b/109806636

نسخه ۱.۰.۰-آلفا۰۱

۸ مه ۲۰۱۸

Navigation provides a framework for building in-app navigation. This initial release is 1.0.0-alpha01 .