תמיד מומלץ לבדוק את האפליקציה ל-Android ב- מכשיר אמיתי לפני שחרורו למשתמשים. בדף הזה נסביר איך מגדירים את סביבת הפיתוח ומכשיר Android כדי לבצע בדיקות וניפוי באגים חיבור ל-Android Debug Bridge (ADB).
הגדרת מכשיר לפיתוח
לפני שמתחילים בניפוי באגים במכשיר, צריך להחליט אם להתחבר למכשיר באמצעות כבל USB או Wi-Fi. לאחר מכן מבצעים את הפעולות הבאות:
במכשיר, פותחים את אפליקציית ההגדרות, בוחרים באפשרות אפשרויות למפתחים. לאחר מכן מפעילים ניפוי באגים ב-USB (אם רלוונטי).
מגדירים את המערכת לזיהוי המכשיר.
- 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
- כל משתמש שרוצה להשתמש ב-ADB צריך להיות בקבוצה
חיבור למכשיר באמצעות USB
כאשר המכשיר מוגדר ומחובר באמצעות ה-USB, לוחצים על הפעלה
ב-Android Studio
ליצור ולהפעיל את האפליקציה במכשיר.
אפשר גם להשתמש ב-adb
כדי להריץ פקודות,
ככה:
- כדי לוודא שהמכשיר מחובר, מריצים את הפקודה
adb devices
מהספרייה שלך ב-android_sdk/platform-tools/
. אם המיקום המכשיר המחובר יופיע ברשימה. - שולחים פקודת
adb
כלשהי עם הדגל-d
כדי לטרגט את המכשיר.
התחברות למכשיר באמצעות Wi-Fi
מערכת Android מגרסה 11 ואילך תומכת בפריסה ובניפוי באגים באפליקציה באופן אלחוטי מתחנת העבודה שלך דרך Android Debug Bridge (ADB). לדוגמה, אפשר: לפרוס את האפליקציה שניתנת לניפוי באגים במספר מכשירים מרוחקים בלי פיזית חיבור של המכשיר באמצעות USB והתמודדות עם בעיות נפוצות בחיבור USB, כמו התקנת מנהל התקן.
כדי להשתמש בניפוי באגים אלחוטי, צריך להתאים את המכשיר לתחנת העבודה באמצעות קוד התאמה. כדי להתחיל, מבצעים את השלבים הבאים:
- צריך לוודא שתחנת העבודה והמכשיר מחוברים לאותה רשת אלחוטית עמוקה מאוד,
- מוודאים שבמכשיר פועלת מערכת Android מגרסה 11 ואילך. לקבלת מידע נוסף מידע נוסף, ראו בדיקות עדכון Android במכשיר .
- מוודאים שמותקנת הגרסה העדכנית של Android Studio. להורדה
- בתחנת העבודה, מעדכנים לגרסה האחרונה של SDK Platform Tools
כדי להתחבר למכשיר, מבצעים את השלבים הבאים:
- פותחים את Android Studio ובוחרים באפשרות התאמת מכשירים באמצעות Wi-Fi
תפריט ההגדרות האישיות.
איור 1. הפעלת הגדרות .
איור 2. תיבת דו-שיח להתאמה מכשירים באמצעות קוד QR או קוד התאמה. - הפעלת המפתח אפשרויות במכשיר.
- הפעלת ניפוי באגים במהלך
Wi-Fi
במכשיר.
איור 3. ההגדרה ניפוי באגים אלחוטי ב-Google Pixel בטלפון. - מקישים על ניפוי באגים אלחוטי ומתאימים את המכשיר:
- כדי להתאים את המכשיר באמצעות קוד QR, בוחרים באפשרות התאמת המכשיר באמצעות קוד QR וסורקים את קוד ה-QR, שמוצג באיור 2.
- כדי להתאים את המכשיר באמצעות קוד התאמה, בוחרים באפשרות התאמת המכשיר עם
קוד התאמה מתיבת הדו-שיח התאמה של מכשירים חדשים באמצעות Wi-Fi. ב-
המכשיר הרצוי, בוחרים באפשרות התאמה באמצעות קוד התאמה. מספר בן 6 ספרות
מופיעה עם הקוד. ברגע שהמכשיר יופיע
בחלון התאמת מכשירים באמצעות רשת Wi-Fi, מזינים את המספר בן 6 הספרות
הקוד שמוצג במכשיר ובוחרים באפשרות התאמה .
איור 4. דוגמה של 6 ספרות עם קוד התאמה.
- לאחר ההתאמה, אפשר לנסות לפרוס את האפליקציה במכשיר.
כדי להתאים מכשיר אחר או כדי למחוק את המכשיר הזה בתחנת העבודה:
- עוברים אל ניפוי באגים אלחוטי במכשיר.
- מקישים על השם של תחנת העבודה בקטע מכשירים מותאמים.
- בוחרים באפשרות הסרה.
שיקוף מסך
אפשר לשקף את המכשיר הפיזי שלך בחלון מכשירים פועלים ב-Android אולפן. כשתעבירו את תצוגת המכשיר בסטרימינג ישירות ל-Android Studio, תוכלו: להשתמש בסביבת הפיתוח המשולבת (IDE) של Studio כדי לבצע פעולות נפוצות כמו הפעלת אפליקציות אינטראקציה איתם, סיבוב המסך, קיפול ופתיחה של הטלפון, שינוי עוצמת הקול.
תמיד אפשר לסנכרן בענן ובמחשב מכשירים שמחוברים אל מחשב שמופעל בו ניפוי באגים ב-USB או אלחוטי. אפשר להתחיל ולהפסיק שיקוף באמצעות החלון של מכשירים פועלים או מנהל המכשירים (תצוגה > Windows בכלי > מנהל המכשירים). אפשר גם לקבוע מתי מכשיר שיקוף המסך מופעל בהגדרות שלו (הגדרות > כלים > שיקוף מכשיר).
הפניית אודיו לכתובת אחרת
כשמשתמשים בסנכרון בענן ובמחשב, אפשר להפנות את הקול מהמכשיר המחובר מכשירים פיזיים לרמקולים או לאוזניות של המחשב. עם אודיו הפניה אוטומטית, יש להשאיר את האוזניות מחוברות למחשב ולהאזין לשניהם את המחשב והטלפון המחובר בלי להתחבר מחדש באופן ידני במכשיר ואז מכשיר נוסף. כדי להפעיל הפניה אוטומטית של אודיו, עוברים אל קובץ (Android) Studio ב-macOS) > הגדרות > כלים > שיקוף מכשירים ובוחרים הפניית אודיו ממכשירים מקומיים. שימו לב שהאודיו תמיד מופנה לכתובת אחרת: בלי קשר להגדרות, במכשירי 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, נסו את השלבים הבאים כדי כדי לפתור את הבעיה:
פתרון בעיות באמצעות אסיסטנט החיבור
אסיסטנט החיבור מספק הוראות מפורטות כדי לעזור לך להגדיר ולהשתמש במכשיר עם חיבור ADB.
כדי להפעיל את העוזר הדיגיטלי, בוחרים באפשרות כלים > פתרון בעיות בחיבורי המכשירים.
אסיסטנט החיבור מספק הוראות, פקדים בהקשר ורשימה של המכשירים המחוברים בסדרת דפים בחלונית Assistant. משתמשים ב הלחצנים הבא והקודם בתחתית החלונית Assistant כדי לעבור על הדפים לפי הצורך:
- חיבור המכשיר באמצעות USB: אסיסטנט החיבור מציג קודם בקשה לחבר את המכשיר באמצעות USB ומספק לסריקה מחדש של התקני USB לחצן שבו אפשר להתחיל סריקה חדשה לאיתור של מכשירים מחוברים.
- מפעילים ניפוי באגים ב-USB: כלי החיבור אומר לכם איך להפעיל ניפוי באגים ב-USB באפשרויות למפתחים במכשיר.
- צריך להפעיל מחדש את שרת ADB: אם המכשיר עדיין לא מופיע רשימה של המכשירים הזמינים, צריך להשתמש בלחצן הפעלה מחדש של שרת ADB הדף האחרון של 'מסייע החיבור'. גם הפעלה מחדש של שרת ה-ADB גורמת ADB כדי לסרוק שוב לאיתור מכשירים. אם המכשיר שלכם עדיין לא מופיע ברשימה מהמכשירים הזמינים, נסו את שלבי פתרון הבעיות בקטע הבא.
פתרון בעיות בחיבור USB
אם אסיסטנט החיבור לא מזהה את המכשיר בחיבור USB, אפשר לנסות השלבים הבאים לפתרון הבעיה:
איך בודקים שמערכת Android Studio מתחברת לאמולטור Android
כדי לבדוק אם הבעיה נגרמת מבעיית חיבור בין Android ב-Studio ובאמולטור Android, מבצעים את השלבים הבאים:
- פותחים את מנהל המכשירים.
- יוצרים AVD חדש, אם עדיין לא עשיתם זאת יש.
- מפעילים את האמולטור באמצעות ה-AVD.
- מבצעים אחת מהפעולות הבאות:
- אם אי אפשר להתחבר לאמולטור ב-Android Studio, צריך להוריד את הגרסה האחרונה כלי פלטפורמה ל-SDK ולנסות שוב.
- אם האמולטור מתחיל בהצלחה, עליכם לבדוק את כבל ה-USB, כמו שמתואר בקטע הבא.
בדיקת כבל ה-USB
כדי לבדוק אם הבעיה נגרמת על ידי כבל USB פגום, צריך לבצע את השלבים הבאים בקטע הזה.
אם יש לכם כבל USB אחר:
- מחברים את המכשיר באמצעות הכבל המשני.
- בודקים אם אסיסטנט החיבור יכול עכשיו לזהות את המכשיר.
- אם המכשיר לא זוהה, יש לנסות שוב להשתמש בכבל הראשי.
- אם המכשיר עדיין לא מזוהה, מניחים שהבעיה היא מכשיר, וגם לבדוק אם המכשיר מוגדר לפיתוח כמתואר בסעיף הבא.
אם אין לכם כבל USB אחר אבל יש לכם מכשיר Android אחר:
- מחברים את המכשיר המשני למחשב.
אם אסיסטנט החיבור יכול לזהות את המכשיר המשני, נניח ש היא במכשיר הראשי. לבדוק אם המכשיר מוגדר לפיתוח.
אם המכשיר המשני לא מזוהה, יכול להיות שהבעיה ב-USB באמצעות כבל.
בדיקה אם המכשיר מוגדר לפיתוח
כדי לבדוק אם הבעיה נגרמת מההגדרות במכשיר, מבצעים את הפעולות הבאות שלבים:
- פועלים לפי ההוראות במאמר הגדרת מכשיר לפיתוח. .
- אם הבעיה לא נפתרת, יש לפנות ליצרן ה-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
אחרות לא יכולים
מבוצעת אלא אם יש לך אפשרות לבטל את הנעילה של המכשיר ולאשר את תיבת הדו-שיח.