Wear OS ऐप्लिकेशन को डीबग करना

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

अगर आपके ऐप्लिकेशन के लिए, एक से ज़्यादा डिवाइसों पर काम करने वाले वर्कफ़्लो की सुविधा ज़रूरी है, तो उन्हें भी टेस्ट किया जा सकता है. जैसे, स्मार्टवॉच और फ़ोन. टेस्टिंग के लिए कनेक्शन सेट अप करने के तरीके के बारे में ज़्यादा जानने के लिए, घड़ी को फ़ोन से कनेक्ट करना पर जाएं.

ध्यान दें: अगर आपके पास स्मार्टवॉच नहीं है, तो Android Studio में एम्युलेटर पर भी अपने ऐप्लिकेशन को टेस्ट और चलाया जा सकता है.

Wear OS को नए वर्शन पर अपडेट करना

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

अपने टेस्ट डिवाइस पर सिस्टम अपडेट देखने के लिए, यह तरीका अपनाएं:

  1. डिवाइस को किसी वाई-फ़ाई नेटवर्क से कनेक्ट करें.
  2. डिवाइस को चार्ज करना शुरू करें.
  3. डिवाइस की बैटरी को 50% या इससे ज़्यादा चार्ज होने दें.
  4. अपने टेस्ट डिवाइस पर, सेटिंग > सिस्टम > सिस्टम अपडेट पर जाएं.

    अगर कोई सिस्टम अपडेट उपलब्ध है, तो वह आपके टेस्ट डिवाइस पर डाउनलोड और इंस्टॉल हो जाएगा.

Wear OS का कोई वर्शन इंस्टॉल करना (ज़रूरी नहीं)

अगर आपके ऐप्लिकेशन का टेस्ट केस, Wear OS के किसी खास वर्शन पर निर्भर करता है, तो यूएसबी डेटा कनेक्शन की सुविधा वाली घड़ियों पर सॉफ़्टवेयर इमेज फ़्लैश की जा सकती है. उदाहरण के लिए, Google Pixel Watch 3 या Google Pixel Watch 2 डिवाइस पर फ़ैक्ट्री इमेज या फ़ुल ओटीए इमेज फ़्लैश की जा सकती है.

अपनी स्मार्टवॉच पर डेवलपर के लिए सेटिंग और टूल चालू करना

अपनी स्मार्टवॉच पर डीबग करने से पहले, डेवलपर के लिए सेटिंग और टूल चालू करें. आपको ऐसा सिर्फ़ एक बार करना होगा. डेवलपर के लिए सेटिंग और टूल तब तक चालू रहते हैं, जब तक आप उन्हें बंद नहीं करते. डेवलपर के लिए सेटिंग और टूल चालू करने के लिए, यह तरीका अपनाएं:

  1. स्मार्टवॉच पर सेटिंग खोलें.
  2. सिस्टम > जानकारी > वर्शन पर टैप करें.
  3. बिल्ड नंबर पर सात बार टैप करें.
  4. आपको एक मैसेज दिखेगा, जिसमें यह पुष्टि की जाएगी कि अब आप डेवलपर हैं.

वाई-फ़ाई पर डीबग करें

शुरू करने से पहले, वॉच पर डेवलपर के लिए उपलब्ध सेटिंग और टूल चालू करें. इसके बारे में पहले बताया जा चुका है.

स्मार्टवॉच को वाई-फ़ाई नेटवर्क से कनेक्ट करना

  1. स्मार्टवॉच पर सेटिंग खोलें.
  2. कनेक्टिविटी > वाई-फ़ाई पर टैप करें.
  3. कोई नेटवर्क चुनें और ज़रूरत पड़ने पर उसका पासवर्ड डालें.

    ध्यान दें: स्मार्टवॉच और डेवलपमेंट मशीन, दोनों एक ही नेटवर्क से कनेक्ट होनी चाहिए. सभी ऐक्सेस पॉइंट सही नहीं होते. आपको ऐसे ऐक्सेस पॉइंट का इस्तेमाल करना पड़ सकता है जिसका फ़ायरवॉल, adb के साथ काम करने के लिए सही तरीके से कॉन्फ़िगर किया गया हो.

