navigation3
| جدیدترین بهروزرسانی | نسخه پایدار | نامزد انتشار | انتشار نسخه بتا | نسخه آلفا |
|---|---|---|---|---|
| ۴ نوامبر ۲۰۲۶ | ۱.۲.۱ | - | - | 1.3.0-alpha04 |
اعلام وابستگیها
برای افزودن وابستگی به navigation3، باید مخزن Google Maven را به پروژهتان اضافه کنید. برای اطلاعات بیشتر، مخزن Maven در Google را بخوانید.
وابستگیهای لازم برای مصنوعات موردنیازتان را در فایل build.gradle برای برنامه یا واحدتان اضافه کنید:
شیک
dependencies { implementation "androidx.navigation3:navigation3-runtime:1.3.0-alpha04" implementation "androidx.navigation3:navigation3-ui:1.3.0-alpha04" }
کاتلین
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
NavEntrynot 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/430807423DeferredAnimatedContentازDeferredTransitionبرای جدا کردن انتقالها به یک فاز معوق (ازطریقdefer) استفاده میکند که تبدیلهای دستی را درطول اشاره تند کشیدن اعمال میکند، و یک فاز خودکار (ازطریقanimateTo) که انتقال را هنگام انجام تند کشیدن اجرا میکند.
مشکلات شناختهشده
- عناصر همرسانیشده درطول انتقال بهجای صحنه ورودی در صحنه خروجی رندر میشوند. (b/582354988)
- عناصر همرسانیشده درطول مرحله تعویق (اشاره) جستجو نمیکنند.
Navigation3 نسخه ۱.۲
نسخه ۱.۲.۱
۴ نوامبر ۲۰۲۶
androidx.navigation3:navigation3-*:1.2.1 منتشر شده است. نسخه ۱.۲.۱ حاوی این ثبتها است.
تغییرات
-
compileSdkاز ۳۷ به ۳۶ تنزل یافته است. نسخه ۱.۲ به Compose1.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، یاIntentAndroid است. فرادادههای درخواست اضافی را میتوان بااستفاده از محفظهRequestExtrasایمن ازنظر نوع که باrequestExtrasDSL و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را میتوان باrequestExtrasDSL نمونهسازی کرد. (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'sT ازAny?بهAnyتغییر کرده است. (I6bf1a)فیلد سازنده
DeepLinkRequesturiاکنون بهطور پیشفرض null است. نامuriStringسازنده ثانویه بهuriتغییر کرده است. (Ia0f14، b/522194187)
رفع اشکالها
-
ResultEffectاکنون ازrememberUpdatedStateبرای ضبط جدیدترینonResultlambda استفاده میکند. (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 حاوی این موارد ارسال است.
میانای برنامهسازی کاربردی جدید
- یک
rememberResultEventBusapi اضافه شد که یک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) requestExtrasdsl جدیدی بهعنوان روشی ایمن ازنظر نوع برای ساختن نقشهای از موارد اضافی اضافه شده است. 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 مطابقت داشته باشد
رفع اشکالها
IllegalArgumentExceptionAnimatedBottomSheetSampleهنگام نمایش چند رونهاد رفع شد. نمونه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)
Navigation3 نسخه ۱.۱
نسخه ۱.۱.۷
۲۶ اوت ۲۰۲۶
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ها است.
رفع اشکالها
- اکنون
entryProviderDSL به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) NavMetadataKeyDialogKeyبرای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 حاوی این ارسالها است.
ویژگیهای جدید
- اکنون میتوانید فراداده را بهصورت پویا با درنظر گرفتن کلید ورودی ازطریق
EntryProviderDSL اضافه کنید. (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) onBacklambda که بهNavDisplayوSceneStrategyشما منتقل شده است دیگر پارامترcount: Intرا برای نشان دادن زمان پاپ شدن چندین ورودی ارائه نمیدهد. درعوض، در موارد نادری که «صحنه» شما درخواست میکند چندین ورودی را پاپ کند،() -> Unitlambda اکنون چندین بار پشتسرهم فراخوانی میشود. (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)
- مدیریت عمومیها برای
entryProviderDSL بهبود یافته است. اگر قبلاًandroidx.navigation3.runtime.entryرا وارد میکردید، دیگر نیازی به این کار نیست. (I299fc) - محدود کردن سربار
NavBackStackSerializerمبتنی بر بازتاب به Android. این کار با اجباری کردن استفاده از سربارگذاری صریحSavedStateConfigurationدر کد چندپلاتفرمی، از شکستهای ضمنی سریالسازی زمان اجرا در پلاتفرمهای غیرAndroid جلوگیری میکند. (I73313، b/420443609) - Make
NavigationEvent'sswipeEdgean@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)
تغییرات وابستگی
- Navigation3 اکنون به NavigationEvent Alpha08 وابسته است.
نسخه 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
- minSdk پیشفرض برای AndroidX از API 21 به API 23 منتقل شده است (Ibdfca، b/380448311، b/435705964، b/435705223)
تغییرات میانای برنامهسازی کاربردی
SavedStateNavEntryDecoratorاکنون ازSaveableStateRegistryتعبیهشده درSaveableStateProviderبرای ذخیره و بازیابی وضعیتها استفاده میکند. (If8d9a)- اکنون
predictivePopTransitionSpecلبه تند کشیدن را بهعنوان پارامتر ارائه میدهد و به شما امکان میدهد انتقال را براساس لبهای که کاربر اشاره «برگشت پیشگویانه» را از آن شروع کرده است سفارشیسازی کنید. (I753a8)
رفع اشکالها
- مشکلی که باعث میشد صحنههای سفارشی بهطور نامحدود بازمحاسبه شوند، چون آخرین صحنه بهخاطر آورده نمیشد، برطرف شد. (I7ba84، b/418153031)
بهروزرسانی وابستگی
- Navigation3 اکنون به رویداد پیمایش
1.0.0-alpha06بستگی دارد.
نسخه 1.0.0-alpha06
۳۰ ژوئیه ۲۰۲۵
androidx.navigation3:navigation3-*:1.0.0-alpha06 منتشر شده است. نسخه 1.0.0-alpha06 حاوی این ارسالها است.
بهروزرسانی وابستگی
- Navigation3 اکنون به رویداد پیمایش
1.0.0-alpha05بستگی دارد.
نسخه 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 را ببینید.