الانتقال إلى

تحريك الحركة في واجهة المستخدم باستخدام تخطيطات البداية والنهاية.
آخر تعديل الإصدار المستقر إصدار مرشح الإصدار التجريبي الإصدار الأولي
29 تشرين الثاني (نوفمبر) 2023 1.4.1 - - 1.5.0-alpha05

تعريف التبعيات

لإضافة تبعية للنقل، يجب إضافة مستودع 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-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 على هذه الالتزامات.

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

  • تغيير عطل - تأخذ طريقة 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 على هذه الالتزامات.

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

  • يوفّر تطبيق Transit الآن دعمًا للصور المتحركة على شكل "رجوع" ضمن التطبيق على أجهزة 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() لن يؤثر في جذر Transit.

الإصدار 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 لإضافة أدوات معالجة إلى مثيلات 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

  • تحسينات للجزء 1.2.0: تم تحسين التكامل مع Fragment 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).
  • تم إصلاح العديد من الأخطاء الثانوية الأخرى.