تصحيح أخطاء تطبيق 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 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. تأكَّد من تفعيل تصحيح أخطاء Ads Data Hub.
  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>

استخدام تسجيل الشاشة لنظام 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 الإلكتروني للتنزيل تعليمات التثبيت.