מעבר

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

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

כדי להוסיף תלות ב-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-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 מומלץ לעדכן לגרסה D8 8.1 ואילך. למידע נוסף, מומלץ לעיין במאמר הזה. ‫(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() אחרי ש-animateToStart() ייתן את Runnable. (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 מכילה את הקומיטים האלה.

תכונות חדשות

  • הספרייה Transition תומכת עכשיו באנימציות של חזרה עם חיזוי באפליקציות במכשירי 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 View כשנעשה שימוש ב-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).
  • תיקנו באגים קלים רבים אחרים.