navigation3

  
‫Navigation 3 کتابخانه پیمایش جدیدی است که برای کار با Compose طراحی شده است.
جدیدترین به‌روزرسانی نسخه پایدار نامزد انتشار انتشار نسخه بتا نسخه آلفا
‫۴ نوامبر ۲۰۲۶ ۱.۲.۱ - - 1.3.0-alpha04

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

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

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

Groovy

dependencies {
    implementation "androidx.navigation3:navigation3-runtime:1.3.0-alpha04"
    implementation "androidx.navigation3:navigation3-ui:1.3.0-alpha04"
}

Kotlin

dependencies {
    implementation("androidx.navigation3:navigation3-runtime:1.3.0-alpha04")
    implementation("androidx.navigation3:navigation3-ui:1.3.0-alpha04")
}

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

بازخورد

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

ایجاد مشکل جدید

برای اطلاعات بیشتر، مستندات Issue Tracker را ببینید.

نسخه ۱.۳

نسخه 1.3.0-alpha04

‫۴ نوامبر ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.3.0-alpha04 منتشر شده است. نسخه 1.3.0-alpha04 حاوی این ارسال‌ها است.

رفع اشکال‌ها

  • Fix shared NavEntry not rendered on screen when it is popped then pushed again before the pop completes. (I6a482)

نسخه 1.3.0-alpha03

‫۲۱ اکتبر ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.3.0-alpha03 منتشر شده است. نسخه 1.3.0-alpha03 حاوی این ارسال‌ها است.

بدون تغییر نسبت به 1.3.0-alpha02

نسخه 1.3.0-alpha02

‫۷ اکتبر ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.3.0-alpha02 منتشر شده است. نسخه 1.3.0-alpha02 حاوی این commitها است.

تغییرات میانای برنامه‌سازی کاربردی

  • کلاس SceneInfo ویژگی‌های title و url را اضافه کرده است که به‌طور خودکار از آخرین فراداده NavEntry's «صحنه» پر می‌شوند. از TitleMetadataKey و UrlMetadataKey برای تعریف عنوان‌ها و نشانی‌های وب مقصد در فراداده ورودی استفاده کنید. (I78a20، b/542693522)

نسخه 1.3.0-alpha01

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

‫androidx.navigation3:navigation3-*:1.3.0-alpha01 منتشر شده است. نسخه 1.3.0-alpha01 حاوی این ارسال‌ها است.

رفع اشکال‌ها

  • مشکل انتقال پویانمایی اشاره برگشت پیش‌گویانه در NavDisplay با انتقال به DeferredAnimatedContent و حل مشکلات انتقال برطرف شد. I145eaedd b/430807423
    • DeferredAnimatedContent از DeferredTransition برای جدا کردن انتقال‌ها به یک فاز معوق (ازطریق defer) استفاده می‌کند که تبدیل‌های دستی را درطول اشاره تند کشیدن اعمال می‌کند، و یک فاز خودکار (ازطریق animateTo) که انتقال را هنگام انجام تند کشیدن اجرا می‌کند.

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

  • عناصر هم‌رسانی‌شده درطول انتقال به‌جای صحنه ورودی در صحنه خروجی رندر می‌شوند. (b/582354988)
  • عناصر هم‌رسانی‌شده درطول مرحله تعویق (اشاره) جستجو نمی‌کنند.

نسخه ۱.۲.۱

‫۴ نوامبر ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.2.1 منتشر شده است. نسخه ۱.۲.۱ حاوی این ثبت‌ها است.

تغییرات

  • ‫compileSdk از ۳۷ به ۳۶ تنزل یافته است. نسخه ۱.۲ به Compose 1.10 وابسته است که به compileSdk ۳۷ نیاز ندارد.

نسخه ۱.۲.۰

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

‫androidx.navigation3:navigation3-*:1.2.0 منتشر شده است. نسخه ۱.۲.۰ حاوی این ثبت‌ها است.

‫نسخه ۱.۲.۰ اکنون پایدار است!

تغییرات مهم از نسخه ۱.۱.۰

Result API

  • این میانای برنامه‌سازی کاربردی جدید امکان انتقال نتایج بین NavEntries را بااستفاده از ResultEventBus ارائه‌شده توسط LocalResultEventBus و ResultEventBusNavEntryDecorator فراهم می‌کند.
  • ‫rememberResultEventBus برای پشتیبانی از بالا بردن ResultEventBus در خارج از ResultEventBusNavEntryDecorator و ارسال آن به rememberResultEventBusNavEntryDecorator اضافه شد.
  • نتایج ارسال‌شده را می‌توان به‌عنوان وضعیت با ResultEventBus#conflateAsState دسترسی پیدا کرد یا به‌عنوان جریان نتایج با ResultEffect جمع‌آوری کرد.

Deep Link API

Navigation3 اکنون از پیوندهای عمیق Kotlin Multiplatform (KMP) در androidx.navigation3.runtime.deeplink ازطریق DeepLinkRequest، DeepLinkUri، و DeepLinkMatcher پشتیبانی می‌کند.

  • DeepLinkRequest و RequestExtras: نشان‌دهنده درخواست پیوند عمیق ایجادشده از DeepLinkUri، رشته URI، یا Intent Android است. فراداده‌های درخواست اضافی را می‌توان بااستفاده از محفظه RequestExtras ایمن ازنظر نوع که با requestExtras DSL و RequestExtrasKey<T> ساخته شده است پیوست کرد.
  • ‫DeepLinkMatcher: نشان‌دهنده پیوند عمیقی است که می‌تواند با DeepLinkRequest مطابقت داده شود. هر نمونه تطبیق‌دهنده با کلید پیمایشی که از این پیوند عمیق پشتیبانی می‌کند مرتبط است. کلید پیمایش می‌تواند با چند تطبیق‌دهنده مرتبط باشد. فراخوانی DeepLinkMatcher.match یک MatchResult برمی‌گرداند که درصورت موفقیت‌آمیز بودن مطابقت، حاوی کلید پیمایش مرتبط است. دو پیاده‌سازی پیش‌فرض DeepLinkMatcher وجود دارد: UriDeepLinkMatcher برای مطابقت دادن پیوندهای عمیق براساس Uri، و StaticKeyDeepLinkMatcher برای مطابقت دادن پیوندهای عمیق فقط با DeepLinkMatcher.Filter که با بولی مطابقت دارند.
  • BackStackMatcher: DeepLinkMatcher برای ساختن پشته قبلی‌های مصنوعی پس‌از مطابقت موفقیت‌آمیز پیوند عمیق. BackStackMatcher را می‌توان ازطریق تابع افزونه DeepLinkMatcher.withBackStack ایجاد کرد.

مدیریت برگشت پیش‌گویانه

  • NavigationBackHandler و rememberNavigationEventState برای ساده کردن اتصال SceneState با مدیریت برگشت پیش‌گویانه (onBackCompleted و onBackCancelled) اضافه شد. این کار به مؤلفه‌های میانای کاربر سفارشی امکان می‌دهد تا از پیمایش به عقب استاندارد و اشاره‌های برگشت پیش‌گویانه بدون محاسبه دستی دلتاهای پشته قبلی‌ها پشتیبانی کنند.
  • بهبود انتقال‌های اشاره برگشت پیش‌گویانه، ازجمله پشتیبانی از اشاره‌های برگشت پیش‌گویانه که در میان پویانمایی‌های روبه‌جلو راه‌اندازی می‌شوند.

تغییرات دیگر

  • NavEntry.contentKey اکنون به‌طور پیش‌فرض ترکیبی از key.toString() و key::class.toString() است، که از تداخل کلیدها بین کلیدهای data object که نام ساده یکسانی در رابط‌های مختلف دارند جلوگیری می‌کند.
  • EntryProvider اکنون مطابقت را براساس نمونه‌های کلید نسبت‌به انواع کلید در اولویت قرار می‌دهد.
  • بررسی lint اضافه شد تا اطمینان حاصل شود که پیاده‌سازی‌های Scene یا data class هستند یا equals و hashCode را پیاده‌سازی می‌کنند.

نسخه 1.2.0-rc01

‫۹ سپتامبر ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.2.0-rc01 منتشر شده است. نسخه 1.2.0-rc01 حاوی این ارسال‌ها است.

رفع اشکال‌ها

  • نام‌های جای‌بان تکراری در الگوهای URI پیوند عمیق مجاز نیست. (I8985c، b/522343165)

نسخه 1.2.0-beta01

‫۲۶ اوت ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.2.0-beta01 منتشر شده است. نسخه 1.2.0-beta01 حاوی این موارد ثبت است.

تغییرات میانای برنامه‌سازی کاربردی

  • ‫DeepLinkRequest.extras از Map<String, Any> به کلاس جدید ایمن ازنظر نوع شبیه به نقشه RequestExtras که جفت‌های RequestExtrasKey<T> به T را ذخیره می‌کند بازسازی کد شد. ‫RequestExtras را می‌توان با requestExtras DSL نمونه‌سازی کرد. (Ic929d،‏ b/543883369)

رفع اشکال‌ها

  • مشکلی که باعث می‌شد اشاره‌های برگشت پیش‌گویانه که درطول انتقال روبه‌جلو راه‌اندازی می‌شوند در پاسخ به پیشرفت تند کشیدن پویانمایی نشوند برطرف شد. اکنون اشاره برگشت پیش‌گویانه به‌درستی پویانمایی و تکمیل می‌شود. (Icdcb0، b/456218398)
  • بررسی lint اضافه شد تا اطمینان حاصل شود که پیاده‌سازی‌های Scene یا کلاس‌های داده هستند یا equals و hashcode را پیاده‌سازی می‌کنند تا اطمینان حاصل شود که درصورت لزوم از همان Scene استفاده می‌شود. (Ibdf0d، b/542316099)
  • NavEntry.contentKey اکنون به‌طور پیش‌فرض ترکیبی از key.toString() و key::class.toString() است. این کار تضمین می‌کند که اشیای داده‌ای که نام یکسانی دارند اما میاناهای متفاوتی را پیاده‌سازی می‌کنند دیگر contentKey یکسانی نداشته باشند. بااین‌حال، key::class پلاتفرم JS فقط نام کلاس ساده را به‌جای نام کاملاً واجدشرایط برمی‌گرداند، بنابراین پلاتفرم JS همچنان باید contentKey سفارشی را برای اشیای داده با نام‌های تکراری پیاده‌سازی کند. (I1fbbb، b/512534342)
  • IllegalArgumentException که توسط SaveableStateProvider برای کلیدهای تکراری استفاده‌شده درطول پیمایش سریع به عقب هنگام درحال اجرا بودن چند انتقال پاپ‌آپ ایجاد می‌شد برطرف شد. (I4d728، b/516312097)

نسخه 1.2.0-alpha07

‫۲۹ ژوئیه ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.2.0-alpha07 منتشر شده است. نسخه 1.2.0-alpha07 حاوی این ارسال‌ها است.

تغییرات میانای برنامه‌سازی کاربردی

  • کلاس انتزاعی WrappedMatchResult برای پوشاندن DeepLinkMatcher.MatchResult دیگر اضافه شد. این کار باعث می‌شود نتایج منطبق سفارشی‌شده روی نتیجه دیگری قرار بگیرد. (I7d4dc، b/470282247)
  • کلاس جدید BackStackMatcher اضافه شد که دو پارامتر می‌گیرد: یک نمونه تطبیق‌دهنده، و یک سازنده لامبدا که نتیجه تطابق تطبیق‌دهنده ورودی را ارائه می‌دهد و یک پشته قبلی‌ها برمی‌گرداند. درصورت مطابقت موفق، BackStackMatcher یک BackStackMatchResult برمی‌گرداند که WrappedMatchResult را گسترش می‌دهد و حاوی نتیجه مطابقت اصلی به‌همراه پشته قبلی‌ها ساخته‌شده با لامبدا است. BackStackMatcher را فقط می‌توان با تابع افزونه جدید DeepLinkMatcher.withBackStack ایجاد کرد. (Ibf987، b/470282247)

  • کلاس DeepLinkSerializer انتزاعی اضافه شد که KSerializer را برای کدگذاری و کدگشایی value : T به‌عنوان String گسترش می‌دهد. از DeepLinkSerializer می‌توان برای سریال‌سازی آرگومان‌های پیوند عمیق غیرابتدایی استفاده کرد. سازگار با rememberSaveable و rememberNavBackStack. (Id3c9f، b/470282247)

  • ‫DeepLinkMatcher پارامتر نوع دوم out R : DeepLinkMatcher.MatchResult<T> را اضافه کرده است تا توسعه‌دهندگان بتوانند بدون تبدیل نوع به ویژگی‌های MatchResult زیرکلاس‌شده که توسط DeepLinkMatcher.match() برگردانده شده است دسترسی داشته باشند. (I693d3، b/470282247)

  • کران بالای DeepLinkMatcher.MatchResult's T از Any? به Any تغییر کرده است. (I6bf1a)

  • فیلد سازنده DeepLinkRequest uri اکنون به‌طور پیش‌فرض null است. نام uriString سازنده ثانویه به uri تغییر کرده است. (Ia0f14، b/522194187)

رفع اشکال‌ها

  • ‫ResultEffect اکنون از rememberUpdatedState برای ضبط جدیدترین onResult lambda استفاده می‌کند. (I7d2a3، b/531709234)
  • تطابق پیوند عمیق برای بخش‌های مسیر خالی اصلاح شد. اگر نوع آرگومان «رشته» باشد، مسیر خالی به‌عنوان مقدار رشته خالی درنظر گرفته خواهد شد. درغیراین‌صورت، مسیر خالی به‌عنوان مقداری که ارائه نشده است درنظر گرفته می‌شود و به مقدار پیش‌فرض برمی‌گردد. اگر مقدار پیش‌فرضی وجود نداشته باشد، مطابقت ناموفق خواهد بود. (I56575، b/535298128)
  • پشتیبانی از مقادیر پُرسمان خالی در DeepLinkRequest.uri اضافه شد. اگر آرگومان از نوع «رشته» باشد، مقدار خالی به‌عنوان رشته خالی تحت‌اللفظی درنظر گرفته می‌شود. درغیراین‌صورت، مقدار خالی به‌عنوان مقدار ارائه‌نشده درنظر گرفته می‌شود و مطابقت‌یابی تلاش می‌کند به مقدار پیش‌فرض بازگردد. اگر مقدار پیش‌فرضی وجود نداشته باشد، مطابقت ناموفق خواهد بود. (I30343، b/535127459)
  • EntryProvider اکنون مطابقت را براساس نمونه‌های کلید نسبت‌به انواع کلید در اولویت قرار می‌دهد. (Ib5ec9، b/533331924)
  • SceneState اکنون صحنه‌های قبلی را به‌درستی از بالاترین صحنه غیرهم‌پوشان محاسبه می‌کند. (I91915، b/513630541)

نسخه 1.2.0-alpha06

‫۱۵ ژوئیه ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.2.0-alpha06 منتشر شده است. نسخه 1.2.0-alpha06 حاوی این موارد ثبت است.

رفع اشکال‌ها

  • UriDeepLinkMatcher سند مربوط به قطعه‌های URI اصلاح شد تا مشخص شود که قطعه‌های دارای نویسه عام با هر ورودی‌ای مطابقت خواهند داشت اما ورودی به‌عنوان آرگومان استخراج نمی‌شود. (I5ad9b، b/524677091)
  • مشکل عدم تطابق UriDeepLinkMatcher با درخواست درصورت عدم وجود طرح‌واره در الگوی URI یا عدم شروع با دو خط مورب برطرف شد. برای مثال، www.example.com/home اکنون با http://www.example.com/home مطابقت خواهد داشت. (Ia6b65، b/522791926)

نسخه 1.2.0-alpha05

‫۱ ژوئیه ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.2.0-alpha05 منتشر شده است. نسخه 1.2.0-alpha05 حاوی این موارد ارسال است.

میانای برنامه‌سازی کاربردی جدید

  • یک rememberResultEventBus api اضافه شد که یک ResultEventBus برمی‌گرداند که می‌تواند به rememberResultEventBusNavEntryDecorator منتقل شود. این کار امکان بالا بردن ResultEventBus را در خارج از ResultEventBusNavEntryDecorator فراهم می‌کند. (Ia655b، b/516995400)

DeepLinkRequest

  • دو سازنده سازگار با KMP اضافه شد - یکی که DeepLinkUri را می‌گیرد و دیگری که uri رشته خام را می‌گیرد. (I3c088، b/513200887، b/522194187)
  • (فقط Android) سازنده‌ای اضافه شد که Intent را می‌گیرد. (Ia0498،‏ b/513200887،‏ b/522194187)
  • همه سازنده‌ها فیلد extras دیگری برای Map<String, Any> دارند تا اطلاعات درخواست اضافی را پیوست کنند. (If81d5،‏ b/513200887)
  • requestExtras dsl جدیدی به‌عنوان روشی ایمن ازنظر نوع برای ساختن نقشه‌ای از موارد اضافی اضافه شده است. dsl تابع put را برای ذخیره جفت‌های RequestExtrasKey تا Any ارائه می‌دهد. از تابع افزونه Map<String, Any>.get(key) می‌توان برای خواندن از نقشه با RequestExtrasKey استفاده کرد (I5091c، b/513200887)
  • (فقط Android) تابع ActionExtrasKey و actionExtra برای ایجاد نقشه موارد اضافی با ActionExtrasKey اضافه شد. (Id0c90, [b/513200887]
  • تابع MimeTypeExtrasKey و mimeTypeExtra برای ایجاد نقشه موارد اضافی با MimeTypeExtrasKey اضافه شد. (I85131، b/513200887)

DeepLinkMatcher

  • توابع DeepLinkMatcher.mimeTypeFilter و DeepLinkMatcher.actionFilter برای ایجاد DeepLinkMatcher.Filters اضافه شد که DeepLinkRequest را براساس mimeType یا action فیلتر می‌کند (فقط Android). هر دو فیلتر براساس برابری رشته مطابقت داده می‌شوند و به حروف بزرگ و کوچک حساس نیستند. (Ie7e67، b/513191950)

تغییرات میانای برنامه‌سازی کاربردی

DeepLinkRequest

  • برداشتن تابع کارخانه fromAction. برای ایجاد درخواست مرتبط با «کنش»، از فیلد جدید DeepLinkRequest.extras استفاده کنید.(Id0c90، b/513200887)
  • تابع کارخانه‌ای fromMimeType برداشته شد. برای ایجاد درخواست مرتبط با mimeType، از فیلد جدید DeepLinkRequest.extras استفاده کنید. (I85131، b/513200887)
  • (فقط Android) تابع کارخانه fromIntent برداشته شد. با سازنده جدیدی که Intent و نقشه موارد اضافی را می‌گیرد جایگزین شده است. (Ia0498،‏ b/513200887،‏ b/522194187)
  • توابع کارخانه‌ای fromUri و fromUriString برداشته شد. با سازنده‌های جدیدی جایگزین شده است که یا DeepLinkUri یا رشته خام URI را می‌گیرند. (Id5b6f، b/522194187)
  • DeepLinkMatcher، DeepLinkMatcher.MatchResult و زیرکلاس‌های آن‌ها اکنون یک T هم‌وردا (T خروجی) می‌گیرند تا کلیدهای سلسله‌مراتبی هنگام استفاده با Matchers نیازی به تبدیل نوع نداشته باشند. (I1e453، b/525094876)
  • پارامتر سازنده UriMatchResult برای نقشه آرگومان‌ها اکنون به‌طور پیش‌فرض روی نقشه خالی تنظیم شده است. (I3acdd)
  • کلاس انتزاعی DeepLinkMatcher.Filter اکنون یک میانای کاربردی است. فیلد سازنده filter برداشته شده است و درعوض باید مستقیماً در زیرکلاس ارسال شود. (I9eb7d، b/522194187)

رفع اشکال‌ها

  • مشکل ناپدید شدن فوری ورودی پاپ‌شده هنگام پاپ کردن به ورودی‌ای که فراداده تودرتو حاوی مقادیر lambda دارد برطرف شد. (Idb872، b/520494430)
  • UriDeepLinkMatcher اصلاح شد تا وقتی آرگومان‌های الزامی درطول تطبیق وجود ندارد، به‌جای ایجاد MissingFieldException، مقدار تهی UriMatchResult را برگرداند. (I5322f، b/524663005)
  • UriDeeplinkMatcher حاوی شناسه منبع یکسان با طرح‌واره https فقط می‌تواند با درخواست‌هایی مطابقت داده شود که طرح‌واره https نیز دارند. (Ibfe22، b/522304329)
  • ‫UriDeepLinkMatcher را اصلاح کنید تا طرح http را به‌درستی به‌عنوان تطابق مثبت با https هنگام تطبیق DeepLinkRequest با UriDeepLinkMatcher شناسایی کند. (I3a62b، b/518804264)
  • اکنون مقایسه‌گر DeepLinkMatcher.MatchResult به‌طور پیش‌فرض وقتی دو نتیجه برابر باشند، 0 را برمی‌گرداند. (I48ddb، b/518841353)
  • اکنون وقتی درخواست مطابقت به‌دلیل نبودن متغیرهای مستقل الزامی ناموفق باشد، UriDeepLinkMatcher به‌جای ایجاد استثنا، UriMatchResult تهی برمی‌گرداند. (I669a7،‏ b/470282247،‏ b/512923412)

نسخه 1.2.0-alpha04

‫۳ ژوئن ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.2.0-alpha04 منتشر شده است. نسخه 1.2.0-alpha04 حاوی این ارسال‌ها است.

رفع اشکال‌ها

  • مشکل پویانمایی رونهاد برطرف شد که در آن رونهادهای تودرتو مانند ModalBottomSheet وقتی رونهادهای بالای آن ظاهر می‌شوند به‌طور غیرمنتظره‌ای دوباره پویانمایی می‌شوند. (Ia2b9e، b/502624496)

نسخه 1.2.0-alpha03

۱۹ مه ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.2.0-alpha03 منتشر شده است. نسخه 1.2.0-alpha03 حاوی این ارسال‌ها است.

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

‫Navigation 3 اکنون از پیوندهای عمیق با DeepLinkRequest و DeepLinkMatcher پشتیبانی می‌کند:

  • DeepLinkRequest پیوند عمیق درخواست‌شده حاوی DeepLinkUri و mimeType یا کنش اختیاری (فقط Android). همراه با کلاس جدید، توابع همراهی برای ایجاد نمونه با uri، mimeType، یا action وجود دارد. پلاتفرم Android همچنین دارای یک کمک‌کننده برای ساختن درخواست از Intent است. (Iaaac9، b/470282247)

    val uriOnlyRequest = DeepLinkRequest.fromUriString("https://sampledeeplink.com/home")
    val uriAndMimeRequest = DeepLinkRequest.fromUriString(
      "https://sampledeeplink.com/user/profile?id=123",
      "image/png"
    )
    
  • DeepLinkMatcher نشان‌دهنده پیوند عمیقی است که می‌تواند با DeepLinkRequest مطابقت داده شود. هر نمونه تطبیق‌دهنده با کلید پیمایشی که از این پیوند عمیق پشتیبانی می‌کند مرتبط است. کلید پیمایش می‌تواند با چند تطبیق‌دهنده مرتبط باشد. فراخوانی DeepLinkMatcher.match یک MatchResult برمی‌گرداند که درصورت موفقیت‌آمیز بودن مطابقت، حاوی کلید پیمایش مرتبط است. دو پیاده‌سازی پیش‌فرض DeepLinkMatcher وجود دارد: UriDeepLinkMatcher برای مطابقت دادن پیوندهای عمیق براساس Uri، و StaticKeyDeepLinkMatcher برای مطابقت دادن پیوندهای عمیق فقط با DeepLinkMatcher.Filter که با Boolean مطابقت دارند. (I3798e، b/470282247)

  • UriDeepLinkMatcher یک پیاده‌سازی نظری از DeepLinkMatcher است که پیوند عمیق را با مطابقت دادن DeepLinkUri با کلید پیمایش «سریال‌شدنی» مدیریت می‌کند. از آرگومان‌های پیوند عمیق از انواع Primitive یا Collection of primitives مانند Lists،‏ Arrays، و Sets پشتیبانی می‌کند. (I1520b، b/470282247)

    @Serializable
    data class UserKey(val id: Int): NavKey
    
    // declare a deep link supported by UserKey
    val userMatcher = UriDeepLinkMatcher(
      uriPattern = "www.sampledeeplink.com/user?userId={id}",
      serializer = serializer<UserKey>()
    )
    
    // handle a requested deep link with fallback key
    val key = userMatcher.match(deepLinkRequest)?.key ?: HomeKey
    
  • ‫DeepLinkUri که نسخه kotlin-multiplatform از android.net.Uri است اضافه شد (Id4725، b/470282247)

تغییرات میانای برنامه‌سازی کاربردی

  • به compileSdk 37 ارتقا یافت تا با compileSdk مربوط به Compose مطابقت داشته باشد

رفع اشکال‌ها

  • IllegalArgumentException AnimatedBottomSheetSample هنگام نمایش چند رونهاد رفع شد. نمونه SceneStrategy اکنون آخرین غیرOverlayScene را به‌درستی محاسبه می‌کند و آن را زیر همه صحنه‌های هم‌پوشانی نمایش می‌دهد. (If2281, b/506733412)
  • وابستگی NavigationEvent به نسخه ۱.۱.۱ ارتقا داده شد که NavigationEventHandler بدون عملیات را در حالت بازرسی برمی‌دارد تا «بازگشت پیش‌بینانه» در «پیش‌نمایش‌های استودیو Android» فعال شود. (I487fd)

نسخه 1.2.0-alpha02

‫۲۲ آوریل ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.2.0-alpha02 منتشر شده است. نسخه 1.2.0-alpha02 حاوی این ارسال‌ها است.

تغییرات میانای برنامه‌سازی کاربردی

  • onBack را به onBackCompleted تغییر نام دهید و onBackCancelled را به NavigationBackHandler اضافه کنید تا از مدیریت اشاره‌های لغوی لغوشده پشتیبانی شود. (I92741)
  • NavigationBackHandler را اضافه کنید تا مدیریت اشاره‌های برگشت و برگشت پیش‌گویانه هنگام استفاده از SceneState ساده شود. این کار به توسعه‌دهندگان اجازه می‌دهد تا راحت‌تر مؤلفه‌های میانای کاربر سفارشی ایجاد کنند که از پیمایش به عقب استاندارد و اشاره‌های پیش‌بینی‌کننده بدون محاسبه دستی دلتاهای پشته قبلی‌ها پشتیبانی می‌کند. (I6a055)
  • rememberNavigationEventState را اضافه کنید تا اتصال SceneState با مدیریت اشاره برگشت پیش‌گویانه ساده شود. (Iae49c)

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

  • یک میانای برنامه‌سازی کاربردی ResultEventBus اضافه شد تا امکان انتقال نتایج بین NavEntries با LocalResultEventBus ارائه‌شده توسط ResultEventBusNavEntryDecorator جدید فراهم شود. نتایج ارسال‌شده را می‌توان به‌عنوان یک وضعیت با ResultEventBus#conflateAsState یا به‌عنوان جریانی از نتایج با ResultEffect ارزیابی کرد.

نسخه 1.2.0-alpha01

‫۸ آوریل ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.2.0-alpha01 منتشر شده است. نسخه 1.2.0-alpha01 حاوی این ارسال‌ها است.

رفع اشکال‌ها

  • دسترسی به LocalNavAnimatedContentScope از OverlayScene دیگر باعث IllegalStateException نمی‌شود زیرا OverlayScenes اکنون با LocalAnimatedContentScope بدون عملیات ارائه می‌شود. (I2f00c، b/486067688)

نسخه ۱.۱.۷

‫۲۶ اوت ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.1.7 منتشر شده است. نسخه ۱.۱.۷ حاوی این ثبت‌ها است.

رفع اشکال‌ها

  • مشکلی که باعث می‌شد اشاره‌های برگشت پیش‌گویانه که درطول انتقال روبه‌جلو راه‌اندازی می‌شوند در پاسخ به پیشرفت تند کشیدن پویانمایی نشوند برطرف شد. اکنون اشاره برگشت پیش‌گویانه به‌درستی پویانمایی و تکمیل می‌شود. (Icdcb0، b/456218398)

نسخه ۱.۱.۶

‫۱۲ اوت ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.1.6 منتشر شده است. نسخه ۱.۱.۶ حاوی این ثبت‌ها است.

رفع اشکال‌ها

  • NavEntry.contentKey اکنون به‌طور پیش‌فرض ترکیبی از key.toString() و key::class.toString() است. این کار تضمین می‌کند که اشیای داده‌ای که نام یکسانی دارند اما میاناهای متفاوتی را پیاده‌سازی می‌کنند دیگر contentKey یکسانی نخواهند داشت. بااین‌حال، key::class پلاتفرم JS فقط نام کلاس ساده را به‌جای نام کاملاً واجدشرایط برمی‌گرداند، بنابراین پلاتفرم JS همچنان باید contentKey سفارشی را برای اشیای داده با نام‌های تکراری پیاده‌سازی کند. (I1fbbb، b/512534342)
  • IllegalArgumentException که توسط SaveableStateHolder برای استفاده مجدد از کلید هنگام انجام هم‌زمان چند انتقال پاپ به‌دلیل پاپ سریع از پشته قبلی‌ها ایجاد می‌شد برطرف شد. (I4d728، b/516312097)

نسخه ۱.۱.۵

‫۲۹ ژوئیه ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.1.5 منتشر شده است. نسخه ۱.۱.۵ حاوی این commitها است.

رفع اشکال‌ها

  • اکنون entryProvider DSL به NavEntry ساخته‌شده با نمونه کلید، برای مثال entry(key = userKey) { ... }، نسبت‌به NavEntry ساخته‌شده با کلاس کلید، مثل entry<UserKey>{ ... }، اولویت می‌دهد.(Ib5ec9، b/533331924)

نسخه ۱.۱.۴

‫۱ ژوئیه ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.1.4 منتشر شده است. نسخه ۱.۱.۴ حاوی این ثبت‌ها است.

رفع اشکال‌ها

  • مشکل ناپدید شدن فوری ورودی پاپ‌شده هنگام پاپ کردن به ورودی‌ای که فراداده تودرتو حاوی مقادیر lambda دارد برطرف شد. (Idb872، b/520494430)

نسخه ۱.۱.۳

۱۷ ژوئن ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.1.3 منتشر شده است. نسخه ۱.۱.۳ حاوی این commitها است.

رفع اشکال‌ها

  • مشکل پویانمایی رونهاد برطرف شد که در آن رونهادهای تودرتو مانند ModalBottomSheet وقتی رونهادهای بالای آن ظاهر می‌شوند به‌طور غیرمنتظره‌ای دوباره پویانمایی می‌شوند. (Ia2b9e، b/502624496)

  • وابستگی NavigationEvent به ۱.۱.۲ ارتقا داده شد که NavigationEventHandler بدون عملیات را هنگام قرار داشتن در حالت بازرسی حذف کرد تا «بازگشت پیش‌بینانه» در «پیش‌نمایش‌های استودیو Android» فعال شود.

نسخه ۱.۱.۲

۱۹ مه ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.1.2 منتشر شده است. نسخه ۱.۱.۲ حاوی این ثبت‌ها است.

رفع اشکال‌ها

  • وابستگی NavigationEvent به ۱.۱.۱ ارتقا یافت که NavigationEventHandler بدون عملیات را هنگام قرار داشتن در حالت بازرسی برای فعال کردن «بازگشت پیش‌بینانه» در «پیش‌نمایش‌های استودیو Android» حذف کرد.

نسخه ۱.۱.۱

‫۲۲ آوریل ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.1.1 منتشر شده است. نسخه ۱.۱.۱ حاوی این ثبت‌ها است.

رفع اشکال‌ها

  • دسترسی به LocalNavAnimatedContentScope از OverlayScene دیگر باعث IllegalStateException نمی‌شود زیرا OverlayScenes اکنون با LocalAnimatedContentScope بدون عملیات ارائه می‌شود. (I2f00c، b/486067688)

نسخه ۱.۱.۰

‫۸ آوریل ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.1.0 منتشر شده است. نسخه ۱.۱.۰ حاوی این ثبت‌ها است.

‫نسخه ۱.۱.۰ اکنون پایدار است!

تغییرات مهم از نسخه ۱.۰.۰

عناصر مشترک بین صحنه‌ها - Navigation3 اکنون از درنظر گرفتن صحنه‌ها به‌عنوان شیء عنصر مشترک پشتیبانی می‌کند. این یعنی وقتی صحنه‌ها تغییر می‌کنند، می‌توان مطمئن شد که انتقال روانی دارند. می‌توانید این ویژگی را با ارسال SharedTransitionScope به NavDisplay یا rememberSceneState فعال کنید.

SceneDecoratorStrategy - معرفی SceneDecoratorStrategy برای پشتیبانی از موارد استفاده مانند تزئین صحنه‌ها با مؤلفه‌های واسط کاربر رایج یا هم‌رسانی وضعیت در صحنه‌ها.

NavMetadata DSL - Navigation3 اکنون یک DSL فراداده ایمن ازنظر نوع جدید ارائه می‌دهد. DSL از میانای MetadataKey جدیدی استفاده می‌کند که امکان تعریف انواع کلید و مقدار را که می‌خواهند به نقشه فراداده ارائه دهند فراهم می‌کند. این کار همچنین NavMetadataKeys جدیدی برای گذارهای NavDisplay اضافه کرد تا بتوان از آن‌ها با DSL فراداده جدید برای افزودن گذار به NavDisplay استفاده کرد.

پویانمایی‌های OverlayScene - میانای OverlayScene دارای فراخوان بازگشت تعلیق onRemoved جدیدی است. این فراخوانی پس‌از حذف کلید مرتبط با صحنه از پشته برگشت، اما قبل‌از خروج از ترکیب‌بندی، فراخوانی می‌شود. این کار به پویانمایی‌های خروج فراخوانی‌شده در onRemoved اجازه می‌دهد تا قبل‌از برداشته شدن صحنه هم‌پوشانی از ترکیب‌بندی تکمیل شوند.

تغییرات دیگر - NavDisplay و rememberSceneState اکنون به‌جای پارامتر تکی قبلی SceneStrategy که با میانوند then زنجیر شده بود، List<SceneStrategy> را می‌گیرند. - اکنون می‌توانید فراداده را به‌طور پویا با درنظر گرفتن کلید ورودی ازطریق EntryProvider DSL اضافه کنید.

نسخه 1.1.0-rc01

‫۲۵ مارس ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.1.0-rc01 منتشر شده است. نسخه 1.1.0-rc01 حاوی این ارسال‌ها است.

رفع اشکال‌ها

  • NavDisplay اکنون تضمین می‌کند که ورودی‌هایی که در زیر هم‌پوشانی‌ها نمایش داده می‌شوند، Lifecycle آن‌ها به STARTED محدود شود. این کار تضمین می‌کند که میاناهای برنامه‌سازی کاربردی مثل dropUnlessResumed هنگام استفاده از کادرهای گفتگو همچنان کار کنند. (If209f، b/483966071)
  • مشکلی در NavDisplay برطرف شد که در آن پیمایش رفت‌وبرگشت بین صفحه‌های یکسان و قطع کردن پویانمایی‌های بین آن دو می‌توانست باعث شود ترتیب z صفحه‌ها نادرست باشد. (I4d491، b/459419800)

نسخه 1.1.0-beta01

‫۱۱ مارس ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.1.0-beta01 منتشر شده است. نسخه 1.1.0-beta01 حاوی این ارسال‌ها است.

نسخه 1.1.0-alpha05

‫۲۵ فوریه ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.1.0-alpha05 منتشر شده است. نسخه 1.1.0-alpha05 حاوی این ارسال‌ها است.

تغییرات میانای برنامه‌سازی کاربردی

  • NavDisplay و rememberSceneState اکنون به‌جای پارامتر تکی قبلی SceneStrategy که با میانوند then زنجیر شده بود، List<SceneStrategy> را می‌گیرند. این امر با List<SceneDecoratorStrategy<T>> که هر دوی این میاناهای برنامه‌سازی کاربردی درحال‌حاضر انجام می‌دهند همسوتر است. میاناهای برنامه‌سازی کاربردی قبلی منسوخ شده‌اند. (I78b2c، b/482108465)
  • عملگر #contains فراداده اضافه شد تا بررسی شود که آیا نقشه فراداده حاوی NavMetadataKey داده‌شده است یا نه. (Ic30db، b/485311895)
  • NavMetadataKey DialogKey برای DialogSceneStrategy اضافه شد تا با Metadata DSL استفاده شود. (Ic7a26، b/483388817)

نسخه 1.1.0-alpha04

‫۱۱ فوریه ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.1.0-alpha04 منتشر شده است. نسخه 1.1.0-alpha04 حاوی این موارد ثبت است.

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

  • ‫Navigation3 اکنون DSL فراداده ایمنی تایپی جدیدی ارائه می‌دهد. DSL از میانای MetadataKey جدیدی استفاده می‌کند که امکان تعریف انواع کلید و مقدار را که می‌خواهند به نقشه فراداده ارائه دهند فراهم می‌کند. این کار همچنین NavMetadataKeyهای جدیدی برای انتقال‌های NavDisplay اضافه کرد تا بتوان از آن‌ها با DSL جدید metadata برای افزودن انتقال به NavDisplay استفاده کرد. (Ic10ef, Ic049c,b/476213928)

تغییرات میانای برنامه‌سازی کاربردی

  • میانای OverlayScene دارای فراخوانی برگشتی تعلیق onRemoved جدیدی است. این فراخوانی پس‌از حذف کلید مرتبط با صحنه از پشته برگشت، اما قبل‌از خروج از ترکیب‌بندی، فراخوانی می‌شود. این کار به پویانمایی‌های خروج که در onRemoved فراخوانی شده‌اند اجازه می‌دهد تا قبل‌از برداشته شدن صحنه هم‌پوشانی از ترکیب‌بندی تکمیل شوند. (I29a72، b/440558061)
  • SceneStrategy تابع تزئین را به SceneDecoratorStrategy جدیدی جدا کرده است. این میانای جدید چیزی است که باید برای تزئین صحنه‌ها استفاده شود. میاناهای برنامه‌سازی کاربردی جدیدی برای NavDisplay و rememberSceneState وجود دارد که امکان افزودن SceneDecoratorStrategies را فراهم می‌کند. (If9385، b/477669607، b/477670333)

رفع اشکال‌ها

  • خطایی برطرف شد که در آن ارسال SharedTransitionLayout به NavDisplay یا rememberSceneState و استفاده از هر OverlayScene باعث ازکارافتادن می‌شد، زیرا استفاده از SharedTransitionLayout فقط با NavEntries که به‌عنوان بخشی از AnimatedContent ارائه می‌شود کار می‌کند و OverlayScene در پنجره‌های جداگانه خودشان ارائه می‌شوند. (I1bb76، b/478664101)

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

  • از Navigation3 نسخه ۱.۰.۱: Navigation3 اکنون به NavigationEvent نسخه ۱.۰.۲ وابسته است. این به‌روزرسانی IllegalStateException را که به‌دلیل استفاده از NavDisplay درطول «پیش‌نمایش‌های» AndroidStudio ایجاد شده است برطرف می‌کند. (Id7212،‏ b/477149762)

نسخه 1.1.0-alpha03

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

‫androidx.navigation3:navigation3-*:1.1.0-alpha03 منتشر شده است. نسخه 1.1.0-alpha03 حاوی این ارسال‌ها است.

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

  • اکنون می‌توانید فراداده را به‌صورت پویا با درنظر گرفتن کلید ورودی ازطریق EntryProvider DSL اضافه کنید. (I942fb، b/474416976)

نسخه 1.1.0-alpha02

‫۱۴ ژانویه ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.1.0-alpha02 منتشر شده است. نسخه 1.1.0-alpha02 حاوی این ارسال‌ها است.

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

  • SceneStrategy اکنون از صحنه‌های تودرتو ازطریق عملکرد جدید calculatedScene(Scene) پشتیبانی می‌کند. این یعنی SceneStrategy را می‌توان سفارشی‌سازی کرد تا عملکرد بیشتری برای صحنه‌های دیگر ارائه دهد. (I5df7c،b/440333896)

نسخه 1.1.0-alpha01

‫۳ دسامبر ۲۰۲۵

‫androidx.navigation3:navigation3-*:1.1.0-alpha01 منتشر شده است. نسخه 1.1.0-alpha01 حاوی این موارد ثبت است.

تغییرات میانای برنامه‌سازی کاربردی

  • Navigation3 اکنون از درنظر گرفتن صحنه‌ها به‌عنوان شیء عنصر هم‌رسانی‌شده پشتیبانی می‌کند. این یعنی وقتی صحنه‌ها تغییر می‌کنند، می‌توان مطمئن شد که انتقال روانی دارند. می‌توانید این ویژگی را با ارسال SharedTransitionScope به NavDisplay یا rememberSceneState فعال کنید. (I15868)

نسخه 1.0

نسخه ۱.۰.۱

‫۱۱ فوریه ۲۰۲۶

‫androidx.navigation3:navigation3-*:1.0.1 منتشر شده است. نسخه ۱.۰.۱ حاوی این ثبت‌ها است.

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

  • ‫Navigation3 اکنون به NavigationEvent نسخه ۱.۰.۲ وابسته است. این به‌روزرسانی IllegalStateException را که به‌دلیل استفاده از NavDisplay درطول «پیش‌نمایش‌های» AndroidStudio ایجاد شده است برطرف می‌کند. (Id7212،‏ b/477149762)

نسخه ۱.۰.۰

‫۱۹ نوامبر ۲۰۲۵

‫androidx.navigation3:navigation3-*:1.0.0 منتشر شده است. نسخه ۱.۰.۰ حاوی این ثبت‌ها است.

معرفی Navigation3!

  • کتابخانه Navigation3 اکنون پایدار است! ‫Navigation3 رویکرد اول AndroidX Compose برای پیمایش است.
  • برای اطلاعات بیشتر، پست وبلاگ اعلام را ببینید، به منابع مراجعه کنید، و دستورالعمل‌ها را امتحان کنید.

نسخه 1.0.0-rc01

‫۵ نوامبر ۲۰۲۵

‫androidx.navigation3:navigation3-*:1.0.0-rc01 منتشر شده است. نسخه 1.0.0-rc01 حاوی این commitها است.

رفع اشکال‌ها

  • NavDisplay اکنون LocalLifecycleOwner را در سطح Scene تنظیم می‌کند که به نویسندگان صحنه اجازه می‌دهد با بررسی اینکه Lifecycle.State، RESUMED است، تعیین کنند آیا همه انتقال‌ها به‌پایان رسیده است یا نه. رفتار LocalLifecycleOwner در سطح NavEntry بدون تغییر است: همچنین اگر انتقالی درحال انجام باشد، در STARTED محدود می‌ماند و علاوه‌براین، اگر آن NavEntry از پشته قبلی‌ها خارج شده باشد و درحال پویانمایی خروجی باشد، در CREATED محدود می‌شود. (I03113، b/454045829)

نسخه 1.0.0-beta01

‫۲۲ اکتبر ۲۰۲۵

‫androidx.navigation3:navigation3-*:1.0.0-beta01 منتشر شده است. نسخه 1.0.0-beta01 حاوی این ارسال‌ها است.

تغییرات میانای برنامه‌سازی کاربردی

  • SceneStrategyScope اکنون فقط یک سازنده عمومی بدون آرگومان دارد که برای آزمایش SceneStrategy شما و Scene برگردانده‌شده به‌صورت مجزا مناسب است. برای موارد استفاده پیچیده‌تر، لطفاً از rememberSceneState() استفاده کنید. (I8440c، b/451679047)

رفع اشکال‌ها

  • حلقه بی‌نهایت هنگام زنجیر کردن SceneStrategy با then برطرف شد. (Iba3f0، b/450323470)
  • لرزش صفحه‌نمایش هنگام جابه‌جا کردن backStack منتقل‌شده به NavDisplay و استفاده از پویانمایی‌ها برطرف شد. (Ief7b5، b/450967248)

نسخه 1.0.0-alpha11

‫۸ اکتبر ۲۰۲۵

‫androidx.navigation3:navigation3-*:1.0.0-alpha11 منتشر شده است. نسخه 1.0.0-alpha11 حاوی این ارسال‌ها است.

تغییرات میانای برنامه‌سازی کاربردی

  • روش calculateScene در SceneStrategy دیگر @Composable نیست. درعوض، این کار را به ساخت روش SceneStrategy (یعنی در روش rememberMySceneStrategy()) منتقل کنید که کاملاً به شما امکان می‌دهد طول عمر هر مقدار rememberSaveable یا عبارت کلیدی remember را براساس مقادیر صحیح تعریف کنید. (If1733، b/448709506)
  • پارامتر onBack برای SceneStrategy.calculateScene به دامنه گیرنده جدید SceneStrategyScope منتقل شده است تا واضح‌تر شود که این پارامتر اختیاری است و نقطه گسترشی برای ویژگی‌های Navigation3 آینده ارائه دهد. (I3aea3، b/448460407)
  • onBack lambda که به NavDisplay و SceneStrategy شما منتقل شده است دیگر پارامتر count: Int را برای نشان دادن زمان پاپ شدن چندین ورودی ارائه نمی‌دهد. درعوض، در موارد نادری که «صحنه» شما درخواست می‌کند چندین ورودی را پاپ کند، () -> Unit lambda اکنون چندین بار پشت‌سرهم فراخوانی می‌شود. (Idedb5،‏ b/446989346)
  • کلاس NavEntryWrapper را بردارید و عملکرد آن را با کلاس نهایی NavEntry با سازنده ثانویه جدیدی که NavEntry را با محتوای جدید می‌گیرد جایگزین کنید. این کار امکان پشتیبانی مداوم از پیچیدن ورودی با محتوای جدید را فراهم می‌کند. (I7da2a، b/444447130)
  • تابع navEntryDecorator که NavEntryDecorator را ایجاد می‌کند و برمی‌گرداند برداشته شده است و کلاس NavEntryDecorator جایگزین آن شده است که اکنون عمومی شده و برای زیرکلاس‌سازی باز است. (If81f8، b/444447434، b/447381176)
  • نام SavedStateNavEntryDecorator به SaveableStateHolderNavEntryDecorator تغییر کرده است زیرا ورودی‌ها را با SaveableStateHolder تزئین می‌کند. دکوراتور نیز از تابع به کلاس بازسازی شده است زیرا ازنظر عملکردی کارخانه‌ای برای NavEntryDecorator است. (Ie6013، b/447381176)
  • نمایشگرهای سفارشی که از SceneState به‌عنوان جایگزینی برای استفاده از NavDisplay استفاده می‌کنند، دیگر نیازی به استفاده از ترکیب‌بندی محلی LocalEntriesToRenderInCurrentScene ندارند، که اکنون داخلی است. (Ic40ef، b/414668196)
  • SceneSetupNavEntryDecorator و rememberSceneSetupNavEntryDecorator() از سطح API عمومی برداشته شد. این عملکرد اکنون به‌طور پیش‌فرض گنجانده شده است و نیازی نیست آن را به‌طور دستی اضافه کنید. (Ieae42، b/444479133)
  • ‫NavEntry،‏ DialogScene،‏ SinglePaneScene، و SceneState اکنون همگی equals را پیاده‌سازی می‌کنند. (I96121)
  • میانای Scene فیلد فراداده جدیدی دارد که فراداده مختص صحنه را برای NavDisplay پیوست می‌کند. این کار به «صحنه» اجازه می‌دهد فراداده را در NavDisplay لغو کند، مثلاً با انتقال‌ها. (I1fd96، b/443955625)
  • ساده‌سازی امضای rememberNavBackStack با برداشتن پارامتر نوع عمومی زائد. این تابع اکنون vararg elements: NavKey را می‌پذیرد. (I03e45)
  • پویانمایی‌های پیش‌فرض برای NavDisplay اکنون بخشی از API مشترک هستند که امکان فراخوانی آن‌ها را از همه پلاتفرم‌ها فراهم می‌کند. (I71af9، b/447147159)
  • نام EntryProviderBuilder را به EntryProviderScope تغییر دهید تا به‌درستی نشان دهد که کلاس یک Kotlin DSL است که دامنه‌ای برای ساخت NavEntries ارائه می‌دهد. (Ia7465)

رفع اشکال‌ها

  • rememberNavBackStack() اکنون سریال‌سازی چندریختی را برای NavKey اعمال می‌کند و به SavedStateConfiguration سفارشی نیاز دارد که برای اطمینان از بازیابی صحیح وضعیت پیکربندی شده باشد. ‫KDoc به‌روز شده است تا این الزام را نشان دهد که همه زیرنوع‌های NavKey باید در SerializersModule ارائه‌شده ثبت شوند. (I6de37،‏ I782f2،‏ b/446664383)

نسخه 1.0.0-alpha10

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

‫androidx.navigation3:navigation3-*:1.0.0-alpha10 منتشر شده است. نسخه 1.0.0-alpha10 حاوی این ارسال‌ها است.

تغییرات میانای برنامه‌سازی کاربردی

  • افزودن سربارگذاری NavDisplay جدید که فهرستی از NavEntry<T> را که با rememberDecoratedNavEntries تزئین شده است می‌گیرد. (I4025b،‏ b/441940314)
  • ‫DialogScene به بسته جدیدی منتقل شد. (Ia5840)
  • برداشتن میانای برنامه‌سازی کاربردی عمومی DecorateNavEntry. به‌جای آن، از rememberDecoratedNavEntries برای پیچیدن NavEntry با فهرستی از تزئین‌کننده‌ها استفاده کنید. (Id8c09)
  • واسط کاربر Navigation3 اکنون ویژگی‌های پیش‌فرض جدید transitionSpec را ارائه می‌دهد. (Ibcabd)
  • شیء SceneState جدیدی برای کمک به مدیریت صحنه‌ها اضافه شد. این کار همچنین یک سربارگذاری NavDisplay جدید ارائه می‌دهد که SceneState و NavigationEventState را می‌گیرد. (Idfb46، b/444479133)
  • NavDisplay اکنون به شما امکان می‌دهد با نگاه کردن به currentState و targetState مربوط به Transition، انتقال‌ها را براساس اینکه از کدام Scene به کدام می‌روید سفارشی‌سازی کنید. (I906cc، b/443872322)
  • ‫NavigationEventInfo اکنون abstract class است نه interface. همه پیاده‌سازی‌های سفارشی را به‌روز کنید تا از کلاس (مثلاً data class MyInfo : NavigationEventInfo()) ارث‌بری کنند. (I1e59c، b/444734264)
  • میاناهای برنامه‌سازی کاربردی گرداننده navigationevent-compose به‌روزرسانی شده‌اند. NavigationEventHandler و NavigationBackHandler (و انواع آن) اکنون از سربارگذاری جدیدی پشتیبانی می‌کنند که NavigationEventStates بالابرده را می‌پذیرد. بارگذاری‌های بیش‌ازحد ساده (بااستفاده از currentInfo) حفظ می‌شوند و اکنون از این مدل حالت جدید به‌طور داخلی استفاده می‌کنند. (Ic3251، b/444734264)
  • همه Scene API از navigation3-ui به navigation3-runtime منتقل شده‌اند. این یعنی این ویژگی‌ها اکنون در همه پلاتفرم‌های پشتیبانی‌شده توسط navigation3-runtime دردسترس هستند. (I431d0، b/444449993)
  • بار اضافی جدید rememberDecoratedNavEntries اضافه شد که فهرستی از NavEntry را برای تزئین می‌گیرد. ورودی‌های ورودی ممکن است قبلاً با تزئین‌کننده‌های ورودی دیگر تزئین شده باشند. (I5a034،‏ b/444230270)
  • Remove navigation3 wildcard type parameters (I02540)
  • مدیریت عمومی‌ها برای entryProvider DSL بهبود یافته است. اگر قبلاً androidx.navigation3.runtime.entry را وارد می‌کردید، دیگر نیازی به این کار نیست. (I299fc)
  • محدود کردن سربار NavBackStackSerializer مبتنی بر بازتاب به Android. این کار با اجباری کردن استفاده از سربارگذاری صریح SavedStateConfiguration در کد چندپلاتفرمی، از شکست‌های ضمنی سریال‌سازی زمان اجرا در پلاتفرم‌های غیرAndroid جلوگیری می‌کند. (I73313، b/420443609)
  • Make NavigationEvent's swipeEdge an @IntDef (Icee54, b/443950342)
  • محدود کردن سریال‌سازی NavBackStack به Android. این کار از خرابی‌های زمان اجرا در پلاتفرم‌های غیرAndroid جلوگیری می‌کند. برای ذخیره وضعیت چندپلاتفرمی، از سربارگذاری rememberNavBackStack با SavedStateConfiguration صریح استفاده کنید. (I1e418، b/420443609)

رفع اشکال‌ها

  • رفع ازکارافتادن درطول برگشت پیش‌بینانه وقتی NavDisplay تودرتو یک ورودی فرعی دارد. (I2cdc0، b/441933162)

نسخه 1.0.0-alpha09

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

‫androidx.navigation3:navigation3-*:1.0.0-alpha09 منتشر شده است. نسخه 1.0.0-alpha09 حاوی این ارسال‌ها است.

تغییرات میانای برنامه‌سازی کاربردی

  • ‫DecoratedNavEntryProvider با rememberDecoratedNavEntries جایگزین شده است که NavEntries تزئین‌شده با فهرست تزئین‌کننده‌های ارائه‌شده را ایجاد می‌کند و برمی‌گرداند (I0fe1c، b/441328236)
  • NavBackStack اکنون روی نوع NavKey عمومی است. این ویژگی به برنامه‌ها و کتابخانه‌ها اجازه می‌دهد انواع کلید سفارشی را برای پشته قبلی‌های خود تعریف کنند، به‌جای اینکه به NavKey محدود شوند. ‫(I4d190،‏ Iad2f4،‏ b/420443609)
  • NavBackStack اکنون @kotlinx.serialization.Serializable است، که امکان ذخیره و بازیابی وضعیت پیمایش را در سراسر مرگ پردازش و تغییرات پیکربندی بدون کد تکراری اضافی فراهم می‌کند. (I2c3cf، b/420443609)
  • RememberNavBackStack به commonMain منتقل شده است تا مطمئن شویم در همه پلاتفرم‌های هدف ارائه می‌شود. (Id69e7, b/420443609)

رفع اشکال‌ها

  • NavDisplay اکنون هر NavEntry را به‌درستی به Lifecycle.State صحیح منتقل می‌کند. (I30aac، b/440145700)
  • مشکلی برطرف شد که در آن NavDisplay هرگونه NavigationEventDispatcherOwner تودرتو را که ازطریق LocalNavigationEventDispatcherOwner کتابخانه NavigationEvent تنظیم شده بود نادیده می‌گرفت. (I6224a)

تغییرات وابستگی

نسخه 1.0.0-alpha08

‫۲۷ اوت ۲۰۲۵

‫androidx.navigation3:navigation3-*:1.0.0-alpha08 منتشر شده است. نسخه 1.0.0-alpha08 حاوی این ارسال‌ها است.

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

  • هدف‌های جدید Kotlin MultiPlatform (KMP) به مصنوعات Navigation3 Runtime اضافه شد. ‫Navigation3 Runtime اکنون درمجموع از پلاتفرم‌های زیر پشتیبانی می‌کند: JVM (‏Android و رایانه)، Native (‏Linux،‏ iOS،‏ watchOS،‏ macOS،‏ MinGW)، و وب (JavaScript،‏ WasmJS). (I55078، b/424410398، b/419294028، b/419046226). توجه: این گزینه هدف‌های KMP را برای مصنوع Navigation3 UI ارائه نمی‌دهد. در پلاتفرم‌های دیگر، باید NavDisplay سفارشی خودتان را پیاده‌سازی کنید. اگر می‌خواهید این ویژگی پشتیبانی شود، لطفاً اینجا در مشکل Jetbrains رأی دهید و پیشرفت را برای پشتیبانی بیشتر در آنجا دنبال کنید.
  • شیء NavDisplayInfo اکنون عمومی است و می‌توان از آن برای بازیابی فهرست ورودی‌های نمایان از NavDisplay استفاده کرد. (Ibc91f)

تغییرات میانای برنامه‌سازی کاربردی

  • NavBackStackSerializer جدیدی اضافه شد تا همراه با rememberNavBackStack برای بازیابی وضعیت استفاده شود. rememberNavBackStack() اکنون SavedStateConfiguration را نیز می‌پذیرد که می‌تواند برای ارائه پیکربندی خودتان استفاده شود. (I2f4d2، I4cd58، b/420443609)

رفع اشکال‌ها

  • مشکلی که باعث می‌شد پیمایش باعث راه‌اندازی رویدادهای نادرست «چرخه حیات» شود برطرف شد. (I8bf6d، b/425901162، b/434109022)

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

  • اشکالی توسط I8bf6d معرفی شده بود که باعث می‌شد «چرخه‌های حیات» به‌جای ورودی‌های تکی براساس صحنه‌ها باشد، که این امر «چرخه حیات» را برای هر موردی که key ارائه‌شده به NavEntry یک String نباشد یا NavEntry شما contentKey را لغو نکرده باشد و آن را برابر با key تنظیم نکرده باشد خراب می‌کرد (توجه داشته باشید که انجام این کار باعث می‌شود کلید شما بتواند در Bundle ذخیره شود). این مشکل برای نسخه بعدی برطرف شده است. (b/440145700)

نسخه 1.0.0-alpha07

‫۱۳ اوت ۲۰۲۵

‫androidx.navigation3:navigation3-*:1.0.0-alpha07 منتشر شده است. نسخه 1.0.0-alpha07 حاوی این ارسال‌ها است.

به‌روزرسانی MinSdk

تغییرات میانای برنامه‌سازی کاربردی

  • SavedStateNavEntryDecorator اکنون از SaveableStateRegistry تعبیه‌شده در SaveableStateProvider برای ذخیره و بازیابی وضعیت‌ها استفاده می‌کند. (If8d9a)
  • اکنون predictivePopTransitionSpec لبه تند کشیدن را به‌عنوان پارامتر ارائه می‌دهد و به شما امکان می‌دهد انتقال را براساس لبه‌ای که کاربر اشاره «برگشت پیش‌گویانه» را از آن شروع کرده است سفارشی‌سازی کنید. (I753a8)

رفع اشکال‌ها

  • مشکلی که باعث می‌شد صحنه‌های سفارشی به‌طور نامحدود بازمحاسبه شوند، چون آخرین صحنه به‌خاطر آورده نمی‌شد، برطرف شد. (I7ba84،‏ b/418153031)

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

نسخه 1.0.0-alpha06

‫۳۰ ژوئیه ۲۰۲۵

‫androidx.navigation3:navigation3-*:1.0.0-alpha06 منتشر شده است. نسخه 1.0.0-alpha06 حاوی این ارسال‌ها است.

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

نسخه 1.0.0-alpha05

‫۲ ژوئیه ۲۰۲۵

‫androidx.navigation3:navigation3-*:1.0.0-alpha05 منتشر شده است. نسخه 1.0.0-alpha05 حاوی این ارسال‌ها است.

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

  • وضعیت NavEntry اکنون کاملاً براساس فهرست فعلی تزئین‌کننده‌هایی است که به NavDisplay منتقل شده‌اند. این یعنی درصورت وجود چند پشته قبلی‌ها، تزئین‌کننده‌ها باید درطول پشته‌های قبلی‌ها جابه‌جا شوند تا وضعیت NavEntries در پشته قبلی‌ها حفظ شود. درغیراین‌صورت، وضعیت‌ها پاک می‌شوند، گویی ورودی‌ها حذف شده‌اند (به‌جای جابه‌جایی). (I7a759، b/428033667)

نسخه 1.0.0-alpha04

‫۱۸ ژوئن ۲۰۲۵

‫androidx.navigation3:navigation3-*:1.0.0-alpha04 منتشر شده است. نسخه 1.0.0-alpha04 حاوی این ارسال‌ها است.

تغییرات میانای برنامه‌سازی کاربردی

  • NavEntry.content اکنون خصوصی است. برای فراخوانی محتوای NavEntry، میانای برنامه‌سازی کاربردی جدید NavEntry.Content() را فراخوانی کنید که دیگر برای فراخوانی به پارامتر key نیاز ندارد. (Icd0fd، b/420991203)
  • NavEntry.key اکنون فیلدی خصوصی است. ‫NavEntry و حالت‌های مربوط به آن باید با فیلد جدید contentKey شناسایی شوند که از لامبدای جدید contentKeyFactory تولید می‌شود و به‌طور پیش‌فرض به درهم‌سازی قابل‌ذخیره تولیدشده از NavEntry.key تبدیل می‌شود (I81a6c،‏ b/422001357،‏ b/420991203 I2d7d4،‏ b/420991203،‏ b/422841812)

تغییرات وابستگی

  • Navigation3 اکنون به آرتیفکت جدید androidx.navigationevent.compose وابسته است.

نسخه 1.0.0-alpha03

‫۴ ژوئن ۲۰۲۵

‫androidx.navigation3:navigation3-*:1.0.0-alpha03 منتشر شده است. نسخه 1.0.0-alpha03 حاوی این موارد ثبت است.

رفع اشکال‌ها

  • Navigation3 دیگر وضعیت‌های تزئین‌کننده را برای backStacks که جابه‌جا شده و با نمونه backStack دیگری جایگزین شده است پاک نخواهد کرد. (I28a42، b/415076044)

نسخه 1.0.0-alpha02

‫۲۳ مه ۲۰۲۵

‫androidx.navigation3:navigation3-*:1.0.0-alpha02 منتشر شده است. نسخه 1.0.0-alpha02 حاوی این ارسال‌ها است.

رفع اشکال‌ها

  • مشکلی در SavedStateNavEntryDecorator برطرف شد که باعث تداخل در کلاس‌های داده مختلف با مقادیر ویژگی یکسان می‌شد. (b/418070648، Iff4775)
  • مشکل کلاس مفقود که باعث ازکارافتادن برنامه هنگام اجرا بدون اعلام وابستگی‌های صریح می‌شد برطرف شد. (b/419049149، I4b4ed)

نسخه 1.0.0-alpha01

‫۲۰ مه ۲۰۲۵

‫androidx.navigation3:navigation3-*:1.0.0-alpha01 منتشر شده است. نسخه 1.0.0-alpha01 حاوی این ارسال‌ها است.

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

Navigation3 کتابخانه پیمایش جدیدی است که به‌طور خاص برای مدیریت پیمایش درون‌برنامه Jetpack Compose ساخته شده است. ساخته androidx.navigation3.runtime واحدهای سازنده را ارائه می‌دهد، درحالی‌که ساخته androidx.navigation3.ui لایه واسط کاربر را ازطریق میانای برنامه‌سازی کاربردی NavDisplay ارائه می‌دهد. توسعه‌دهندگان می‌توانند وضعیت خود را مستقیماً به تابع ترکیب‌پذیر NavDisplay ارائه دهند، که محتوا را براساس تغییرات در وضعیت توسعه‌دهنده تغییر می‌دهد.

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

val backStack = rememberNavBackStack(Home)

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

برای اطلاعات بیشتر، راهنمای Navigation3 را ببینید.