כל מכשיר וירטואלי שפועל מספק מסוף שמאפשר לשלוח שאילתות לסביבת המכשיר המדומה ולשלוט בה. לדוגמה, אתם יכולים להשתמש במסוף כדי לנהל הפניית יציאות, מאפייני רשת ואירועי טלפוניה בזמן שהאפליקציה פועלת באמולטור.
כדי להריץ את הפקודות הבאות, צריך להפעיל אמולטור. מידע נוסף על הפעלת אמולטור זמין במאמרים הפעלת אפליקציות באמולטור Android והפעלת האמולטור משורת הפקודה.
התחלה ועצירה של סשן במסוף
כדי לגשת למסוף ולהזין פקודות מחלון הטרמינל, משתמשים ב-telnet כדי להתחבר ליציאת המסוף ומספקים את אסימון האימות. בכל פעם שמוצג OK במסוף, אפשר להזין פקודות. אין הנחיה אופיינית.
כדי להתחבר למסוף של מכשיר וירטואלי פועל:
פותחים את חלון הטרמינל ומזינים את הפקודה הבאה:
telnet localhost console-portבכותרת של חלון האמולטור מופיע מספר היציאה של המסוף כשהוא פועל בחלון נפרד, אבל לא כשהוא פועל בחלון של הכלי. לדוגמה, כותרת החלון של אמולטור שמשתמש ביציאת מסוף 5554 יכולה להיות Pixel8_API_34:5554. בנוסף, הפקודה
adb devicesמדפיסה רשימה של מכשירים וירטואליים שפועלים ומספרי היציאות שלהם במסוף. מידע נוסף זמין במאמר שאילתות לגבי מכשירים.הערה: האמולטור מאזין לחיבורים ביציאות 5554 עד 5585 ומקבל חיבורים רק מ-localhost.
אחרי שמוצג OK במסוף, מזינים את הפקודה
auth auth_token.כדי להזין פקודות במסוף, צריך לבצע אימות במסוף האמולטור. הערך של
auth_tokenצריך להיות זהה לתוכן של הקובץ.emulator_console_auth_tokenבספריית הבית.אם הקובץ הזה לא קיים, הפקודה
telnet localhost console-portיוצרת את הקובץ, שמכיל אסימון אימות שנוצר באופן אקראי. כדי להשבית את האימות, מוחקים את האסימון מהקובץ.emulator_console_auth_tokenאו יוצרים קובץ ריק אם הוא לא קיים.אחרי שמתחברים למסוף, מזינים פקודות מסוף.
כדי לראות רשימה של פקודות במסוף ולקבל מידע על פקודות ספציפיות, מזינים
help, help commandאוhelp-verbose.כדי לצאת מהסשן במסוף, מזינים
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 firstactivitysnapshotfold: מקפל את המכשיר כדי להציג את תצורת המסך הקטן יותר, אם המכשיר מתקפל ופתוח כרגע.
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 100network 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 80network 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: הפסקת התהליך הפעיל של הקלטת המסך.
- start 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"} |
מריץ פקודות מעטפת מקוריות של מערכת ההפעלה של האורח |
סימולציה ואימות של טביעת אצבע
אפשר להשתמש בפקודה finger כדי לדמות ולאמת את האימות באמצעות טביעת אצבע באפליקציה. נדרשים SDK Tools בגרסה 24.3 ואילך ו-Android בגרסה 6.0 (רמת API 23) ואילך.
כדי לדמות ולאמת אימות באמצעות טביעת אצבע, פועלים לפי השלבים הבאים:
אם עדיין אין לכם מזהה טביעת אצבע, אתם יכולים לרשום טביעת אצבע חדשה באמולטור: בוחרים באפשרות Settings > Security > Fingerprint ופועלים לפי הוראות הרישום.
מגדירים את האפליקציה כך שתקבל אימות באמצעות טביעת אצבע. אחרי שמבצעים את ההגדרה הזו, במכשיר מוצג מסך האימות באמצעות טביעת אצבע.
כשהאפליקציה מציגה את מסך האימות באמצעות טביעת אצבע, עוברים למסוף ומזינים את הפקודה
finger touchואת מזהה טביעת האצבע שיצרתם. הפעולה הזו מדמה נגיעה באצבע.לאחר מכן, מזינים את הפקודה
finger removeכדי לדמות הסרה של האצבע. האפליקציה צריכה להגיב כאילו המשתמש נגע בחיישן טביעת האצבע ואז הסיר את האצבע.