انتقالات

تحريك الحركة في واجهة المستخدم باستخدام تخطيطات البداية والنهاية.
التعديل الأخير الإصدار المستقر إصدار مرشح الإصدار التجريبي إصدار ألفا
3 نيسان (أبريل) 2024 1.4.1 1.5.0-rc01 - -

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

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

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

رائع

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

Kotlin

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

لمزيد من المعلومات حول التبعيات، انظر إضافة تبعيات الإصدار.

ملاحظات

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

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

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

الإصدار 1.5

الإصدار 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()، فإنّ TransitionListeners المُضافة سيكون لها الآن onTransitionEnd() يتم استدعاءها بعد منح animateToStart() للسمة Runnable. (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 هذه الالتزامات.

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

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

تعديل التبعية

  • يتم الآن تجميع Transition مع واجهة برمجة التطبيقات 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 إلى RRC01 . يتضمّن الإصدار 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).
  • تم إصلاح العديد من الأخطاء الصغيرة الأخرى.