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 لـ Android 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.08.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.08.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'
}
بين الماضي والحاضر
تم تصميم مكوّنات TV Material لغرفة المعيشة، مع مؤشرات تركيز واضحة وسلوك إدخال مناسب لجهاز التحكّم عن بُعد. لمعرفة تفاصيل حول كيفية استخدام هذه المكوّنات المحدّدة، يمكنك الاطّلاع على أدلة تصميم واجهة مستخدم التلفزيون.
استخدِم إصدار التلفزيون من واجهات برمجة التطبيقات كلما أمكن للاستفادة من هذه الميزات.
مع أنّه من الممكن من الناحية الفنية استخدام نسخة الموقع الإلكتروني المخصّصة للأجهزة الجوّالة من Compose Material، فإنّه غير محسّن لأسلوب التفاعلات الفريد على Android TV. بالإضافة إلى ذلك، يمكن أن يؤدي دمج Compose Material مع Compose Material من Compose لـ Android TV إلى سلوك غير متوقّع. على سبيل المثال، بما أنّ كل مكتبة تتضمّن كائن MaterialTheme خاصًا بها، من المحتمل أن تكون الألوان أو الطباعة أو الأشكال غير متّسقة إذا تم استخدام كلا الإصدارَين.
يوضّح الجدول التالي الاختلافات في الاعتمادات بين أجهزة التلفزيون والأجهزة الجوّالة:
| اعتمادية التلفزيون (androidx.tv.*) |
المقارنة | اعتمادية الجهاز الجوّال (androidx.compose.*) |
|---|---|---|
| androidx.tv:tv-material | بدلاً من | androidx.compose.material3:material3 |
مراجع إضافية
أدلة تصميم التلفزيون
نظرة عامة على مكوّنات التلفزيون المخصّصة لإنشاء واجهات المستخدم مع روابط لمراجع المطوّرين ذات الصلة.نموذج كتالوج TV Material
تطبيق كتالوج يوضّح كيفية تنفيذ مبادئ Material Design باستخدام Compose for TV.نموذج JetStream
تطبيق لبثّ الوسائط يوضّح استخدام TV Compose مع تطبيق Material نموذجي وبنية في العالم الحقيقيمقدّمة عن Compose لـ Android TV
يشرح هذا الدرس التطبيقي حول الترميز كيفية إنشاء تطبيق مشغّل فيديو يتضمّن شاشة متصفّح كتالوج وشاشة تفاصيل.
محتوى إضافي للقراءة
يمكنك استكشاف هذه الأدلة للتعرّف على كيفية إنشاء تجارب رائعة محسّنة لأجهزة التلفزيون من أجل: