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

Wear OS के लिए Compose, मोबाइल के लिए Compose की तरह ही है. हालांकि, इनमें कुछ मुख्य अंतर हैं. इस गाइड में, दोनों के बीच की समानताएं और अंतर बताए गए हैं.

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

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

android skills add wear-compose-m3

Wear OS पर Jetpack Compose में मटीरियल डिज़ाइन

Wear OS पर Jetpack Compose, Material 3 को लागू करने की सुविधा भी मिलती है. इससे आपको ज़्यादा दिलचस्प ऐप्लिकेशन डिज़ाइन करने में मदद मिलती है. Wear OS पर मटीरियल डिज़ाइन कॉम्पोनेंट, Wear मटीरियल थीमिंग के आधार पर बनाए जाते हैं. यह थीमिंग, मटीरियल डिज़ाइन को पसंद के मुताबिक बनाने का एक व्यवस्थित तरीका है. इससे आपके प्रॉडक्ट के ब्रैंड को बेहतर तरीके से दिखाया जा सकता है.

इनके साथ काम करता है

सर्फसिस

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

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

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

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

Jetpack Compose वाला नया प्रोजेक्ट बनाने के लिए, यह तरीका अपनाएं:

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

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

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

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

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

हालांकि, Wear OS के लिए material, material3, foundation, और navigation लाइब्रेरी के अपने वर्शन होते हैं. इसलिए, पक्का करें कि सही लाइब्रेरी का इस्तेमाल किया जा रहा हो.

जहां भी हो सके, एपीआई के WearComposeMaterial वर्शन का इस्तेमाल करें. तकनीकी तौर पर, Compose Material के मोबाइल वर्शन का इस्तेमाल किया जा सकता है. हालांकि, इसे Wear OS की खास ज़रूरतों के हिसाब से ऑप्टिमाइज़ नहीं किया गया है. इसके अलावा, Compose Material को Compose Material for Wear OS के साथ मिलाने से, अनचाहे नतीजे मिल सकते हैं. उदाहरण के लिए, हर लाइब्रेरी की अपनी MaterialTheme क्लास होती है. इसलिए, अगर दोनों वर्शन का इस्तेमाल किया जाता है, तो हो सकता है कि रंग, टाइपोग्राफ़ी या शेप में अंतर हो.

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

यहां दिए गए स्निपेट में, build.gradle फ़ाइल का एक उदाहरण दिखाया गया है. इसमें ये डिपेंडेंसी शामिल हैं:

dependencies {

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

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

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

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

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

    // 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.2")

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

}