انتقال

حرکت را در رابط کاربری با طرح‌بندی‌های شروع و پایان متحرک کنید.
آخرین به روز رسانی انتشار پایدار نامزد انتشار نسخه بتا انتشار آلفا
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"
}

کاتلین

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 شامل این commit ها است.

رفع اشکال

  • رفع مشکلی که در آن فراخوانی به 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 شامل این commit ها است.

تغییرات مهم از 1.4.0

  • Transitions از جستجو در API 34 و بالاتر پشتیبانی می کند. یک API جدید به TransitionManager اضافه شد، controlDelayedTransition() که یک TransitionSeekController را برمی گرداند که امکان جستجوی Transition می دهد. این قابلیت توسط Fragment 1.7.0 برای جستجوی خودکار انتقال ها هنگام استفاده از ژست بازگشت پیش بینی کننده استفاده می شود.
  • Transition ها یک متد جدید به نام getRootTransition() دارند که Transition حاوی Transition فعلی یا Transition فعلی را در صورتی که توسط Transition دیگری موجود نباشد برمی گرداند. این می تواند مفید باشد اگر توسعه دهنده نیاز به شنوندگان برای زمانی که کل انتقال شروع یا پایان می یابد.
  • 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 حاوی این commit ها است.

به روز رسانی وابستگی

  • وابستگی 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 حاوی این commit ها است.

نسخه 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 حاوی این commit ها است.

