Wear OS पर Jetpack Compose का इस्तेमाल करना

Wear OS के लिए लिखना इससे मिलता-जुलता है मोबाइल के लिए लिखें. हालांकि, कुछ बड़े अंतर होते हैं. यह गाइड यह आपको समानताओं और अंतरों के बारे में बताता है.

Wear OS के लिए लिखें, Android Jetpack का हिस्सा है. यह अन्य Wear Jetpack की तरह है लाइब्रेरी का उपयोग करती हैं, तो यह तेज़ी से बेहतर कोड लिखने में आपकी सहायता करती है. यह हमारा Wear OS ऐप्लिकेशन के लिए यूज़र इंटरफ़ेस बनाने के लिए सुझाया गया तरीका.

अगर आपको Jetpack Compose टूलकिट इस्तेमाल करने के बारे में कोई जानकारी नहीं है, तो यहां देखें पाथवे लिखें. मोबाइल पर लिखने के लिए डेवलपर के कई सिद्धांत Wear OS के लिए Compose पर लागू करें. लिखें क्यों देखें, डिक्लेरेटिव यूआई फ़्रेमवर्क के सामान्य फ़ायदे. Compose के बारे में ज़्यादा जानने के लिए Wear OS के लिए, Wear OS पाथवे के लिए लिखें और Wear OS के सैंपल देखें GitHub पर सेव किया गया है.

काम करता है या नहीं

Wear OS के लिए लिखने की सुविधा, Wear OS 3.0 (एपीआई लेवल 30) पर काम करने वाली स्मार्टवॉच पर काम करती है और ऐसी स्मार्टवॉच जिनमें Wear OS 2.0 (एपीआई लेवल 25 और इसके बाद का वर्शन) का इस्तेमाल किया जाता है. इसका इस्तेमाल किया जा रहा है Wear OS के लिए, Compose के वर्शन 1.0 के लिए androidx.compos लाइब्रेरी और Kotlin 1.7.0.

प्लैटफ़ॉर्म

Wear OS के लिए लिखने की सुविधा से, Wear OS पर ऐप्लिकेशन बनाना आसान हो जाता है. Reader Revenue Manager को सेट अप करने के बारे में ऐप्लिकेशन देखें. पहले से मौजूद टूल का इस्तेमाल करें उपयोगकर्ता अनुभव तैयार करने के लिए कॉम्पोनेंट, जो Wear OS के दिशा-निर्देशों के मुताबिक हों. कॉम्पोनेंट के बारे में ज़्यादा जानकारी के लिए, यह देखें: डिज़ाइन के लिए दिशा-निर्देश.

सेट अप किया जा रहा है

Wear OS के साथ Jetpack Compose का इस्तेमाल करना, Jetpack Compose की सुविधा जैसा है किसी अन्य Android प्रोजेक्ट पर काम करता है. दोनों में मुख्य अंतर यह है कि Wear के लिए Jetpack Compose सुविधा इसमें Wear के लिए खास लाइब्रेरी जोड़ी गई हैं, ताकि यूज़र इंटरफ़ेस आसानी से बनाया जा सके जिन्हें घड़ियों के हिसाब से डिज़ाइन किया गया है. कुछ मामलों में, उन कॉम्पोनेंट के नाम एक जैसे होते हैं ऐसी चीज़ें जो पहने हुए नहीं हैं, जैसे कि androidx.wear.compose.material.Button और androidx.compose.material.Button.

Android Studio में नया ऐप्लिकेशन बनाना

अगर आपको ऐसा नया प्रोजेक्ट बनाना है जिसमें Jetpack Compose शामिल है, तो यह तरीका अपनाएं:

  1. अगर आप Android Studio में आपका स्वागत है विंडो में हैं, तो नया शुरू करें Android Studio प्रोजेक्ट. अगर आपके पास पहले से ही Android Studio प्रोजेक्ट खुला हुआ है, तो फ़ाइल > चुनें नया > मेन्यू बार से सैंपल इंपोर्ट करें.
  2. Wear के लिए लिखें को खोजें और Wear OS Starter के लिए लिखें को चुनें.
  3. अपना प्रोजेक्ट कॉन्फ़िगर करें विंडो में, ये काम करें:
    1. ऐप्लिकेशन का नाम सेट करें.
    2. अपने सैंपल के लिए, प्रोजेक्ट की जगह चुनें.
  4. पूरा करें पर क्लिक करें.
  5. पुष्टि करें कि प्रोजेक्ट की build.gradle फ़ाइल सही तरीके से कॉन्फ़िगर की गई है, जैसा कि Gradle प्रॉपर्टी फ़ाइलों में बताया गया है.

अब आप Wear OS के लिए Compose का इस्तेमाल करके ऐप्लिकेशन डेवलप करने के लिए तैयार हैं.

Jetpack Compose टूलकिट डिपेंडेंसी

Wear OS के साथ Jetpack Compose का इस्तेमाल करने के लिए, आपको Jetpack Compose शामिल करना होगा आपके ऐप्लिकेशन की build.gradle फ़ाइल में टूलकिट डिपेंडेंसी, जैसा कि स्निपेट:

Kotlin

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")
}

अलग क्या है

इसका इस्तेमाल करें WearComposeMaterial जहां भी संभव हो API के वर्शन का उपयोग करने की सलाह दी जाती है. वैसे तो तकनीकी तौर पर, Compose मटीरियल का मोबाइल वर्शन है, यह यूनीक Wear OS की ज़रूरी शर्तें. इसके अलावा, Compose के कॉन्टेंट को Compose के साथ इस्तेमाल करने पर Wear OS के लिए उपलब्ध मटीरियल की वजह से, ऐसा हो सकता है कि ऐप्लिकेशन के काम न करने की वजह से यह समस्या ठीक न हो. उदाहरण के लिए, क्योंकि हर लाइब्रेरी में अपनी MaterialTheme क्लास होती है, इसलिए अगर दोनों वर्शन का इस्तेमाल किया जाता है, तो रंग, टाइपोग्राफ़ी या आकारों का अलग-अलग होना.

नीचे दी गई टेबल में, Wear OS और Wear OS के बीच डिपेंडेंसी में अंतर के बारे में बताया गया है मोबाइल से:

Wear OS डिपेंडेंसी

(androidx.wear.*)

तुलना मोबाइल डिपेंडेंसी

(Androidx.*)

androidx.wear.compos:compos-material इसके बजाय androidx.compos.material:material
androidx.wear.compos:compos-navigation इसके बजाय androidx.नेविगेशन:नेविगेशन-कंपोज़
androidx.wear.compos:compos-foundation के अलावा androidx.compos.foundation:foundation

यहां build.gradle फ़ाइल का एक उदाहरण दिया गया है:

// 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...
}

सुझाव

Wear OS के लिए, Compose की सुविधा को आज़माएं और समस्या को ट्रैक करने वाला टूल इस्तेमाल करें.

इसमें शामिल हों #compos-wear चैनल Kotlin Slack पर अनुभव.