הפעלת אפליקציות במכשירי חומרה

תמיד כדאי לבדוק את אפליקציית Android במכשיר אמיתי לפני שמפיצים אותה למשתמשים. בדף הזה מוסבר איך להגדיר את סביבת הפיתוח ואת המכשיר עם Android לבדיקה ולניפוי באגים באמצעות חיבור של ממשק הגישור של Android‏ (ADB).

הגדרת מכשיר לפיתוח

לפני שמתחילים לנפות באגים במכשיר, צריך להחליט אם רוצים להתחבר למכשיר באמצעות כבל USB או Wi-Fi. לאחר מכן מבצעים את הפעולות הבאות:

  1. במכשיר, פותחים את אפליקציית ההגדרות, בוחרים באפשרות אפשרויות למפתחים ומפעילים את האפשרות ניפוי באגים ב-USB (אם רלוונטי).

  2. מגדירים את המערכת כך שתזהה את המכשיר.

    • ‫ChromeOS: לא נדרשת הגדרה נוספת.
    • ‫macOS: לא נדרשת הגדרה נוספת.
    • ‫Windows: מתקינים דרייבר של התקן USB ל-ADB (אם רלוונטי). במאמר התקנת מנהלי התקנים של OEM ל-USB תוכלו למצוא מדריך להתקנה וקישורים למנהלי התקנים של OEM.
    • ‫Ubuntu Linux: מגדירים את הפרטים הבאים:

      • כל משתמש שרוצה להשתמש ב-ADB צריך להיות בקבוצה plugdev. אם מופיעה הודעת שגיאה שאומרת שאתם לא בקבוצה plugdev, הוסיפו את עצמכם אליה באמצעות הפקודה הבאה:
      sudo usermod -aG plugdev $LOGNAME
      

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

      • במערכת צריכים להיות מותקנים כללי udev שחלים על המכשיר. החבילה android-sdk-platform-tools-common מכילה קבוצת ברירת מחדל של כללי udev למכשירי Android, שמתוחזקת על ידי הקהילה. כדי להתקין אותו, משתמשים בפקודה הבאה:
      apt-get install android-sdk-platform-tools-common
      

חיבור למכשיר באמצעות USB

אחרי שמסיימים את ההגדרה ומחברים את המכשיר באמצעות USB, לוחצים על Run (הפעלה) ב-Android Studio כדי ליצור ולהפעיל את האפליקציה במכשיר.

אפשר גם להשתמש ב-adb כדי להפעיל פקודות, באופן הבא:

  • מריצים את הפקודה adb devices מהספרייה android_sdk/platform-tools/ כדי לוודא שהמכשיר מחובר. אם הוא מחובר, המכשיר יופיע ברשימה.
  • מפעילים פקודת adb כלשהי עם הדגל -d כדי לטרגט את המכשיר.

התחברות למכשיר באמצעות Wi-Fi

ב-Android מגרסה 11 ואילך אפשר לפרוס את האפליקציה ולנפות בה באגים באופן אלחוטי מתחנת העבודה באמצעות Android Debug Bridge‏ (ADB). לדוגמה, אתם יכולים לפרוס את האפליקציה שניתן לבצע בה ניפוי באגים בכמה מכשירים שמחוברים לרשת אחרת, בלי לחבר פיזית את המכשיר באמצעות USB ולהתמודד עם בעיות נפוצות בחיבור USB, כמו התקנת מנהל התקן.

ב-Android 17, לצד adb 37.0.0, יש גרסה חדשה של adb Wi-Fi 2.0 שפותרת הרבה מבעיות השימושיות בגרסה הקודמת. חשוב לציין שהמכשיר יתחבר אוטומטית לתחנת העבודה כשהוא יתחבר לרשת מהימנה לניפוי באגים אלחוטי.

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

  1. מוודאים שתחנת העבודה והמכשיר מחוברים לאותה רשת אלחוטית.
  2. מוודאים שבמכשיר מותקנת מערכת Android מגרסה 11 ואילך. איך בודקים את גרסת Android במכשיר ומעדכנים אותה
  3. מוודאים שמותקנת הגרסה העדכנית של Android Studio. להורדה
  4. בתחנת העבודה, מעדכנים לגרסה האחרונה של SDK Platform Tools.

