Compose for TV

  
تزويد المطوّرين بوظائف Compose وMaterial Design لكتابة تطبيقات للتلفزيون

يسرد هذا الجدول جميع العناصر في المجموعة androidx.tv.

العناصر الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأولي
tv-material 1.1.0 - - -
tv-foundation 1.0.0 - - -
تم إجراء آخر تعديل على هذه المكتبة في: 06 مايو 2026

تحديد الاعتماديات

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

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

Groovy

dependencies {
    implementation "androidx.tv:tv-material:1.1.0"
    implementation "androidx.tv:tv-foundation:1.0.0"
}

Kotlin

dependencies {
    implementation("androidx.tv:tv-material:1.1.0")
    implementation("androidx.tv:tv-foundation:1.0.0")
}

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

الملاحظات

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

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

لا تتوفّر ملاحظات إصدار لهذا العنصر.

Tv-Material

الإصدار 1.1

الإصدار 1.1.0

‫6 مايو 2026

تم طرح androidx.tv:tv-material:1.1.0. يتضمّن الإصدار 1.1.0 هذه التعديلات.

الإصدار 1.1.0-rc01

‫8 أبريل 2026

تم طرح androidx.tv:tv-material:1.1.0-rc01. يتضمّن الإصدار 1.1.0-rc01 هذه التعديلات.

الإصدار 1.1.0-beta01

‫11 مارس 2026

تم طرح androidx.tv:tv-material:1.1.0-beta01. يتضمّن الإصدار 1.1.0-beta01 هذه التعديلات.

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

  • تتطلّب المشاريع التي تم إصدارها باستخدام Kotlin 2.0 استخدام الإصدار 2.0.0 أو إصدار أحدث من KGP (Idb6b5، b/344563182)

المساهمة الخارجية

  • تم إيقاف androidx.compose.ui.graphics.NativePaint typealias نهائيًا، استخدِم android.graphics.Paint مباشرةً بدلاً من ذلك (I6303c، b/477394763)
  • استبدِل الإضافة Paint.asFrameworkPaint() بالإضافة Paint.nativePaint لتجنُّب عرض نوع النظام الأساسي في مجموعة المصادر commonMain من خلال typealias (I6303c، b/477394763)

الإصدار ‎1.1.0-alpha01

‫15 يناير 2025

تم طرح androidx.tv:tv-material:1.1.0-alpha01. يتضمّن الإصدار 1.1.0-alpha01 هذه التعديلات.

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

  • تغيير FocusEnterExitScope.cancelFocus() إلى cancelFocusChange()(I89959)
  • تم استبدال FocusProperties.enter وFocusProperties.exit بـ onEnter وonExit على التوالي، وذلك باستخدام نطاق جهاز استقبال بدلاً من المَعلمة FocusDirection. (I6e667)

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

  • تم نقل CompositingStrategy.OffScreen من Surface إلى Text لإصلاح النص المتقطع أثناء تغيير الحجم. (I92b15f17)
  • إصلاح مشكلة إدارة التركيز المعطَّلة في لوحة العرض الدوّارة (Ie508b721375)
  • يتم تنفيذ السطح (غير التفاعلي) بطريقة مبسطة مقارنةً بالأسطح التفاعلية. (I7ea545150)

الإصدار 1.0

الإصدار 1.0.1

‫16 يوليو 2025

تم طرح androidx.tv:tv-material:1.0.1. يتضمّن الإصدار 1.0.1 هذه التعديلات.

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

  • تم تعديل ارتفاع NavigationDrawerItem ليتوافق مع المواصفات. (cf9a3ce)
  • تم نقل إعدادات استراتيجية التكوين من الدالة المركّبة Surface إلى الدالة المركّبة Text. يؤدي ذلك إلى إصلاح الخلل الذي لم يكن يعرض فيه Exoplayer على الدوال المركّبة Surface في إصدارات Android API الأقدم. (9858ffb)

الإصدار 1.0.0

‫21 أغسطس 2024

تم طرح androidx.tv:tv-material:1.0.0. الإصدار 1.0.0 هو أول إصدار ثابت من androidx.tv:tv-material.

الإصدار ‎1.0.0-rc02

‫7 أغسطس 2024

تم طرح androidx.tv:tv-material:1.0.0-rc02. يتضمّن الإصدار 1.0.0-rc02 هذه التعديلات.

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

  • تم إصلاح مشكلة عدم ثبات الصورة المتحركة للنص في العنصر القابل للإنشاء Surface. (3163319)

الإصدار ‎1.0.0-rc01

‫10 يوليو 2024

تم طرح androidx.tv:tv-material:1.0.0-rc01. يتضمّن الإصدار 1.0.0-rc01 هذه التعديلات.

الإصدار 1.0.0-beta01

‫1 مايو 2024

تم طرح androidx.tv:tv-material:1.0.0-beta01. يتضمّن الإصدار 1.0.0-beta01 هذه التعديلات.

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

  • أصبحت ColorScheme ودوالها المساعدة ثابتة الآن. (If34fa)
  • أصبحت الإصدار LocalContentColor ثابتًا الآن (I60ee2)
  • أصبحت واجهة برمجة التطبيقات Typography مستقرة الآن (I088d6)
  • أصبحت واجهات برمجة التطبيقات الخاصة بالأشكال ثابتة الآن (I0f5f4)
  • أصبحت واجهة Border API ثابتة الآن (I69281)
  • أصبحت Glow API الآن إصدارًا ثابتًا (Iea5f1)
  • أصبح مكوّن الرمز ثابتًا الآن (I62c2d)
  • LocalTextStyles أصبحت واجهة برمجة التطبيقات مستقرة الآن (Iaded8)
  • MaterialTheme أصبحت واجهة برمجة التطبيقات مستقرة الآن (I2f541)
  • أصبح مكوّن النص ثابتًا الآن (Ib9e31)
  • أصبح المكوّن RadioButton ثابتًا الآن (Ia03c8)
  • أصبح مكوّن "مفتاح التحكّم" ثابتًا الآن (I6cea3)
  • أصبحت مكوّنات Checkbox الآن ثابتة (I7eafc)
  • أصبحت مكوّنات واجهة المستخدم ثابتة الآن (I58758 وI04aca)
  • تمت إعادة تسمية NonInteractiveSurfaceDefaults إلى SurfaceDefaults وNonInteractiveSurfaceColors إلى SurfaceColors (I0812e)
  • تستخدم ميزة "مساحة العرض القابلة للتحديد" الآن مصطلح "اختيار" بدلاً من "وضع علامة" لأنّ لكلّ منهما دلالة مختلفة (I5a206).
  • أصبح الإصداران NavigationDrawer وNavigationDrawerScope ثابتَين الآن (I249c1)
  • أصبح المكوّن NavigationDrawerItem ثابتًا الآن (Id6986)
  • أصبحت مكوّنات علامة التبويب وTabRow ثابتة الآن (I92d92)
  • أصبحت المكوّنات Button وOutlinedButton وIconButton وOutlinedIconButton وWideButton ثابتة الآن (Ib4de8)
  • أصبحت المكوّنات Card وClassicCard وCompactCard وWideClassicCard وStandardCardContainer وWideCardContainer ثابتة الآن (I34390)
  • تمت إعادة تسمية StandardCardLayout إلى StandardCardContainer وWideCardLayout إلى WideCardContainer (I08883)
  • تمت إزالة CardContainerDefaults.ImageCard وإعادة تسمية CardDefaults.ContainerGradient إلى CardDefaults.ScrimBrush (I6adfe). يمكنك استخدام Card بدلاً من CardContainerDefaults.ImageCard في حاويات البطاقات.
  • أصبح الإصداران ListItem وDenseListItem ثابتَين الآن (Idebd9)
  • أصبحت ListItemDefaults.ListItemShape وListItemDefaults.FocusedDisabledBorder وListItemDefaults.SelectedContainerColorOpacity خاصة الآن (I5d533)
  • تمت إعادة ترتيب مَعلمات ListItem وإعادة تسمية ListItemDefaults.ListItemElevation إلى ListItemDefaults.TonalElevation (Id6841). تم نقل المَعلمة headlineContent إلى أعلى العنصر القابل للإنشاء. في السابق، كان بإمكانك استخدام صيغة lambda اللاحقة في Kotlin لتمرير headlineContent. الآن، عليك استخدام بنية المَعلمات المسماة لتوفير headlineContent.
  • ‫LocalAbsoluteTonalElevation أصبح الآن داخليًا (Ibfc65)
  • تمت إزالة المكوّن ImmersiveList. يمكنك الاطّلاع على هذا المثال لمعرفة كيفية إنشائه بنفسك. (Id48da)
  • تم تعديل مكوّنات tv-material التي تعرض MutableInteractionSource في واجهة برمجة التطبيقات لتصبح تعرض الآن MutableInteractionSource قابلاً للقيم الخالية، ويتم ضبط القيمة التلقائية على "خالٍ". لا توجد تغييرات دلالية هنا: يعني تمرير قيمة فارغة أنّك لا تريد نقل MutableInteractionSource إلى الأعلى، وسيتم إنشاؤه داخل المكوّن إذا لزم الأمر. يسمح التغيير إلى قيمة فارغة لبعض المكوّنات بعدم تخصيص MutableInteractionSource مطلقًا، ويسمح لمكوّنات أخرى بإنشاء مثيل عند الحاجة فقط، ما يحسّن الأداء في جميع هذه المكوّنات. إذا كنت لا تستخدم MutableInteractionSource الذي تمرّره إلى هذه المكوّنات، ننصحك بتمرير قيمة فارغة بدلاً من ذلك. يُنصح أيضًا بإجراء تغييرات مماثلة في مكوّناتك. (I309b4، b/298048146)
  • أصبحت قيمة المَعلمة TextAlign لمكوّن "النص على التلفزيون" غير فارغة (Ib73b1، b/299490814)
  • تم تقديم قيمة خاصة "غير محدّد" للحقول TextAlign وTextDirection وHyphens وLineBreak في ParagraphTextStyle لاستبدالها (I4197e وb/299490814)

