Android Debug Bridge (adb)

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

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

ריכזנו כאן רשימה של בעיות ידועות בניפוי באגים אלחוטי (עם adb או Android Studio) והדרכים לפתור אותן:

• לא מתבצע חיבור ל-Wi-Fi: רשתות Wi-Fi מאובטחות, כמו רשתות Wi-Fi ארגוניות, עשויות לחסום חיבורי p2p ולא לאפשר חיבור באמצעות Wi-Fi. מנסים להתחבר באמצעות כבל או לרשת Wi-Fi אחרת (לא עסקית). אפשרות נוספת היא חיבור אלחוטי באמצעות adb connect ip:port על גבי tcp/ip (לאחר חיבור USB ראשוני), במקרה שאפשר להשתמש ברשת שאינה של הארגון.

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

• המכשיר לא מתחבר אחרי ההתאמה: adb מסתמך על mDNS כדי לגלות מכשירים מותאמים ולהתחבר אליהם באופן אוטומטי. אם ההגדרות של הרשת או המכשיר לא תומכות ב-mDNS או שהן משביתות אותו, צריך להתחבר למכשיר באופן ידני באמצעות adb connect ip:port.

חיבור אלחוטי למכשיר לאחר חיבור USB ראשוני (האפשרות זמינה רק ב-Android 10 ומטה)

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

הערה: ההוראות הבאות לא רלוונטיות למכשירי Wear עם Android מגרסה 10 (רמת API 29) ומטה. מידע נוסף זמין במדריך בנושא ניפוי באגים באפליקציה ל-Wear OS.

בדרך כלל, adb מתקשר עם המכשיר באמצעות USB, אבל אפשר להשתמש גם ב-adb באמצעות Wi-Fi. כדי לחבר מכשיר עם Android מגרסה 10 (API ברמה 29) ומטה, פועלים לפי השלבים הראשוניים הבאים באמצעות USB:

1. מחברים את מכשיר Android ואת המחשב המארח adb לרשת Wi-Fi משותפת.

הערה: חשוב לזכור שלא כל נקודות הגישה מתאימות. יכול להיות שתצטרכו להשתמש בנקודת גישה שחומת האש שלה מוגדרת כראוי לתמיכה ב-adb.

2. מחברים את המכשיר למחשב המארח באמצעות כבל USB.
3. מגדירים את מכשיר היעד להאזנה לחיבור TCP/IP ביציאה 5555:

   adb tcpip 5555
   

4. מנתקים את כבל ה-USB מהמכשיר היעד.
5. מוצאים את כתובת ה-IP של מכשיר Android. לדוגמה, במכשיר Nexus, אפשר למצוא את כתובת ה-IP בקטע הגדרות > מידע על הטאבלט (או מידע על הטלפון) > סטטוס > כתובת IP.
6. מתחברים למכשיר לפי כתובת ה-IP שלו:

   adb connect device_ip_address:5555
   

7. מוודאים שמחשב המארח מחובר למכשיר היעד:

   $ adb devices
   List of devices attached
   device_ip_address:5555 device
   

המכשיר שלך מחובר עכשיו אל adb.

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

• מוודאים שהמארח עדיין מחובר לאותה רשת Wi-Fi שאליה מחובר מכשיר Android.
• כדי להתחבר מחדש, צריך לבצע שוב את השלב adb connect.
• אם הבעיה נמשכת, מאפסים את המארח adb:

  adb kill-server
  

  לאחר מכן מתחילים מחדש.

שליחת שאילתה לגבי מכשירים

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

  adb devices -l
  

בתגובה, adb מדפיס את פרטי הסטטוס האלה לכל מכשיר:

• מספר סידורי: adb יוצר מחרוזת כדי לזהות את המכשיר באופן ייחודי לפי מספר היציאה שלו. דוגמה למספר סידורי: emulator-5554
• מצב: מצב החיבור של המכשיר יכול להיות אחד מהבאים:
  • offline: המכשיר לא מחובר ל-adb או שהוא לא מגיב.
  • device: המכשיר מחובר לשרת של adb. חשוב לזכור שהמצב הזה לא מעיד על כך שמערכת Android מופעלת באופן מלא, כי המכשיר מתחבר ל-adb בזמן שהמערכת עדיין מופעלת. זהו מצב התפעול הרגיל של המכשיר לאחר האתחול.
  • no device: אין מכשיר מחובר.
• תיאור: אם תכללו את האפשרות -l, הפקודה devices תציין את סוג המכשיר. המידע הזה שימושי כשיש כמה מכשירים מחוברים, כדי שתוכלו להבדיל ביניהם.

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

