انتقالات

تحريك الحركة في واجهة المستخدم باستخدام تنسيقات البداية والنهاية.
التعديل الأخير الإصدار المستقر سحب المرشح الإصدار التجريبي إصدار أولي
24 يوليو 2024 1.5.1 - - -

إعلان التبعيات

لإضافة اعتمادية على Transition، يجب إضافة مستودع Google Maven إلى مشروعك. الاطّلاع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الملحقات التابعة للعناصر التي تحتاجها في ملف build.gradle لـ لتطبيقك أو الوحدة التي تستخدمها:

Groovy

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")
}

لمزيد من المعلومات حول العناصر الاعتمادية، يُرجى الاطّلاع على إضافة تبعيات الإصدار.

ملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى إلقاء نظرة على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة تصويتك إلى مشكلة حالية عن طريق بالنقر فوق زر النجمة.

إنشاء عدد جديد

يُرجى الاطّلاع على مستندات أداة تتبُّع المشاكل. لمزيد من المعلومات.

الإصدار 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

  • إتاحة عمليات الانتقال في واجهة برمجة التطبيقات 34 والإصدارات الأحدث تمت إضافة واجهة برمجة تطبيقات جديدة إلى 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 على عمليات التنفيذ هذه.

تعديل بشأن التبعية

  • تم تعديل تبعية الجزء إلى الإصدار 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 على عمليات الالتزام هذه.

إصلاح الأخطاء

  • تم إصلاح مشكلة في "الأجزاء" تؤدي فيها مقاطعة الانتقالات الواردة باستخدام إيماءة رجوع توقُّعية إلى تدمير عرض الدخول، ومن المحتمل أن تترك شاشة فارغة. (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)

تعديل بشأن التبعية

  • تم تعديل تبعية الجزء إلى 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).
  • تم إصلاح مشكلة إعادة الدخول في عملية النقل التي أدت إلى تعطُّل عملية الإلغاء. (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 على هذه عمليات التنفيذ.

التغييرات في واجهة برمجة التطبيقات

  • كسر التغيير - تستخدم الطريقة 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 عند استخدامها مع القسم 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)

تعديل بشأن التبعية

  • يتم تجميع النقل الآن باستخدام واجهة برمجة التطبيقات 34.

الإصدار 1.5.0-alpha01

10 أيار (مايو) 2023

تم طرح androidx.transition:transition:1.5.0-alpha01 وandroidx.transition:transition-ktx:1.5.0-alpha01. تم تطوير هذا الإصدار في فرع داخلي.

الميزات الجديدة

  • إتاحة عمليات الانتقال في واجهة برمجة التطبيقات 34 والإصدارات الأحدث تمت إضافة واجهة برمجة تطبيقات جديدة إلى TransitionManager، controlDelayedTransition()، ما يعرض TransisionSeekController تسمح بالطلب عملية النقل.

التغييرات في واجهة برمجة التطبيقات

  • تتوفر في TransitionManager طريقة جديدة، controlDelayedTransition()، تتيح للتطبيقات التحكّم في تقدُّم عملية النقل على واجهة برمجة التطبيقات 34 أو الإصدارات الأحدث. تتيح TransitionSeekController التي يتم عرضها لمطوّر البرامج معرفة الوقت الذي يكون فيه الانتقال جاهزًا للتقديم أو ترجيع الفيديو، ومدة الحركة، ويسمح بضبط الوقت الحالي للصورة المتحركة. يتيح controlDelayedTransition() فقط عمليات الانتقال التي تلغي isSeekable() وإرجاع القيمة "صحيح".
  • تشتمل عمليات النقل على طريقة جديدة، 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 على عمليات الالتزام هذه.

إصلاح الأخطاء

  • إصلاح خطأ كان يتم اقتصاص بعض طرق العرض المتحركة بشكل غير صحيح عند استخدام ChangeTransform (b/148798452)

الإصدار 1.3.0

الإصدار 1.3.0

22 كانون الثاني (يناير) 2020

تم طرح androidx.transition:transition:1.3.0. يحتوي الإصدار 1.3.0 على عمليات الالتزام هذه.

تغييرات مهمة منذ الإصدار 1.2.0

  • تحسينات على الإصدار 1.2.0: تم تحسين الدمج مع الإصدار 1.2.0 لضمان عدم إتلاف عرض الجزء قبل اكتمال عملية النقل وإلغاء عمليات النقل في الوقت المناسب.

الإصدار 1.3.0-rc02

4 كانون الأول (ديسمبر) 2019

تم طرح androidx.transition:transition:1.3.0-rc02. يحتوي الإصدار 1.3.0-rc02 على هذه عمليات التنفيذ.

إصلاح الأخطاء

  • تم إصلاح مشكلة وضع علامة INVISIBLE على المشاهدات بشكل غير صحيح بعد ظهور جزء مخفي. (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 على هذه الالتزامات.

الميزات الجديدة

  • تم تحسين الدمج مع القسم 1.2.0-beta01 لضمان عدم تلف عرض الجزء قبل اكتمال عملية النقل وإلغاء عمليات النقل في الوقت المناسب. (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

ويجب استخدام هذا الإصدار إذا كنت تستهدف المستوى 29 من واجهة برمجة التطبيقات. وإلا، فلن تعمل بعض عمليات الانتقال بشكل صحيح. بدلاً من استدعاءات الانعكاس، يستخدم هذا الإصدار الطرق العامة الجديدة التي تمت إضافتها في المستوى 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. وإلا، فلن تعمل بعض عمليات الانتقال بشكل صحيح. بدلاً من استدعاءات الانعكاس، يستخدم هذا الإصدار الطرق العامة الجديدة التي تمت إضافتها في المستوى 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، والذي يحدث في المستوى 17 من واجهة برمجة التطبيقات والمستويات الأدنى (aosp/937350).

الإصدار 1.1.0-alpha02

13 آذار (مارس) 2019

تم طرح androidx.transition:transition:1.1.0-alpha02. يمكن الاطّلاع هنا على القائمة الكاملة لخطط الاشتراك المضمَّنة في هذا الإصدار.

التغييرات في واجهة برمجة التطبيقات

  • تم تغيير نوع معلَمة الطريقة Scene.getCurrentScene() من View إلى ViewGroup.

إصلاح الأخطاء

  • لا يعمل SidePropagation عند توفير تأخير إضافي من خلال setStartDelay() (b/119839526).
  • تطبِّق الدالة ChangeImageTransform مصفوفة غير صحيحة عند مقاطعتها قبل واجهة برمجة التطبيقات 21 (b/123226255).
  • تعمل ChangeTransform بشكل غير صحيح في بعض الحالات قبل واجهة برمجة التطبيقات 21 (b/125777978).

الإصدار 1.1.0-alpha01

3 كانون الأول (ديسمبر) 2018

التغييرات في واجهة برمجة التطبيقات

  • aosp/807055: تم نشر طريقة Scene.getCurrentScene(View) بشكل علني. يسمح لك بكتابة منطق شرطي مخصص بناءً على مشهد حالي.

إصلاح الأخطاء

  • تم إصلاح عطل عند استخدام TransitionManager لتصغير/توسيع العنصر في RecyclerView (b/37129527).
  • تم إصلاح الرسوم المتحركة غير الصحيحة عند تطبيق انتقاليتين لمستوى الرؤية (b/62629600).
  • السماح بقيم الإلغاء مثل المدة وأداة الاستيفاء لعناصر TransitionSet الثانوية (b/64644617).
  • إصلاح العديد من الأخطاء الطفيفة الأخرى.