التغييرات في السلوك

  • تم تغيير القيمة التلقائية للمَعلمة shape للحدث Surface غير التفاعلي إلى RectangleShape (I1b859cb)
  • تمت إزالة بعض ميزات لوحة العرض الدوّارة لإطلاق الإصدار التجريبي بسبب كون واجهات برمجة التطبيقات الضرورية تجريبية (I0e755d4)
  • لم يعُد تغيير contentColor في Surface يؤدي إلى إنشاء صورة متحركة بين الحالات (I436e794f)

Tv-Foundation

الإصدار 1.0

الإصدار 1.0.0

‫6 مايو 2026

تم طرح androidx.tv:tv-foundation:1.0.0. يتضمّن الإصدار 1.0.0 هذه التعديلات.

الإصدار ‎1.0.0-rc01

‫8 أبريل 2026

تم طرح androidx.tv:tv-foundation:1.0.0-rc01. يتضمّن الإصدار 1.0.0-rc01 هذه التعديلات.

الإصدار 1.0.0-beta01

‫11 مارس 2026

تم طرح androidx.tv:tv-foundation:1.0.0-beta01. يتضمّن الإصدار 1.0.0-beta01 هذه التعديلات.

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

  • تتطلّب المشاريع التي تم إصدارها باستخدام Kotlin 2.0 استخدام الإصدار 2.0.0 أو إصدار أحدث من KGP (Idb6b5، b/344563182)

الإصدار ‎1.0.0-alpha12

‫15 يناير 2025