$ adb devices
List of devices attached
emulator-5556 device product:sdk_google_phone_x86_64 model:Android_SDK_built_for_x86_64 device:generic_x86_64
emulator-5554 device product:sdk_google_phone_x86 model:Android_SDK_built_for_x86 device:generic_x86
0a388e93      device usb:1-1 product:razor model:Nexus_7 device:flo

האמולטור לא מופיע ברשימה

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

• השרת adb לא פועל.
• משתמשים בפקודה emulator עם האפשרות -port או -ports עם ערך יציאה במספר אי-זוגי בין 5554 ל-5584.
• היציאה בעלת המספר הלא זוגי שבחרתם לא תפוסה, כך שניתן לבצע את חיבור היציאה במספר היציאה שצוין. אם היא תפוסה, הסימולטור עובר ליציאה אחרת שעומדת בדרישות שמפורטות בפסקה 2.
• מפעילים את השרת adb אחרי שמפעילים את הסימולטור.

אחת הדרכים למנוע את המצב הזה היא לתת לאמולטור לבחור יציאות משלו ולהפעיל עד 16 אמולטורים בו-זמנית. אפשרות אחרת היא תמיד להפעיל את השרת adb לפני שמשתמשים בפקודה emulator, כפי שמוסבר בדוגמאות הבאות.

דוגמה 1: בסדרת הפקודות הבאה, הפקודה adb devices מפעילה את השרת adb, אבל רשימת המכשירים לא מופיעה.

מפסיקים את השרת adb ומזינים את הפקודות הבאות בסדר המוצג. בשם ה-AVD, נותנים שם AVD חוקי מהמערכת. כדי לקבל רשימה של שמות AVD, מקלידים emulator -list-avds. הפקודה emulator נמצאת בספרייה android_sdk/tools.

$ adb kill-server
$ emulator -avd Nexus_6_API_25 -port 5555
$ adb devices

List of devices attached
* daemon not running. starting it now on port 5037 *
* daemon started successfully *

דוגמה 2: בסדרת הפקודות הבאה, adb devices מציגה את רשימת המכשירים כי שרת adb הופעל קודם.

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

$ adb kill-server
$ emulator -avd Nexus_6_API_25 -port 5557
$ adb start-server
$ adb devices

List of devices attached
emulator-5557 device

למידע נוסף על האפשרויות של שורת הפקודה באמולטור, ראו אפשרויות הפעלה של שורת הפקודה.

שליחת פקודות למכשיר ספציפי

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

1. משתמשים בפקודה devices כדי לקבל את המספר הסידורי של היעד.
2. אחרי שמוצאים את המספר הסידורי, משתמשים באפשרות -s עם הפקודות adb כדי לציין את המספר הסידורי.
   1. אם מריצים הרבה פקודות adb, אפשר להגדיר את משתנה הסביבה $ANDROID_SERIAL כך שיכלול את המספר הסידורי.
   2. אם משתמשים גם ב--s וגם ב-$ANDROID_SERIAL, -s מבטל את $ANDROID_SERIAL.

בדוגמה הבאה, מתקבלת רשימת המכשירים המחוברים, ואז המספר הסידורי של אחד מהמכשירים משמש להתקנת helloWorld.apk במכשיר הזה:

$ adb devices
List of devices attached
emulator-5554 device
emulator-5555 device
0.0.0.0:6520  device

# To install on emulator-5555
$ adb -s emulator-5555 install helloWorld.apk
# To install on 0.0.0.0:6520
$ adb -s 0.0.0.0:6520 install helloWorld.apk

הערה: אם נותנים פקודה בלי לציין מכשיר יעד כשיש כמה מכשירים זמינים, ב-adb תוצג השגיאה "adb: more than one device/emulator".

אם יש לכם כמה מכשירים זמינים, אבל רק אחד מהם הוא אמולטור, תוכלו להשתמש באפשרות -e כדי לשלוח פקודות לאמולטור. אם מחוברים כמה מכשירים אבל רק מכשיר חומרה אחד מחובר, אפשר להשתמש באפשרות -d כדי לשלוח פקודות למכשיר החומרה.

התקנת אפליקציה

אפשר להשתמש ב-adb כדי להתקין קובץ APK במה emultor או במכשיר מחובר באמצעות הפקודה install:

adb install path_to_apk

צריך להשתמש באפשרות -t עם הפקודה install כשמתקינים קובץ APK לבדיקה. למידע נוסף, ראו -t.