رفع اشکال

  • هنگامی که TransitionSeekController.animateToStart() استفاده می شود، TransitionListeners اضافه شده اکنون بعد از Runnable داده شده توسط animateToStart() onTransitionEnd() فراخوانی می شود. ( 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 حاوی این commit ها است.

رفع اشکال

  • رفع NullPointerException ناشی از تنظیم یک انتقال عنصر مشترک و عدم تنظیم یک enter/exitTransition نیز. ( I8472b )
  • مشکلی که در آن animateToStart() با Slide() نتوانست View را به موقعیت شروع بازگرداند ( 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 حاوی این commit ها است.

تغییرات 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 حاوی این commit ها است.

ویژگی های جدید

  • اکنون Transition از انیمیشن‌های In-app Predictive Back در دستگاه‌های Android 14 در صورت استفاده با Fragment 1.7.0-alpha05 پشتیبانی می‌کند.

رفع اشکال

  • رفع اشکال وقفه انتقال اسلاید. هنگامی که یک Slide Transition یک انتقال ورودی را برای حذف یک View قطع می‌کند، به موقعیت نادرستی می‌پرد. ( 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 حاوی این commit ها است.

ویژگی های جدید

  • اکنون TransitionSeekController به شما امکان می دهد پیشرفت را به عنوان کسری از مدت زمان کل از طریق setCurrentFragment() تنظیم کنید. ( aosp/2647607 )
  • TransitionSeekController اکنون با فراخوانی addOnProgressChangedListener امکان مشاهده پیشرفت را هنگام استفاده از animateToStart() و animateToEnd() می دهد. ( aosp/2647607 )
  • TransitionManager.seekTo() اضافه شد تا امکان استفاده از صحنه‌ها برای جستجوی Transitions فراهم شود. ( aosp/2647607 )
  • اضافه شدن انیمیشن های مبتنی بر فیزیک به جستجوی انتقال. از یک ردیاب سرعت 1 بعدی برای ردیابی تغییر پیشرفت با 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 منتشر شدند. این نسخه در یک شعبه داخلی توسعه یافته است.

ویژگی های جدید

  • Transitions از جستجو در API 34 و بالاتر پشتیبانی می کند. یک API جدید به TransitionManager اضافه شد، controlDelayedTransition() که یک TransisionSeekController را برمی گرداند که امکان جستجوی Transition را می دهد.

تغییرات API

  • TransitionManager یک روش جدید به نام controlDelayedTransition() دارد که به برنامه‌ها اجازه می‌دهد تا پیشرفت انیمیشن‌های انتقال را در API 34+ کنترل کنند. TransitionSeekController برگشتی به توسعه دهنده اجازه می دهد از زمانی که انتقال برای جستجو آماده است، مدت زمان انیمیشن را بداند و اجازه می دهد زمان فعلی انیمیشن را تنظیم کند. فقط ترانزیشن هایی که برای برگرداندن true isSeekable() لغو می کنند توسط controlDelayedTransition() پشتیبانی می شوند.
  • Transition ها یک متد جدید به نام getRootTransition() دارند که Transition حاوی Transition فعلی یا Transition فعلی را در صورتی که توسط Transition دیگری موجود نباشد برمی گرداند. این می تواند مفید باشد اگر توسعه دهنده نیاز به شنوندگان برای زمانی که کل انتقال شروع یا پایان می یابد.
  • TransitionListeners اکنون شنونده‌های onTransitionStart() و onTransitionEnd() جدیدی دارند که به توسعه‌دهنده اجازه می‌دهد بفهمد که آیا انتقال به صورت معکوس شروع یا پایان می‌یابد یا خیر. این می‌تواند برای توسعه انتقال‌های قابل جستجو که دارای TransitionListeners هستند، مهم باشد.

رفع اشکال

  • Transition ها اکنون TransitionListeners خود را هنگامی که شبیه سازی می شوند کپی می کنند. این بدان معنی است که افزودن شنوندگان جدید در طول createAnimator() روی Transition ریشه تأثیری نخواهد گذاشت.

نسخه 1.4.1

نسخه 1.4.1

21 آوریل 2021

androidx.transition:transition:1.4.1 و androidx.transition:transition-ktx:1.4.1 منتشر شدند. نسخه 1.4.1 حاوی این commit ها است.

رفع اشکال

  • رفع مشکلی که در آن شروع یک 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 حاوی این commit ها است.

تغییرات عمده از 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 حاوی این commit ها است.

نسخه 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 حاوی این commit ها است.

ویژگی های جدید

  • مصنوع transition-ktx افزونه های Kotlin را برای افزودن شنوندگان به نمونه های AndroidX Transition معرفی می کند. ( b/138870873 )

نسخه 1.3.1

نسخه 1.3.1

19 فوریه 2020

androidx.transition:transition:1.3.1 منتشر شد. نسخه 1.3.1 حاوی این commit ها است.

رفع اشکال

  • رفع اشکال در هنگام استفاده از ChangeTransform برخی از نماهای متحرک به اشتباه بریده شده بودند ( b/148798452 )

نسخه 1.3.0

نسخه 1.3.0

22 ژانویه 2020

androidx.transition:transition:1.3.0 منتشر شد. نسخه 1.3.0 شامل این commit ها است .

تغییرات مهم از 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 حاوی این commit ها است .

رفع اشکال

  • مشکلی را برطرف کرد که در آن نماها پس از نمایش یک قطعه پنهان، به اشتباه INVISIBLE علامت‌گذاری شدند. ( b/70793925 )

نسخه 1.3.0-rc01

23 اکتبر 2019

androidx.transition:transition:1.3.0-rc01 بدون تغییر از 1.3.0-beta01 منتشر شد. نسخه 1.3.0-rc01 حاوی این commit ها است .

نسخه 1.3.0-beta01

9 اکتبر 2019

androidx.transition:transition:1.3.0-beta01 منتشر شد. نسخه 1.3.0-beta01 حاوی این تعهدات است .

ویژگی های جدید

  • ادغام با Fragment 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 شامل این commit ها است .

تغییرات مهم از نسخه 1.1.0

اگر سطح API 29 را هدف قرار می دهید، باید از این نسخه استفاده کنید. در غیر این صورت، برخی از انتقال ها به درستی کار نمی کنند. به جای فراخوانی بازتاب، این نسخه از روش‌های عمومی جدید اضافه شده در API Level 29 استفاده می‌کند. این بخشی از محدودیت‌های ما در تلاش برای رابط‌های غیر SDK است.

نسخه 1.2.0-rc01

5 سپتامبر 2019

androidx.transition:transition:1.2.0-rc01 بدون تغییر از نسخه 1.2.0-beta01 منتشر شده است. commit های موجود در این نسخه را می توانید در اینجا بیابید.

نسخه 1.2.0-beta01

2 جولای 2019

androidx.transition:transition:1.2.0-beta01 منتشر شد. commit های موجود در این نسخه را می توانید در اینجا بیابید.

ویژگی های جدید

  • اگر 29 را به عنوان targetSdkVersion مشخص می کنید، باید از این نسخه استفاده شود. در غیر این صورت، برخی از انتقال ها به درستی کار نمی کنند. به جای فراخوانی بازتاب، این نسخه از روش‌های عمومی جدید اضافه شده در API Level 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 منتشر شد. commit های موجود در این نسخه را می توانید در اینجا بیابید.

نسخه 1.1.0-rc02

5 ژوئن 2019

androidx.transition:transition:1.1.0-rc02 منتشر شد. commit های موجود در این نسخه را می توانید در اینجا بیابید.

رفع اشکال

  • برای TransitionManager.endTransitions() برای درست کار کردن با ترانزیشن های وابسته رفع کنید. ( aosp/946400 )

نسخه 1.1.0-rc01

7 مه 2019

androidx.transition:transition:1.1.0-rc01 منتشر شد. commit های موجود در این نسخه را می توانید در اینجا بیابید.

نسخه 1.1.0-beta01

3 آوریل 2019

androidx.transition:transition:1.1.0-beta01 منتشر شد. commit های موجود در این نسخه را می توانید در اینجا بیابید.

رفع اشکال

  • رفع اشکال کش کردن ViewGroupOverlay در Visibility که در سطح API 17 و پایین‌تر رخ می‌دهد ( aosp/937350 )

نسخه 1.1.0-alpha02

13 مارس 2019

androidx.transition:transition:1.1.0-alpha02 منتشر شد. لیست کامل commit های موجود در این نسخه را می توانید در اینجا بیابید.

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 ).
  • هنگامی که دو تغییر Visibility اعمال شد، انیمیشن نادرست رفع شد ( b/62629600 ).
  • برای فرزندان TransitionSet مقادیری مانند مدت زمان و درون یابی مجاز است ( b/64644617 ).
  • بسیاری دیگر از اشکالات جزئی رفع شده است.