שליחת פקודות במסוף האמולטור

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

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

התחלה ועצירה של סשן במסוף

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

כדי להתחבר למסוף של מכשיר וירטואלי פועל:

  1. פותחים את חלון הטרמינל ומזינים את הפקודה הבאה:

    telnet localhost console-port
    

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

    הערה: האמולטור מאזין לחיבורים ביציאות 5554 עד 5585 ומקבל חיבורים רק מ-localhost.

  2. אחרי שמוצג OK במסוף, מזינים את הפקודה auth auth_token.

    כדי להזין פקודות במסוף, צריך לבצע אימות במסוף האמולטור. הערך של auth_token צריך להיות זהה לתוכן של הקובץ .emulator_console_auth_token בספריית הבית.

    אם הקובץ הזה לא קיים, הפקודה telnet localhost console-port יוצרת את הקובץ, שמכיל אסימון אימות שנוצר באופן אקראי. כדי להשבית את האימות, מוחקים את האסימון מהקובץ .emulator_console_auth_token או יוצרים קובץ ריק אם הוא לא קיים.

  3. אחרי שמתחברים למסוף, מזינים פקודות מסוף.

    כדי לראות רשימה של פקודות במסוף ולקבל מידע על פקודות ספציפיות, מזינים help, ‏help command או help-verbose.

  4. כדי לצאת מהסשן במסוף, מזינים quit או exit.

הנה דוגמה לסשן:

$ telnet localhost 5554
Trying ::1...
telnet: connect to address ::1: Connection refused
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
Android Console: Authentication required
Android Console: type 'auth <auth_token>' to authenticate
Android Console: you can find your <auth_token> in
'/Users/me/.emulator_console_auth_token'
OK
auth 123456789ABCdefZ
Android Console: type 'help' for a list of commands
OK
help-verbose
Android console command help:
    help|h|?         Prints a list of commands
    help-verbose     Prints a list of commands with descriptions
    ping             Checks if the emulator is alive
    automation       Manages emulator automation
    event            Simulates hardware events
    geo              Geo-location commands
    gsm              GSM related commands
    cdma             CDMA related commands
    crash            Crashes the emulator instance
    crash-on-exit    Simulates crash on exit for the emulator instance
    kill             Terminates the emulator instance
    restart          Restarts the emulator instance
    network          Manages network settings  (ethernet and cellular only)
    power            Power related commands
    quit|exit        Quits control session
    redir            Manages port redirections
    sms              SMS related commands
    avd              Controls virtual device execution
    qemu             QEMU-specific commands
    sensor           Manages emulator sensors
    physics          Manages physical model
    finger           Manages emulator finger print
    debug            Controls the emulator debug output tags
    rotate           Rotates the screen clockwise by 90 degrees
    screenrecord     Records the emulator's display
    fold             Folds the device
    unfold           Unfolds the device
    multidisplay     Configures the multi-display
    nodraw           turn on/off NoDraw mode. (experimental)
    resize-display   resize the display resolution to the preset size
    virtualscene-image  customize virtualscene image for virtulscene camera
    proxy            manage network proxy server settings
    phonenumber      set phone number for the device

try 'help <command>' for command-specific help
OK
exit
Connection closed by foreign host.

פקודות "שגר ושכח"

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

adb emu command commandParameter

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

adb -s emulator-serial emu command commandParameter

הפניה לפקודות של האמולטור

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

פקודות כלליות

  • avd {stop| start| status| name} מבצע שאילתות, שולט ומנהל את המכשיר הווירטואלי, באופן הבא:

    • ‫stop: הפסקת הפעולה של המכשיר.
    • ‫start: הפעלת המכשיר.
    • ‫status: שאילתה על סטטוס המכשיר הווירטואלי, שיכול להיות פועל או מושבת.
    • ‫name: שאילתה לגבי שם המכשיר הווירטואלי.
  • ‫avd snapshot {list| save name| load name| delete name} שומר ומשחזר את מצב המכשיר בתמונות מצב, באופן הבא:

    • ‫list: הצגת רשימה של כל קובצי ה-snapshot השמורים.
    • ‫save name: שמירת תמונת המצב בשם.
    • ‫load name: טעינת תמונת המצב שצוינה.
    • ‫delete name: מחיקת קובץ ה-snapshot שצוין.

    בדוגמה הבאה נשמרת תמונת מצב בשם firstactivitysnapshot:

    avd snapshot save firstactivitysnapshot
    
  • ‫fold: מקפל את המכשיר כדי להציג את תצורת המסך הקטן יותר, אם המכשיר מתקפל ופתוח כרגע.

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

  • ‫kill: סוגר את המכשיר הווירטואלי.

  • ‫ping: בודקת אם המכשיר הווירטואלי פועל.

  • ‫rotate: מסובב את ה-AVD נגד כיוון השעון במרווחים של 45 מעלות.

השבתת האמולטור

  • ‫crash: קריסה של האמולטור בזמן הפעלת האפליקציה.

  • ‫crash-on-exit: האמולטור קורס כשהאפליקציה נסגרת.

תגים לניפוי באגים

  • ‫debug tags ...: הפעלה או השבתה של הודעות ניפוי באגים מחלקים ספציפיים של האמולטור. הפרמטר tags חייב להיות ערך מרשימת תגי ניפוי הבאגים שמופיעה כשמריצים את emulator -help-debug-tags. מידע נוסף על האפשרות -help-debug-tags מופיע בטבלה של האפשרויות הנפוצות. בדוגמה הבאה מופעל תג הרדיו:

    debug radio
    

הפניה אוטומטית של יציאה

  • ‫redir list: הצגת רשימה של הפניות היציאות הנוכחיות.

  • redir add protocol:host-port:guest-port הוספת הפניית יציאה חדשה, באופן הבא:

    • ‫protocol: הערך חייב להיות tcp או udp.
    • ‫host-port: מספר היציאה שצריך לפתוח במארח.
    • ‫guest-port: מספר היציאה שאליה הנתונים ינותבו באמולטור.
  • redir del protocol:host-port מחיקת הפניית יציאה.

    • ‫protocol: הערך חייב להיות tcp או udp.
    • ‫host-port: מספר היציאה שצריך לפתוח במארח.

מיקום גיאוגרפי

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