تم طرح androidx.tv:tv-foundation:1.0.0-alpha12. يتضمّن الإصدار ‎1.0.0-alpha12 هذه التعديلات.

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

  • إزالة التنسيقات غير النشطة من tv-foundation راجِع ملاحظات الإصدار 1.0.0-alpha11 لنقل البيانات من التصاميم الكسولة في tv-foundation. (I2fdd3، b/358913893)

الإصدار ‎1.0.0-alpha11

‫10 يوليو 2024

تم طرح androidx.tv:tv-foundation:1.0.0-alpha11. يتضمّن الإصدار ‎1.0.0-alpha11 هذه التعديلات.

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

  • تم إيقاف ميزة Tv Lazy Layouts نهائيًا من مكتبة tv-foundation. يُرجى الرجوع إلى هذه البطاقة لمعرفة كيفية نقل البيانات من Tv Lazy Layouts. (I0855f، b/332674072)
  • أصبح PlatformImeOptions الآن فئة ملموسة بدلاً من واجهة. (If40a4)

الإصدار ‎1.0.0-alpha10

‫4 أكتوبر 2023

تم طرح androidx.tv:tv-foundation:1.0.0-alpha10 وandroidx.tv:tv-material:1.0.0-alpha10. يتضمّن الإصدار 1.0.0-alpha10 هذه التعديلات.

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

  • تمت إضافة NavigationDrawerItem لاستخدامه ضمن NavigationDrawer وModalNavigationDrawer. (I4b491)
  • إضافة ملف تعريف أساسي إلى مكتبة tv-foundation (2b57fd7)
  • إضافة ملف تعريف أساسي إلى مكتبة tv-material (1711ff5)

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

  • تمت إعادة تسمية NavigationDrawerScope.doesTabRowHaveFocus إلى NavigationDrawerScope.hasFocus. (I8286b)
  • تمت إعادة تسمية TabRowScope.isActivated إلى TabRowScope.hasFocus. (Ic4273)

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

  • إصلاح توافق "لوحة العرض الدوّارة" مع العناصر المجاورة التي تستخدم واجهات برمجة تطبيقات لاستعادة التركيز (7b2a7a4)
  • إيقاف مؤشر التوهّج لمستوى واجهة برمجة التطبيقات الأقل من 28 لأنّ نظام التشغيل لا يتيح استخدامه (6d3616f)
  • تم إصلاح عُطل ANR الناتج عن وضع العناصر بشكل غير صحيح في الحاويات الكسولة عند التنقّل السريع في الاتجاه المعاكس. (642d65c)
  • تمت إزالة مساحة متروكة في الخلفية في "درج التنقّل" المنبثق. (69965b2)
  • تم إصلاح مشكلة ظهور Scrim في "لوحة التنقّل" فوق المحتوى في الخلفية بدلاً من ظهوره خلفه. (d4bbefb)

الإصدار ‎1.0.0-alpha09

‫6 سبتمبر 2023

تم طرح androidx.tv:tv-foundation:1.0.0-alpha09 وandroidx.tv:tv-material:1.0.0-alpha09. يتضمّن الإصدار 1.0.0-alpha09 هذه التعديلات.

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

  • إضافة واجهة ReusableComposition لإدارة مراحل نشاط التركيبات الفرعية وإعادة استخدامها (I812d1، b/252846775)
  • مزامنة نسخة tv-foundation مع compose-foundation (I737c3، b/287011882)
  • تمت إضافة حمل زائد من LazyLayout، ويقبل تعبير lambda من LazyLayoutItemProvider، وليس كائنًا عاديًا كما كان من قبل. تم إيقاف التحميل الزائد السابق نهائيًا. (I42a5a)
  • أضِف TvKeyboardAlignment للسماح للمطوّر بضبط موضع لوحة المفاتيح على الشاشة من خلال AndroidImeOptions. (Idb772)
  • أضِف rememberCarouselState لتذكُّر CarouselState باستخدام Saver إلى TV Compose Material. (Id7275)
  • تم تغيير المَعلمة scrimColor: Color إلى المَعلمة scrimBrush:Brush للسماح للمستخدمين بإضافة تدرّجات إلى طبقة التعتيم. (I254d4)

