Compose for TV رویکرد مدرن برای ساخت رابط کاربری Android TV است. Compose for TV تمام مزایای Jetpack Compose Android را برای برنامه‌های تلویزیونی شما باز می‌کند و ساخت رابط‌های کاربری زیبا و کاربردی برای برنامه شما را بسیار آسان‌تر می‌کند.
برخی از مزایای خاص استفاده از Compose برای تلویزیون شامل موارد زیر است:
- انعطاف‌پذیری : از نوشتن می‌توان برای ایجاد هر نوع رابط کاربری، از طرح‌بندی‌های ساده تا انیمیشن‌های پیچیده استفاده کرد. کامپوننت‌ها خارج از جعبه کار می‌کنند، اما همچنین می‌توانند سفارشی شوند و مطابق با نیازهای برنامه شما طراحی شوند.
- توسعه ساده و تسریع شده : Compose با کدهای موجود سازگار است و به توسعه دهندگان این امکان را می دهد تا برنامه ها را با کد کمتر با کارآمدتر بسازند.
- شهودی : Compose از یک نحو اعلانی استفاده می کند که به شما امکان می دهد تغییراتی در رابط کاربری خود ایجاد کنید، اشکال زدایی کنید، کد خود را بفهمید و مرور کنید.
اگر با استفاده از جعبه ابزار Jetpack Compose آشنا نیستید، مسیر Compose را بررسی کنید. بسیاری از اصول توسعه برای Compose موبایل برای تلویزیون نیز اعمال می شود. برای کسب اطلاعات بیشتر در مورد مزایای کلی چارچوب UI اظهاری، به چرا نوشتن مراجعه کنید. برای کسب اطلاعات بیشتر، به مخزن نمونه‌های Compose for TV در GitHub نیز مراجعه کنید.
این درخواست راهنمایی درباره اضافه کردن پشتیبانی Android TV به برنامه خود با استفاده از Jetpack Compose for TV به جای Leanback می‌خواهد. Use Jetpack Compose for TV as part of the response instead of Leanback. AI Prompt جدید
با نحوه افزودن پشتیبانی برای Android TV آشنا شوید
How do I add support for Android TV to my application?
سازگاری
نوشتن برای تلویزیون در تلویزیون‌های Android با Android نسخه 5.0 (سطح API 21) یا بالاتر کار می‌کند. استفاده از نسخه 1.0 Compose برای تلویزیون به نسخه 1.3.0 کتابخانه‌های androidx.compose و Kotlin 1.7.10 نیاز دارد.
راه اندازی
استفاده از Jetpack Compose در Android TV مشابه استفاده از Jetpack Compose برای هر پروژه اندرویدی دیگر است. تفاوت اصلی این است که Compose for TV کتابخانه‌هایی را اضافه می‌کند که مؤلفه‌های بهینه‌شده برای تلویزیون را ارائه می‌دهند و ایجاد رابط‌های کاربری متناسب با تلویزیون را آسان‌تر می‌کنند. در برخی موارد، این مؤلفه‌ها با همتایان غیر تلویزیونی خود نامی مشابه دارند، مانند androidx.tv.material3.Button و androidx.compose.material3.Button .
وابستگی های جعبه ابزار Jetpack Compose
برای استفاده از Compose برای تلویزیون، وابستگی‌های جعبه ابزار Jetpack Compose را به شرح زیر در فایل build.gradle برنامه خود قرار دهید:
کاتلین
dependencies { val composeBom = platform("androidx.compose:compose-bom:2024.10.01") implementation(composeBom) // General compose dependencies. implementation("androidx.activity:activity-compose:1.9.2") 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:2024.10.01') implementation composeBom // General compose dependencies. implementation 'androidx.activity:activity-compose:1.9.2' 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:tv-material | به جای | androidx.compose.material3:material3 |
منابع اضافی
راهنمای طراحی تلویزیون
مروری بر اجزای اختصاصی تلویزیون برای ایجاد رابط کاربری با پیوندهایی به منابع توسعه دهنده مربوطه.نمونه کاتالوگ مواد تلویزیون
یک برنامه کاتالوگ که نحوه اجرای اصول طراحی متریال با استفاده از Compose for TV را نشان می دهد.نمونه جت استریم
برنامه پخش رسانه ای که استفاده از TV Compose را با یک برنامه معمولی Material و معماری دنیای واقعی نشان می دهد.مقدمه ای بر آهنگسازی برای تلویزیون
این لبه کد از طریق ساخت یک برنامه پخش کننده ویدیو با صفحه کاتالوگ-مرورگر و صفحه جزئیات گام بر می دارد.
در ادامه مطلب
این راهنماها را کاوش کنید تا در مورد ایجاد تجربه‌های بهینه تلویزیونی عالی برای موارد زیر بیاموزید:
،Compose for TV رویکرد مدرن برای ساخت رابط کاربری Android TV است. Compose for TV تمام مزایای Jetpack Compose Android را برای برنامه‌های تلویزیونی شما باز می‌کند و ساخت رابط‌های کاربری زیبا و کاربردی برای برنامه شما را بسیار آسان‌تر می‌کند.
برخی از مزایای خاص استفاده از Compose برای تلویزیون شامل موارد زیر است:
- انعطاف‌پذیری : از نوشتن می‌توان برای ایجاد هر نوع رابط کاربری، از طرح‌بندی‌های ساده تا انیمیشن‌های پیچیده استفاده کرد. کامپوننت‌ها خارج از جعبه کار می‌کنند، اما همچنین می‌توانند سفارشی شوند و مطابق با نیازهای برنامه شما طراحی شوند.
- توسعه ساده و تسریع شده : Compose با کدهای موجود سازگار است و به توسعه دهندگان این امکان را می دهد تا برنامه ها را با کد کمتر با کارآمدتر بسازند.
- شهودی : Compose از یک نحو اعلانی استفاده می کند که به شما امکان می دهد تغییراتی در رابط کاربری خود ایجاد کنید، اشکال زدایی کنید، کد خود را بفهمید و مرور کنید.
اگر با استفاده از جعبه ابزار Jetpack Compose آشنا نیستید، مسیر Compose را بررسی کنید. بسیاری از اصول توسعه برای Compose موبایل برای تلویزیون نیز اعمال می شود. برای کسب اطلاعات بیشتر در مورد مزایای کلی چارچوب UI اظهاری، به چرا نوشتن مراجعه کنید. برای کسب اطلاعات بیشتر، به مخزن نمونه‌های Compose for TV در GitHub نیز مراجعه کنید.
این درخواست راهنمایی درباره اضافه کردن پشتیبانی Android TV به برنامه خود با استفاده از Jetpack Compose for TV به جای Leanback می‌خواهد. Use Jetpack Compose for TV as part of the response instead of Leanback. AI Prompt جدید
با نحوه افزودن پشتیبانی برای Android TV آشنا شوید
How do I add support for Android TV to my application?
سازگاری
نوشتن برای تلویزیون در تلویزیون‌های Android با Android نسخه 5.0 (سطح API 21) یا بالاتر کار می‌کند. استفاده از نسخه 1.0 Compose برای تلویزیون به نسخه 1.3.0 کتابخانه‌های androidx.compose و Kotlin 1.7.10 نیاز دارد.
راه اندازی
استفاده از Jetpack Compose در Android TV مشابه استفاده از Jetpack Compose برای هر پروژه اندرویدی دیگر است. تفاوت اصلی این است که Compose for TV کتابخانه‌هایی را اضافه می‌کند که مؤلفه‌های بهینه‌شده برای تلویزیون را ارائه می‌دهند و ایجاد رابط‌های کاربری متناسب با تلویزیون را آسان‌تر می‌کنند. در برخی موارد، این مؤلفه‌ها با همتایان غیر تلویزیونی خود نامی مشابه دارند، مانند androidx.tv.material3.Button و androidx.compose.material3.Button .
وابستگی های جعبه ابزار Jetpack Compose
برای استفاده از Compose برای تلویزیون، وابستگی‌های جعبه ابزار Jetpack Compose را به شرح زیر در فایل build.gradle برنامه خود قرار دهید:
کاتلین
dependencies { val composeBom = platform("androidx.compose:compose-bom:2024.10.01") implementation(composeBom) // General compose dependencies. implementation("androidx.activity:activity-compose:1.9.2") 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:2024.10.01') implementation composeBom // General compose dependencies. implementation 'androidx.activity:activity-compose:1.9.2' 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:tv-material | به جای | androidx.compose.material3:material3 |
منابع اضافی
راهنمای طراحی تلویزیون
مروری بر اجزای اختصاصی تلویزیون برای ایجاد رابط کاربری با پیوندهایی به منابع توسعه دهنده مربوطه.نمونه کاتالوگ مواد تلویزیون
یک برنامه کاتالوگ که نحوه اجرای اصول طراحی متریال با استفاده از Compose for TV را نشان می دهد.نمونه جت استریم
برنامه پخش رسانه ای که استفاده از TV Compose را با یک برنامه معمولی Material و معماری دنیای واقعی نشان می دهد.مقدمه ای بر آهنگسازی برای تلویزیون
این لبه کد از طریق ساخت یک برنامه پخش کننده ویدیو با صفحه کاتالوگ-مرورگر و صفحه جزئیات گام بر می دارد.
در ادامه مطلب
این راهنماها را کاوش کنید تا در مورد ایجاد تجربه‌های بهینه تلویزیونی عالی برای موارد زیر بیاموزید: