הגדרת 'חיזוי החזרה'

התכונות 'חיזוי החזרה' ו'אנימציות מערכת' מופעלות כברירת מחדל. אם האפליקציה שלכם מיירטת את אירוע החזרה ולא ביצעתם מעבר לניווט חזרה עם חיזוי, תצטרכו לעדכן את האפליקציה כדי להשתמש בממשקי API נתמכים לניווט חזרה.

הפעלת אנימציות ברירת המחדל של המערכת

אנימציות המערכת של חזרה למסך הבית, מעבר בין פעילויות ומעבר בין משימות זמינות במכשירים עם Android מגרסה 15 ואילך, באפליקציות שעברו ל-APIs הנתמכים לטיפול בתנועת החזרה.

• חזרה למסך הבית: מחזיר את המשתמש למסך הבית.
• פעילות חוצת-פעילויות: מעברים בין פעילויות באפליקציה.
• בין משימות: מעברים בין משימות.

האנימציות האלה מופעלות כברירת מחדל ב-Android מגרסה 15 ואילך. במכשירים עם Android 13 או Android 14, המשתמשים יכולים להפעיל אותם דרך האפשרויות למפתחים.

כדי לקבל את האנימציות של המערכת, צריך לעדכן את התלות ב-AndroidX Activity לגרסה 1.6.0 ואילך.

הפעלת חיזוי החזרה באמצעות Navigation Compose

כדי להשתמש בתכונה 'חזרה חזויה' ב-Navigation Compose, צריך לוודא שאתם משתמשים בספרייה navigation-compose 2.8.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 שולטים באנימציות באופן ספציפי כשמבצעים פעולת חזרה (pop) במקבץ פעילויות קודמות (back stack), למשל באמצעות תנועת חזרה. אפשר גם להשתמש ב-enterTransition וב-exitTransition כדי להגדיר אנימציות לכניסה וליציאה של רכיבי Composable באופן כללי, ולא רק עבור חיזוי החזרה. אם מגדירים רק את enterTransition ואת exitTransition, הם ישמשו גם לניווט רגיל וגם להחזרת מקבץ הפעילויות הקודמות (back stack). עם זאת, באמצעות popEnterTransition ו-popExitTransition אפשר ליצור אנימציות שונות לניווט אחורה.

שילוב עם מעברים של רכיבים משותפים

מעברים בין רכיבים משותפים מספקים חיבור ויזואלי חלק בין קומפוזיציות עם תוכן משותף, ומשמשים לעיתים קרובות לניווט.

כדי להשתמש ברכיבים משותפים עם Navigation Compose, אפשר לעיין במאמר בנושא חיזוי החזרה עם רכיבים משותפים.

תמיכה בחזרה חזויה באמצעות רכיבי Material Compose

רכיבים רבים בספריית Material Compose מתוכננים לפעול בצורה חלקה עם תנועות ניווט חזויות. כדי להפעיל אנימציות של חזרה עם חיזוי ברכיבים האלה, צריך לכלול בפרויקט את התלות העדכנית ב-Material3 (גרסה androidx.compose.material3:material3-*:1.3.0 ואילך).

רכיבי Material שתומכים באנימציות של חיזוי החזרה כוללים:

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

‫SearchBar ו-ModalBottomSheet מונפשים אוטומטית באמצעות חיזוי תנועות החזרה. כדי להשתמש ב-ModalNavigationDrawer,‏ ModalDrawerSheet, ‏ DismissibleDrawerSheet ו-DismissibleNavigationDrawer, צריך להעביר את drawerState לרכיבי ה-Composable של תוכן הגיליון המתאימים.

בדיקת האנימציה של חיזוי תנועת החזרה

אם אתם עדיין משתמשים ב-Android 13 או ב-Android 14, אתם יכולים לבדוק את האנימציה של החזרה למסך הבית.

כדי לבדוק את האנימציה הזו, מבצעים את השלבים הבאים:

1. במכשיר, עוברים אל הגדרות > מערכת > אפשרויות למפתחים.
2. בוחרים באפשרות חיזוי החזרה אנימציות.
3. מפעילים את האפליקציה המעודכנת ומשתמשים בתנועת החזרה כדי לראות אותה בפעולה.

ב-Android מגרסה 15 ואילך, התכונה הזו מופעלת כברירת מחדל.

מקורות מידע נוספים

• ‫Codelab בנושא הוספת אנימציות של חיזוי החזרה
• אנימציות מתקדמות של פריסות ב-Compose video