نقل البيانات إلى أداة ComposeAllowed على التلفزيون
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لنقل البيانات من حِزمة أدوات واجهة مستخدم Leanback إلى Compose لأجهزة Android TV، اتّبِع الخطوات التالية:
تقييم عملية تنفيذ Leanback الحالية من خلال تحديد المكوّنات
التي تستخدمها (بما في ذلك تلك المقدَّمة داخل الأجزاء
المعدّة مسبقًا) وفهم بنية واجهة المستخدم وكيفية تدفق البيانات
في تطبيقك
نقل الشاشات الفردية من تطبيقك التلفزيوني إلى Compose حتى تتمكّن من التعرّف على Compose
وتكيّف معه تدريجيًا
على الرغم من أنّه يمكنك استخدام كلّ من Leanback وCompose في التطبيق نفسه للسماح بأحد
عمليات نقل البيانات تدريجيًا، ابدأ باستبدال أقسام كاملة في كل مرة
بغرض تحويل تطبيقك المخصّص للتلفزيون إلى نشاط واحد.
ابدأ بميزانية صغيرة. لا تحاول نقل كل البيانات دفعة واحدة. ابدأ بالمكونات
الأصغر حجمًا، مثل الإعدادات أو شاشات الحساب، وانتقِل تدريجيًا
إلى أقسام التطبيق الأخرى.
راجِع المستندات والأمثلة في الموارد المدرَجة في قسم
الموارد.
الاستفادة من المكوّنات المخصّصة من Compose لأجهزة التلفزيون باستخدام مكتبات
Jetpack يمكنك الرجوع إلى أدلّة التصميم للتعرّف على
كيفية تخصيص العناصر القابلة للتجميع الجاهزة للاستخدام وتوسيع نطاقها لإنشاء
واجهات مستخدم جميلة على التلفزيون.
تكييف إدارة البيانات والحالة لتتوافق مع منصّة برمجة
الإعلانية في Compose قد يتطلّب التأقلم تغييرات في كيفية إدارة
البيانات والحالة في تطبيقك. استخدِم ViewModel
وميكانيزمات إدارة الحالة الداخلية في Jetpack Compose لإدارة البيانات
والحالة في تطبيقك.
اختبِر الإصدارات المتكرّرة أثناء نقل الأجزاء الأكثر تعقيدًا من تطبيقك.
يمكنك التواصل مع منتدى مطوّري تطبيقات Android النشطين على Stack
Overflow بشأن أي أخطاء تواجهها، أو إرسال الأخطاء من خلال
نظام تتبُّع الأخطاء العلني.
المراجع
سواء كنت مبتدئًا في استخدام Compose أو كنت بصدد نقل بياناتك إليه،
يمكنك الاطّلاع على مجموعة كبيرة من المراجع لمساعدتك في التعرّف على أفضل
الممارسات لإنشاء واجهات مستخدم للتلفزيون باستخدام مجموعة أدوات تطوير Android الحديثة،
Jetpack Compose:
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Migrate to Compose for TV\n\nTo migrate from the Leanback UI toolkit to Compose for Android TV, follow these steps:\n\n- **Assess your current Leanback implementation** by identifying the components\n you're using (including those that are provided inside the prefabricated\n fragments) and understanding how your UI is structured and how data flows\n through your app.\n\n- **Migrate individual screens** of your TV app to Compose so you can learn and adapt to Compose\n gradually.\n\n - While you can use both Leanback and Compose within the same app to allow for\n a gradual migration process, begin by replacing entire fragments at a time\n with a goal of converting your TV application into a single activity.\n\n - Start small. Don't try to migrate everything at once. Begin with smaller\n components like settings or account screens and gradually work your way\n through the app.\n\n - Refer to documentation and examples in the resources listed in the\n [Resources](#resources) section.\n\n- **Leverage dedicated components** from Compose for TV by using [the Jetpack\n libraries](/jetpack/androidx/releases/tv). Consult our [design guides](/design/ui/tv/guides/components) to explore\n how you can customize and extend ready-to-use composables to build\n beautiful TV UIs.\n\n- **Adapt your data and state management** to support the Compose [declarative\n programming paradigm](/develop/ui/compose/mental-model#paradigm). Adaptation might require changes in how you manage\n data and state in your app. Use [`ViewModel`](/reference/kotlin/androidx/lifecycle/ViewModel)\n and Jetpack Compose internal state management mechanisms to manage data and\n state in your app.\n\n- **[Test](/develop/ui/compose/testing) and iterate** as you migrate more complex parts of your app.\n\nEngage with the active Android [developer community on Stack\nOverflow](https://stackoverflow.com/questions/tagged/android-jetpack-compose-tv) for any bugs you encounter, or submit the bugs through\nour [public bug tracker](/jetpack/androidx/releases/tv#feedback).\n\nResources\n---------\n\nWhether you're new to Compose or are in the process of migrating to Compose\nalready, our large collection of resources are here to help you learn best\npractices for building TV UIs with the modern Android development toolkit,\nJetpack Compose:\n\n- [Compose for TV integration guides](/training/tv/playback/compose)\n- [TV design guides](/design/ui/tv/guides/components)\n- [Introduction to Compose for TV](/codelabs/compose-for-tv-introduction) codelab\n- [Library release notes](/jetpack/androidx/releases/tv)\n- [JetStream](https://github.com/android/tv-samples/tree/main/JetStreamCompose) video streaming sample app\n- [JetCaster](https://github.com/android/compose-samples/tree/main/Jetcaster/tv-app) audio streaming sample app\n- [Component samples](https://cs.android.com/androidx/platform/frameworks/support/+/androidx-main:tv/samples/src/main/java/androidx/tv/samples/)"]]