מעבר

מוסיפים אנימציה של התנועה בממשק המשתמש בעזרת פריסות של התחלה וסיום.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסה אלפא
24 ביולי 2024 1.5.1 - - -

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

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

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

מגניב

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

Kotlin

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

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

משוב

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

דיווח על בעיה חדשה

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

גירסה 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 ל-גרסה 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(), הפונקציה onTransitionEnd() תופעל עכשיו ב-TransitionListeners שנוסף אחרי ה-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 מכילה את ההצהרות האלה.

תכונות חדשות

  • התכונה 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 כוללת את ההוספות האלה.

תכונות חדשות

  • עכשיו אפשר להגדיר את ההתקדמות כחלק מתוך משך הזמן הכולל באמצעות setCurrentFragment() ב-TransitionSeekController. (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)

עדכון יחסי תלות

  • עכשיו אפשר לבצע הידור של Transition עם 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 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

תיקוני באגים

  • תוקנה בעיה שבה הפעלת 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 להוספת מאזינים למכונות Transition של AndroidX. (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 להוספת מאזינים למכונות Transition של AndroidX. (b/138870873)

גרסה 1.3.1

גרסה 1.3.1

19 בפברואר 2020

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

תיקוני באגים

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

גרסה 1.2.0-beta01

2 ביולי 2019

androidx.transition:transition:1.2.0-beta01 משוחרר. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

תכונות חדשות

  • צריך להשתמש בגרסה הזו אם מציינים 29 כ-targetSdkVersion. אחרת, חלק מהמעברים לא יפעלו כראוי. במקום הקריאות להחזרה, הגרסה הזו משתמשת בשיטות הציבוריות החדשות שנוספו ברמה 29 של API. היא חלק מהמאמצים שלנו להגביל את השימוש בממשקים שאינם 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 משוחרר. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

תיקוני באגים

  • תיקון ל-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 משוחרר. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

תיקוני באגים

  • תוקן באג שמקורו בשמירת 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).
  • תוקנה אנימציה שגויה כאשר הופעלו שני מעברי חשיפה (b/62629600).
  • מתן הרשאה לשינוי ערכי ברירת מחדל כמו משך זמן ואינטרפולטור לילדים של TransitionSet (b/64644617).
  • תיקנו הרבה באגים קטנים נוספים.