الإصدار ‎1.0.0-alpha08

‏26 تموز (يوليو) 2023

تم طرح androidx.tv:tv-foundation:1.0.0-alpha08 وandroidx.tv:tv-material:1.0.0-alpha08. يتضمّن الإصدار 1.0.0-alpha08 هذه التعديلات.

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

  • تقديم مكوّنات Chip لمواد Compose لـ Android TV (I86da4)
  • أضِف مكوّن ListItem إلى مكتبة TV Compose Material. (I3f0b3)
  • إضافة مكوّن DenseListItem إلى مادة TV Compose (I536bf)

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

  • تم تصنيف واجهات برمجة التطبيقات العلنية الخاصة بالمواد التلفزيونية على أنّها تجريبية. (I632e7)
  • تمت إضافة TabRowScope لمشاركة الحالة من الدالة المركّبة TabRow مع الدالة المركّبة Tab، وتمت إعادة تسمية خصائص TabColors. (Ief587)

الإصدار ‎1.0.0-alpha07

‫7 يونيو 2023

تم طرح androidx.tv:tv-foundation:1.0.0-alpha07 وandroidx.tv:tv-material:1.0.0-alpha07. يتضمّن الإصدار 1.0.0-alpha07 هذه التعديلات.

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

  • تتضمّن مؤشرات مقياس المكوّنات الآن الخيار "بلا" لإيقاف تغيير الحجم. (I50df5)
  • تمت إضافة إمكانية النقر مع الاستمرار على "واجهة Material للتلفزيون" والبطاقات والأزرار. (Id2b89)
  • تمت إزالة CarouselItem وCarouselScope. يمكن إنشاء صورة متحركة للمحتوى في المقدّمة في الشريحة باستخدام Modifier.animateEnterExit من AnimatedContentScope. (Ic038e)
  • تم دمج المَعلمتَين color وcontentColor في colors من أجل TV Material Surface. (Ie69eb)
  • تمت إضافة عنصر RadioButton قابل للإنشاء في مكتبة TV Material. (I08690)
  • تم تقديم العنصر القابل للإنشاء Switch في TV Material. (I45e29)
  • تمت إضافة Checkbox القابل للإنشاء في TV Material. (I6a45a)
  • تمت إضافة Surface غير تفاعلي في TV Material. (Ic5f85)
  • جعل المؤشرات داخلية (Ibff82)

الإصدار ‎1.0.0-alpha06

‫19 أبريل 2023

تم طرح androidx.tv:tv-foundation:1.0.0-alpha06 وandroidx.tv:tv-material:1.0.0-alpha06. يتضمّن الإصدار 1.0.0-alpha06 هذه التعديلات.

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

  • إضافة عمليات تنفيذ بطاقة Material 3 محسَّنة للتلفزيون
    • البطاقة الأساسية (I5b701)
    • ‫ClassicCard وCompactCard وWideClassicCard (I70471)
    • ‫StandardCardLayout وWideCardLayout (I33fae)
  • إضافة عمليات تنفيذ زر Material 3 محسّنة للتلفزيون
    • زر أساسي (I69c11)
    • ‫IconButton وOutlinedIconButton (Ib504c)
    • WideButton (I4cecf)

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

  • تمت إعادة تسمية CarouselSlide وslideCount في Carousel إلى CarouselItem وitemCount. (Ie554c)
  • تمت إعادة تسمية forward وbackward ContentTransforms إلى StartToEnd وEndToStart. (Ie554c)

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

  • التعامل مع زر لوحة التحكّم الاتجاهية (DPAD) للخلف عند التركيز على NavigationDrawer (d654f4)

الإصدار ‎1.0.0-alpha05

‫22 مارس 2023

