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

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

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

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

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

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

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

सर्फसिस

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

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

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

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

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

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

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

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

Wear OS के साथ Jetpack Compose का इस्तेमाल करने के लिए, आपको अपने ऐप्लिकेशन की build.gradle फ़ाइल में, Jetpack Compose टूलकिट की डिपेंडेंसी शामिल करनी होंगी. 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="" />

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

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

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

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

यहां दिए गए स्निपेट में, 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")

}