يُعد Compose for TV الطريقة الحديثة لإنشاء واجهات المستخدم في Android TV. تتيح لك ميزة Compose for TV الاستفادة من جميع مزايا Jetpack Compose على مستوى تطبيقات Android لتطبيقات التلفزيون، ما يجعل إنشاء واجهات مستخدم رائعة وعملية لتطبيقك أكثر سهولة.
تشمل بعض المزايا المحدّدة لاستخدام ميزة "إنشاء رسالة" على التلفزيون ما يلي:
- المرونة: يمكن استخدام ميزة Compose لإنشاء أي نوع من واجهات المستخدم، بدءًا من التنسيقات البسيطة ووصولاً إلى الصور المتحركة المعقّدة. تعمل المكونات بشكل فوري ولكن يمكن أيضًا تخصيصها وتصميمها لتناسب احتياجات تطبيقك.
- التطوير المبسّط والمسرّع: تتوافق ميزة Compose مع الرموز البرمجية الحالية وتمكّن المطوّرين من إنشاء التطبيقات بكفاءة أكبر وبدون استخدام رموز برمجية.
- سهلة: تستخدم ميزة Compose بنية تعريفية تتيح لك إجراء تغييرات على واجهة المستخدم وتصحيح الأخطاء وفهم الرموز البرمجية ومراجعتها.
إذا لم تكن معتادًا على استخدام مجموعة أدوات Jetpack Compose، يمكنك الاطّلاع على مسار الإنشاء. تنطبق العديد من مبادئ تطوير ميزة "الكتابة على الأجهزة الجوّالة" على التلفزيون أيضًا. راجع أسباب الإنشاء للحصول على مزيد من المعلومات حول المزايا العامة لإطار عمل واجهة المستخدم التعريفية. لمزيد من المعلومات، يُرجى أيضًا الاطّلاع على مستودع Compose لنماذج البرامج التلفزيونية على GitHub.
التوافق
تعمل ميزة Compose for TV على أجهزة Android TV التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 21 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث. لاستخدام الإصدار 1.0 من Compose for TV، يجب توفُّر الإصدار 1.3.0 من مكتبات androidx.compose والإصدار 1.7.10 من Kotlin.
إعداد
يشبه استخدام Jetpack Compose على Android TV استخدام Jetpack Compose لأي مشروع آخر على Android. يتمثل الاختلاف الرئيسي في أنّ Compose للتلفزيون
يضيف مكتبات تقدّم مكوّنات محسَّنة للتلفزيون ويسهّل إنشاء
واجهات مستخدم مخصَّصة للتلفزيون. وفي بعض الحالات، تحمل هذه المكوّنات الاسم نفسه الذي تحمله نظيراتها غير التابعة للتلفزيون، مثل androidx.tv.material3.Button
وandroidx.compose.material3.Button
.
اعتماديات مجموعة أدوات Jetpack Compose
لاستخدام Compose for TV، عليك تضمين ملحقات مجموعة أدوات Jetpack Compose في ملف build.gradle
لتطبيقك على النحو التالي:
Kotlin
dependencies { val composeBom = platform("androidx.compose:compose-bom:2024.06.00") implementation(composeBom) // General compose dependencies. implementation("androidx.activity:activity-compose:1.9.0") implementation("androidx.compose.ui:ui-tooling-preview") debugImplementation("androidx.compose.ui:ui-tooling") // Compose for TV dependencies. implementation("androidx.tv:tv-material:1.0.0-rc01") }
رائع
dependencies { def composeBom = platform('androidx.compose:compose-bom:2024.06.00') implementation composeBom // General compose dependencies. implementation 'androidx.activity:activity-compose:1.9.0' implementation 'androidx.compose.ui:ui-tooling-preview' debugImplementation 'androidx.compose.ui:ui-tooling' // Compose for TV dependencies. implementation 'androidx.tv:tv-material:1.0.0-rc01' }
الميزات المختلفة
استخدِم إصدار التلفزيون من واجهات برمجة التطبيقات كلما أمكن ذلك.
من الممكن تقنيًا استخدام إصدار الأجهزة الجوّالة من Compose Material،
ولكنه لم يتم تحسينه ليناسب أسلوب التفاعل الفريد على Android TV. بالإضافة إلى ذلك، قد يؤدي المزج بين "مواد صناعة" و"مواد إنشاء" من
ميزة "إنشاء المحتوى" إلى حدوث سلوك غير متوقّع. على سبيل المثال،
من المحتمل أن تكون الألوان أو أسلوب الخط أو الأشكال غير متّسقة في حال استخدام كلا الإصدارين، وذلك بسبب احتواء كل مكتبة على عنصر MaterialTheme
خاص بها.
يوضح الجدول التالي اختلافات التبعية بين التلفزيون والهاتف المحمول:
اعتمادية التلفزيون (androidx.tv.*) |
المقارنة | الاعتمادية على الأجهزة الجوّالة (androidx.compose.*) |
---|---|---|
androidx.tv:tv-material | بدلاً من | androidx.compose.material3:material3 |
مصادر إضافية
نموذج لكتالوج مواد العرض التلفزيوني
تطبيق كتالوج يوضح كيفية تنفيذ مبادئ التصميم المتعدد الأبعاد باستخدام أداة Compose for TVنموذج JetStream
تطبيق لبث الوسائط يوضح استخدام TV Compose مع تطبيق Material Design عادي وبنية واقعية.مقدّمة حول Compose لـ TV
يشرح هذا الدرس التطبيقي حول الترميز خطوات إنشاء تطبيق مشغّل فيديو يضم شاشة متصفّح قائمة تضم كتالوجات وشاشة تفاصيل.
محتوى إضافي للقراءة
يمكنك الاطّلاع على هذه الأدلّة لمعرفة كيفية إنشاء تجارب رائعة محسَّنة للتلفزيون: