שימוש ב-Jetpack פיתוח נייטיב ב-Wear OS

התכונה 'יצירת מוזיקה' ל-Wear OS דומה לתכונה 'יצירת מוזיקה' לנייד. עם זאת, יש כמה הבדלים חשובים. במדריך הזה מוסבר על נקודות הדמיון וההבדלים בין שני סוגי המינויים.

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

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

Material Design ב-Jetpack פיתוח נייטיב ב-Wear OS

‫Jetpack פיתוח נייטיב ב-Wear OS מציע הטמעה של Material 3, שעוזרת לעצב חוויית שימוש באפליקציה מושכת יותר. רכיבי Material Design ב-Wear OS מבוססים על התאמת העיצוב של Google Material Design ב-Wear. העיצוב הזה הוא דרך שיטתית להתאים אישית את Material Design ולשקף טוב יותר את המותג של המוצר.

תאימות

שכבות

‫Compose for Wear OS מקל על פיתוח אפליקציות ל-Wear OS. מידע נוסף זמין במאמר בנושא אפליקציות. אפשר להשתמש ברכיבים המובנים שלנו כדי ליצור חוויות משתמש שתואמות להנחיות של Wear OS. מידע נוסף על רכיבים זמין בהנחיות העיצוב שלנו.

בתהליך הגדרה

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

יצירת אפליקציה חדשה ב-Android Studio

כדי ליצור פרויקט חדש שכולל Jetpack פיתוח נייטיב, פועלים לפי השלבים הבאים:

1. אם אתם נמצאים בחלון Welcome to Android Studio (ברוכים הבאים ל-Android Studio), לוחצים על Start a new Android Studio project (התחלת פרויקט חדש ב-Android Studio). אם כבר פתוח פרויקט ב-Android Studio, בוחרים באפשרות File > ‏New > ‏Import Sample (קובץ > חדש > ייבוא דוגמה) מסרגל התפריטים.
2. מחפשים את Compose for Wear ובוחרים באפשרות Compose for Wear OS Starter.
3. בחלון Configure your project (הגדרת הפרויקט), מבצעים את הפעולות הבאות:
   1. מגדירים את שם האפליקציה.
   2. בוחרים את מיקום הפרויקט לדוגמה.
4. לוחצים על סיום.
5. מוודאים שקובץ ה-build.gradle של הפרויקט מוגדר בצורה נכונה, כפי שמתואר במאמר קובצי מאפיינים של Gradle.

עכשיו אפשר להתחיל לפתח אפליקציה באמצעות Compose ל-Wear OS.

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

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

<img 'foundation',="" 'material',="" 'runtime'.="" 'ui',="" 2="" 4="" a="" alt="" and="" are="" bottom,="" box""="" by="" contain="" from="" rectangles="" rectangles.="" red="" src="/static/wear/images/components/ComposeDependencies.png" surrounded="" the="" to="" top="" />

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

עם זאת, ל-Wear OS יש גרסאות משלו של ספריות material ו-material3, foundation ו-navigation, לכן חשוב לוודא שאתם משתמשים בספריות המתאימות.

במידת האפשר, מומלץ להשתמש בגרסה WearComposeMaterial של ממשקי ה-API. אמנם אפשר מבחינה טכנית להשתמש בגרסה לנייד של Compose Material, אבל היא לא מותאמת לדרישות הייחודיות של Wear OS. בנוסף, שילוב של Compose Material עם Compose Material ל-Wear OS עלול להוביל להתנהגות לא צפויה. לדוגמה, לכל ספרייה יש מחלקה משלה של MaterialTheme, ולכן יכול להיות שיהיו הבדלים בצבעים, בטיפוגרפיה או בצורות אם משתמשים בשתי הגרסאות.

בטבלה הבאה מפורטים ההבדלים בתלות בין Wear OS לבין Mobile:

בקטע הקוד הבא מוצג קובץ build.gradle לדוגמה שכולל את התלות הבאה:

dependencies {

    val composeBom = platform("androidx.compose:compose-bom:2026.03.00")

    // General compose dependencies
    implementation(composeBom)
    implementation("androidx.activity:activity-compose:1.13.0")
    implementation("androidx.compose.ui:ui-tooling-preview:1.11.0")
    // Other compose dependencies

    // Compose for Wear OS dependencies
    implementation("androidx.wear.compose:compose-material3:1.6.1")

    // Foundation is additive, so you can use the mobile version in your Wear OS app.
    implementation("androidx.wear.compose:compose-foundation:1.6.1")

    // Wear OS preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.6.1")

    // If you are using Compose Navigation, use the Wear OS version (NOT THE MOBILE VERSION).
    // Uncomment the line below and update the version number.
    // implementation("androidx.wear.compose:compose-navigation:1.6.1")

    // Testing
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.1.3")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.4.0")
    androidTestImplementation("androidx.compose.ui:ui-test-junit4:1.0.3")
    debugImplementation("androidx.compose.ui:ui-tooling:1.4.1")

}