تصحيح أخطاء تطبيق 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. بالنسبة مثال، يمكنك وميض صورة المصنع أو a الصورة الكاملة للتحديث الهوائي على جهاز 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. في نافذة طرفية على جهاز التطوير، اكتب ما يلي :com 
    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. بعد إدخال الأمر 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 للحصول على تعليمات التنزيل والتثبيت.