מעבר

הנפשת תנועה בממשק המשתמש עם פריסות התחלה וסיום.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫3 בדצמבר 2025 1.6.0 - ‎1.7.0-beta01 -

הצהרה על יחסי תלות

כדי להוסיף תלות ב-Transition, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.

מוסיפים את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:

מגניב

dependencies {
    // Java language implementation
    implementation "androidx.transition:transition:1.6.0"
    // Kotlin
    implementation "androidx.transition:transition-ktx:1.6.0"
}

Kotlin

dependencies {
    // Java language implementation
    implementation("androidx.transition:transition:1.6.0")
    // Kotlin
    implementation("androidx.transition:transition-ktx:1.6.0")
}

מידע נוסף על יחסי תלות זמין במאמר הוספת יחסי תלות ב-build.

משוב

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

יצירת בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא הכלי למעקב אחר בעיות.

גרסה 1.7

גרסה ‎1.7.0-beta01

‫3 בדצמבר 2025

הגרסאות androidx.transition:transition:1.7.0-beta01 ו-androidx.transition:transition-ktx:1.7.0-beta01 יוצאות לאור. גרסה 1.7.0-beta01 מכילה את הקומטים האלה.

תיקוני באגים

גרסה ‎1.7.0-alpha01

‫30 ביולי 2025

הגרסאות androidx.transition:transition:1.7.0-alpha01 ו-androidx.transition:transition-ktx:1.7.0-alpha01 יוצאות לאור. גרסה ‎1.7.0-alpha01 מכילה את הקומטים האלה.

תיקוני באגים

  • תוקנה קריסה שמתרחשת כשהתצוגה מצורפת לחלון עם ערך null של windowId. (I2ddf6)

גרסה 1.6

גרסה 1.6.0

‫23 באפריל 2025

הגרסאות androidx.transition:transition:1.6.0 ו-androidx.transition:transition-ktx:1.6.0 יוצאות לאור. גרסה 1.6.0 מכילה את הקומטים האלה.

גרסה 1.6.0-rc01

‫26 במרץ 2025

הגרסאות androidx.transition:transition:1.6.0-rc01 ו-androidx.transition:transition-ktx:1.6.0-rc01 יוצאות לאור. גרסה 1.6.0-rc01 מכילה את הקומטים האלה.

גרסה ‎1.6.0-beta01

‫12 במרץ 2025

גרסאות androidx.transition:transition:1.6.0-beta01 ו-androidx.transition:transition-ktx:1.6.0-beta01 יוצאות ללא שינויים מאז גרסת האלפא האחרונה. גרסה 1.6.0-beta01 מכילה את הקומטים האלה.

גרסה ‎1.6.0-alpha01

‫11 בדצמבר 2024

הגרסאות androidx.transition:transition:1.6.0-alpha01 ו-androidx.transition:transition-ktx:1.6.0-alpha01 יוצאות לאור. גרסה ‎1.6.0-alpha01 מכילה את ההתחייבויות האלה.

תכונות חדשות

  • המעבר מגדיר עכשיו את ההורה המנותק של ViewOverlays שמשמש להנפשת המעברים שלו. כך אפשר לפתור בעיות שקשורות לבעלים באמצעות ההורה המנותק, מה שאומר שעכשיו אפשר לפתור בעיות שקשורות ל-ViewModels, למחזורי חיים וכו' במהלך מעבר. (I10a16, ‏ b/340894487, ‏ b/287484338)

תיקוני באגים

  • הספרייה הזו משתמשת עכשיו בהערות לגבי ערכי null של JSpecify, שהן הערות לשימוש בסוג. מפתחים ב-Kotlin צריכים להשתמש בארגומנט המהדר הבא כדי לאכוף שימוש נכון: -Xjspecify-annotations=strict (זו ברירת המחדל החל מגרסה 2.1.0 של מהדר Kotlin). (I1f54e, b/326456246)
  • הסרנו את האפשרות ליצור באופן ידני תרשים של הגישה לממשקי API חדשים של הפלטפורמה, כי זה קורה באופן אוטומטי באמצעות מידול API כשמשתמשים ב-R8 עם AGP 7.3 ואילך (למשל R8 גרסה 3.3), ובכל הגרסאות כשמשתמשים ב-AGP 8.1 ואילך (למשל D8 גרסה 8.1). לקוחות שלא משתמשים ב-AGP מומלץ לעדכן לגרסה 8.1 של D8 או לגרסה מאוחרת יותר. למידע נוסף, מומלץ לעיין במאמר הזה. ‫(Ia60e0, ‏ b/345472586)

