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

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

אלה כמה מהיתרונות הספציפיים של השימוש בהצעות לכתיבה לטלוויזיה:

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

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

תאימות

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

הגדרה

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

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

כדי להשתמש ב'כתיבה' בטלוויזיה, צריך לכלול את ערכת הכלים לכתיבה ב-Jetpack של יחסי התלות בקובץ build.gradle של האפליקציה, באופן הבא:

Kotlin

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

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

מגניב

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

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

מה שונה

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

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

תלות בטלוויזיה
(androidx.tv.*) 		השוואה תלות בנייד
(androidx.compose.*)
androidx.tv:tv-material במקום androidx.compose.material3:material3

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

קריאה נוספת

במדריכים האלה מוסבר איך ליצור חוויות נהדרות שמותאמות לטלוויזיה:

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