مهاجرت به نوشتن برای تلویزیون
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
برای انتقال از جعبه ابزار Leanback UI به Compose برای Android TV، این مراحل را دنبال کنید:
اجرای Leanback فعلی خود را با شناسایی مؤلفههایی که استفاده میکنید (از جمله مواردی که در قطعات پیشساخته ارائه شدهاند) و درک نحوه ساختار رابط کاربری و نحوه جریان دادهها در برنامهتان ارزیابی کنید .
صفحات جداگانه برنامه تلویزیون خود را به Compose منتقل کنید تا بتوانید به تدریج یاد بگیرید و با آن سازگار شوید.
در حالی که میتوانید از Leanback و Compose در یک برنامه استفاده کنید تا فرآیند مهاجرت تدریجی را انجام دهید، با جایگزینی کل قطعات در یک زمان با هدف تبدیل برنامه تلویزیونی خود به یک فعالیت شروع کنید.
از کوچک شروع کنید. سعی نکنید همه چیز را به یکباره مهاجرت کنید. با اجزای کوچکتر مانند تنظیمات یا صفحه نمایش حساب شروع کنید و به تدریج راه خود را در برنامه ادامه دهید.
به مستندات و نمونه های موجود در منابع ذکر شده در بخش منابع مراجعه کنید.
با استفاده از کتابخانه های Jetpack از اجزای اختصاصی Compose for TV استفاده کنید . با راهنمای طراحی ما مشورت کنید تا نحوه سفارشی سازی و گسترش ترکیبات آماده برای ساختن رابط های کاربری تلویزیونی زیبا را بررسی کنید.
داده ها و مدیریت حالت خود را برای پشتیبانی از پارادایم برنامه نویسی اعلامی Compose تطبیق دهید. انطباق ممکن است به تغییراتی در نحوه مدیریت دادهها و حالتها در برنامهتان نیاز داشته باشد. از مکانیسمهای مدیریت حالت داخلی ViewModel
و Jetpack Compose برای مدیریت دادهها و حالتها در برنامه خود استفاده کنید.
با انتقال بخشهای پیچیدهتر برنامه خود، آزمایش و تکرار کنید .
برای هر گونه اشکالاتی که با آن مواجه می شوید، با انجمن فعال توسعه دهندگان Android در Stack Overflow تعامل داشته باشید، یا اشکالات را از طریق ردیاب اشکال عمومی ما ارسال کنید.
منابع
چه در نوشتن جدید باشید و چه در حال انتقال به Compose هستید، مجموعه بزرگ منابع ما در اینجا هستند تا به شما کمک کنند بهترین روشها را برای ایجاد رابطهای کاربری تلویزیون با جعبه ابزار توسعه Android مدرن Jetpack Compose یاد بگیرید:
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],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/)"]]