אפשר להפעיל את אחת מהפקודות הבאות למיקום גיאוגרפי ברגע שהמכשיר הווירטואלי פועל. האמולטור מגדיר את המיקום שהזנתם על ידי יצירת ספק הדמיית מיקום. הספק הזה מגיב למאזיני מיקום שמוגדרים על ידי אפליקציות ומספק את המיקום ל-LocationManager. כל אפליקציה יכולה לשלוח שאילתה למנהל המיקום כדי לקבל את תיקון ה-GPS הנוכחי של המכשיר המדומה, באמצעות קריאה ל-LocationManager.getLastKnownLocation("gps").

  • ‫geo fix longitude latitude [altitude] [satellites] [velocity]: שליחת תיקון GPS לאמולטור. מציינים את קו האורך וקו הרוחב במעלות עשרוניות. צריך להשתמש במספר מ-1 עד 12 כדי לציין את מספר הלוויינים שבהם יש להשתמש כדי לקבוע את המיקום, ולציין את הגובה במטרים ואת המהירות בקשרים.

  • ‫geo nmea sentence: שליחת משפט NMEA 0183 למכשיר המדומה כאילו הוא נשלח ממודם GPS מדומה. המשפט צריך להתחיל ב-"‎$GP". כרגע יש תמיכה רק במשפטים "$GPGGA" ו-"$GPRCM". הדוגמה הבאה היא משפט GPGGA (נתוני תיקון של מערכת מיקום גלובלית) שמקבל את נתוני הזמן, המיקום והתיקון של מקלט GPS:

    geo nmea $GPGGA,hhmmss.ss,llll.ll,a,yyyyy.yy,a,x,xx,x.x,x.x,M,x.x,M,x.x,xxxx
    

אירועי חומרה מדומים

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

  • ‫event types: הצגת רשימה של כל סוגי האירועים המזויפים. באירועים שיש להם קודים, מספר הקודים מופיע בסוגריים בצד שמאל. פלט לדוגמה:

    event types
    event <type> can be an integer or one of the following aliases:
        EV_SYN
        EV_KEY    (405 code aliases)
        EV_REL    (2 code aliases)
        EV_ABS    (27 code aliases)
        EV_MSC
        EV_SW     (4 code aliases)
        EV_LED
        EV_SND
        EV_REP
        EV_FF
        EV_PWR
        EV_FF_STATUS
        EV_MAX
    OK
    
  • ‫event send types [types ...]: שליחת סוג אחד או יותר של אירועים מזויפים.

  • ‫event codes type: רשימה של קודי האירועים לסוג האירוע המזויף שצוין.

  • ‫event send type[:code]:[value] [...]: שליחת אירוע מזויף אחד או יותר עם קודים וערכי קוד אופציונליים.

‫EV_KEY — הפניות לקודי מקשים

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

טבלת משנה א': מפתחות של מערכת Android
קוד תיאור
KEY_HOME הפעלה באמצעות כפתור הבית
KEY_BACK טריגר של הכפתור "הקודם"
KEY_MENU כפתור התפריט (אפשרויות נוספות)
KEY_POWER כפתור ההפעלה (לחיצה/לחיצה ארוכה)
KEY_VOLUMEUP הפעלה באמצעות הכפתור להגברת עוצמת הקול
KEY_VOLUMEDOWN הפעלה באמצעות הכפתור להחלשת עוצמת הקול
KEY_CAMERA כפתור הצילום הפיזי של המצלמה
KEY_FOCUS כפתור הצילום עם פוקוס אוטומטי
KEY_SEARCH טריגר של כפתור החיפוש
KEY_SLEEP טריגר לפקודת שינה
KEY_WAKEUP טריגר לפקודת יציאה ממצב שינה
KEY_NOTIFICATION פתיחת חלונית ההתראות
KEY_MUTE השתקת פלט האודיו של המערכת
KEY_MICMUTE השתקת הקלט של המיקרופון
KEY_BRIGHTNESSDOWN הפחתת הבהירות במסך
KEY_BRIGHTNESSUP הגברת הבהירות במסך
KEY_PHONE פתיחת אפליקציית החייגן שמוגדרת כברירת מחדל
KEY_SEND שליחה או התחלה של שיחת טלפון
KEY_HEADSETHOOK כפתור באוזניות (מענה/ניתוק)
KEY_SCREEN הפקודה להפעלת שומר המסך
KEY_CONFIG תפריט מערכת ההגדרות האישיות
KEY_SWITCHVIDEOMODE החלפת מצב הווידאו של המערכת
KEY_KBDILLUMTOGGLE הפעלה או כיבוי של התאורה האחורית במקלדת
טבלת משנה ב': מדיה ורכיבי UI להפעלה
קוד תיאור
KEY_PLAYPAUSE החלפת מצב בין הפעלה והשהיה
KEY_PLAY התחלת הפעלת מדיה
KEY_PAUSECD השהיית ההפעלה של התקליטור
KEY_STOPCD הפסקת ההפעלה של ה-CD
KEY_NEXTSONG דילוג לטראק הבא
KEY_PREVIOUSSONG דילוג לטראק הקודם
KEY_REWIND הרצה אחורה של הטראק הפעיל
KEY_FASTFORWARD הרצה קדימה של הטראק הפעיל
KEY_RECORD פקודת טריגר להקלטה
KEY_SHUFFLE הפעלה או השבתה של הפעלה אקראית
KEY_REPEAT הפעלה או השבתה של הפעלה חוזרת
KEY_MEDIA טריגר של מקש מדיה
טבלת משנה ג': מקלדות ניווט ומקלדות כלליות
קוד תיאור
KEY_UP החץ למעלה בכפתורי החיצים (D-pad)
KEY_DOWN כפתור החץ למטה בכפתורי החיצים (D-pad)
KEY_LEFT החץ שמאלה בכפתורי החיצים (D-pad)
KEY_RIGHT כפתור החץ ימינה בכפתורי החיצים (D-pad)
KEY_PAGEUP ניווט למעלה בדף
KEY_PAGEDOWN ניווט למטה בדף
KEY_INSERT הוספת טריגר של מקש
KEY_DELETE טריגר למחיקת מפתח
KEY_ENTER טריגר של מקש Enter
KEY_ESC טריגר של מקש Escape
KEY_TAB טריגר של מקש Tab
KEY_SPACE טריגר של מקש הרווח
KEY_BACKSPACE טריגר של מקש Backspace
KEY_CLEAR ניקוי מאגר הקלט
KEY_CANCEL ביטול הפעולה הפעילה
KEY_OK אישור הבחירה
KEY_SELECT בחירת טריגר לפריט
KEY_GOTO הולכים למקום שנקבע.
KEY_HELP גישה לתוכן עזרה
טבלת משנה ד': תווים אלפאנומריים וסמלים בלוח המקשים
  • אותיות רגילות: KEY_A עד KEY_Z (26 קודים).
  • מקשים בלוח המקשים הנומרי: KEY_1 עד KEY_0 (10 קודים).
