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 के सैंपल रिपॉज़िटरी देखें.

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

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

साथ काम करने की सुविधा

Compose for Wear OS, Wear OS 3.0 (एपीआई लेवल 30) के साथ काम करने वाली स्मार्टवॉच पर काम करता है. यह Wear OS 2.0 (एपीआई लेवल 25 और इसके बाद के लेवल) का इस्तेमाल करने वाली स्मार्टवॉच पर भी काम करता है. Compose for Wear OS के वर्शन 1.5 का इस्तेमाल करने के लिए, androidx.compose लाइब्रेरी के वर्शन 1.8 और Kotlin 1.9.0 का इस्तेमाल करना ज़रूरी है. Compose के साथ काम करने वाली लाइब्रेरी की जानकारी देखने के लिए, BOM मैपिंग और Compose to Kotlin compatibility map का इस्तेमाल करें.

प्लैटफ़ॉर्म

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 प्रोजेक्ट खोला हुआ है, तो मेन्यू बार से File > New > Import Sample को चुनें.
  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 से जुड़ी ज़्यादातर डिपेंडेंसी में बदलाव, टॉप आर्किटेक्चरल लेयर में होते हैं. नीचे दी गई इमेज में, इसे लाल बॉक्स में दिखाया गया है.

<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 को Compose Material for Wear OS के साथ मिलाने से, अनचाहे नतीजे मिल सकते हैं. उदाहरण के लिए, हर लाइब्रेरी की अपनी MaterialTheme क्लास होती है. इसलिए, अगर दोनों वर्शन का इस्तेमाल किया जाता है, तो हो सकता है कि रंग, टाइपोग्राफ़ी या शेप में अंतर हो.

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

Wear OS पर निर्भरता

(androidx.wear.*)

तुलना मोबाइल पर निर्भरता

(androidx.*)

androidx.wear.compose:compose-material3 के बजाय androidx.compose.material:material3
androidx.wear.compose:compose-navigation के बजाय androidx.navigation:navigation-compose
androidx.wear.compose:compose-foundation इसके अलावा androidx.compose.foundation:foundation

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

Kotlin

dependencies {

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

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

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

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

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

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

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

सुझाव/राय दें या शिकायत करें

Wear OS के लिए Compose आज़माएं और सुझाव/राय देने या शिकायत करने के लिए, समस्या ट्रैकर का इस्तेमाल करें.

डेवलपर कम्यूनिटी से जुड़ने के लिए, Kotlin Slack पर #compose-wear चैनल में शामिल हों. साथ ही, हमें अपने अनुभव के बारे में बताएं.