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

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

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

अगर आपको Jetpack Compose टूलकिट इस्तेमाल करने का तरीका नहीं पता है, तो Compose पाथवे देखें. मोबाइल के लिए Compose के डेवलपमेंट से जुड़े कई सिद्धांत, Wear OS के लिए Compose पर लागू होते हैं. डिक्लेरेटिव यूज़र इंटरफ़ेस (यूआई) फ़्रेमवर्क के सामान्य फ़ायदों के बारे में ज़्यादा जानने के लिए, Compose क्यों इस्तेमाल करें लेख पढ़ें. Compose for Wear OS के बारे में ज़्यादा जानने के लिए, Compose for Wear OS पाथवे और GitHub पर 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 का इस्तेमाल करने जैसा ही है. इनमें मुख्य अंतर यह है कि Wear के लिए Jetpack Compose में, 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. Configure your project विंडो में, ये काम करें:
   1. ऐप्लिकेशन का नाम सेट करें.
   2. अपने सैंपल के लिए प्रोजेक्ट की जगह चुनें.
4. पूरा करें पर क्लिक करें.
5. पुष्टि करें कि प्रोजेक्ट की build.gradle फ़ाइल को सही तरीके से कॉन्फ़िगर किया गया हो, जैसा कि Gradle प्रॉपर्टी फ़ाइलों में बताया गया है.

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

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

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

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

हालांकि, 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.7.1")

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

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

}