גירסה 1.5

גירסה 1.5.1

‫24 ביולי 2024

הגרסאות androidx.transition:transition:1.5.1 ו-androidx.transition:transition-ktx:1.5.1 יוצאות לאור. גרסה 1.5.1 מכילה את ההתחייבויות האלה.

תיקוני באגים

  • תוקנה בעיה שגרמה לכך שהמערכת התעלמה מקריאות ל-animateToStart() או ל-animateToEnd() במעבר שאפשר להזיז את הסמן בו אם המעבר לא התחיל. (I44d96, b/338624457)

גרסה 1.5.0

‫1 במאי 2024

הגרסאות androidx.transition:transition:1.5.0 ו-androidx.transition:transition-ktx:1.5.0 יוצאות לאור. גרסה 1.5.0 מכילה את ההתחייבויות האלה.

שינויים חשובים מאז גרסה 1.4.0

  • התכונה 'מעברים' תומכת בהזזה ב-API מגרסה 34 ואילך. נוסף API חדש ל-TransitionManager, controlDelayedTransition(), שמחזיר TransitionSeekController שמאפשר חיפוש ב-Transition. הפונקציונליות הזו משמשת את Fragment 1.7.0 כדי לחפש באופן אוטומטי מעברים כשמשתמשים בתנועת החזרה החזויה.
  • למעברים יש שיטה חדשה, getRootTransition(), שמחזירה את המעבר שמכיל את המעבר הנוכחי, או את המעבר הנוכחי אם הוא לא נכלל במעבר אחר. זה יכול להיות שימושי אם המפתח צריך להגדיר מאזינים למקרים שבהם כל המעבר מתחיל או מסתיים.
  • ל-TransitionListeners יש עכשיו מאזינים חדשים של onTransitionStart() ושל onTransitionEnd(), שמאפשרים למפתח לדעת אם המעבר מתחיל או מסתיים, אם הוא מתבצע בסדר הפוך או לא. המידע הזה יכול להיות חשוב כשמפתחים מעברים שאפשר להעביר בהם את הסרטון קדימה ואחורה, ושכוללים TransitionListeners.

גרסה 1.5.0-rc02

‫17 באפריל 2024

הגרסאות androidx.transition:transition:1.5.0-rc02 ו-androidx.transition:transition-ktx:1.5.0-rc02 יוצאות לאור. גרסה ‎1.5.0-rc02 מכילה את ההתחייבויות האלה.

עדכון תלות

  • עודכן Fragment dependency לversion 1.7.0-rc02. העדכון הזה פתר באג שגרם לקריסה אם נוסף אלמנט משותף שלא ניתן להעברה לעסקה שבה כל המעברים האחרים ניתנים להעברה.

גרסה ‎1.5.0-rc01

‫3 באפריל 2024

הגרסאות androidx.transition:transition:1.5.0-rc01 ו-androidx.transition:transition-ktx:1.5.0-rc01 יוצאות לאור. גרסה 1.5.0-rc01 מכילה את הקומטים האלה.

גרסה 1.5.0-beta01

‫20 במרץ 2024

הגרסאות androidx.transition:transition:1.5.0-beta01 ו-androidx.transition:transition-ktx:1.5.0-beta01 יוצאות לאור. גרסה 1.5.0-beta01 מכילה את הקומטים האלה.

תיקוני באגים

  • תוקנה בעיה ב-Fragments שבה הפרעה למעברים נכנסים באמצעות תנועת חזרה חזויה גרמה להרס התצוגה הנכנסת, ויכול להיות שהמסך נשאר ריק. ‫(Id3f22, ‏ b/319531491)

גרסה ‎1.5.0-alpha06

‫10 בינואר 2024

הגרסאות androidx.transition:transition:1.5.0-alpha06 ו-androidx.transition:transition-ktx:1.5.0-alpha06 יוצאות לאור. גרסה ‎1.5.0-alpha06 מכילה את הקומיטים האלה.

תיקוני באגים

  • כשמשתמשים ב-TransitionSeekController.animateToStart(), המשתמשים שנוספו TransitionListeners יקבלו עכשיו את ההודעה onTransitionEnd() אחרי שניתן Runnable של animateToStart(). (‫Ic6a55, ‏ b/307624554)

עדכון תלות

  • התלות ב-Fragment עודכנה ל-1.7.0-alpha08.

גרסה ‎1.5.0-alpha05

‫29 בנובמבר 2023

הגרסאות androidx.transition:transition:1.5.0-alpha05 ו-androidx.transition:transition-ktx:1.5.0-alpha05 יוצאות לאור. גרסה ‎1.5.0-alpha05 מכילה את הקומיטים האלה.

תיקוני באגים

  • תוקנה שגיאה NullPointerException שנגרמה מהגדרת מעבר של רכיב משותף בלי להגדיר גם enter/exitTransition. (I8472b)
  • נפתרה בעיה שגרמה לכך שהפונקציה animateToStart() עם Slide() לא העבירה את התצוגה חזרה למיקום ההתחלתי (I698f4, ‏ b/300157785)
  • תוקנה בעיה של כניסה חוזרת ב-Transition שגרמה לביטול. (Iddcce, b/308379201)

גרסה ‎1.5.0-alpha04

‫4 באוקטובר 2023

‫androidx.transition:transition:1.5.0-alpha04 ו-`androidx.transition:transition-ktx:1.5.0-alpha04 הושקו. גרסה ‎1.5.0-alpha04 מכילה את הקומיטים האלה.

שינויים ב-API

  • שינוי שעלול לשבור תאימות לאחור – השיטה animateToStart() מקבלת עכשיו Runnable שצריך להשתמש בו כדי להחזיר את התצוגות המשתנות למצב המקורי שלהן.

גרסה ‎1.5.0-alpha03

‫20 בספטמבר 2023

הגרסאות androidx.transition:transition:1.5.0-alpha03 ו-androidx.transition:transition-ktx:1.5.0-alpha03 יוצאות לאור. גרסה ‎1.5.0-alpha03 מכילה את הקומיטים האלה.

תכונות חדשות

  • המעבר מספק עכשיו תמיכה באנימציות של חזרה עם חיזוי באפליקציה במכשירי Android 14 כשמשתמשים בו עם Fragment 1.7.0-alpha05.

תיקוני באגים

  • תוקן באג שגרם להפרעה במעבר בין שקפים. כשמעבר שקף קטע מעבר כניסה כדי להסיר תצוגה, הוא קופץ למיקום שגוי. ‫(I946f8, ‏ b/297427333)

גרסה ‎1.5.0-alpha02

‫6 בספטמבר 2023

הגרסאות androidx.transition:transition:1.5.0-alpha02 ו-androidx.transition:transition-ktx:1.5.0-alpha02 יוצאות לאור. גרסה ‎1.5.0-alpha02 מכילה את הקומיטים האלה.

תכונות חדשות

  • ‫TransitionSeekController מאפשר עכשיו להגדיר את ההתקדמות כשבר של משך הזמן הכולל באמצעות setCurrentFragment(). (aosp/2647607)
  • מעכשיו אפשר לעקוב אחרי ההתקדמות ב-TransitionSeekController כשמשתמשים ב-animateToStart() וב-animateToEnd() על ידי קריאה ל-addOnProgressChangedListener. (aosp/2647607)
  • נוסף TransitionManager.seekTo() כדי לאפשר שימוש בסצנות לחיפוש מעברים. (aosp/2647607)
  • נוספו אנימציות מבוססות-פיזיקה למעברים בין נקודות זמן בסרטון. הוא משתמש במעקב מהירות חד-ממדי כדי לעקוב אחרי שינוי ההתקדמות באמצעות setCurrentFraction() או setCurrentPlayTimeMillis(), ומשתמש בו למהירות ההתחלתית של animateToStart ו-animateToEnd. (aosp/2647607)

תיקוני באגים

  • תוקנה הבהוב שהתרחש כשמנסים להגיע למיקום מסוים בסרטון AutoTransition. (aosp/2643369)
  • תוקנה בעיה שגרמה לכך שמעבר Slide קפץ למיקום התחלתי שגוי כשהוא הופרע. ‫(aosp/2733729, ‏ b/297427333)

עדכון תלות

  • המעבר מתבצע עכשיו באמצעות API 34.

גרסה ‎1.5.0-alpha01

‫10 במאי 2023

הגרסאות androidx.transition:transition:1.5.0-alpha01 ו-androidx.transition:transition-ktx:1.5.0-alpha01 יוצאות לאור. הגרסה הזו פותחה בענף פנימי.

תכונות חדשות

  • התכונה 'מעברים' תומכת בהזזה ב-API מגרסה 34 ואילך. נוסף API חדש ל-TransitionManager, ‏ controlDelayedTransition(), שמחזיר TransisionSeekController שמאפשר חיפוש המעבר.

שינויים ב-API

  • ‫TransitionManager כולל שיטה חדשה, controlDelayedTransition(), שמאפשרת לאפליקציות לשלוט בהתקדמות של אנימציות מעבר ב-API 34 ומעלה. הערך המוחזר TransitionSeekController מאפשר למפתח לדעת מתי המעבר מוכן לחיפוש, מה משך האנימציה ומאפשר להגדיר את הזמן הנוכחי של האנימציה. ‫controlDelayedTransition() תומך רק במעברים שמבטלים את isSeekable() כדי להחזיר את הערך true.
  • למעברים יש שיטה חדשה, getRootTransition(), שמחזירה את המעבר שמכיל את המעבר הנוכחי, או את המעבר הנוכחי אם הוא לא נכלל במעבר אחר. זה יכול להיות שימושי אם המפתח צריך להגדיר מאזינים למקרים שבהם כל המעבר מתחיל או מסתיים.
  • ל-TransitionListeners יש עכשיו מאזינים חדשים של onTransitionStart() ושל onTransitionEnd(), שמאפשרים למפתח לדעת אם המעבר מתחיל או מסתיים, אם הוא מתבצע בסדר הפוך או לא. המידע הזה יכול להיות חשוב כשמפתחים מעברים שאפשר להעביר בהם את הסרטון קדימה ואחורה, ושכוללים TransitionListeners.

תיקוני באגים

  • מעכשיו, כשמשכפלים מעברים, הם מעתיקים את ה-TransitionListeners שלהם. המשמעות היא שהוספה של מאזינים חדשים במהלך createAnimator() לא תשפיע על המעבר הבסיסי.

גרסה 1.4.1

גרסה 1.4.1

21 באפריל 2021

הגרסאות androidx.transition:transition:1.4.1 ו-androidx.transition:transition-ktx:1.4.1 יוצאות לאור. גרסה 1.4.1 מכילה את הקומיטים האלה.

תיקוני באגים

  • תוקנה בעיה שבה הפעלה של Transition במאגר אחד השהתה בטעות מעברים אחרים שפועלים במאגרים נפרדים, ולכן המעברים האחרים לא הסתיימו. (aosp/1664439, b/182845041)

גרסה 1.4.0

גרסה 1.4.0

‫27 בינואר 2021

הגרסאות androidx.transition:transition:1.4.0 ו-androidx.transition:transition-ktx:1.4.0 יוצאות לאור. גרסה 1.4.0 מכילה את הקומיטים האלה.

שינויים משמעותיים מאז גרסה 1.3.0

  • ארטיפקט transition-ktx מציג תוספים של Kotlin להוספת מאזינים למופעים של AndroidX Transition. (b/138870873)

גרסה 1.4.0-rc01

‫2 בדצמבר 2020

הגרסאות androidx.transition:transition:1.4.0-rc01 ו-androidx.transition:transition-ktx:1.4.0-rc01 לא כוללות שינויים בהשוואה לגרסה 1.4.0-beta01. גרסה 1.4.0-rc01 כוללת את הקומיטים האלה.

גרסה ‎1.4.0-beta01

‫22 ביולי 2020

הגרסאות androidx.transition:transition:1.4.0-beta01 ו-androidx.transition:transition-ktx:1.4.0-beta01 יצאו ללא שינויים מאז 1.4.0-alpha01. גרסה 1.4.0-beta01 מכילה את הקומיטים האלה.

גרסה ‎1.4.0-alpha01

‫24 ביוני 2020

הגרסאות androidx.transition:transition:1.4.0-alpha01 ו-androidx.transition:transition-ktx:1.4.0-alpha01 יוצאות לאור. גרסה ‎1.4.0-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

  • ארטיפקט transition-ktx מציג תוספים של Kotlin להוספת מאזינים למופעים של AndroidX Transition. (b/138870873)

גרסה 1.3.1

גרסה 1.3.1

‫19 בפברואר 2020

androidx.transition:transition:1.3.1 משוחרר. גרסה 1.3.1 מכילה את הקומיטים האלה.

תיקוני באגים

  • תוקן באג שגרם לחיתוך שגוי של חלק מתצוגות Animated Views כשנעשה שימוש ב-ChangeTransform ‏ (b/148798452)

גרסה 1.3.0

גרסה 1.3.0

‫22 בינואר 2020

androidx.transition:transition:1.3.0 משוחרר. גרסה 1.3.0 מכילה את הקומיטים האלה.

שינויים חשובים מאז גרסה 1.2.0

  • שיפורים ב-Fragment 1.2.0: שיפרנו את השילוב עם Fragment 1.2.0 כדי לוודא שהתצוגה של Fragment לא נהרסת לפני שהמעבר מסתיים, ושהמעברים מבוטלים בזמן המתאים.

גרסה 1.3.0-rc02

4 בדצמבר 2019

androidx.transition:transition:1.3.0-rc02 משוחרר. גרסה 1.3.0-rc02 מכילה את הקומיטים האלה.

תיקוני באגים

  • תוקנה בעיה שבה תצוגות סומנו בצורה שגויה INVISIBLE אחרי הצגה של Fragment מוסתר. (b/70793925)

גרסה 1.3.0-rc01

‫23 באוקטובר 2019

הגרסה androidx.transition:transition:1.3.0-rc01 הופצה ללא שינויים מאז 1.3.0-beta01. גרסה 1.3.0-rc01 מכילה את הקומיטים האלה.

גרסה 1.3.0-beta01

‫9 באוקטובר 2019

androidx.transition:transition:1.3.0-beta01 משוחרר. גרסה ‎1.3.0-beta01 מכילה את הקומיטים האלה.

תכונות חדשות

  • שיפרנו את השילוב עם Fragment 1.2.0-beta01 כדי לוודא שהתצוגה של Fragment לא נהרסת לפני שהמעבר מסתיים, ושהמעברים מבוטלים בזמן המתאים. (aosp/1119841)

גרסה 1.2.0

גרסה 1.2.0

‫9 באוקטובר 2019

‫androidx.transition:transition:1.2.0 יוצא ללא שינויים מגרסה 1.2.0-rc01 . גרסה 1.2.0 מכילה את הקומיטים האלה.

שינויים חשובים מאז גרסה 1.1.0

צריך להשתמש בגרסה הזו אם אתם מכוונים לרמת API ‏29. אחרת, חלק מהמעברים לא יפעלו בצורה תקינה. במקום קריאות הרפלקציה, הגרסה הזו משתמשת בשיטות הציבוריות החדשות שנוספו ברמת API‏ 29. היא חלק מהמאמץ שלנו להגביל את השימוש בממשקים שאינם SDK.

גרסה 1.2.0-rc01

5 בספטמבר 2019

‫androidx.transition:transition:1.2.0-rc01 יוצא ללא שינויים מאז גרסה 1.2.0-beta01. כאן אפשר לראות את הקומיטים שכלולים בגרסה הזו.

גרסה ‎1.2.0-beta01

‫2 ביולי 2019

androidx.transition:transition:1.2.0-beta01 משוחרר. כאן אפשר לראות את הקומיטים שכלולים בגרסה הזו.

תכונות חדשות

  • צריך להשתמש בגרסה הזו אם מציינים 29 כ-targetSdkVersion. אחרת, חלק מהמעברים לא יפעלו בצורה תקינה. במקום קריאות הרפלקציה, הגרסה הזו משתמשת בשיטות הציבוריות החדשות שנוספו ברמת API‏ 29. היא חלק מהמאמץ שלנו להגביל את השימוש בממשקים שאינם SDK.

גרסה ‎1.2.0-alpha01

‫7 במאי 2019

androidx.transition:transition:1.2.0-alpha01 משוחרר.

תכונות חדשות

  • צריך להשתמש בגרסה הזו אם מציינים את Q כtargetSdkVersion. אחרת, חלק מהמעברים לא יפעלו בצורה תקינה. במקום קריאות הרפלקציה, הגרסה הזו משתמשת בשיטות הציבוריות החדשות שנוספו ב-Q. היא חלק מהמאמץ שלנו להגביל את השימוש בממשקים שאינם SDK.

גרסה 1.1.0

גרסה 1.1.0

‫2 ביולי 2019

‫androidx.transition:transition:1.1.0 יוצא ללא שינויים מ-1.1.0-rc02. כאן אפשר לראות את הקומיטים שכלולים בגרסה הזו.

גרסה 1.1.0-rc02

‫5 ביוני 2019

androidx.transition:transition:1.1.0-rc02 משוחרר. כאן אפשר לראות את הקומיטים שכלולים בגרסה הזו.

תיקוני באגים

  • תיקון של TransitionManager.endTransitions() כדי שיפעל בצורה נכונה עם מעברים תלויים. (aosp/946400)

גרסה ‎1.1.0-rc01

‫7 במאי 2019

androidx.transition:transition:1.1.0-rc01 משוחרר. כאן אפשר לראות את הקומיטים שכלולים בגרסה הזו.

גרסה ‎1.1.0-beta01

‫3 באפריל 2019

androidx.transition:transition:1.1.0-beta01 משוחרר. כאן אפשר לראות את הקומיטים שכלולים בגרסה הזו.

תיקוני באגים

  • תוקן באג במטמון של ViewGroupOverlay ב-Visibility, שמתרחש ברמת API‏ 17 ומטה (aosp/937350)

גרסה ‎1.1.0-alpha02

‫13 במרץ 2019

androidx.transition:transition:1.1.0-alpha02 משוחרר. כאן אפשר לראות את הרשימה המלאה של הקומיטים שכלולים בגרסה הזו.

שינויים ב-API

  • הסוג של פרמטר השיטה Scene.getCurrentScene() השתנה מ-View ל-ViewGroup.

תיקוני באגים

  • התג SidePropagation לא פועל כשמוסיפים עיכוב באמצעות setStartDelay() (b/119839526).
  • ‫ChangeImageTransform מחיל מטריצה שגויה כשהוא מופרע לפני API 21 (b/123226255).
  • ‫ChangeTransform פועל בצורה שגויה במקרים מסוימים לפני API 21 (‏b/125777978).

גרסה ‎1.1.0-alpha01

‫3 בדצמבר 2018

שינויים ב-API

  • ‫aosp/807055: Scene.getCurrentScene(View) שיטה שהפכה לציבורית. היא מאפשרת לכם לכתוב לוגיקה מותנית בהתאמה אישית בהתאם לסצנה הנוכחית.

תיקוני באגים

  • תוקנה קריסה שהתרחשה כשמשתמשים ב-TransitionManager כדי לכווץ או להרחיב פריט ב-RecyclerView (b/37129527).
  • תוקנה אנימציה שגויה כששני מעברים של Visibility הוחלו (b/62629600).
  • אפשר לבטל ערכים כמו משך ואינטרפולטור עבור רכיבי צאצא של TransitionSet (b/64644617).
  • תיקנו באגים קלים רבים אחרים.