تصحيح أخطاء تطبيق Wear OS

لتصحيح أخطاء تطبيق Wear OS على ساعة فعلية، وصِّل جهاز التطوير بالساعة باستخدام شبكة Wi-Fi أو البلوتوث. بدلاً من ذلك، إذا كانت ساعتك مزوّدة بمنفذ USB، يمكنك الاتصال باستخدام USB.

يمكنك أيضًا اختبار سير العمل التي تمتد على أجهزة متعددة، مثل ساعة وهاتف، إذا كان تطبيقك يتطلّب توفير هذه الميزة. لمزيد من المعلومات حول كيفية إعداد اتصال لإجراء الاختبار، يُرجى الانتقال إلى مقالة ربط ساعة بهاتف.

ملاحظة: إذا لم تكن لديك ساعة فعلية، يمكنك أيضًا اختبار تشغيل تطبيقك على محاكي في "استوديو Android".

تحديث Wear OS إلى أحدث إصدار

للمساعدة في التأكّد من أنّ تطبيقك يعمل على أحدث إصدار من البرنامج على النحو المتوقّع، تأكَّد من أنّ جهاز الاختبار يعمل بأحدث إصدار متوافق من Wear OS.

للبحث عن تحديث للنظام على جهاز الاختبار، أكمل الخطوات التالية:

  1. وصِّل الجهاز بشبكة Wi-Fi.
  2. ابدأ بشحن الجهاز.
  3. انتظِر إلى أن يتم شحن بطارية الجهاز إلى% 50 أو أكثر.

  4. على جهاز الاختبار، انتقِل إلى الإعدادات > النظام > تحديثات النظام.

    في حال توفّر تحديث للنظام، سيتم تنزيله وتثبيته على جهاز الاختبار.

تثبيت إصدار معيّن من Wear OS (اختياري)

إذا كانت حالة الاختبار في تطبيقك تعتمد على إصدار معيّن من Wear OS، يمكنك نقل صورة برنامج إلى الساعات التي تتيح اتّصال بيانات عبر USB. على سبيل المثال، يمكنك تثبيت صورة المصنع أو صورة OTA الكاملة على ساعة Google Pixel Watch 3 أو Google Pixel Watch 2.

تفعيل خيارات المطوّرين على ساعتك

قبل تصحيح الأخطاء على ساعتك، عليك تفعيل خيارات المطوّرين. لن تحتاج إلى إجراء ذلك سوى مرة واحدة. تظل خيارات المطوّرين مفعّلة إلى أن يتم إيقافها. لتفعيل خيارات المطوّرين، اتّبِع الخطوات التالية:

  1. افتح الإعدادات على الساعة.
  2. انقر على النظام > لمحة > الإصدارات.
  3. انقر على الخيار رقم الإصدار سبع مرات.
  4. ستظهر رسالة تؤكّد أنّك أصبحت الآن مطوّرًا.

تصحيح الأخطاء عبر Wi-Fi

قبل البدء، فعِّل خيارات المطوّرين على الساعة كما هو موضّح سابقًا.

توصيل الساعة بشبكة Wi-Fi

  1. افتح الإعدادات على الساعة.
  2. انقر على إمكانية الاتصال > Wi-Fi.
  3. اختَر شبكة وأدخِل كلمة المرور إذا لزم الأمر.

    ملاحظة: يجب أن تكون الساعة وجهاز التطوير متصلَين بالشبكة نفسها. ولا تكون جميع نقاط الوصول مناسبة. قد تحتاج إلى استخدام نقطة وصول تم ضبط جدار الحماية فيها بشكل صحيح لتتوافق مع adb.

تفعيل تصحيح الأخطاء عبر Wi-Fi

  1. افتح الإعدادات على الساعة.
  2. انقر على خيارات المطوّرين > تصحيح الأخطاء عبر شبكة Wi-Fi.
  3. بعد لحظة، ستعرض الشاشة عنوان IP للساعة، مثل 192.168.1.100. ستحتاج إلى هذا الرمز في الخطوة التالية، لذا سجِّله.

إقران أداة تصحيح الأخطاء بالساعة

  1. على جهاز Wear OS، ابحث عن خيارات تصحيح الأخطاء لاسلكيًا في إعدادات النظام. اختَر إقران جهاز جديد.
  2. دوِّن رمز إقران Wi-Fi وعنوان IP والمنفذ.
  3. في نافذة وحدة طرفية على جهاز التطوير، اكتب الأمر التالي: 
    adb pair IP_ADDRESS:PORT
  4. عندما يُطلب منك ذلك، أدخِل رمز إقران Wi-Fi من الخطوة 2. ستعرض محطة الدفع ما إذا كان الإقران ناجحًا. على سبيل المثال: 
    Enter pairing code: 123456
Successfully paired to 192.168.1.100:5555
بعد الإقران، يظهر الكمبيوتر المضيف في قائمة الأجهزة المقترنة على شاشة تصحيح الأخطاء لاسلكيًا في جهاز Wear OS.