כדי להתקין כמה חבילות APK, משתמשים ב-install-multiple. האפשרות הזו שימושית אם מורידים מ-Play Console את כל קובצי ה-APK של האפליקציה למכשיר ספציפי, ואז רוצים להתקין אותם במהדמ או במכשיר פיזי.

למידע נוסף על יצירת קובץ APK שאפשר להתקין במכונה של אמולטור או מכשיר, ראו יצירה והפעלה של אפליקציה.

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

הגדרת העברה ליציאה אחרת

משתמשים בפקודה forward כדי להגדיר העברה שרירותית ליציאה אחרת, שמעבירה בקשות ביציאת מארח ספציפית ליציאה אחרת במכשיר. בדוגמה הבאה מגדירים העברה של יציאת המארח 6100 ליציאת המכשיר 7100:

adb forward tcp:6100 tcp:7100

בדוגמה הבאה מוגדרת העברה של יציאה 6100 למארח ל-local:logd:

adb forward tcp:6100 local:logd

האפשרות הזו שימושית אם רוצים לבדוק מה נשלח לשקע מסוים במכשיר. כל הנתונים שיתקבלו ייכתבו לדימון (daemon) לרישום המערכת ויוצגו ביומני המכשיר.

העתקת קבצים למכשיר וממנו

משתמשים בפקודות pull ו-push כדי להעתיק קבצים למכשיר וממנו. בניגוד לפקודה install, שמעתיקה רק קובץ APK למיקום ספציפי, הפקודות pull ו-push מאפשרות להעתיק ספריות וקבצים שרירותיים לכל מיקום במכשיר.

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

adb pull remote local

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

adb push local remote

מחליפים את local ו-remote בנתיב לקובץ או לתיקיית היעד במחשב הפיתוח (מקומי) ובמכשיר (מרחוק). לדוגמה:

adb push myfile.txt /sdcard/myfile.txt

עצירת שרת adb

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

כדי להפסיק את השרת adb, משתמשים בפקודה adb kill-server. לאחר מכן אפשר להפעיל מחדש את השרת באמצעות כל פקודת adb אחרת.

הפעלת פקודות adb

אפשר להריץ פקודות adb משורת הפקודה במכונה לפיתוח או מסקריפט באמצעות הפקודות הבאות:

adb [-d | -e | -s serial_number] command

אם פועל רק אמולטור אחד או שמחובר רק מכשיר אחד, הפקודה adb נשלחת למכשיר הזה כברירת מחדל. אם פועלים כמה מכשירי אמולציה ו/או מחוברים כמה מכשירים, צריך להשתמש באפשרות -d,‏ -e או -s כדי לציין את מכשיר היעד שאליו צריך לשלוח את הפקודה.

אפשר לראות רשימה מפורטת של כל הפקודות הנתמכות של adb באמצעות הפקודה הבאה:

adb --help

מתן פקודות מעטפת

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

adb [-d |-e | -s serial_number] shell shell_command

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

adb [-d | -e | -s serial_number] shell

כדי לצאת ממעטפת אינטראקטיבית, מקישים על Control+D או מקלידים exit.

ב-Android יש את רוב הכלים הרגילים של שורת הפקודה של Unix. כדי לקבל רשימה של הכלים הזמינים, משתמשים בפקודה הבאה:

adb shell ls /system/bin

אפשר לקבל עזרה לגבי רוב הפקודות באמצעות הארגומנט --help. רבות מפקודות המעטפת מסופקות על ידי toybox. עזרה כללית שחלה על כל הפקודות של תיבת הצעצועים זמינה באמצעות toybox --help.

ב-Android Platform Tools מגרסה 23 ואילך, הפקודה adb מטפלת בארגומנטים באותו אופן שבו הפקודה ssh(1) מטפלת בהם. השינוי הזה תיקן הרבה בעיות שקשורות להזרקת פקודות, ומאפשר להריץ בבטחה פקודות שמכילות מטא-תווים של מעטפת, כמו adb install Let\'sGo.apk. המשמעות של השינוי הזה היא שהפרשנות של כל פקודה שמכילה מטא-תווים במעטפת השתנתה גם היא.

לדוגמה, adb shell setprop key 'two words' היא עכשיו שגיאה, כי המעטפת המקומית 'לוקחת' את המירכאות, והמכשיר רואה adb shell setprop key two words. כדי שהפקודה תפעל, צריך להוסיף פעמיים מירכאות, פעם אחת למעטפת המקומית ופעם אחת למעטפת המרוחקת, כמו שצריך לעשות עם ssh(1). לדוגמה, adb shell setprop key "'two words'" פועל כי המעטפת המקומית מתייחסת לרמת הציטוט החיצונית והמכשיר עדיין רואה את הרמה הפנימית של הציטוט: setprop key 'two words'. אפשר גם להשתמש בהימלטות, אבל בדרך כלל קל יותר להוסיף ציטוט פעמיים.

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

