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

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

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

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

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

  1. افتح قائمة الإعدادات في الساعة.
  2. انتقِل إلى خيارات المطوّرين.
  3. تأكَّد من تفعيل الإعداد تصحيح أخطاء AADB.
  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. بعد إدخال أمر الاتصال، ستطلب منك الساعة تأكيد أنّك تسمح بتصحيح أخطاء Ads Data Hub.
  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 الإلكتروني للحصول على تعليمات حول التنزيل والتثبيت.