ربط أداة تصحيح الأخطاء بالساعة

  1. ربط ساعتك وجهاز التطوير بالشبكة نفسها

  2. اربط أداة تصحيح الأخطاء بالساعة باستخدام عنوان IP الخاص بالساعة ورقم المنفذ. على سبيل المثال، إذا كان عنوان IP هو 192.168.1.100 ورقم المنفذ هو 5555، سيبدو الأمر adb connect والرد عليه على النحو التالي: 

    adb connect 192.168.1.100:5555
connected to 192.168.1.100:5555

أصبحت الساعة الآن مرتبطة بأداة تصحيح الأخطاء وأنت جاهز لبدء تصحيح الأخطاء. أرسِل أوامر adb إلى الساعة باستخدام العلامة -s، مع تحديد عنوان IP الخاص بالساعة ورقم المنفذ:

adb -s 192.168.1.100:5555 <command>

إذا كنت لا تستخدم المحاكي ولديك جهاز واحد فقط متصل لتصحيح الأخطاء، لن تحتاج إلى تحديد العنوان:

adb <command>

تصحيح الأخطاء عبر البلوتوث

ملاحظة: لا يمكن تصحيح أخطاء البلوتوث إلا على الساعات التي تعمل بنظام التشغيل Wear OS 2 والمقترنة بجهاز Android.

قبل البدء، عليك إقران الساعة بالهاتف وتفعيل خيارات المطوّرين على الساعة كما هو موضّح سابقًا. تأكَّد من تفعيل خيارات المطوّرين على الهاتف من خلال فتح قائمة الإعدادات والبحث عن خيارات المطوّرين. إذا لزم الأمر، فعِّل خيارات المطوّرين على الهاتف.

تفعيل ميزة "تصحيح أخطاء الجهاز عبر USB" على الهاتف

  1. افتح قائمة الإعدادات على الهاتف.
  2. اختَر خيارات المطوّرين وفعِّل تصحيح أخطاء الجهاز عبر USB.

تفعيل خيار "تصحيح الأخطاء عبر ADB" أو "تصحيح الأخطاء عبر البلوتوث" على الساعة

  1. افتح قائمة الإعدادات على الساعة.
  2. انتقِل إلى خيارات المطوّرين.
  3. تأكَّد من تفعيل خيار تصحيح الأخطاء عبر ADB.
  4. فعِّل خيار تصحيح الأخطاء عبر البلوتوث.

تفعيل خيار "تصحيح الأخطاء عبر البلوتوث" على الهاتف

  1. على الهاتف، افتح تطبيق Wear OS المصاحب.
  2. انتقِل إلى الإعدادات المتقدّمة وانقر عليها لعرض خيارات الإعدادات المتقدّمة.
  3. فعِّل خيار تصحيح الأخطاء عبر البلوتوث. تظهر رسالة الحالة التالية أسفل الخيار: 
    Host: disconnected
Target: connected

في هذه المرحلة، لا يتواصل جهاز التطوير (المضيف) مع الساعة (الجهاز المستهدف). عليك إكمال الرابط.

ملاحظة: يمكنك تصحيح الأخطاء بجهاز واحد فقط في كل مرة. إذا كانت لديك ساعات متعدّدة مقترنة، لن يتم تفعيل تصحيح أخطاء البلوتوث إلا مع الجهاز المحدّد على الشاشة الرئيسية.

ربط أداة تصحيح الأخطاء بالساعة

في هذه الخطوة الأخيرة، ستستخدم كل شيء: أداة تصحيح الأخطاء والهاتف والساعة.

  1. وصِّل الهاتف بجهاز التطوير باستخدام كابل USB.
  2. نفِّذ هذين الأمرَين في برنامج تصحيح الأخطاء: 
    adb forward tcp:4444 localabstract:/adb-hub
adb connect 127.0.0.1:4444

    ملاحظة: يجب استخدام عنوان IP 127.0.0.1. استخدِم أي منفذ متاح على جهاز التطوير، واستخدِم المنفذ نفسه في كلا الأمرين. في هذا المثال، رقم المنفذ هو 4444.

  3. بعد إدخال أمر الربط، ستطلب منك الساعة تأكيد أنّك تسمح بتصحيح أخطاء ADB.
  4. على الهاتف، تحقَّق من عرض الحالة في تطبيق Wear OS المصاحِب بحثًا عمّا يلي: 
    Host: connected
Target: connected

    5. أصبحت الساعة الآن مرتبطة بأداة تصحيح الأخطاء، وأنت جاهز لبدء تصحيح الأخطاء.

عند تصحيح أخطاء تطبيق على ساعة باستخدام البلوتوث، يستخدم adb دائمًا عنوان IP 127.0.0.1 بالإضافة إلى المنفذ الذي تحدّده. في هذا المثال، يكون المنفذ هو 4444. تستخدِم جميع أوامر adb التنسيق التالي:

adb -s 127.0.0.1:4444 <command>

إذا كنت لا تستخدم المحاكي ولديك جهاز واحد فقط متصل لتصحيح الأخطاء، لن تحتاج إلى تحديد العنوان:

adb <command>