מנהל פעילות השיחות

בתוך מעטפת adb, אפשר להשתמש בכלי של מנהל הפעילויות (am) כדי להוציא פקודות ולבצע פעולות שונות במערכת, כמו הפעלת פעילות, עצירת תהליך בכוח, שידור כוונה, שינוי מאפייני המסך של המכשיר ועוד.

במעטפת, התחביר של am הוא:

am command

אפשר גם להריץ פקודה של מנהל הפעילות ישירות מ-adb בלי להזין מעטפת מרוחקת. לדוגמה:

adb shell am start -a android.intent.action.VIEW

טבלה 1. הפקודות הזמינות לניהול הפעילויות

מפרט לארגומנטים של כוונות

בפקודות של מנהל הפעילות שמקבלות ארגומנט intent, אפשר לציין את Intent בעזרת האפשרויות הבאות:

מנהל חבילת שיחות (pm)

במעטפת של adb אפשר להנפיק פקודות לכלי מנהל החבילות (pm) כדי לבצע פעולות ושאילתות על חבילות האפליקציה שמותקנות במכשיר.

בתור מעטפת, התחביר של pm הוא:

pm command

אפשר גם להריץ פקודה של מנהל חבילות ישירות מ-adb בלי להיכנס למעטפת מרוחק. לדוגמה:

adb shell pm uninstall com.example.MyApp

טבלה 2. הפקודות הזמינות של מנהל החבילות

קריאה למנהל מדיניות המכשיר (dpm)

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

בתור מעטפת, התחביר של dpm הוא:

dpm command

אפשר גם להפעיל פקודה של מנהל מדיניות המכשיר ישירות מ-adb בלי להיכנס למעטפת מרחוק:

adb shell dpm command

טבלה 3 הפקודות הזמינות של מנהל מדיניות המכשיר

יצירת צילום מסך

הפקודה screencap היא תוכנית מעטפת לצילום מסך של מסך המכשיר.

בתור מעטפת, התחביר של screencap הוא:

screencap filename

כדי להשתמש ב-screencap משורת הפקודה, מזינים את הפקודה הבאה:

adb shell screencap /sdcard/screen.png

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

$ adb shell
shell@ $ screencap /sdcard/screen.png
shell@ $ exit
$ adb pull /sdcard/screen.png

הקלט סרטון

הפקודה screenrecord היא תוכנית מעטפת לתיעוד המסך של מכשירים שפועלת בהם מערכת Android בגרסה 4.4 (רמת API 19) ואילך. הכלי מתעד את פעילות המסך בקובץ MPEG-4. אפשר להשתמש בקובץ הזה כדי ליצור סרטונים של קידום מכירות או הדרכה, או לצורך ניפוי באגים ובדיקות.

במעטפת, משתמשים בתחביר הבא:

screenrecord [options] filename

כדי להשתמש ב-screenrecord משורת הפקודה, מזינים את הפקודה הבאה:

adb shell screenrecord /sdcard/demo.mp4

כדי להפסיק את הקלטת המסך, מקישים על Control+C. אחרת, ההקלטה תיפסק אוטומטית אחרי שלוש דקות או מגבלת הזמן שהוגדרה על ידי --time-limit.

כדי להתחיל להקליט את מסך המכשיר, מריצים את הפקודה screenrecord כדי להקליט את הסרטון. לאחר מכן, מריצים את הפקודה pull כדי להוריד את הסרטון מהמכשיר למחשב המארח. דוגמה לסשן הקלטה:

$ adb shell
shell@ $ screenrecord --verbose /sdcard/demo.mp4
(press Control + C to stop)
shell@ $ exit
$ adb pull /sdcard/demo.mp4

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

מגבלות של השירות screenrecord:

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

טבלה 4. אפשרויות של screenrecord

screenrecord --bit-rate 6000000 /sdcard/demo.mp4

קריאת פרופילי ART של אפליקציות

החל מגרסה 7.0 של Android‏ (רמת API 24), סביבת זמן הריצה של Android‏ (ART) אוספת פרופילי ביצוע של אפליקציות מותקנות, שמשמשים לאופטימיזציה של ביצועי האפליקציות. בודקים את הפרופילים שנאספו כדי להבין אילו שיטות מתבצעות בתדירות גבוהה ואילו כיתות נמצאות בשימוש במהלך הפעלת האפליקציה.

