تلفزيون
androidx.tv.foundation
androidx.tv.foundation.lazy.grid
androidx.tv.foundation.lazy.list
androidx.tv.material3
آخر تعديل | الإصدار المستقر | إصدار مرشح | الإصدار التجريبي | الإصدار الأولي |
---|---|---|---|---|
4 تشرين الأول (أكتوبر) 2023 | - | - | - | 1.0.0-alpha10 |
تعريف التبعيات
لإضافة تبعيات على أساس التلفزيون ومواد التلفزيون، يجب إضافة مستودع Google Maven إلى مشروعك. يمكنك الاطّلاع على مستودع Maven الذي يضم أدوات Google للحصول على مزيد من المعلومات.
أضف التبعيات للعناصر التي تحتاجها في ملف build.gradle
لتطبيقك أو وحدتك:
رائع
dependencies { implementation "androidx.tv:tv-foundation:1.0.0-alpha10" implementation "androidx.tv:tv-material:1.0.0-alpha10" }
Kotlin
dependencies { implementation("androidx.tv:tv-foundation:1.0.0-alpha10") implementation("androidx.tv:tv-material:1.0.0-alpha10") }
ولمزيدٍ من المعلومات عن التبعيات، يُرجى الاطّلاع على مقالة إضافة تبعيات الإصدار.
ملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إخبارنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة تصويتك إلى مشكلة حالية من خلال النقر على زر النجمة.
راجع مستندات أداة تتبُّع المشاكل للحصول على مزيد من المعلومات.
لا تتوفّر ملاحظات إصدار لهذا العنصر.
الإصدار 1.0.0
الإصدار 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) - إضافة الملف الشخصي الأساسي إلى مكتبة المؤسسات التلفزيونية. (2b57fd7)
- أضِف ملفًا شخصيًا مرجعيًا إلى مكتبة مواد التلفزيون. (1711ff5)
تغييرات واجهة برمجة التطبيقات
- تمت إعادة تسمية
NavigationDrawerScope.doesTabRowHaveFocus
إلىNavigationDrawerScope.hasFocus
. (I8286b) - تمت إعادة تسمية
TabRowScope.isActivated
إلىTabRowScope.hasFocus
. (Ic4273)
إصلاح الأخطاء
- إصلاح توافق لوحة العرض الدوّارة مع العناصر المجاورة التي تستخدم واجهات برمجة التطبيقات لأداة استعادة التركيز (7b2a7a4)
- يمكن إيقاف مؤشر التوهج لـ API_LEVEL الأقل من 28 لأنّه غير متوافق مع نظام التشغيل. (6d3616f)
- يجب إصلاح تعطُّل أخطاء ANR الذي نتج عن موضع العناصر غير الصحيح في الحاويات الكسولة عند الانتقال السريع في الاتجاه العكسي. (642d65c)
- تمت إزالة المساحة المتروكة في الخلفية في درج التنقل المشروط. (69965b2)
- إصلاح الحاجب في درج التنقل ليتم رسمه فوق محتوى الخلفية بدلاً من خلفه. (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) - مزامنة أداة تأسيس تلفاز مع أساس الإنشاء. (I737c3، b/287011882)
- تمت إضافة الحمل الزائد
LazyLayout
، وهو يقبل دالة lambda التي تساويLazyLayoutItemProvider
، وليس كائنًا عاديًا كما كان من قبل. يتم إيقاف التحميل الزائد السابق نهائيًا. (I42a5a) - يمكنك إضافة "
TvKeyboardAlignment
" للسماح للمطوّر بضبط موضع لوحة المفاتيح على الشاشة من خلال "AndroidImeOptions
". (Idb772) - أضِف
rememberCarouselState
لتذكُّرCarouselState
معSaver
إلى مادة الإنشاء التلفزيوني. (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 على هذه الالتزامات.
الميزات الجديدة
- إدخال مكوّنات "الشريحة" في مواد ميزة "الكتابة على التلفزيون" (I86da4)
- يمكنك إضافة المكوِّن
ListItem
إلى مادة الإنشاء التلفزيوني. (I3f0b3) - أضِف مكوِّنًا
DenseListItem
إلى مادة "الكتابة التلفزيونية". (I536bf)
تغييرات واجهة برمجة التطبيقات
- تم وضع علامة على واجهات برمجة التطبيقات العامة لمواد التلفزيون على أنّها تجريبية. (I632e7)
- تم طرح ميزة "
TabRowScope
" لمشاركة الحالة من "TabRow
" القابل للإنشاء مع خصائص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)
- تمت إضافة إمكانية النقر المطوّل للإعلان على سطح مواد التلفزيون والبطاقات والأزرار. (Id2b89)
- تمت إزالة
CarouselItem
وCarouselScope
. يمكن إنشاء صور متحركة للمحتوى الذي يظهر في المقدمة في الشريحة باستخدامModifier.animateEnterExit
منAnimatedContentScope
. (Ic038e) - تم دمج المَعلمتَين
color
وcontentColor
كمَعلمةcolors
لسطح المادة التلفزيونية. (Ie69eb) - تم تقديم
RadioButton
في مادة التلفزيون. (I08690) - تم تقديم
Switch
في مادة التلفزيون. (I45e29) - تم تقديم
Checkbox
في مادة التلفزيون. (I6a45a) - تم تقديم سطح غير قابل للتفاعل في مادة التلفزيون. (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 المحسَّنة للتلفزيون.
- إضافة عمليات تنفيذ أزرار Material 3 محسَّنة للتلفزيون
تغييرات واجهة برمجة التطبيقات
- تمت إعادة تسمية
CarouselSlide
وslideCount
فيCarousel
إلىCarouselItem
وitemCount
. (Ie554c) - تمت إعادة تسمية
forward
وbackward
ContentTransforms
إلىStartToEnd
وEndToStart
. (Ie554c)
إصلاح الأخطاء
- الرجوع إلى زر "أزرار الاتجاهات" عند التركيز على "
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 على هذه الالتزامات.
تغييرات واجهة برمجة التطبيقات
- نقدّم لك درج التنقّل الجانبي في
tv-material
. لمعرفة كيفية استخدام هذا العنصر، يُرجى الاطّلاع على النماذج. (I12c08) - تقديم رمز قابل للإنشاء في المادة 3 للتلفزيون (I72db9)
- نقدّم لك ميزة "سطح المكتب" التي يمكن تركيبها على
tv-material
مع مؤشرات مثل "الحدود" و"اللمعان" و"المقياس" التي يمكن استخدامها لإنشاء مكوّنات تُبرز بوضوح العنصر الذي يتم التركيز عليه على شاشة التلفزيون. (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
" الآن كواجهة برمجة تطبيقات تجريبية تسمح للمستخدمين بإضافة أشرطة التنقّل العلوية إلى تطبيقاتهم. بشكل عام، من المتوقّع أن يتم تحميل علامات التبويب على أجهزة التلفزيون عند التركيز على عنوان علامة التبويب في صف علامات التبويب. - يتم عرض مؤشرات خاصة بالتلفزيون مثل مؤشر التسطير ومؤشر حبوب اللقاح بشكل غير تقليدي. يمكن العثور على نماذج الاستخدامات في نماذج التلفزيون.
الإصدار 1.0.0-alpha02
تشرين الثاني (نوفمبر) 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
للسماح لحاويات التمرير غير الكسول، مثل الصفوف والعمود والشبكة، بأن يتم تمرير حاوية التمرير في المحتوى كي تظل العناصر التي يتم التركيز عليها في الموضع نفسه على شاشة التلفزيون. - إضافة العناصر
TvLazyRow
وTvLazyColumn
وTvLazyHorizontalGrid
وTvLazyVerticalGrid
لإتاحة إمكانية تمرير حاوية التمرير في المحتوى، لكي يظل العنصر الذي يتم التركيز عليه في الموضع نفسه على شاشة التلفزيون. - إضافة لوحة عرض دوّارة مميزة يمكن إنشاؤها للتلفزيون، وتتيح للمستخدم إنشاء لوحة عرض دوّارة يتم عرضها بشكل تلقائي
- إضافة قائمة جذابة يمكن إنشاؤها للتلفزيون، وتتيح للمستخدم إنشاء صف/عمود/شبكة مجسّمة تغيّر الخلفية بناءً على عنصر القائمة الذي يتم التركيز عليه.
المشاكل المعروفة
- عندما يحصل حاوية التمرير على التركيز، لا يتم التركيز على العنصر الأول بشكل افتراضي.
- فالتركيز على
TextField
لا يؤدي دائمًا إلى فتح لوحة المفاتيح، أو قد يمنع نقل التركيز إلى حقول أخرى. - إنّ أداء التمرير عموديًا في
LazyColumn
يحتوي علىLazyRows
سيئ.