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

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

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

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

תאימות

ההצעות לכתיבה ל-Wear OS פועלות בשעונים עם תמיכה ב-Wear OS 3.0 (רמת API 30) ושעונים עם Wear OS 2.0 (רמת API 25 ומעלה). באמצעות לגרסה 1.0 של 'כתיבה מהירה' ל-Wear OS נדרשת גרסה 1.2 של ספריות androidx.compose ו-Kotlin 1.7.0.

שכבות

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

בתהליך הגדרה

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

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

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

1. אם בחלון ברוכים הבאים אל Android Studio, לוחצים על התחלת פרויקט Android Studio. אם כבר יש לכם פרויקט פתוח של Android Studio: בוחרים באפשרות File > (קובץ >) חדש > אפשר לייבא טעימה מסרגל התפריטים.
2. מחפשים את האפשרות כתיבה ל-Wear ובוחרים באפשרות כתיבה ל-Wear OS Starter.
3. בחלון Configure your project, מבצעים את הפעולות הבאות:
   1. מגדירים את Application name (שם האפליקציה).
   2. בוחרים את Project location (מיקום הפרויקט) עבור הדגימה.
4. לוחצים על סיום.
5. מוודאים שקובץ ה-build.gradle של הפרויקט מוגדר כמו שצריך. כפי שמתואר בקובצי תכונות של Gradle.

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

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

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

dependencies {

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

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

    // Compose for Wear OS Dependencies
    implementation("androidx.wear.compose:compose-material:1.3.1")

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

    // Wear OS preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.3.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.3.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.0.3")
}

// Example project in app/build.gradle file
dependencies {
    // Standard Compose dependencies...

    // Wear specific Compose Dependencies
    implementation "androidx.wear.compose:compose-material:$rootProject.wearVersion"
    implementation "androidx.wear.compose:compose-foundation:$rootProject.wearVersion"

    // For navigation within your app...
    implementation "androidx.wear.compose:compose-navigation:$rootProject.wearVersion"

    // Other dependencies...
}