वाई-फ़ाई डीबग करने की सुविधा चालू करना

  1. स्मार्टवॉच पर सेटिंग खोलें.
  2. डेवलपर के लिए सेटिंग और टूल > वाई-फ़ाई पर डीबग करें पर टैप करें.
  3. कुछ देर बाद, स्क्रीन पर स्मार्टवॉच का आईपी पता दिखता है. जैसे, 192.168.1.100. आपको अगले चरण में इसकी ज़रूरत पड़ेगी. इसलिए, इसे नोट कर लें.

स्मार्टवॉच से डीबगर को जोड़ना

  1. अपने Wear OS डिवाइस पर, सिस्टम सेटिंग में जाकर वायरलेस डीबगिंग के विकल्प ढूंढें. नया डिवाइस जोड़ें को चुनें.
  2. वाई-फ़ाई से जोड़ने का कोड और आईपी पता और पोर्ट नोट करें.
  3. अपनी डेवलपमेंट मशीन पर मौजूद टर्मिनल विंडो में, यह कमांड टाइप करें:
    adb pair IP_ADDRESS:PORT
  4. जब आपसे कहा जाए, तब दूसरे चरण में मिला वाई-फ़ाई से जोड़ने का कोड डालें. टर्मिनल पर यह जानकारी दिखेगी कि डिवाइस को टर्मिनल से जोड़ा गया है या नहीं. उदाहरण के लिए:
    Enter pairing code: 123456
    Successfully paired to 192.168.1.100:5555
    
पेयर करने के बाद, होस्ट कंप्यूटर का नाम, Wear OS डिवाइस की वायरलेस डीबगिंग स्क्रीन पर, पेयर किए गए डिवाइस की सूची में दिखता है.

डिबगर को स्मार्टवॉच से कनेक्ट करना

  1. अपनी स्मार्टवॉच और डेवलपमेंट मशीन को एक ही नेटवर्क से कनेक्ट करें.
  2. स्मार्टवॉच के आईपी पते और पोर्ट नंबर का इस्तेमाल करके, डीबगर को स्मार्टवॉच से कनेक्ट करें. उदाहरण के लिए, अगर आईपी पता 192.168.1.100 है और पोर्ट नंबर 5555 है, तो adb connect कमांड और उसका जवाब इस तरह दिखेगा:

    adb connect 192.168.1.100:5555
    connected to 192.168.1.100:5555
    

अब स्मार्टवॉच, डीबगर से कनेक्ट हो गई है. अब डीबग करना शुरू किया जा सकता है. स्मार्टवॉच को adb कमांड भेजें. इसके लिए, -s फ़्लैग का इस्तेमाल करें. साथ ही, स्मार्टवॉच का आईपी पता और पोर्ट नंबर डालें:

adb -s 192.168.1.100:5555 <command>

अगर एम्युलेटर का इस्तेमाल नहीं किया जा रहा है और डीबग करने के लिए सिर्फ़ एक डिवाइस कनेक्ट किया गया है, तो आपको पता बताने की ज़रूरत नहीं है:

adb <command>

ब्लूटूथ पर डीबग करें

ध्यान दें: ब्लूटूथ डीबगिंग की सुविधा, सिर्फ़ Android से कनेक्ट की गई उन स्मार्टवॉच के लिए काम करती है जिनमें Wear OS 2 है.

शुरू करने से पहले, स्मार्टवॉच और फ़ोन को एक-दूसरे से जोड़ें. साथ ही, स्मार्टवॉच पर डेवलपर के लिए सेटिंग और टूल चालू करें. इसके बारे में पहले बताया जा चुका है. पक्का करें कि फ़ोन पर डेवलपर के लिए सेटिंग और टूल चालू हों. इसके लिए, फ़ोन के सेटिंग मेन्यू खोलें और डेवलपर के लिए सेटिंग और टूल देखें. अगर ज़रूरी हो, तो फ़ोन पर डेवलपर के लिए सेटिंग और टूल चालू करें.

