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

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

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