تم طرح androidx.tv:tv-foundation:1.0.0-alpha05 وandroidx.tv:tv-material:1.0.0-alpha05. يتضمّن الإصدار 1.0.0-alpha05 هذه التعديلات.

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

  • نقدّم لك الدالة المركّبة Side Navigation Drawer في tv-material. لمعرفة كيفية استخدام هذه الدالة المركّبة، يُرجى الرجوع إلى الأمثلة. (I12c08)
  • إضافة دالة Icon قابلة للإنشاء في TV Material 3 (I72db9)
  • نقدّم Surface composable إلى tv-material مع مؤشرات مثل Border وGlow وScale، والتي يمكن استخدامها لإنشاء مكوّنات تسلّط الضوء بوضوح على العنصر الذي تم التركيز عليه على شاشة التلفزيون. (I4a6d8), (Iceea1), (Iee4d4), (I79edf), (Icb376)
  • تعديل CarouselItem إلى CarouselSlide لتتطابق مع اسم المَعلمة slideCount في واجهة برمجة التطبيقات "منصّة العرض الدوّارة" (Ic4299)

الإصدار ‎1.0.0-alpha04

‫8 فبراير 2023

تم طرح androidx.tv:tv-foundation:1.0.0-alpha04 وandroidx.tv:tv-material:1.0.0-alpha04. يتضمّن الإصدار 1.0.0-alpha04 هذه التعديلات.

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

  • في الصفوف والأعمدة والشبكات الكسولة، يتم تجاهل نقطة الارتكاز، إذا لزم الأمر، لضمان عرض العنصر بأكمله. (11d7e40)
  • إضافة خيار تخصيص ألوان علامات التبويب في حالات مختلفة (21b2925)
  • تقبل الآن لوحة العرض الدوّارة صورًا متحركة مخصّصة للتمرير اليدوي للأمام والخلف. (431494a)

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

  • إعادة تسمية androidx.tv.material إلى androidx.tv.material3 وتسوية بنية الحزمة ضِمن androidx.tv.material3 (I6ca52)
  • أصبح المؤشر ضِمن صف مؤشر اللوحة الدوّارة الآن عبارة عن موضع إعلان يمكن للمطوّر تخصيصه. (268af2a)
  • تمت إعادة تسمية focusableItem إلى immersiveListItem. على المستخدمين إضافة المعدِّل focusable() أو clickable() يدويًا مع immersiveListItem (5dd5078)(b/263061052)
  • تمت إعادة تسمية timeToDisplayMillis إلى autoScrollDurationMillis في مكوّن "لوحة العرض الدوّارة". (431494a)
  • يقتصر استخدام "CarouselItem" الآن على Carousel. (431494a)
  • تقبل لوحة العرض الدوّارة الآن ContentTransforms كتعريف للرسوم المتحركة بدلاً من EnterTransition وExitTransitions. (431494a)
  • تم طرح واجهة برمجة التطبيقات PinnableContainer التي يتم نشرها من خلال القوائم الكسولة عبر تركيبة محلية تتيح تثبيت العنصر الحالي. (Ib8881، b/259274257، b/195049010)
  • تمت إضافة السمة mainAxisItemSpacing إلى TvLazyListLayoutInfo وTvLazyGridLayoutInfo (I37765)

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

  • تعديل صف علامات التبويب لضمان التعامل مع عدد علامات التبويب 0 أو 1 بشكلٍ صحيح (I44009)، (1c01525)، (b/264018028)
  • تم إصلاح عُطل البحث المركّز عند احتواء TvLazyColumn على TvLazyRow فارغ. (e11b4fe)، (b/260299091)
  • يعمل المعدِّل clickable الآن مع ImmersiveList. (5dd5078)، (b/263061052)
  • تم الآن التعامل مع مفتاح الرجوع واستخدامه للخروج من "لوحة العرض الدوّارة". (84c138c)
  • لا تفقد لوحة العرض الدوّارة التركيز عند الضغط على المفاتيح بسرعة عدة مرات. (799489f)
  • لا تفقد لوحة العرض والتدوير التركيز عند الضغط مع الاستمرار على المفاتيح. (b2cf37e)
  • تم إصلاح الأعطال التي تحدث عند تغيير عدد شرائح لوحة العرض الدوّارة. (b261247)

