ניפוי באגים באפליקציה ל-Wear OS

כדי לנפות באגים באפליקציית Wear OS בשעון פיזי, מחברים את מכונת הפיתוח לשעון באמצעות Wi-Fi או Bluetooth. לחלופין, אם בשעון יש יציאת USB, אפשר להתחבר באמצעות USB.

אם האפליקציה שלכם דורשת תמיכה כזו, אתם יכולים גם לבדוק תהליכי עבודה שמתפרסים על פני כמה מכשירים, כמו שעון וטלפון. מידע נוסף על הגדרת חיבור לצורך בדיקה זמין במאמר חיבור שעון לטלפון.

הערה: אם אין לכם שעון פיזי, אתם יכולים גם לבדוק את האפליקציה ולהריץ אותה באמולטור ב-Android Studio.

עדכון לגרסה האחרונה של Wear OS

כדי לוודא שהאפליקציה פועלת כמצופה בתוכנה העדכנית ביותר, צריך לבדוק שבמכשיר הבדיקה פועלת הגרסה העדכנית ביותר של Wear OS שהמכשיר תומך בה.

כדי לבדוק אם יש עדכון מערכת במכשיר הבדיקה, מבצעים את השלבים הבאים:

  1. מחברים את המכשיר לרשת Wi-Fi.
  2. מתחילים לטעון את המכשיר.
  3. ממתינים עד שהסוללה של המכשיר תיטען ל-50% ומעלה.

  4. במכשיר הבדיקה, עוברים אל הגדרות > מערכת > עדכוני מערכת.

    אם יש עדכון מערכת זמין, הוא יורד ויותקן במכשיר הבדיקה.

התקנה של גרסה ספציפית של Wear OS (אופציונלי)

אם תרחיש הבדיקה של האפליקציה שלכם תלוי בגרסה ספציפית של Wear OS, אתם יכולים לצרוב תמונת תוכנה על שעונים שתומכים בחיבור נתונים באמצעות USB. לדוגמה, אפשר לצרוב קובץ אימג' של קושחת המכשיר או קובץ אימג' מלא ל-OTA במכשיר Google Pixel Watch 3 או Google Pixel Watch 2.

הפעלת האפשרויות למפתחים בשעון

כדי לנפות באגים בשעון, צריך להפעיל את האפשרויות למפתחים. צריך לעשות את זה רק פעם אחת. האפשרויות למפתחים נשארות מופעלות עד שמשביתים אותן. כדי להפעיל את האפשרויות למפתחים:

  1. פותחים את ההגדרות בשעון.
  2. מקישים על מערכת > מידע > גרסאות.
  3. מקישים שבע פעמים על האפשרות מספר Build.
  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>

ניפוי באגים באמצעות Bluetooth

הערה: ניפוי באגים ב-Bluetooth פועל רק בשעונים עם Wear OS 2 שמשויכים ל-Android.

לפני שמתחילים, צריך להתאים בין השעון לטלפון ולהפעיל את האפשרויות למפתחים בשעון, כמו שמתואר למעלה. כדי לוודא שהאפשרויות למפתחים מופעלות בטלפון, פותחים את תפריט ההגדרות של הטלפון ומחפשים את האפשרות אפשרויות למפתחים. אם צריך, מפעילים את האפשרויות למפתחים בטלפון.

הפעלת ניפוי באגים ב-USB בטלפון

  1. פותחים את תפריט ההגדרות בטלפון.
  2. בוחרים באפשרות אפשרויות למפתחים ומפעילים את האפשרות ניפוי באגים ב-USB.

הפעלה של ניפוי באגים באמצעות ADB או Bluetooth בשעון

  1. פותחים את תפריט ההגדרות בשעון.
  2. גוללים אל אפשרויות למפתחים.
  3. מוודאים שהאפשרות ניפוי באגים באמצעות ADB מופעלת.
  4. מפעילים את האפשרות ניפוי באגים ב-Bluetooth.

הפעלת ניפוי באגים באמצעות Bluetooth בטלפון

  1. בטלפון, פותחים את האפליקציה הנלווית של Wear OS.
  2. גוללים אל הגדרות מתקדמות ומקישים כדי להציג את האפשרויות של הגדרות מתקדמות.
  3. מפעילים את האפשרות ניפוי באגים ב-Bluetooth. הודעת הסטטוס הבאה מופיעה מתחת לאפשרות: 
    Host: disconnected
Target: connected

בשלב הזה, מכונת הפיתוח – המארח – לא מתקשרת עם השעון – היעד. צריך להשלים את הקישור.

הערה: אפשר לבצע ניפוי באגים רק במכשיר אחד בכל פעם. אם יש לכם כמה שעונים מוצמדים, ניפוי הבאגים ב-Bluetooth מופעל רק במכשיר שנבחר במסך הראשי.

חיבור מאתר הבאגים לשעון

בשלב האחרון הזה משתמשים בכל מה שיש: מאתר הבאגים, הטלפון והשעון.

  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. השעון מחובר עכשיו ל-Debugger, ואפשר להתחיל בניפוי הבאגים.

כשמבצעים ניפוי באגים בשעון באמצעות Bluetooth, ‏ adb תמיד משתמש בכתובת ה-IP‏ 127.0.0.1 בתוספת היציאה שאתם מקצים. בדוגמה הזו, היציאה היא 4444. כל הפקודות של adb בנויות בפורמט הבא:

adb -s 127.0.0.1:4444 <command>

אם אתם לא משתמשים באמולטור ויש לכם רק מכשיר אחד שמחובר לניפוי באגים, אתם לא צריכים לציין את הכתובת:

adb <command>