از Jetpack Compose در Android TV استفاده کنید

Compose for TV رویکردی مدرن برای ساخت رابط‌های کاربری اندروید تی‌وی است. Compose for TV تمام مزایای Jetpack اندروید برای برنامه‌های تلویزیون شما را در اختیارتان قرار می‌دهد و ساخت رابط‌های کاربری زیبا و کاربردی برای برنامه شما را بسیار آسان‌تر می‌کند.

برخی از مزایای خاص استفاده از Compose برای تلویزیون شامل موارد زیر است:

  • انعطاف‌پذیری : از Compose می‌توان برای ایجاد هر نوع رابط کاربری، از طرح‌بندی‌های ساده گرفته تا انیمیشن‌های پیچیده، استفاده کرد. کامپوننت‌ها به صورت آماده کار می‌کنند، اما می‌توانند سفارشی‌سازی و استایل‌بندی شوند تا با نیازهای برنامه شما مطابقت داشته باشند.
  • توسعه ساده و سریع : Compose با کد موجود سازگار است و توسعه‌دهندگان را قادر می‌سازد تا با کد کمتر، برنامه‌هایی با کارایی بیشتر بسازند.
  • شهودی : Compose از یک سینتکس اعلانی استفاده می‌کند که به شما امکان می‌دهد در رابط کاربری خود تغییراتی ایجاد کنید، کد خود را اشکال‌زدایی، درک و بررسی کنید.

اگر با استفاده از جعبه ابزار Jetpack Compose آشنا نیستید، مسیر Compose را بررسی کنید. بسیاری از اصول توسعه برای Compose موبایل در مورد TV نیز صدق می‌کند. برای اطلاعات بیشتر در مورد مزایای کلی یک چارچوب رابط کاربری اعلانی، به «چرا 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.

استفاده از پیام‌های هوش مصنوعی

دستورات هوش مصنوعی برای استفاده در Gemini در اندروید استودیو در نظر گرفته شده‌اند.

برای اطلاعات بیشتر در مورد Gemini در استودیو به اینجا مراجعه کنید: https://developer.android.com/studio/gemini/overview

خود را به اشتراک بگذارید

سازگاری

Compose for TV روی تلویزیون‌های اندروید با اندروید ۵.۰ (سطح API ۲۱) یا بالاتر کار می‌کند. استفاده از نسخه ۱.۰ Compose for TV به نسخه ۱.۳.۰ کتابخانه‌های androidx.compose و کاتلین ۱.۷.۱۰ نیاز دارد.

راه‌اندازی

استفاده از Jetpack Compose در Android TV مشابه استفاده از Jetpack Compose برای هر پروژه اندرویدی دیگر است. تفاوت اصلی این است که Compose for TV کتابخانه‌هایی را اضافه می‌کند که اجزای بهینه شده برای TV را ارائه می‌دهند و ایجاد رابط‌های کاربری متناسب با TV را آسان‌تر می‌کنند. در برخی موارد، این اجزا نام مشابهی با همتایان غیر TV خود دارند، مانند androidx.tv.material3.Button و androidx.compose.material3.Button .

وابستگی‌های جعبه ابزار Jetpack Compose

برای استفاده از Compose برای تلویزیون، وابستگی‌های ابزار Jetpack Compose را به صورت زیر در فایل build.gradle برنامه خود قرار دهید:

کاتلین 

dependencies {
   val composeBom = platform("androidx.compose:compose-bom:2025.10.01")
   implementation(composeBom)

   // General compose dependencies.
   implementation("androidx.activity:activity-compose:1.11.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")
}

گرووی 

dependencies {
   def composeBom = platform('androidx.compose:compose-bom:2025.10.01')
   implementation composeBom

   // General compose dependencies.
   implementation 'androidx.activity:activity-compose:1.11.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'
}

چه فرقی داره؟

اجزای متریال تلویزیون برای اتاق نشیمن طراحی شده‌اند، با نشانگرهای فوکوس واضح و رفتار ورودی مناسب از راه دور . برای جزئیات بیشتر در مورد نحوه استفاده از این اجزای خاص، راهنماهای طراحی رابط کاربری تلویزیون را بررسی کنید.

شکل ۱. اجزای نمونه از کتابخانه مواد تلویزیون.

برای بهره‌مندی از این ویژگی‌ها، در صورت امکان از نسخه تلویزیونی APIها استفاده کنید.

اگرچه از نظر فنی امکان استفاده از نسخه موبایل Compose Material وجود دارد، اما برای سبک منحصر به فرد تعاملات در Android TV بهینه نشده است. علاوه بر این، ترکیب Compose Material با Compose Material از Compose for TV می‌تواند منجر به رفتار غیرمنتظره‌ای شود. به عنوان مثال، از آنجا که هر کتابخانه شیء MaterialTheme مخصوص به خود را دارد، در صورت استفاده از هر دو نسخه، احتمال ناسازگاری رنگ‌ها، تایپوگرافی یا اشکال وجود دارد.

جدول زیر تفاوت‌های وابستگی بین تلویزیون و موبایل را شرح می‌دهد:

وابستگی به تلویزیون
(androidx.tv.*)		 مقایسه وابستگی به موبایل
(androidx.compose.*)
androidx.tv:مواد تلویزیون به جای androidx.compose.material3:material3

منابع اضافی

مطالعه بیشتر

برای یادگیری نحوه ساخت تجربیات عالی بهینه شده برای تلویزیون برای موارد زیر، این راهنماها را بررسی کنید:

بعدی
یک مرورگر کاتالوگ ایجاد کنید