الإصدار ‎1.0.0-alpha03

‫7 كانون الأول (ديسمبر) 2022

تم طرح androidx.tv:tv-foundation:1.0.0-alpha03 وandroidx.tv:tv-material:1.0.0-alpha03. يتضمّن الإصدار 1.0.0-alpha03 هذه التعديلات.

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

  • تتوفّر TabRow الآن كواجهة برمجة تطبيقات تجريبية تتيح للمستخدمين إضافة أشرطة تنقّل علوية إلى تطبيقاتهم. بشكل عام، تتوقّع أجهزة التلفزيون تحميل علامات التبويب عند التركيز على عنوان علامة التبويب في صف علامات التبويب.
  • تتوفّر مؤشرات خاصة بالتلفزيون، مثل مؤشر التسطير ومؤشر الحبة، بدون الحاجة إلى إعدادات إضافية. ويمكن العثور على أمثلة على الاستخدام في tv-samples.

الإصدار ‎1.0.0-alpha02

‫9 نوفمبر 2022

تم طرح androidx.tv:tv-foundation:1.0.0-alpha02 وandroidx.tv:tv-material:1.0.0-alpha02. يتضمّن الإصدار 1.0.0-alpha02 هذه التعديلات.

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

  • تحسين أداء التمرير عند التمرير خلال مجموعة من TvLazyRows/TvLazyColumns من خلال تقليل مساحة البحث عن التركيز (I723a3)

الإصدار ‎1.0.0-alpha01

‫5 أكتوبر 2022

تم طرح androidx.tv:tv-foundation:1.0.0-alpha01 وandroidx.tv:tv-material:1.0.0-alpha01. يتضمّن الإصدار 1.0.0-alpha01 هذه التعديلات.

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

تحتوي الإصدارات الأولى من الإصدار التجريبي الأوّلي على عمليات تنفيذ معاينة مبكرة للمكوّنات الخاصة بحالات استخدام التلفزيون، بما في ذلك:

  • إضافة المعدِّل scrollableWithPivot للسماح للحاويات غير الكسولة التي يمكن الانتقال فيها، مثل Row وColumn وGrid، بأن تتيح للحاوية التي يمكن الانتقال فيها نقل المحتوى ليبقى العنصر الذي يتم التركيز عليه في الموضع نفسه على شاشة التلفزيون
  • إضافة العناصر القابلة للإنشاء TvLazyRow وTvLazyColumn وTvLazyHorizontalGrid وTvLazyVerticalGrid لجعل الحاوية القابلة للتمرير تمرّر المحتوى ليبقى العنصر الذي يتم التركيز عليه في الموضع نفسه على شاشة التلفزيون
  • إضافة دالة مركّبة Featured Carousel للتلفزيون، ما يتيح للمستخدم إنشاء لوحة عرض دوّارة للبانر يتم تمريرها تلقائيًا
  • إضافة عنصر Immersive List قابل للإنشاء على التلفزيون يتيح للمستخدم إنشاء صف أو عمود أو شبكة Immersive تتغيّر خلفيتها استنادًا إلى عنصر القائمة الذي يتم التركيز عليه

المشاكل المعروفة

  • عندما يكتسب حاوية التمرير التركيز، لا يكتسب العنصر الأول التركيز تلقائيًا.
  • لا يؤدي التركيز على TextField دائمًا إلى فتح لوحة المفاتيح أو قد يمنع التركيز من الانتقال إلى حقول أخرى.
  • يكون أداء التمرير عموديًا في LazyColumn الذي يحتوي على LazyRows ضعيفًا.