Jetpack Navigation 3 نسخه ۱.۰ پایدار است 🎉. همین امروز آن را در برنامههای تولیدیتان استفاده کنید. JetBrains درحالحاضر از آن در برنامه KotlinConf خود استفاده میکند.
Navigation 3 کتابخانه پیمایش جدیدی است که از ابتدا برای پذیرش حالت Jetpack Compose ساخته شده است. این مؤلفه کنترل کامل پشته قبلیها را به شما میدهد، به شما کمک میکند وضعیت پیمایش را حفظ کنید، و به شما امکان میدهد بهراحتی چیدمانهای تطبیقی (مانند فهرست-جزئیات) ایجاد کنید. حتی یک نسخه چندسکویی از JetBrains وجود دارد.
چرا کتابخانه جدید؟
کتابخانه اصلی Jetpack Navigation (اکنون Nav2) ۷ سال پیش طراحی شد و اگرچه اهداف اصلی خود را بهخوبی برآورده میکند و بهطور تکراری بهبود یافته است، اما نحوه ساخت برنامهها اکنون بهطور اساسی تغییر کرده است.
برنامهنویسی واکنشی با میانای کاربری اعلانی اکنون به یک هنجار تبدیل شده است. Nav3 از این رویکرد استقبال میکند. برای مثال، NavDisplay (مؤلفه میانای کاربر Nav3 که صفحههای شما را نمایش میدهد) بهسادگی فهرستی از کلیدها (هرکدام نشاندهنده یک صفحه) را که توسط حالت Compose پشتیبانی میشود مشاهده میکند و وقتی آن فهرست تغییر میکند، میانای کاربر خود را بهروز میکند.
Nav2 همچنین میتواند داشتن منبع واحد حقیقت را برای وضعیت پیمایش شما دشوار کند زیرا وضعیت داخلی خودش را دارد. با Nav3، شما وضعیت خودتان را ارائه میدهید که به شما کنترل کامل میدهد.
درنهایت، شما انعطافپذیری و سفارشیسازی بیشتری درخواست کردید. Nav3 بهجای داشتن یک میانای برنامهسازی کاربردی یکپارچه، میاناهای برنامهسازی کاربردی کوچکتر و مجزایی (یا «بلوکهای سازنده») ارائه میدهد که میتوانند باهم ترکیب شوند تا عملکرد پیچیدهای ایجاد کنند. Nav3 خودش از این بلوکهای سازنده برای ارائه پیشفرضهای معقول برای موارد استفاده پیمایش بهخوبی تعریفشده استفاده میکند.
این رویکرد به شما امکان میدهد:
- سفارشیسازی پویانماییهای صفحهنمایش هم در سطح کلی و هم در سطح فردی
- نمایش همزمان چند قاب، و ایجاد چیدمانهای انعطافپذیر بااستفاده از Scenes API
- اگر رفتار سفارشی میخواهید، بهراحتی مؤلفههای Nav3 را با پیادهسازیهای خودتان جایگزین کنید
درباره طراحی و ویژگیهای آن در وبلاگ راهاندازی بیشتر بخوانید.
انتقال از Navigation 2
اگر درحالحاضر از Nav2، بهویژه Navigation Compose، استفاده میکنید، باید به Nav3 مهاجرت کنید. برای کمک به شما در این زمینه، یک راهنمای انتقال وجود دارد. مراحل کلیدی عبارتاند از:
- وابستگیهای پیمایش ۳ را اضافه کنید.
- مسیرهای پیمایش را برای پیادهسازی NavKey بهروز کنید. مسیرهای شما برای استفاده از Nav3 نیازی به پیادهسازی این میانای کاربری ندارند، اما اگر این کار را انجام دهند، میتوانید از تابع rememberNavBackStack در Nav3 برای ایجاد یک پشته قبلیها پایدار استفاده کنید.
- کلاسهایی برای نگهداری و اصلاح وضعیت پیمایش خود ایجاد کنید - این جایی است که پشتههای قبلیها شما نگهداری میشوند.
- NavController را با این کلاسها جایگزین کنید.
- مقصدهایتان را از NavGraph مربوط به NavHost به entryProvider منتقل کنید.
- NavHost را با NavDisplay جایگزین کنید.
درحال آزمایش انتقال عامل هوشوارهای
شاید بخواهید استفاده از عامل هوش مصنوعی را برای خواندن راهنمای انتقال و انجام مراحل در پروژهتان امتحان کنید. برای امتحان کردن این مورد با Gemini در «حالت عامل» از «استودیو Android»:
- این نسخه نشانگذاری راهنما را در پروژه خود ذخیره کنید.
- این پیامواره را در عامل جایگذاری کنید (اما کلید Enter را نزنید): «این پروژه را بااستفاده از به Navigation 3 منتقل کن».
- @migration-guide.md را تایپ کنید - این کار راهنما را بهعنوان بافت به نماینده ارائه میدهد.
مثل همیشه، حتماً تغییرات ایجادشده توسط عامل هوش مصنوعی را بهدقت بازبینی کنید - ممکن است اشتباه کند!
دوست داریم بدانیم شما یا نمایندهتان چگونه عمل کردید، لطفاً بازخوردتان را اینجا ارسال کنید.
دستورالعملهای پیمایش خوشمزه برای سناریوهای رایج
برای موارد استفاده رایج اما ظریف، یک مخزن دستورالعمل داریم. این نشان میدهد که چگونه Nav3 APIs را به روشی خاص ترکیب کنید و به شما امکان میدهد دستورالعمل را براساس نیازهای خاص خود انتخاب یا اصلاح کنید. اگر دستورالعملی محبوب شود، درنظر میگیریم که بخشهای غیرظریف آن را به کتابخانه اصلی Nav3 یا کتابخانههای برافزا «ارتقا» دهیم.
درحالحاضر ۱۹ دستور پخت وجود دارد، ازجمله برای:
- پشتههای قبلیها چندگانه
- مدولارسازی و تزریق وابستگی
- ارسال آرگومانهای پیمایش به ViewModels (ازجمله بااستفاده از Koin)
- برگرداندن نتایج از صفحهها براساس رویدادها و براساس وضعیت همرسانیشده
درحالحاضر روی دستورالعمل پیوندهای عمیق و همچنین ادغام Koin کار میکنیم و موارد بسیار دیگری را نیز برنامهریزی کردهایم. مهندسی از JetBrains نیز نسخه چندپلتفرمی Compose از دستورالعملها را منتشر کرده است.
اگر مورد استفاده رایجی دارید که میخواهید دستورالعملی برای آن ببینید، لطفاً درخواست دستورالعمل ارسال کنید.
خلاصه
برای شروع کار با Nav3، اسناد و دستورالعملها را بررسی کنید. بهعلاوه، منتظر یک هفته کامل محتوای فنی باشید، ازجمله:
- ویدیویی با بررسی عمیق درباره میانای برنامهسازی کاربردی که شامل مدولارسازی، پویانماییها، و چیدمانهای تطبیقی است.
- یک جلسه زنده «هرچه میخواهید بپرسید» (AMA) با مهندسانی که Nav3 را ساختهاند.
Nav3 Spotlight Week starts Dec 1st 2025.
مثل همیشه، اگر با مشکلی مواجه شدید، لطفاً آن را در اینجا ثبت کنید.
-
اخبار محصولدر سال ۲۰۲۵، بومسازگان Android بسیار فراتر از تلفن رشد کرده است. امروز، توسعهدهندگان این فرصت را دارند که به بیشاز ۵۰۰ میلیون دستگاه فعال، ازجمله دستگاههای تاشو، رایانههای لوحی، واقعیت گسترده، Chromebook، و خودروهای سازگار دسترسی پیدا کنند.
Fahd Imtiaz • ۲ دقیقه خواندن -
اخبار محصولپساز بیشاز یک سال آمادهسازی مشترک با رهبران صنعت، شرکای منطقهای، توزیعکنندگان برنامه، و انجمنهای Android، محافظتهای ما از کاربران در ۳۰ سپتامبر با موفقیت برای فروشگاههای شرکتکننده در اندونزی، برزیل، تایلند، و سنگاپور فعال شد.
Matthew Forsythe • ۲ دقیقه خواندن -
اخبار محصولبرای ارائه این تجربهها به بازیکنان و اطمینان از اینکه بازیهایتان در هر اندازه صفحهنمایشی میدرخشند، Google Play الزامات کیفیت جدیدی برای بازیها در صفحهنمایشهای بزرگ معرفی میکند
Aurash Mahbod • زمان خواندن: ۴ دقیقه
جدیدترین اطلاعات آماری توسعه Android را بهصورت هفتگی در صندوق ورودیتان دریافت کنید.