כדי להתאים את המכשיר:

  1. מפעילים את האפשרויות למפתחים במכשיר.
  2. במכשיר, לוחצים על "ניפוי באגים אלחוטי".

    טלפון Pixel שמוצגת בו ההודעה "ניפוי באגים אלחוטי".
    איור 1. ההודעה Wireless debugging בטלפון Google Pixel.

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

    טלפון Pixel שמוצגת בו הגדרת המערכת "ניפוי באגים אלחוטי".
    איור 2. ההגדרה Wireless debugging בטלפון Google Pixel.

  4. פותחים את Android Studio ובוחרים באפשרות Pair Devices Using Wi-Fi (התאמת מכשירים באמצעות Wi-Fi) בתפריט של הגדרות ההפעלה.

    תפריט נפתח של הגדרות הפעלה
    איור 3. Run configurations.

  5. מופיעה תיבת הדו-שיח Pair devices over Wi-Fi, כמו שמוצג באיור 4.

    חלון קופץ להתאמת מכשירים באמצעות Wi-Fi
    איור 4. תיבת דו-שיח להתאמת מכשירים דרך Wi-Fi.

    אפשר גם להתאים את המכשיר דרך Device Manager. לדוגמה My Pixel.

    ‫Device Manager עם מכשיר זמין להתאמה דרך Wi-Fi
    איור 5. ‫Device Manager עם מכשיר שזמין להתאמה באמצעות Wi-Fi.

  6. לוחצים על Pair במכשיר שרוצים להתאים. תיבת הדו-שיח להתאמת מכשירים מופיעה.

    1. כדי להתאים את המכשיר באמצעות קוד QR, בוחרים באפשרות התאמת המכשיר באמצעות קוד QR וסורקים את קוד ה-QR.
      חלון קופץ להתאמת מכשירים באמצעות Wi-Fi
      איור 6. תיבת דו-שיח להתאמת מכשיר באמצעות קוד QR.
    2. כדי להתאים את המכשיר באמצעות קוד התאמה, בוחרים באפשרות התאמת מכשיר באמצעות קוד התאמה בתיבת הדו-שיח התאמת מכשירים חדשים באמצעות Wi-Fi. במכשיר, לוחצים על התאמה באמצעות קוד התאמה. מופיע קוד בן שש ספרות. כשהמכשיר מופיע בחלון התאמת מכשירים באמצעות Wi-Fi, מזינים את הקוד בן שש הספרות שמופיע במכשיר ולוחצים על התאמה.
      דוגמה להזנת קוד התאמה
      איור 7. דוגמה להזנת קוד התאמה בן שש ספרות.
  7. אחרי ההתאמה, אתם יכולים לנסות לפרוס את האפליקציה במכשיר.

כדי לבטל התאמה של תחנת העבודה, עוברים אל ניפוי באגים אלחוטי במכשיר. לוחצים על השם של תחנת העבודה בקטע מכשירים מותאמים ובוחרים באפשרות הסרה. אפשר גם ללחוץ על Revoke adb debugging authorizations בדף הגדרות המכשיר כדי לבטל את ההתאמה של תחנת העבודה ושל כל תחנות העבודה האחרות שהותאמו בעבר.

שיקוף מכשיר

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

שיקוף המכשיר תמיד זמין כשיש מכשירים שמחוברים למחשב ומופעל בהם ניפוי באגים ב-USB או ניפוי באגים אלחוטי. אפשר להתחיל ולהפסיק את השיקוף באמצעות החלון מכשירים מחוברים או Device Manager (View > חלון של הכלי > Device Manager). אתם יכולים גם להתאים אישית את המקרים שבהם שיקוף המכשיר מופעל בהגדרות שלו (הגדרות > כלים > שיקוף מכשיר).

שיקוף מכשיר בחלון Running Devices (מכשירים מחוברים) ב-Android Studio
איור 8. בממשק המשתמש של המכשירים המחוברים.

הפניה לאודיו

כשאתם משתמשים בשיקוף מכשיר, אתם יכולים להפנות את האודיו ממכשירים פיזיים מחוברים לרמקולים או לאוזניות של המחשב. עם הפניית אודיו, אתם יכולים להשאיר את האוזניות מחוברות למחשב ולהאזין גם למחשב וגם לטלפון המחובר בלי שתצטרכו להתחבר ידנית למכשיר אחד ואז למכשיר אחר. כדי להפעיל את הפניית האודיו, עוברים אל File (Android Studio ב-macOS) ‏> Settings ‏> Tools ‏> Device Mirroring ובוחרים באפשרות Redirect audio from local devices. שימו לב שהאודיו תמיד מופנה מחדש, בלי קשר להגדרות, במכשירי Firebase Test Lab עם Android בגרסה 12 ואילך.

בעיות מוכרות

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

2023-06-01 15:32:22,675 [  56094]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - Too many video encoder errors:
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - encoder: c2.android.vp8.encoder
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - mime type: video/x-vnd.on2.vp8
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max resolution: 640x640
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - min resolution: 2x2
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - alignment: 2x2
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate: 960
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate for 288x640: 960
2023-06-01 15:32:22,870 [  56289]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max bitrate: 20000000
2023-06-01 15:32:22,871 [  56290]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - terminated with code 1

הודעת פרטיות

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

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

אם המכשיר לא מתחבר ל-Android Studio, נסו את השלבים הבאים כדי לפתור את הבעיה:

פתרון בעיות בעזרת הכלי "עזרה בחיבור"

בכלי Connection Assistant יש הוראות מפורטות להגדרה ולשימוש במכשיר דרך חיבור ADB.

כדי להפעיל את הכלי, בוחרים באפשרות Tools (כלים) > Troubleshoot Device Connections (פתרון בעיות בחיבורי מכשירים).

‫Connection Assistant מספק הוראות, אמצעי בקרה בהקשר ורשימה של מכשירים מחוברים בסדרה של דפים בחלונית Assistant. משתמשים בלחצנים Next ו-Previous בתחתית החלונית Assistant כדי לעבור בין הדפים לפי הצורך:

  • חיבור המכשיר באמצעות USB: קודם כל, עוזר החיבור מבקש לחבר את המכשיר באמצעות USB, ומציג את הלחצן סריקה מחדש של התקני USB שמאפשר להתחיל סריקה חדשה של מכשירים מחוברים.
  • הפעלת ניפוי באגים ב-USB: כלי העזר לחיבור יסביר לכם איך להפעיל ניפוי באגים ב-USB באפשרויות למפתחים במכשיר.
  • הפעלה מחדש של שרת ה-ADB: אם המכשיר עדיין לא מופיע ברשימת המכשירים הזמינים, לוחצים על הכפתור Restart ADB server בדף האחרון של Connection Assistant. הפעלה מחדש של שרת ה-ADB גם גורמת ל-ADB לסרוק שוב מכשירים. אם המכשיר עדיין לא מופיע ברשימת המכשירים הזמינים, נסו את השלבים לפתרון בעיות בקטע הבא.

פתרון בעיות בחיבור USB

אם כלי העזר לחיבור לא מזהה את המכשיר בחיבור USB, נסו את השלבים הבאים לפתרון הבעיה:

מוודאים ש-Android Studio מתחבר לאמולטור Android

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

  1. פותחים את Device Manager.
  2. אם עדיין אין לכם AVD, צרו AVD חדש.
  3. מפעילים את האמולטור באמצעות ה-AVD.
  4. מבצעים אחת מהפעולות הבאות:
    • אם Android Studio לא מצליח להתחבר לאמולטור, צריך להוריד את הגרסה העדכנית של SDK Platform Tools ולנסות שוב.
    • אם האמולטור מופעל, בודקים את כבל ה-USB כמו שמתואר בקטע הבא.

בדיקת כבל ה-USB

כדי לבדוק אם הבעיה נגרמת בגלל כבל USB פגום, פועלים לפי השלבים בקטע הזה.

אם יש לכם כבל USB אחר:

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

אם אין לכם כבל USB אחר אבל יש לכם מכשיר Android אחר:

  1. מחברים את המכשיר המשני למחשב.
  2. אם הכלי Connection Assistant מזהה את המכשיר המשני, כנראה שהבעיה היא במכשיר הראשי. בדקו אם המכשיר מוגדר לפיתוח.

    אם המכשיר המשני לא מזוהה, יכול להיות שהבעיה היא בכבל ה-USB.

בודקים אם המכשיר מוגדר לפיתוח

כדי לבדוק אם הבעיה נגרמת בגלל ההגדרות במכשיר, פועלים לפי השלבים הבאים:

  1. פועלים לפי השלבים בקטע הגדרת מכשיר לפיתוח.
  2. אם הבעיה לא נפתרה, פנו לתמיכת הלקוחות של יצרן הציוד המקורי (OEM) של המכשיר כדי לקבל עזרה. אומרים לנציג תמיכת הלקוחות שהמכשיר לא מתחבר ל-Android Studio באמצעות ADB.

פתרון בעיות בחיבור אלחוטי

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

בודקים אם תחנת העבודה והמכשיר עומדים בדרישות המוקדמות

בודקים שתחנת העבודה והמכשיר עומדים בדרישות המוקדמות.

עיון במדריך לפתרון בעיות ב-adb

פועלים לפי המדריך לפתרון בעיות ב-adb.

מפתח אבטחה מסוג RSA

כשמחברים למחשב מכשיר עם Android בגרסה 4.2.2 (רמת API‏ 17) ומעלה, המערכת מציגה תיבת דו-שיח שבה צריך לאשר מפתח RSA שמאפשר ניפוי באגים דרך המחשב הזה. מנגנון האבטחה הזה מגן על מכשירי המשתמשים כי אי אפשר להפעיל ניפוי באגים ב-USB ופקודות adb אחרות בלי לבטל את נעילת המכשיר ולאשר את תיבת הדו-שיח.