איך משתמשים ב-Jetpack פיתוח נייטיב ב-Android TV

פיתוח נייטיב לטלוויזיה הוא הגישה המודרנית ליצירת ממשקי משתמש ל-Android TV. פיתוח נייטיב לטלוויזיה מאפשר לכם ליהנות מכל היתרונות של Jetpack פיתוח נייטיב ל-Android באפליקציות לטלוויזיה, וכך ליצור ממשקי משתמש יפים ופונקציונליים לאפליקציה שלכם בקלות רבה יותר.

אלה כמה מהיתרונות הספציפיים של השימוש ב-Compose for TV:

  • גמישות: אפשר להשתמש ב-Compose כדי ליצור כל סוג של ממשק משתמש, מפריסות בסיסיות ועד לאנימציות מורכבות. הרכיבים פועלים מיד, אבל אפשר גם להתאים אותם אישית ולשנות את הסגנון שלהם כדי שיתאימו לצרכים של האפליקציה.
  • פיתוח פשוט ומהיר יותר: ‏ Compose תואם לקוד קיים ומאפשר למפתחים לבנות אפליקציות בצורה יעילה יותר עם פחות קוד.
  • אינטואיטיבי: ב-Compose נעשה שימוש בתחביר הצהרתי שמאפשר לבצע שינויים בממשק המשתמש, לנפות באגים, להבין ולבדוק את הקוד.

אם אתם לא מכירים את ערכת הכלים Jetpack Compose, כדאי לעיין בתוכנית הלימודים בנושא Compose. הרבה מעקרונות הפיתוח של Compose לנייד רלוונטיים גם לטלוויזיה. מידע נוסף על היתרונות הכלליים של מסגרת הצהרתית לממשק משתמש זמין במאמר למה כדאי להשתמש ב-Compose. מידע נוסף זמין גם במאגר הדוגמאות של Compose for TV ב-GitHub.

‫ הנחיית AI

איך מוסיפים תמיכה ב-Android TV

ההודעה הזו מבקשת הנחיות להוספת תמיכה ב-Android TV לאפליקציה באמצעות Jetpack פיתוח נייטיב לטלוויזיה במקום 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.

שימוש בפרומפטים ל-AI

הנחיות ל-AI מיועדות לשימוש ב-Gemini ב-Android Studio.

מידע נוסף על Gemini ב-Studio זמין כאן: https://developer.android.com/studio/gemini/overview

תאימות

התכונה 'יצירה לטלוויזיה' פועלת בטלוויזיות עם Android מגרסה 5.0 (רמת API‏ 21) ואילך. כדי להשתמש בגרסה 1.0 של Compose for TV, צריך להשתמש בספריות androidx.compose בגרסה 1.3.0 וב-Kotlin 1.7.10.

הגדרה

השימוש ב-Jetpack פיתוח נייטיב ב-Android TV דומה לשימוש ב-Jetpack פיתוח נייטיב בכל פרויקט אחר ל-Android. ההבדל העיקרי הוא שב-Compose for TV נוספות ספריות שמציעות רכיבים שעברו אופטימיזציה לטלוויזיה, ומקלות על יצירת ממשקי משתמש שמותאמים לטלוויזיה. במקרים מסוימים, לרכיבים האלה יש שם זהה לגרסאות שלהם שלא מיועדות לטלוויזיה, כמו androidx.tv.material3.Button ו-androidx.compose.material3.Button.

יחסי תלות בערכת הכלים של Jetpack פיתוח נייטיב

כדי להשתמש ב-Compose לטלוויזיה, צריך לכלול את יחסי התלות של ערכת הכלים 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'
}

מה השתנה

רכיבי הטלוויזיה מיועדים לשימוש בסלון, עם אינדיקטורים ברורים למיקוד והתנהגות קלט שמתאימה לשלט רחוק. פרטים על אופן השימוש ברכיבים הספציפיים האלה מופיעים במדריכים לעיצוב ממשק משתמש לטלוויזיה.

איור 1. רכיבים לדוגמה מספריית החומרים של הטלוויזיה.

כדי ליהנות מהתכונות האלה, מומלץ להשתמש בגרסת ה-TV של ממשקי ה-API בכל מקום שאפשר.

אפשר להשתמש בגרסה לנייד של Compose Material, אבל היא לא מותאמת לסגנון הייחודי של אינטראקציות ב-Android TV. בנוסף, שילוב של רכיבים של Compose עם רכיבים של Compose for TV עלול לגרום להתנהגות בלתי צפויה. לדוגמה, מכיוון שלכל ספרייה יש אובייקט MaterialTheme משלה, יכול להיות שיהיו הבדלים בצבעים, בטיפוגרפיה או בצורות אם משתמשים בשתי הגרסאות.

בטבלה הבאה מפורטים ההבדלים בתלות בין טלוויזיה לנייד:

TV Dependency
(androidx.tv.*) 		השוואה Mobile Dependency
(androidx.compose.*)
androidx.tv:tv-material במקום androidx.compose.material3:material3

מקורות מידע נוספים

קריאה נוספת

כדאי לעיין במדריכים הבאים כדי לקבל מידע על יצירת חוויות מעולות שמותאמות לטלוויזיה:

הבא
יצירת דפדפן של קטלוג