انتقالات
التعديل الأخير | الإصدار المستقر | إصدار مرشح | الإصدار التجريبي | إصدار ألفا |
---|---|---|---|---|
1 أيار (مايو) 2024 | 1.5.0 | - | - | - |
إعلان التبعيات
لإضافة تبعية إلى Transition، يجب عليك إضافة مستودع Google Maven إلى مشروعك. لمزيد من المعلومات، يمكنك الاطّلاع على مستودع Maven من Google.
أضف التبعيات للعناصر التي تحتاجها في ملف build.gradle
لت��بيقك أو الوحدة الخاصة بك:
رائع
dependencies { // Java language implementation implementation "androidx.transition:transition:1.5.0" // Kotlin implementation "androidx.transition:transition-ktx:1.5.0" }
Kotlin
dependencies { // Java language implementation implementation("androidx.transition:transition:1.5.0") // Kotlin implementation("androidx.transition:transition-ktx:1.5.0") }
لمزيد من المعلومات حول التبعيات، انظر إضافة تبعيات الإصدار.
ملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إخبارنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة تصويتك إلى مشكلة حالية من خلال النقر على زر النجمة.
راجِع مستندات أداة تتبُّع المشاكل للحصول على مزيد من المعلومات.
الإصدار 1.5
الإصدار 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()
، فإنّ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 لإضافة مستمعين إلى مثيلات AndroidXTransition
. (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 لإضافة مستمعين إلى مثيلات AndroidXTransition
. (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).
- تم إصلاح العديد من الأخطاء الصغيرة الأخرى.