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

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

הערה: אפשר להשתמש במכונה וירטואלית ל-Android כדי לבדוק את האפליקציה בגרסאות שונות של פלטפורמת Android ובמסכים בגדלים שונים. מומלץ להשתמש ב-Firebase Test Lab כדי להריץ את האפליקציה במגוון רחב של מכשירים אמיתיים שמתארחים בתשתית מבוססת-ענן.

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

לפני שמתחילים לנפות באגים במכשיר, צריך להחליט אם להתחבר למכשיר באמצעות כבל 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, תוכלו ללחוץ על הפעלה ב-Android Studio כדי ליצור ולהריץ את האפליקציה במכשיר.

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

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

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

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

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

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

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

1. פותחים את Android Studio ובוחרים באפשרות התאמת מכשירים באמצעות Wi-Fi תפריט ההגדרות האישיות.

   

   איור 1. הפעלת הגדרות .

   
   
   תיבת הדו-שיח התאמת מכשירים באמצעות Wi-Fi מופיעה, כפי שמוצג באיור 2.

   

   איור 2. תיבת דו-שיח להתאמת מכשירים באמצעות קוד QR או קוד התאמה.

2. הפעלת מפתח אפשרויות במכשיר.
3. הפעלת ניפוי באגים במהלך Wi-Fi במכשיר.

   

   איור 3. ההגדרה ניפוי באגים אלחוטי ב-Google Pixel בטלפון.

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

      

      איור 4. דוגמה של 6 ספרות עם קוד התאמה.

5. לאחר ההתאמה, אפשר לנסות לפרוס את האפליקציה במכשיר.

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

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

שיקוף מסך

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

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

הערה: אם אתם משתמשים במכשירים מסוימים, למשל Xiaomi Redmi K40,‏ Poco F3 או Mi 11X עם Android 12, עליכם להפעיל גם את ההגדרה ניפוי באגים ב-USB וגם את ההגדרה ניפוי באגים ב-USB (הגדרות אבטחה), ואז להפעיל מחדש את המכשיר כדי להפעיל את שיקוף המסך.

הפניה לאודיו

כשמשתמשים בשיקוף המסך של המכשיר, אפשר להפנות אודיו ממכשירים פיזיים מחוברים לרמקולים או לאוזניות של המחשב. עם אודיו הפניה אוטומטית, יש להשאיר את האוזניות מחוברות למחשב ולהאזין לשניהם את המחשב והטלפון המחובר בלי להתחבר מחדש באופן ידני במכשיר ואז מכשיר נוסף. כדי להפעיל הפניה אוטומטית של אודיו, עוברים אל קובץ (Android) Studio ב-macOS) > הגדרות > כלים > שיקוף מכשירים ובוחרים הפניית אודיו ממכשירים מקומיים. שימו לב שהאודיו תמיד מופנה לכתובת אחרת: בלי קשר להגדרות, במכשירי Firebase Test Lab עם Android 12 או גבוהה יותר.

בעיות מוכרות

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

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, אפשר לנסות את השלבים הבאים כדי לפתור את הבעיה:

פתרון בעיות באמצעות אסיסטנט החיבור

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

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

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

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

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

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

בדיקה ש-Android Studio מתחבר למהדמנת Android

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

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

בדיקת כבל ה-USB

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

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

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

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

1. מחברים את המכשיר המשני למחשב.

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

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

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

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

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

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

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

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

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

• תחנת העבודה והמכשיר מחוברים לאותה רשת אלחוטית.
• במכשיר שלך פועלת מערכת Android מגרסה 11 ואילך. מידע נוסף זמין במאמר הבא: בדיקה ו- עדכון Android במכשיר .
• מותקנת הגרסה האחרונה של Android Studio. אפשר להוריד אותו מהדף הראשי של Android Studio.
• יש לכם את הגרסה האחרונה של SDK Platform Tools בתחנת העבודה.

בדיקת בעיות ידועות אחרות

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

• לא מתבצע חיבור ל-Wi-Fi: חלק מרשתות ה-Wi-Fi, כמו Wi-Fi של החברה עשויות לחסום חיבורי P2p ולא לאפשר לכם להתחבר באמצעות Wi-Fi. אפשר לנסות להתחבר באמצעות כבל או לרשת Wi-Fi אחרת.
• לפעמים מתבצעת השבתה אוטומטית של ADB ב-Wi-Fi: הדבר יכול לקרות אם המכשיר עובר בין רשתות Wi-Fi או מתנתק מהרשת.

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

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