קוד סמל של דמות
KEY_COMMA ,
KEY_DOT .
KEY_SLASH /
KEY_SEMICOLON ;
KEY_APOSTROPHE '
KEY_GRAVE \`
KEY_MINUS -
KEY_EQUAL =
KEY_LEFTBRACE [
KEY_RIGHTBRACE ]
KEY_BACKSLASH \
KEY_KPASTERISK * (לוח מקשים נומרי)
KEY_KPPLUS + (לוח מקשים נומרי)
KEY_KPMINUS - (לוח מקשים נומרי)
KEY_KPDOT . (לוח מקשים נומרי)
KEY_KPSLASH / (לוח מקשים נומרי)
KEY_KPENTER ‫Enter (לוח מקשים נומרי)
KEY_KPEQUAL = (לוח מקשים נומרי)
KEY_KPCOMMA , (לוח מקשים נומרי)
KEY_KPJPCOMMA , (פריסה יפנית)
KEY_KPLEFTPAREN ( (לוח מקשים נומרי)
KEY_KPRIGHTPAREN ) (לוח מקשים נומרי)
KEY_KPPLUSMINUS ± (לוח מקשים נומרי)
טבלת משנה ה': מקשי צירוף ומקשי פונקציות
  • מקשי פונקציות רגילים: KEY_F1 עד KEY_F24 (24 קודים).
קוד תיאור
KEY_LEFTSHIFT מקש Shift שמאלי לשינוי מקשים במקלדת
KEY_RIGHTSHIFT מקש Shift ימני לשינוי מצב המקלדת
KEY_LEFTCTRL מקש Control שמאלי לשינוי מקלדת
KEY_RIGHTCTRL מקש הצירוף Control הימני במקלדת
KEY_LEFTALT מקש Alt שמאלי לשינוי מקלדת
KEY_RIGHTALT מקש הצירוף Alt הימני במקלדת
KEY_LEFTMETA מקש Meta/Command שמאלי
KEY_RIGHTMETA מקש Meta/Command ימני
KEY_CAPSLOCK הפעלה או כיבוי של Caps Lock במקלדת
KEY_NUMLOCK החלפת מצב המקלדת באמצעות Num Lock
KEY_SCROLLLOCK הפעלה או השבתה של מקש Scroll Lock במקלדת
KEY_COMPOSE עוזר לכתיבת תווים
KEY_FN מקש FN במקלדת פיזית
KEY_FN_ESC שילובי מקשי פונקציות
KEY_FN_1 מקש קיצור לפונקציה מיוחדת 1
KEY_FN_2 מקש קיצור לפונקציה מיוחדת 2
KEY_FN_D מקש קיצור לפונקציה מיוחדת D
KEY_FN_E מקש קיצור לפונקציה מיוחדת E
KEY_FN_F מקש קיצור לפונקציה מיוחדת F
KEY_FN_S מקש קיצור לפונקציה מיוחדת S
KEY_FN_B מקש קיצור לפונקציה מיוחדת ב'
טבלת משנה ו': שלטי משחק וג'ויסטיקים
קוד תיאור
BTN_A / BTN_B / BTN_C כפתורי A/B/C בשלט
BTN_X / BTN_Y / BTN_Z כפתורי הפנים של הבקר X/Y/Z
BTN_START כפתור תפריט ההתחלה בשלט המשחק
BTN_SELECT כפתור הבחירה בשלט המשחק
BTN_MODE מתג למצב בקר
BTN_TL / BTN_TR כפתורי הכתף השמאליים והימניים
BTN_TL2 / BTN_TR2 טריגרים אנלוגיים שמאלה/ימינה
BTN_THUMBL / BTN_THUMBR לחיצה על הסטיק השמאלי או הימני
BTN_DPAD_UP טריגר של כפתור החיצים (D-pad) למעלה בשלט המשחק
BTN_DPAD_DOWN טריגר של כפתורי החיצים (D-pad) למטה בשלט המשחק
BTN_DPAD_LEFT כפתורי החיצים (D-pad) בשלט המשחק, כפתור LT
BTN_DPAD_RIGHT הדק ימני בכפתורי החיצים (D-pad) של שלט המשחק
BTN_THUMB הפעלה עם האגודל הראשי בג'ויסטיק
BTN_TOP / BTN_TOP2 הכפתורים העליונים בג'ויסטיק
BTN_PINKIE טריגרים של כפתור הזרת בג'ויסטיק
BTN_BASE עד _BASE6 כפתורים בבסיס הג'ויסטיק
BTN_DEAD סימון של אזור מת לא פעיל בשלט המשחק
BTN_TRIGGER טריגר ידני של ג'ויסטיק פיזי
BTN_JOYSTICK קוד קלט של ג'ויסטיק גנרי
טבלת משנה ז': קלט מעכבר, ממגע ומסטיילוס
קוד תיאור
BTN_MOUSE אירוע גנרי של סמן העכבר
BTN_LEFT לחיצה על הכפתור השמאלי בעכבר
BTN_RIGHT לחיצה על הכפתור הימני בעכבר
BTN_MIDDLE לחיצה על גלגל הגלילה האמצעי
BTN_SIDE טריגר של מקש צדדי לניווט
BTN_EXTRA טריגר של כפתור עכבר נוסף
BTN_FORWARD קליק על כפתור "הבא" בדפדפן
BTN_BACK לחיצה על כפתור החזרה בדפדפן
BTN_TASK מקש למעבר בין משימות במערכת
BTN_TOUCH זוהה מגע פיזי במסך
BTN_STYLUS קרבה של עט סטיילוס פעיל
BTN_STYLUS2 מתג משני בסטיילוס
BTN_TOOL_PEN מזהה כלי של עט סטיילוס
BTN_TOOL_RUBBER מזהה כלי המחיקה של הסטיילוס
BTN_TOOL_BRUSH מזהה כלי המברשת של הצייר
BTN_TOOL_PENCIL מזהה כלי העיפרון לשרטוט
BTN_TOOL_AIRBRUSH מזהה כלי הצביעה איירבראש
BTN_TOOL_FINGER מגע של האצבע במסך המגע
BTN_TOOL_MOUSE מזהה כלי העכבר החיצוני
BTN_TOOL_LENS כלי זכוכית מגדלת אופטית
BTN_TOOL_DOUBLETAP דגל מהירות הלחיצה הכפולה בתנועה
BTN_TOOL_TRIPLETAP סימון מהירות הלחיצה המשולשת בתנועה
טבלת משנה ח': קיצורי דרך של אפליקציות
קוד הפעולה שמוגדרת כיעד
KEY_WWW הפעלת דפדפן האינטרנט שמוגדר כברירת מחדל
KEY_MAIL פתיחת תוכנת האימייל שמוגדרת כברירת מחדל
KEY_BOOKMARKS פתיחת רשימת הסימניות בדפדפן
KEY_CALC פתיחת כלי המחשבון
KEY_FILE פתיחת סייר הקבצים המקומיים
KEY_EDIT טריגר לעריכת מסמך
KEY_NEW טריגר חדש ליצירת מסמך
KEY_OPEN טריגר לפתיחת מסמך
KEY_SAVE טריגר למשימה של שמירת קובץ
KEY_CLOSE טריגר לסגירת משימה בקובץ
KEY_PRINT טריגר למשימת הדפסת קובץ
KEY_COPY פעולת העתקה של מאגר הנתונים הזמני בלוח
KEY_PASTE פעולת הוספה של מאגר הנתונים הזמני בלוח
KEY_CUT פעולת גזירה של מאגר הנתונים הזמני בלוח
KEY_UNDO פעולת ביטול של מאגר הנתונים הזמני בלוח
KEY_REDO פעולת ביצוע מחדש של מאגר הנתונים הזמני של הלוח
KEY_CANCEL טריגר לתהליך ביטול המאגר
KEY_FIND כלי לחיפוש מסמכים
KEY_REFRESH כלי לרענון מסמכים
KEY_EXIT כלי לסגירת מסמכים
KEY_DOCUMENTS פתיחת פורטל המסמכים של המערכת
KEY_HOMEPAGE הפעלת דף הבית של הדפדפן
KEY_FAVORITES פתיחת פורטל המועדפים בדפדפן
KEY_CHAT פתיחת אפליקציה להעברת הודעות מיידיות
KEY_EMAIL טריגר להשקת כתובת אימייל חלופית
KEY_FINANCE פתיחת כלי המניות/הפיננסים
KEY_SPORT פתיחת הכלי למעקב אחרי ספורט
KEY_SHOP פתיחת פורטל הקניות הדיגיטלי
KEY_PLAYER פתיחת נגן המדיה הראשי
KEY_MP3 פתיחת נגן ה-MP3 הראשי
KEY_TEXT פתיחת הכלי לעריכת טקסט שמוגדר כברירת מחדל
KEY_LIST פתיחת הכלי של רשימת המשימות
KEY_MEMO פתיחת פנקס רשימות / כלי תזכורות
KEY_CALENDAR פתיחת פורטל היומן או סדר היום
KEY_DIRECTORY פתיחת ספריית הכתובות של המערכת
KEY_COMPUTER פתיחת סייר המפרטים
KEY_TV / KEY_TV2 הפעלת פורטל הטלוויזיה
KEY_RADIO הפעלת כלי הרדיו
KEY_CD / KEY_DVD הפעלת קורא כונן אופטי
KEY_AUDIO / KEY_VIDEO גישה למפרטי מדיה
KEY_TUNER הגדרת מקלטים/טיונרים
KEY_SAT / KEY_SAT2 הגדרת פידים של לוויינים
KEY_TAPE טייפ להפעלת קלטות
KEY_VCR הפעלת הפיד של נגן הווידאו
KEY_VCR2 הפעלת הפיד של נגן VCR 2
KEY_AUX קלט ליציאות מדיה נוספות
KEY_SETUP תפריט הגדרת התצורה
KEY_PROG1 עד _PROG4 מקשי תוכנה מוגדרים על ידי המשתמש
KEY_ZOOM שינוי מרחק התצוגה
KEY_MODE בחירת מצב אזור התצוגה
KEY_KEYBOARD הצגה או הסתרה של המקלדת הווירטואלית
KEY_LANGUAGE החלפת השפה של טראק האודיו
KEY_TITLE פתיחת האפשרויות של שם המדיה
KEY_SUBTITLE הצגה או הסתרה של ממשק הכתוביות
KEY_ANGLE שינוי זוויות המצלמה בסרטון
KEY_EPG פתיחת מדריך התוכניות האלקטרוני
KEY_PVR פתיחת מקליט הווידאו האישי
KEY_MHP פתיחת פלטפורמת המולטימדיה הביתית
KEY_CHANNEL פתיחת ערוצים של טיונר לטלוויזיה
KEY_CHANNELUP העברת ערוץ הטלוויזיה למעלה
KEY_CHANNELDOWN העברת ערוץ טלוויזיה למטה
KEY_RED כפתור אינטראקטיבי אדום
KEY_GREEN כפתור אינטראקטיבי ירוק
KEY_YELLOW כפתור אינטראקטיבי צהוב
KEY_BLUE כפתור אינטראקטיבי כחול
KEY_FIRST בחירת האפשרות של הפריט הראשון
KEY_LAST בחירת האפשרות של הפריט האחרון
KEY_NEXT בחירת האפשרות של הטראק הבא
KEY_PREVIOUS בחירת האפשרות של הטראק הקודם
KEY_RESTART הפעלה מחדש של הלולאה של טראק המדיה
KEY_SLOW אפשרות להפעלה בהילוך איטי
KEY_AB לולאה של רצף חזרות A-B
KEY_PLAYCD פקודת הפעלה של נגן תקליטורים
KEY_PAUSECD פקודת השהיה של נגן תקליטורים
KEY_STOPCD פקודת עצירה של נגן תקליטורים
KEY_DIGITS פקודת כניסה באמצעות לוח מקשים דיגיטלי
KEY_TEEN אפשרות לערכי בני נוער בלוח המקשים
KEY_TWEN אפשרות לערכי לוח חיוג של 20
KEY_DEL_EOL מחיקה עד לסוף מאגר השורות
KEY_DEL_EOS מחיקה עד לסוף מאגר הנתונים של המסך
KEY_INS_LINE הוספת מאגר נתונים זמני של שורה חדשה
KEY_BRL_DOT1 עד _DOT8 קלט מהכפתורים של צג הברייל
KEY_VOICECOMMAND הפעלת אפליקציית העוזר הקולי
KEY_SELECTIVE_SCREEN הפעלת חיתוך אזורי של המסך
KEY_BATTERY התראות על מצב הסוללה של השאילתות
KEY_STAR / KEY_SHARP סמלים בלוח החיוג של הטלפון
KEY_PLUS סמל הפלוס בלוח החיוג של הטלפון
KEY_INFO הצגת שכבת-העל של חלונית המידע
KEY_TIME הצגת השעה הנוכחית
KEY_VENDOR מפרטים של ספקי שאילתות
KEY_ARCHIVE פתיחת כלי הארכיון המקומי
KEY_PROGRAM הגדרת הפרמטרים של התוכנית
KEY_POWER2 מפעיל גיבוי חשמל חלופי

EV_ABS — אירועי תנועה מוחלטת

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

קוד טווח הקואורדינטות תיאור
ABS_MT_TRACKING_ID -1 או ≥0 מזהה לצורכי מעקב; -1 מסתיים במגע
ABS_MT_POSITION_X 0 עד 1767 קואורדינטת X‏ (Pixel Fold)
ABS_MT_POSITION_Y 0 עד 2207 קואורדינטת Y (ב-Pixel Fold)
ABS_MT_TOUCH_MAJOR פיקסלים רוחב הציר הראשי של אזור המגע
ABS_MT_TOUCH_MINOR פיקסלים רוחב הציר המשני של אזור המגע
ABS_MT_WIDTH_MAJOR פיקסלים רוחב הציר הראשי של הכלי
ABS_MT_WIDTH_MINOR פיקסלים רוחב הציר המשני של הכלי
ABS_MT_ORIENTATION 0 עד 255 זווית הכיוון של המגע
ABS_MT_PRESSURE 0 עד 255 עוצמת הכוח של המגע
ABS_MT_DISTANCE מ"מ מרחק הריחוף מהמסך
ABS_MT_TOOL_TYPE 0 עד 2 ‫0=אצבע, 1=עט, 2=עיפרון
ABS_MT_BLOB_ID מספר שלם מזהה ה-blob של איש הקשר
ABS_MT_TOOL_X פיקסלים קואורדינטת מיקום X של הכלי
ABS_MT_TOOL_Y פיקסלים קואורדינטת המיקום של הכלי על ציר ה-Y
ABS_MT_SLOT 0 עד N משבצת פעילה (פרוטוקול ב')
ABS_X / _Y / _Z אנלוגי צירי הקואורדינטות של הג'ויסטיק
ABS_RX / _RY / _RZ אנלוגי צירי סיבוב של ג'ויסטיק
ABS_THROTTLE / _BRAKE אנלוגי דוושות ואמצעי בקרה להיגוי
ABS_HAT0X / _HAT0Y -1 / 0 / 1 כפתורי החיצים (D-pad) ומתגי POV
ABS_PRESSURE 0 עד 255 רמת הלחץ של הסטיילוס או המצביע
ABS_DISTANCE מ"מ מרחק ריחוף (עט סטיילוס)
ABS_TILT_X / _TILT_Y מעלות זוויות הנטייה של הסטיילוס
ABS_VOLUME אנלוגי עוצמת הקול של השלט

אינטראקציית המגע ב-Android מופעלת על ידי פרוטוקולים של ריבוי מגע (MT). אמולטורים מודרניים מיישמים גם את פרוטוקול א' (בלי שמירת מצב, שליחת חבילות של נקודות מגע שמופרדות על ידי סימני סנכרון) וגם את פרוטוקול ב' (עם שמירת מצב, הקצאת נקודות מגע למשבצות מעקב ייעודיות). פרוטוקול B מאפשר מעקב יעיל אחרי כמה נגיעות בו-זמנית לתנועות כמו פתיחת או סגירת אצבעות לשינוי מרחק התצוגה.

‫EV_REL ו-EV_SW – מתגי תנועה וחומרה

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

קוד ערכים תיאור
REL_X דלתה תנועה אופקית של הסמן
REL_Y דלתה תנועה אנכית של הסמן
SW_LID 0/1 סטטוס המכסה של המחשב הנייד (0=פתוח, 1=סגור)
SW_TABLET_MODE 0/1 סטטוס מצב טאבלט (0=מושבת, 1=פעיל)
SW_HEADPHONE_INSERT 0/1 סטטוס שקע האוזניות (0=מנותק, 1=מחובר)
SW_MICROPHONE_INSERT 0/1 סטטוס שקע המיקרופון (0=בחוץ, 1=בפנים)
תחביר של שליחת פקודות

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

דוגמאות לסקריפטים של אירועים ותנועות

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

הדמיה של נגיעה במסך

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

# Press down at coordinate (400, 800) and sync
event send EV_ABS:ABS_MT_TRACKING_ID:1
OK
event send EV_ABS:ABS_MT_POSITION_X:400
OK
event send EV_ABS:ABS_MT_POSITION_Y:800
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Lift finger up and sync
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK
הדמיה של גלילה אנכית (החלקה)

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

# Finger touch down at start coordinate (500, 1600)
event send EV_ABS:ABS_MT_TRACKING_ID:2
OK
event send EV_ABS:ABS_MT_POSITION_X:500
OK
event send EV_ABS:ABS_MT_POSITION_Y:1600
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Move coordinates upward dynamically
event send EV_ABS:ABS_MT_POSITION_Y:1200
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_POSITION_Y:800
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_POSITION_Y:400
OK
event send EV_SYN:0:0
OK
# Finger release at coordinate (500, 400)
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK
הדמיה של תנועת פתיחת או סגירת אצבעות לשינוי מרחק התצוגה

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

# Finger 1 down at (500, 1000) using slot 0
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_TRACKING_ID:10
OK
event send EV_ABS:ABS_MT_POSITION_X:500
OK
event send EV_ABS:ABS_MT_POSITION_Y:1000
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Finger 2 down at (600, 1000) using slot 1
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_TRACKING_ID:11
OK
event send EV_ABS:ABS_MT_POSITION_X:600
OK
event send EV_ABS:ABS_MT_POSITION_Y:1000
OK
event send EV_SYN:0:0
OK
# Fingers slide apart from each other
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_POSITION_X:300
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_POSITION_X:800
OK
event send EV_SYN:0:0
OK
# Lift Finger 1 using slot 0
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_SYN:0:0
OK
# Lift Finger 2 using slot 1
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK
הדמיה של מתג חיבור אוזניות

הדמיה של חיבור או ניתוק של שקע האוזניות כדי לבדוק את מתגי ניתוב האודיו. הערך 1 מייצג הכנסת תקע, והערך 0 מייצג הוצאת אוזניות.

# Simulate headphones plugged in
event send EV_SW:SW_HEADPHONE_INSERT:1 EV_SYN:0:0
OK
# Simulate headphones unplugged
event send EV_SW:SW_HEADPHONE_INSERT:0 EV_SYN:0:0
OK
איך למצוא קודי אירועים של מסוף ממכשיר אמיתי

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

# Run getevent to monitor input events dynamically
adb shell getevent -lt
/dev/input/event12: EV_KEY       KEY_POWER            DOWN
/dev/input/event12: EV_SYN       SYN_REPORT           00000000
/dev/input/event12: EV_KEY       KEY_POWER            UP
/dev/input/event12: EV_SYN       SYN_REPORT           00000000
  • הודעת טקסט של אירוע: שליחת מחרוזת של תווים שמדמים לחיצות על מקשים. ההודעה חייבת להיות מחרוזת בקידוד UTF-8. פוסטים ב-Unicode ממופים באופן הפוך בהתאם למקלדת הנוכחית של המכשיר, ותווים לא נתמכים נמחקים בלי להציג הודעה.

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

  • תצוגת הסוללה: מציגה את מצב הסוללה והמטען.

  • power ac {on| off}‎: הפעלה או השבתה של מצב טעינת AC.

  • power status {unknown| charging| discharging| not-charging| full}: משנה את סטטוס הסוללה לפי מה שצוין.

  • power present {true| false}: הגדרת מצב הנוכחות של הסוללה.

  • power health {unknown| good| overheat| dead| overvoltage| failure}: מגדיר את מצב תקינות הסוללה.

  • power capacity percent: הגדרת מצב קיבולת הסוללה שנותרה באחוזים, מ-0 עד 100.

סטטוס החיבור לרשת (אתרנט ורשת סלולרית בלבד)

  • סטטוס הרשת: בדיקת סטטוס הרשת ומאפייני העיכוב והמהירות הנוכחיים.

  • network delay latency משנה את זמן האחזור של הרשת המדומה.

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

    הפורמט של זמן האחזור ברשת הוא אחד מהבאים (המספרים הם באלפיות השנייה):

    פורמט זמן האחזור של הרשת:

  • gprs: ‏GPRS, שמשתמש בטווח זמן אחזור של 150 מינימום ו-550 מקסימום.

  • ‫edge: ‏EDGE/EGPRS, שמשתמש בטווח זמן אחזור של 80 מינימום ו-400 מקסימום.

  • ‫umts: ‏UMTS/3G, שמשתמש בטווח זמן אחזור של 35 מינימום ו-200 מקסימום.

  • none: אין זמן אחזור.

  • ‫num: מדמה את זמן האחזור שצוין באלפיות השנייה.

  • ‫min:max: הדמיה של טווח זמן האחזור שצוין.

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

    emulator -netdelay gprs
    emulator -netdelay 40,100
    

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

    network delay gprs
    network delay 40 100
    
  • network speed speed האמולטור מאפשר לדמות קצבי העברה שונים ברשת. אפשר להגדיר קצב או טווח העברה בהפעלת האמולטור, או להשתמש במסוף כדי לשנות את הקצב בזמן שהאפליקציה פועלת באמולטור.

    הפורמט של מהירות הרשת הוא אחד מהבאים (המספרים הם קילו-ביטים לשנייה):

    פורמט מהירות הרשת:

  • ‫gsm: GSM/CSD, שמשתמש במהירות של 14.4 העלאה ו-14.4 הורדה.

  • ‫hscsd: ‏HSCSD, שמשתמש במהירות של 14.4 בהעלאה ו-43.2 בהורדה.

  • gprs: ‏GPRS, שמשתמש במהירות של 40.0 העלאה ו-80.0 הורדה.

  • ‫edge: EDGE/EGPRS, שמשתמש במהירות של 118.4 להעלאה ו-236.8 להורדה.

  • ‫umts: ‏UMTS/3G, שמשתמש במהירות של 128.0 להעלאה ו-1920 להורדה.

  • ‫hsdpa: ‏HSDPA, שמשתמש במהירות של 348.0 להעלאה ו-14,400.0 להורדה.

  • ‫lte: LTE, שמשתמש במהירות של 58,000 להעלאה ו-173,000 להורדה.

  • ‫evdo: EVDO, שמשתמש במהירות של 75,000 להעלאה ו-280,000 להורדה.

  • ‫full: מהירות בלתי מוגבלת, אבל תלויה במהירות החיבור של המחשב.

  • ‫num: הגדרת קצב מדויק בקילו-ביטים לשנייה, שמשמש גם להעלאה וגם להורדה.

  • up:down: הגדרת קצבים מדויקים בקילו-ביט לשנייה להעלאה ולהורדה בנפרד.

    כדי להגדיר את מהירות הרשת בהפעלת האמולטור, משתמשים באפשרות האמולטור -netspeed. דוגמאות:

    emulator -netspeed gsm @Pixel_API_26
    emulator -netspeed 14.4,80 @Pixel_API_26
    

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

    network speed 14.4 80
    
  • network capture {start| stop} file שליחת חבילות לקובץ. ברשימה הבאה מתוארים הפרמטרים וערכי הפרמטרים:

    הערה: החל מגרסה 36.5 של אמולטור Android, תנועת הנתונים בחיבור ה-Wi-Fi מטופלת על ידי netsim כברירת מחדל. הפקודה במסוף לתיעוד תעבורת הנתונים ברשת מתעדת רק תעבורת נתונים מדור קודם ברשת הסלולרית או ב-WAN, שמנותבת דרך מחסנית ה-slirp של QEMU. כדי לתעד חבילות של Wi-Fi,‏ Bluetooth או רשת מתקדמת בגרסאות מודרניות של אמולטור, עיינו בקטע תיעוד תנועה ברשת במדריך Advanced Emulator Networking.

  • קובץ התחלה: מתחיל לתעד חבילות נתונים ברשת. מטעמי אבטחה, הקובץ חייב להיות שם קובץ בלבד (ללא מפרידי נתיבים כמו / וללא ..). קובץ תיעוד החבילות יישמר בספריית התוכן של ה-AVD בתיקייה console_out/ (לדוגמה, ~/.android/avd/avd_name.avd/console_out/file).

  • ‫stop file: הפסקת השליחה של חבילות לקובץ שצוין.

אמולציה של טלפוניה

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

  • gsm {call| accept| cancel| busy} phonenumber אלה הפרמטרים של gsm:

    • call: מדמה שיחת טלפון נכנסת מ-phonenumber.
    • ‫accept: קבלת שיחה נכנסת ממספר טלפון ושינוי מצב השיחה לפעיל. אפשר לשנות את הסטטוס של שיחה ל"פעילה" רק כשהסטטוס הנוכחי שלה הוא "בהמתנה" או "מושהית".
    • cancel: סיום שיחת טלפון נכנסת או שיחת טלפון יוצאת למספר טלפון.
    • busy: סוגר שיחה יוצאת ללקוח ל-phonenumber ומשנה את מצב השיחה ל-busy. אפשר לשנות את הסטטוס של שיחה ל"תפוס" רק כשהסטטוס הנוכחי שלה הוא "בהמתנה".
  • gsm {data| voice} state הפקודה data state משנה את המצב של חיבור הנתונים ב-GPRS, והפקודה voice state משנה את המצב של חיבור הקול ב-GPRS, באופן הבא:

    • unregistered: אין רשת זמינה.
    • home: ברשת מקומית, לא בנדידה.
    • נדידה: ברשת נדידה.
    • ‫searching: חיפוש רשתות.
    • ‫denied: שיחות חירום בלבד.
    • off: כמו "לא רשום".
    • on: כמו home.
  • gsm hold: מעביר שיחה למצב המתנה. אפשר להעביר שיחה להמתנה רק אם היא פעילה או ממתינה.

  • ‫gsm list: הצגת רשימה של כל השיחות הנכנסות והיוצאות והסטטוסים שלהן.

  • ‫gsm status: דיווח על המצב הנוכחי של הקול והנתונים ב-GSM. הערכים הם אלה שמתוארים בפקודות הקוליות ובפקודות הנתונים.

  • gsm signal {rssi| ber} משנה את עוצמת האות המדווחת (rssi) ואת שיעור שגיאות הסיביות (ber) ב-15 השניות הבאות של העדכון. ברשימה הבאה מתוארים הפרמטרים והערכים שלהם:

    • ‫rssi: הטווח הוא בין 0 ל-31, ו-99 אם הערך לא ידוע.
    • ‫ber: הטווח הוא בין 0 ל-7, ו-99 אם הערך לא ידוע.
  • gsm signal-profile num: הגדרת פרופיל עוצמת האות. num הוא מספר מ-0 עד 4.

  • cdma ssource source מגדירה את המקור הנוכחי של מינויי CDMA, כאשר המקור הוא רשימת היתרים מבוססת-רשת שמכילה את המנויים של ספק ה-CDMA ואת הערכים שלהם, באופן הבא:

    • ‫nv: קריאת המינוי מ-RAM לא נדיף.
    • ‫ruim: קריאת המינוי מ-Removable User Identity Module ‏(RUIM).
  • ‫cdma prl_version version: הצגת הגרסה הנוכחית של רשימת הנדידה המועדפת (PRL). מספר הגרסה הוא של מסד הנתונים של ה-PRL, שמכיל מידע שמשמש במהלך תהליך הבחירה והרכישה של המערכת.

ניהול החיישנים באמולטור

הפקודות האלה קשורות לחיישנים שזמינים ב-AVD. בנוסף לשימוש בפקודה sensor, אפשר לראות ולשנות את ההגדרות באמולטור במסך Virtual sensors בכרטיסיות Accelerometer ו-Additional sensors.

  • סטטוס החיישן: רשימה של כל החיישנים והסטטוס שלהם.

  • ‫sensor get sensor-name: קבלת ההגדרות של sensor-name. בדוגמה הבאה אפשר לראות איך מקבלים את הערך של חיישן התאוצה:

    sensor get acceleration
    acceleration = 2.23517e-07:9.77631:0.812348
    

    ערכי התאוצה שמופרדים בנקודתיים (:) מתייחסים לקואורדינטות x,‏ y ו-z של החיישנים הווירטואליים.

  • sensor set sensor-name value-x:value-y:value-z: הגדרת הערכים של sensor-name. בדוגמה הבאה, חיישן התאוצה מוגדר לערכי x,‏ y ו-z שמופרדים בנקודתיים.

    sensor set acceleration 2.23517e-07:9.77631:0.812348
    

אמולציה של SMS

  • sms send sender-phone-number textmessage יוצרת הודעת SMS נכנסת מדומה. ברשימה הבאה מתוארים הפרמטרים והערכים שלהם:

    • ‫sender-phone-number: מכיל מחרוזת מספרית שרירותית.
    • ‫textmessage: הודעת ה-SMS.

    בדוגמה הבאה, ההודעה "hi there" נשלחת למספר הטלפון 4085555555:

    sms send 4085555555 hi there
    

המסוף מעביר את הודעת ה-SMS ל-Android framework, שמעבירה אותה לאפליקציה באמולטור שמטפלת ב-SMS, כמו אפליקציית Messages. אם מעבירים 10 מספרים, האפליקציה מעצבת אותם כמספר טלפון. מחרוזות מספריות ארוכות או קצרות יותר יוצגו כמו ששלחתם אותן.

סימולציה של טביעת אצבע

  • ‫finger touch fingerprint-id: מדמה נגיעה של אצבע בחיישן.

  • finger remove: מדמה הסרה של האצבע.

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

הקלטת המסך

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

  • screenrecord {start| stop} file התחלה או הפסקה של תהליך הקלטת המסך.
    • start file: התחלת הקלטת וידאו. קובץ הפלט חייב להסתיים בסיומת החובה .webm. הסרטון שצולם נשמר ישירות בספריית הפלט של מסוף ה-AVD: ~/.android/avd/avd_name.avd/console_out/file.
    • stop file: הפסקת התהליך הפעיל של הקלטת המסך.

אוטומציה ומאקרו

תת-המערכת של האוטומציה מאפשרת למפתחים לתעד מעברי מצב של פקודות מאקרו במכשיר הווירטואלי שפועל, ולהפעיל אותם כדי להריץ תהליכי בדיקה אוטומטיים.

  • automation {record| stop-record| play| stop-play} ניהול הקלטות אוטומטיות של פקודות מאקרו.
    • ‫record: הפקודה הזו מתחילה להקליט את השינויים במצב המכשיר ואת הקלט.
    • ‫stop-record: הפסקת הסשן הנוכחי של הקלטת המאקרו.
    • ‫play: הפעלה של רצף פקודות מאקרו שהוקלט.
    • ‫stop-play: הפסקת רצף ההפעלה של פקודת המאקרו הפעילה.

פיזיקה (6DoF)

הפקודות הפיזיקליות מנהלות את רישום אמת הקרקע (ground truth) של תנוחות מרחביות למודלים של תנועה פיזית עם שש דרגות חופש (6DoF), שמשמשים להדמיה של מעקב תנועה מתקדם.

  • physics {record-gt| stop} ניהול הקלטות של מודלים לתנוחות פיזיות.
    • ‫record-gt: מתחיל להקליט נתוני תנועה של 6DoF באמת קרקע (ground truth).
    • ‫stop: הפסקת התהליך הנוכחי של הקלטת אמת קרקע (ground truth).

אמצעי בקרה מתקדמים למכשירים

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

  • multidisplay {add| del} הוספה או מחיקה של מסכים וירטואליים משניים כדי לבדוק הגדרות של כמה מסכים. הערה: אין תמיכה במסכים משניים בפרופילים של מכשירים מתקפלים כמו Pixel Fold או האמולטור Resizable.

  • proxy {set| clear} הגדרה של העברת שרת proxy ברשת באופן פרוגרמטי מהמסוף.

    • ‫set host port: הגדרת שרת ה-proxy לטירגוט.
    • ‫clear: מאפס את הגדרות שרת ה-Proxy לברירת המחדל. הערה: פעולות של הגדרת שרת proxy נכשלות בסביבות הפעלה ללא GUI.
  • virtualscene-image {wall| table} image_path ההגדרה הזו מאפשרת להתאים אישית את הקירות ברקע או את השולחנות האופקיים שמוצגים בפיד המצלמה של הסצנה הווירטואלית, באמצעות קובץ תמונה מותאם אישית של המשתמש.

  • resize-display scale התאמה דינמית של רזולוציית המסך בין קני מידה מוגדרים מראש. הערה: אי אפשר לשנות את הרזולוציה בהגדרות ללא ממשק משתמש.

  • nodraw {on| off} ההגדרה הזו משביתה את העיבוד של ממשק המשתמש הגרפי הפיזי במסך המארח כדי להפחית את העומס על זיכרון המערכת ועל ה-GPU במהלך הפעלות אוטומטיות של headless ברקע בנפח גבוה.

  • grpc port הגדרה של שליטה פרוגרמטית מתקדמת במכשיר על נקודות קצה של יציאות gRPC בהתאמה אישית.

  • ‫qemu monitor: גישה ישירה למסוף אינטראקטיבי של ה-hypervisor הבסיסי. אפשר להזין את הפקודה הזו רק בסשנים פעילים של מסוף Telnet.

  • icebox track pid ההגדרה הזו מפעילה תמונות מצב אוטומטיות של המערכת כשתהליך האפליקציה שצוין נתקל בחריגה שלא טופלה או בקריסה.

  • phonenumber number מגדיר את מספר הטלפון המקומי הווירטואלי של מכשיר היעד.

ממשק פרוגרמטי של gRPC

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

כדי לבחור בין מסוף Telnet הקודם לבין ממשק gRPC המודרני, כדאי לעיין בהשוואה הבאה של ביצועים, אבטחה ותכונות:

תכונה מסוף Telnet ממשק gRPC
מתאים במיוחד ל- ניפוי באגים ידני, סשנים אינטראקטיביים. ‫CI/CD ללא ממשק משתמש, מערכי בדיקה אוטומטיים כבדים.
מהירות איטי יותר, תקורה של טקסט, זמן אחזור של החיבור. אופטימיזציה, ריבוב HTTP/2, פרוטוקול מהיר.
אבטחה לא מוצפן; יציאות מקומיות (5554–5585). אפשר לאבטח באמצעות TLS, פועל ברשתות.
מקורות נתונים לא נתמך; בקשה-תגובה בלבד. שידורים ל-logcat, הקלטת אודיו של אורחים.
מדיה כתיבת קובצי פלט בדיסק של המארח או האורח. מאגרים בינאריים ישירים ברשת.
מערכת הפעלה אורחת מוגבל לפקודות קבועות של אמולטור. מריצה פקודות מעטפת Bash מקוריות של אורח.

הפעלה וקריאה ל-gRPC

כדי להשתמש בנקודות הקצה של gRPC, מפעילים את אמולטור Android משורת הפקודה וכוללים את הדגל -grpc, תוך ציון יציאת הלולאה החוזרת (loopback) של היעד.

# Start the emulator with the gRPC service enabled on port 8556
emulator -grpc localhost:8556 @Pixel_Fold

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

# Query the status of the virtual device using grpcurl
grpcurl -plaintext -d '{}' localhost:8556 \
  android.emulation.control.EmulatorController/getStatus

# Simulate an incoming phone call
grpcurl -plaintext -d '{"operation": "InitCall", "number": "1234567890"}' localhost:8556 \
  android.emulation.control.EmulatorController/sendPhone

# Simulate typing text into the guest OS
grpcurl -plaintext -d '{"text": "Hello"}' localhost:8556 \
  android.emulation.control.EmulatorController/sendKey

מיפוי של מסוף Telnet לשירות gRPC

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

קטגוריה פקודת Telnet מדור קודם שירות או שיטה של gRPC
סטטוס ping EmulatorController/getStatus
סטטוס avd name incubating.AvdService/getAvdInfo
סטטוס kill EmulatorController/setVmState
סטטוס restart EmulatorController/setVmState
הפעלה power display EmulatorController/getBattery
הפעלה power capacity EmulatorController/setBattery
מיקום גיאוגרפי geo fix EmulatorController/setGps
חיישנים sensor set incubating.SensorService/setSensor
מידע ביומטרי finger touch EmulatorController/sendFingerprint
Posture posture EmulatorController/setPosture
Posture physics / fold EmulatorController/setPhysicalModel
SMS sms send EmulatorController/sendSms
שיחת GSM gsm call EmulatorController/sendPhone
שיחת GSM phonenumber EmulatorController/setPhoneNumber
הפניה אוטומטית redir add Waterfall/ForwardPort
קלט event send EV_KEY EmulatorController/sendKey
קלט event send EV_ABS EmulatorController/sendTouch
מדיה screenrecord incubating.ScreenRecording
עיבוד nodraw EmulatorController/setDisplayMode
תמונות מצב avd snapshot list SnapshotService/ListSnapshots
תמונות מצב avd snapshot load/save SnapshotService/LoadSnapshot

פקודות פרוגרמטיות ייחודיות ל-gRPC

ממשק ה-gRPC מספק כמה יכולות מתקדמות שאי אפשר לבצע פיזית באמצעות חיבורים למסוף Telnet מדור קודם. הן כוללות סטרימינג ישיר של logcat, הקלטה או הזרקה של אודיו דו-כיווני, שינויים בממשק המשתמש הגרפי (GUI) של המארח וגישה ישירה למעטפת.

שירות או שיטה של gRPC פרמטר פונקציה
streamLogcat {"maxLines": 100} העברת פלט של logcat ממערכת האורח
streamAudio {} העברת אודיו מהרמקול דרך הכבל
injectAudio {"audio": "..."} הזרקת שידורי אודיו מהמיקרופון
UiController {"theme": "DARK"} משנה את העיצובים של חלון המארח
Waterfall/Exec {"cmd": "ls"} מריץ פקודות מעטפת מקוריות של מערכת ההפעלה של האורח

סימולציה ואימות של טביעת אצבע

תרשים 1. מסך אימות באמצעות טביעת אצבע.

אפשר להשתמש בפקודה finger כדי לדמות ולאמת את האימות באמצעות טביעת אצבע באפליקציה. נדרשים SDK Tools בגרסה 24.3 ואילך ו-Android בגרסה 6.0 (רמת API ‏23) ואילך.

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

  1. אם עדיין אין לכם מזהה טביעת אצבע, אתם יכולים לרשום טביעת אצבע חדשה באמולטור: בוחרים באפשרות Settings > Security > Fingerprint ופועלים לפי הוראות הרישום.

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

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

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