פיתוח נייטיב לטלוויזיה הוא הגישה המודרנית ליצירת ממשקי משתמש ל-Android TV. Compose for TV מאפשר לכם ליהנות מכל היתרונות של Jetpack Compose ל-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.
תאימות
התכונה 'Compose for TV' פועלת בטלוויזיות עם Android מגרסה 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
כדי להשתמש ב-Compose for TV, צריך לכלול את יחסי התלות של ערכת הכלים Jetpack Compose בקובץ build.gradle של האפליקציה באופן הבא:
Kotlin (build.gradle.kts)
dependencies {
val composeBom = platform("androidx.compose:compose-bom:2026.09.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.09.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'
}
מה השתנה
רכיבי הטלוויזיה מיועדים לשימוש בסלון, עם אינדיקטורים ברורים למיקוד והתנהגות קלט שמתאימה לשלט רחוק. פרטים על אופן השימוש ברכיבים הספציפיים האלה מופיעים במדריכים לעיצוב ממשק משתמש לטלוויזיה.
כדי ליהנות מהתכונות האלה, מומלץ להשתמש בגרסת ה-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 |
מקורות מידע נוספים
מדריכי עיצוב לטלוויזיה
סקירה של רכיבי טלוויזיה ייעודיים ליצירת ממשקי משתמש עם קישורים למקורות מידע רלוונטיים למפתחים.דוגמה לקטלוג של תכנים לטלוויזיה
אפליקציית קטלוג שמדגימה איך ליישם עקרונות של Material Design באמצעות Compose לטלוויזיה.דוגמה ל-JetStream
אפליקציית סטרימינג של מדיה שמדגימה את השימוש ב-TV Compose עם אפליקציית Material טיפוסית וארכיטקטורה מהעולם האמיתי.Introduction to Compose for TV
ב-codelab הזה מוסבר איך ליצור אפליקציית נגן וידאו עם מסך של דפדפן קטלוג ומסך פרטים.
קריאה נוספת
כדאי לעיין במדריכים הבאים כדי לקבל מידע על יצירת חוויות מעולות שמותאמות לטלוויזיה: