Compose for TV هو النهج الحديث لإنشاء واجهات مستخدم لتطبيقات Android TV. تتيح لك Compose لـ Android TV الاستفادة من جميع مزايا Jetpack Compose على Android لتطبيقاتك على التلفزيون، ما يسهّل عليك إنشاء واجهات مستخدم جميلة وعملية لتطبيقك.
في ما يلي بعض المزايا المحدّدة لاستخدام Compose لـ Android TV:
- المرونة: يمكن استخدام Compose لإنشاء أي نوع من واجهات المستخدم، بدءًا من التصاميم الأساسية وصولاً إلى الرسوم المتحركة المعقّدة. تعمل المكوّنات فورًا، ولكن يمكن أيضًا تخصيصها وتصميمها لتناسب احتياجات تطبيقك.
- تطوير مبسّط وأسرع: تتوافق Compose مع الرموز البرمجية الحالية، وتتيح للمطوّرين إنشاء التطبيقات بشكل أكثر فعالية باستخدام رموز برمجية أقل.
- سهولة الاستخدام: تستخدم Compose بنية تعريفية تتيح لك إجراء تغييرات على واجهة المستخدم وتصحيح الأخطاء وفهم الرمز البرمجي ومراجعته.
إذا لم تكن معتادًا على استخدام مجموعة أدوات Jetpack Compose، يمكنك الاطّلاع على مسار Compose التعليمي. وينطبق العديد من مبادئ تطوير التطبيقات باستخدام Compose على الأجهزة الجوّالة على تطبيقات التلفزيون أيضًا. يمكنك الاطّلاع على مزايا Compose للحصول على مزيد من المعلومات حول المزايا العامة لإطار عمل واجهة مستخدم تعريفية. لمزيد من المعلومات، يمكنك أيضًا الاطّلاع على مستودع نماذج Compose for TV على GitHub.
طلب موجَّه إلى الذكاء الاصطناعي
كيفية إضافة دعم لأجهزة Android TV
يطلب هذا الطلب إرشادات حول إضافة توافق تطبيقك مع Android TV باستخدام Jetpack Compose for TV بدلاً من Leanback.
How do I add support for Android TV to my application?
Use Jetpack Compose for TV as part of the response instead of
Leanback.
التوافق
تعمل Compose لـ Android TV على أجهزة Android TV التي تعمل بنظام Android 5.0 (مستوى واجهة برمجة التطبيقات 21) أو الإصدارات الأحدث. يتطلّب استخدام الإصدار 1.0 من Compose for TV الإصدار 1.3.0 من مكتبات androidx.compose وKotlin 1.7.10.
الإعداد
إنّ استخدام Jetpack Compose على Android TV يشبه استخدام Jetpack Compose في أي مشروع Android آخر. الفرق الرئيسي هو أنّ Compose لـ Android TV تضيف مكتبات توفّر مكوّنات محسّنة للتلفزيون وتسهّل إنشاء واجهات مستخدم مخصّصة للتلفزيون. في بعض الحالات، تتشارك هذه المكوّنات الاسم نفسه مع نظيراتها غير التلفزيونية، مثل androidx.tv.material3.Button وandroidx.compose.material3.Button.
تبعيات مجموعة أدوات Jetpack Compose
لاستخدام Compose لـ Android TV، أدرِج تبعيات مجموعة أدوات Jetpack Compose
في ملف build.gradle الخاص بتطبيقك على النحو التالي:
Kotlin (build.gradle.kts)
dependencies {
val composeBom = platform("androidx.compose:compose-bom:2026.09.00")
implementation(composeBom)
// General compose dependencies.
implementation("androidx.activity:activity-compose:1.13.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")
}
Groovy (ملف build.gradle)
dependencies {
def composeBom = platform('androidx.compose:compose-bom:2026.09.00')
implementation composeBom
// General compose dependencies.
implementation 'androidx.activity:activity-compose:1.13.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'
}
الاختلافات
تم تصميم مكوّنات Material الخاصة بالتلفزيون لتناسب غرف المعيشة، وهي تتضمّن مؤشرات تركيز واضحة وسلوك إدخال مناسبًا لأجهزة التحكّم عن بُعد. للحصول على تفاصيل حول كيفية استخدام هذه المكوّنات المحدّدة، يُرجى الاطّلاع على أدلّة تصميم واجهة المستخدم على التلفزيون.
استخدِم إصدار التلفزيون من واجهات برمجة التطبيقات حيثما أمكن للاستفادة من هذه الميزات.
مع أنّه من الممكن تقنيًا استخدام إصدار Compose Material للأجهزة الجوّالة،
إلا أنّه غير محسَّن لأسلوب التفاعل الفريد على Android TV. بالإضافة إلى ذلك، قد يؤدي دمج Compose Material مع Compose Material من Compose for TV إلى حدوث سلوك غير متوقّع. على سبيل المثال،
بما أنّ كل مكتبة تحتوي على عنصر MaterialTheme خاص بها، من المحتمل أن تكون الألوان أو الخطوط أو الأشكال غير متسقة إذا تم استخدام كلا الإصدارين.
يوضّح الجدول التالي الاختلافات في الاعتمادية بين التلفزيون والأجهزة الجوّالة:
| اعتمادية التلفزيون (androidx.tv.*) |
المقارنة | اعتمادية الجهاز الجوّال (androidx.compose.*) |
|---|---|---|
| androidx.tv:tv-material | بدلاً من | androidx.compose.material3:material3 |
مراجع إضافية
أدلة تصميم تطبيقات التلفزيون
نظرة عامة على مكوّنات تطبيقات التلفزيون المخصّصة لإنشاء واجهات المستخدم، مع روابط تؤدي إلى مراجع ذات صلة بالمطوّريننموذج كتالوج TV Material
تطبيق كتالوج يوضّح كيفية تنفيذ مبادئ Material Design باستخدام Compose for TV.نموذج JetStream
تطبيق لبث الوسائط يوضّح كيفية استخدام Compose for TV مع تطبيق Material نموذجي وبنية واقعية.مقدمة عن Compose لـ Android TV
يتضمّن هذا الدرس التطبيقي حول الترميز خطوات إنشاء تطبيق مشغّل فيديو يتضمّن شاشة متصفّح كتالوج وشاشة تفاصيل.
محتوى إضافي للقراءة
يمكنك الاطّلاع على هذه الأدلة للتعرّف على كيفية إنشاء تجارب رائعة محسّنة للتلفزيون من أجل: