راه‌اندازی «برگشت پیش‌گویانه»

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

فعال کردن پویانمایی‌های پیش‌فرض سیستم

پویانمایی‌های سیستم برگشت به صفحه اصلی، بین‌فعالیتی، و بین‌تکلیفی در دستگاه‌های Android 15 و نسخه‌های جدیدتر برای برنامه‌هایی که به میاناهای برنامه‌سازی کاربردی پشتیبانی‌شده مدیریت برگشت منتقل شده‌اند دردسترس است.

• بازگشت به صفحه اصلی: کاربر را به صفحه اصلی برمی‌گرداند.
• فعالیت متقابل: انتقال بین فعالیت‌ها در برنامه.
• بین‌تکلیفی: انتقال بین تکالیف.

این پویانمایی‌ها به‌طور پیش‌فرض در Android 15 و نسخه‌های بالاتر فعال هستند. در دستگاه‌های دارای Android 13 یا 14، کاربران می‌توانند آن‌ها را ازطریق گزینه‌های توسعه‌دهندگان فعال کنند.

برای دریافت پویانمایی‌های سیستم، وابستگی AndroidX Activity را به 1.6.0 یا بالاتر به‌روز کنید.

فعال کردن اشاره برگشت پیش‌گویانه با «ترکیب پیمایش»

برای استفاده از برگشت پیش‌بینی‌کننده در «نوشتن پیمایش»، مطمئن شوید از کتابخانه navigation-compose ۲.۸.۰ یا بالاتر استفاده می‌کنید.

وقتی کاربر به عقب می‌کشد، «ترکیب پیمایش» به‌طور خودکار بین صفحه‌ها محو می‌کند:

هنگام پیمایش، می‌توانید با popEnterTransition و popExitTransition انتقال‌های سفارشی ایجاد کنید. وقتی روی NavHost اعمال می‌شوند، این اصلاح‌کننده‌ها به شما امکان می‌دهند نحوه پویانمایی صفحه‌های ورود و خروج را تعریف کنید. می‌توانید از آن‌ها برای ایجاد جلوه‌های متنوعی مانند مقیاس‌بندی، محو شدن، یا لغزیدن استفاده کنید.

در این مثال، scaleOut در popExitTransition برای کوچک کردن صفحه خروجی هنگام پیمایش کاربر به عقب استفاده می‌شود. علاوه‌براین، پارامتر transformOrigin نقطه‌ای را که پویانمایی مقیاس‌بندی حول آن رخ می‌دهد تعیین می‌کند. به‌طور پیش‌فرض، این مقدار مرکز صفحه‌نمایش است (0.5f, 0.5f). می‌توانید این مقدار را تنظیم کنید تا مقیاس‌بندی از نقطه دیگری شروع شود.

NavHost(
    navController = navController,
    startDestination = Home,
    popExitTransition = {
        scaleOut(
            targetScale = 0.9f,
            transformOrigin = TransformOrigin(pivotFractionX = 0.5f, pivotFractionY = 0.5f)
        )
    },
    popEnterTransition = {
        EnterTransition.None
    },
    modifier = modifier,
)
PredictiveBackSnippets.kt

این کد نتیجه زیر را تولید می‌کند:

popEnterTransition و popExitTransition به‌طور خاص پویانمایی‌ها را هنگام بیرون آوردن پشته برگشت با اشاره برگشت کنترل می‌کنند، برای مثال. همچنین می‌توانید از enterTransition و exitTransition برای تعریف پویانمایی‌های ورود و خروج عناصر ترکیبی به‌طور کلی استفاده کنید، نه فقط برای اشاره برگشت پیش‌گویانه. اگر فقط enterTransition و exitTransition را تنظیم کنید، از آن‌ها هم برای پیمایش معمولی و هم برای باز کردن پشته برگشت استفاده می‌شود. بااین‌حال، استفاده از popEnterTransition و popExitTransition به شما امکان می‌دهد پویانمایی‌های متمایزی برای پیمایش به‌عقب ایجاد کنید.

ادغام با انتقال‌های عنصر هم‌رسانی‌شده

گذار عناصر مشترک ارتباط دیداری روانی بین ترکیب‌پذیرهای دارای محتوای مشترک ایجاد می‌کند که اغلب برای پیمایش استفاده می‌شود.

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

پشتیبانی از اشاره برگشت پیش‌گویانه با عناصر Material Compose

بسیاری از عناصر در کتابخانه Material Compose به‌گونه‌ای طراحی شده‌اند که به‌طور یکپارچه با اشاره‌های برگشت پیش‌بینی‌کننده کار کنند. برای فعال کردن پویانمایی‌های برگشت پیش‌بینانه در این عناصر، جدیدترین وابستگی Material3 (androidx.compose.material3:material3-*:1.3.0 یا بالاتر) را در پروژه‌تان بگنجانید.

عناصر «مطالب» که از پویانمایی‌های اشاره برگشت پیش‌گویانه پشتیبانی می‌کنند عبارت‌اند از:

• SearchBar
• ModalBottomSheet
• ModalDrawerSheet/DismissibleDrawerSheet
• ModalNavigationDrawer/DismissibleNavigationDrawer

SearchBar و ModalBottomSheet به‌طور خودکار با اشاره‌های برگشت پیش‌گویانه پویانمایی می‌شوند. ModalNavigationDrawer، ModalDrawerSheet، DismissibleDrawerSheet، و DismissibleNavigationDrawer از شما می‌خواهند که drawerState را به ترکیب‌های محتوای برگ مربوطه آن‌ها منتقل کنید.

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

اگر هنوز از Android 13 یا Android 14 استفاده می‌کنید، می‌توانید پویانمایی برگشت به صفحه اصلی را آزمایش کنید.

برای آزمایش این پویانمایی، این مراحل را دنبال کنید:

1. در دستگاهتان، به تنظیمات > سیستم > گزینه‌های توسعه‌دهنده بروید.
2. پویانمایی‌های اشاره برگشت پیش‌گویانه را انتخاب کنید.
3. برنامه به‌روزشده‌تان را راه‌اندازی کنید و از اشاره برگشت برای دیدن آن در عمل استفاده کنید.

در Android 15 و نسخه‌های جدیدتر، این ویژگی به‌طور پیش‌فرض فعال است.

منابع بیشتر

• افزودن codelab پویانمایی‌های اشاره برگشت پیش‌گویانه
• پویانمایی‌های چیدمان پیشرفته در «ساخت ویدیو»