הערה: אפשר לאחזר את שם הקובץ של פרופיל הביצוע רק אם יש גישה לרמה הבסיסית (root) למערכת הקבצים, למשל באמצעות אמולטור.

כדי ליצור טקסט של פרטי הפרופיל, משתמשים בפקודה הבאה:

adb shell cmd package dump-profiles package

כדי לאחזר את הקובץ שנוצר, משתמשים ב-:

adb pull /data/misc/profman/package.prof.txt

איפוס מכשירים לבדיקה

אם אתם בודקים את האפליקציה במספר מכשירי בדיקה, כדאי לאפס את המכשיר בין הבדיקות. לדוגמה, כדי להסיר את נתוני המשתמשים ולאפס את סביבת הבדיקה. אפשר לבצע איפוס להגדרות המקוריות של מכשיר בדיקה שבו פועלת גרסת Android 10 (רמת API 29) ואילך באמצעות הפקודה testharness adb, כפי שמתואר בהמשך:

adb shell cmd testharness enable

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

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

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

אם האפליקציה צריכה לזהות ולהתאים את הגדרות ברירת המחדל של הפקודה testharness, משתמשים בפקודה ActivityManager.isRunningInUserTestHarness().

sqlite

sqlite3 מפעיל את תוכנית שורת הפקודה sqlite לבדיקה של מסדי נתונים של SQLite. הוא כולל פקודות כמו .dump כדי להדפיס את התוכן של טבלה, ו-.schema כדי להדפיס את ההצהרה SQL CREATE לטבלה קיימת. אפשר גם להריץ פקודות SQLite משורת הפקודה, כפי שמוצג:

$ adb -s emulator-5554 shell
$ sqlite3 /data/data/com.example.app/databases/rssitems.db
SQLite version 3.3.12
Enter ".help" for instructions

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

מידע נוסף זמין במסמכי התיעוד של שורת הפקודה sqlite3.

קצות עורפי של adb USB

שרת ה-adb יכול לקיים אינטראקציה עם מקבץ ה-USB דרך שני קצוות עורפיים. הוא יכול להשתמש בקצה העורפי המקורי של מערכת ההפעלה (Windows,‏ Linux או macOS) או בקצה העורפי של libusb. תכונות מסוימות, כמו attach,‏ detach וזיהוי מהירות USB, זמינות רק כשמשתמשים בקצה העורפי של libusb.

אפשר לבחור קצה עורפי באמצעות משתנה הסביבה ADB_LIBUSB. אם לא מגדירים אותו, adb משתמש בקצה העורפי שמוגדר כברירת מחדל. התנהגות ברירת המחדל משתנה בהתאם למערכת ההפעלה. החל מ-ADB v34, הקצה העורפי liubusb משמש כברירת מחדל בכל מערכות ההפעלה, מלבד Windows, שבה הקצה העורפי המקורי משמש כברירת מחדל. אם הערך של ADB_LIBUSB מוגדר, הוא קובע אם נעשה שימוש בקצה העורפי המקורי או ב-libusb. מידע נוסף על משתני הסביבה של adb זמין בדף המדריך של adb.

קצוות עורפי של mDNS ב-adb

ADB יכול להשתמש בפרוטוקול ה-DNS של ה-multicast כדי לחבר באופן אוטומטי את השרת ואת המכשירים. שרת ה-ADB נשלח עם שני קצוות עורפיים, Bonjour (mdnsResponseer של Apple) ו-Openscreen.

כדי להפעיל את הקצה העורפי של Bonjour, צריך להפעיל דימון במכונה המארחת. ב-macOS, הדימון המובנה של Apple תמיד פועל, אבל ב-Windows וב-Linux, המשתמש צריך לוודא שהדימון mdnsd פועל. אם הפקודה adb mdns check מחזירה שגיאה, סביר להניח ש-ADB משתמש בקצה העורפי של Bonjour אבל אין דימון Bonjour שפועל.

לקצה העורפי של Openscreen לא נדרש דימון (daemon) שפועל במכונה. התמיכה בקצה העורפי Openscreen ב-macOS מתחילה ב-ADB v35. החל מגרסה 34 של ADB, יש תמיכה ב-Windows וב-Linux.

כברירת מחדל, ADB משתמש בקצה העורפי של Bonjour. אפשר לשנות את ההתנהגות הזו באמצעות משתנה הסביבה ADB_MDNS_OPENSCREEN (מוגדרת ל-1 או ל-0). פרטים נוספים זמינים בדף המדריך של ADB.