फ़ोन पर यूएसबी डीबग करने की सुविधा चालू करना

  1. फ़ोन का सेटिंग मेन्यू खोलें.
  2. डेवलपर के लिए सेटिंग और टूल चुनें. इसके बाद, यूएसबी डीबग करना चालू करें.

स्मार्टवॉच पर ADB या ब्लूटूथ डीबग करने की सुविधा चालू करना

  1. स्मार्टवॉच पर सेटिंग मेन्यू खोलें.
  2. स्क्रोल करके, डेवलपर के लिए सेटिंग और टूल पर जाएं.
  3. पुष्टि करें कि ADB डीबग करने की सुविधा चालू है.
  4. ब्लूटूथ पर डीबग करें को चालू करें.

फ़ोन पर ब्लूटूथ डीबग करने की सुविधा चालू करना

  1. फ़ोन पर, Wear OS साथी ऐप्लिकेशन खोलें.
  2. ऐडवांस सेटिंग पर स्क्रोल करें और ऐडवांस सेटिंग के विकल्प देखने के लिए टैप करें.
  3. ब्लूटूथ पर डीबग करने की सुविधा चालू करें. यह स्टेटस मैसेज, विकल्प के नीचे दिखता है:
    Host: disconnected
    Target: connected
    

इस समय, डेवलपमेंट मशीन यानी होस्ट, स्मार्टवॉच यानी टारगेट से कम्यूनिकेट नहीं कर रही है. आपको लिंक पूरा करना होगा.

ध्यान दें: एक बार में सिर्फ़ एक डिवाइस से डीबग किया जा सकता है. अगर आपने एक से ज़्यादा स्मार्टवॉच जोड़ी हैं, तो ब्लूटूथ डीबगिंग सिर्फ़ उस डिवाइस के लिए चालू होगी जिसे मुख्य स्क्रीन पर चुना गया है.

डिबगर को स्मार्टवॉच से कनेक्ट करना

इस आखिरी चरण में, आपको डिबगर, फ़ोन, और स्मार्टवॉच, इन सभी का इस्तेमाल करना होगा.

  1. यूएसबी केबल की मदद से, फ़ोन को डेवलपमेंट मशीन से कनेक्ट करें.
  2. डीबगर में ये दो कमांड चलाएं:
    adb forward tcp:4444 localabstract:/adb-hub
    adb connect 127.0.0.1:4444
    

    ध्यान दें: आपको आईपी पते 127.0.0.1 का इस्तेमाल करना होगा. अपनी डेवलपमेंट मशीन पर मौजूद किसी भी पोर्ट का इस्तेमाल करें. साथ ही, दोनों कमांड में एक ही पोर्ट का इस्तेमाल करें. इस उदाहरण में, पोर्ट 4444 है.

  3. कनेक्ट करने का निर्देश डालने के बाद, स्मार्टवॉच आपसे पुष्टि करने के लिए कहती है कि आपने ADB डिबगिंग की अनुमति दी है.
  4. फ़ोन पर, Wear OS साथी ऐप्लिकेशन में जाकर, इनकी स्थिति देखें:
    Host: connected
    Target: connected
    
  5. अब स्मार्टवॉच, डीबगर से कनेक्ट हो गई है. अब डीबग करना शुरू किया जा सकता है.

ब्लूटूथ का इस्तेमाल करके किसी स्मार्टवॉच को डीबग करते समय, adb हमेशा आईपी पते 127.0.0.1 के साथ-साथ असाइन किया गया पोर्ट इस्तेमाल करता है. इस उदाहरण में, पोर्ट 4444 है. सभी adb कमांड, इस फ़ॉर्मैट का इस्तेमाल करती हैं:

adb -s 127.0.0.1:4444 <command> 

अगर एम्युलेटर का इस्तेमाल नहीं किया जा रहा है और डीबग करने के लिए सिर्फ़ एक डिवाइस कनेक्ट किया गया है, तो आपको पता बताने की ज़रूरत नहीं है:

adb <command>