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

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

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

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

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

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

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

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

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

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

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

إذا كانت حالة اختبار تطبيقك تعتمد على إصدار معيّن من Wear OS، يمكنك فلاش صورة برنامج على الساعات التي تتيح الاتصال عبر كابل USB. على سبيل المثال، يمكنك إعادة تحميل صورة المصنع أو صورة كاملة للتحديث عبر الهواء على ساعة 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>

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

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

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

تفعيل تصحيح أخطاء 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. بعد إدخال الأمر connect، تطلب منك الساعة تأكيد السماح بتصحيح أخطاء 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>

استخدام تسجيل الشاشة لنظام Wear OS

إذا كنت تُطوّر على نظام التشغيل macOS، يمكنك استخدام مشروع GitHub أداة Android لأجهزة Mac لتسجيل فيديو من جهاز Wear OS.

يمكنك بدلاً من ذلك تسجيل فيديو من جهاز Wear OS باتّباع الخطوات التالية:

  1. تسجيل اللقطات الأوّلية على الساعة: 
    adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw
  2. انسخ الملف الأوّلي إلى جهاز التطوير: 
    adb pull /sdcard/video.raw video.raw
  3. استخدِم ffmpeg لتحويل الملف الأوّلي إلى MP4: 
    ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4

    ملاحظة: يُرجى الرجوع إلى الموقع الإلكتروني FFmpeg للحصول على تعليمات التنزيل والتثبيت.