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

Android SDK כולל אמולטור מכשיר Android – מכשיר וירטואלי שרצה במחשב. אפליקציית 'אמולטור Android' מאפשרת לכם לפתח ולבדוק אפליקציות ל-Android בלי להשתמש במכשיר פיזי.

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

הפעלת האמולטור

משתמשים בפקודה emulator כדי להפעיל את האמולטור, במקום הפעלת הפרויקט או להפעיל אותו דרך מנהל ה-AVD.

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

emulator -avd avd_name [ {-option [value]} … ]

או

emulator @avd_name [ {-option [value]} … ]

לדוגמה, אם מפעילים את האמולטור מתוך Android Studio במחשב Mac, ברירת המחדל שורת הפקודה תהיה דומה לזו:

/Users/janedoe/Library/Android/sdk/emulator/emulator -avd Pixel8_API_34 -netdelay none -netspeed full -qt-hide-window -grpc-use-token -idle-grpc-timeout

חשוב לשים לב שהארגומנטים -qt-hide-window -grpc-use-token -idle-grpc-timeout משמשים רק להפעלת חלון האמולטור ב-Android Studio. אם רוצים להפעיל את האמולטור בחלון נפרד, אין להשתמש בפרמטרים הנוספים האלה.

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

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

emulator -list-avds

ניתן להשתמש באפשרות הזו כדי להציג רשימה של שמות AVD מספריית הבית של Android. אפשר לשנות את ספריית הבית שמוגדרת כברירת מחדל על ידי הגדרה של ANDROID_SDK_HOME שמציין את השורש של ספרייה ספציפית למשתמש שבה מאוחסנים כל ההגדרות ותוכן ה-AVD.

אפשר להגדיר את משתנה הסביבה בחלון הטרמינל לפני שמפעילים במכשיר וירטואלי או דרך הגדרות המשתמש המערכת. לדוגמה, בקובץ .bashrc ב-Linux.

כדי לעצור את האמולטור של Android, סוגרים את חלון האמולטור.

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

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

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

  1. בונים וארוזים את האפליקציה ב-APK, כפי שמתואר במאמר יצירה והפעלה של app.
  2. מפעילים את האמולטור משורת הפקודה, כפי שתואר קודם באמצעות אפשרויות ההפעלה הנדרשות.
  3. התקנת האפליקציה באמצעות adb.
  4. מריצים את האפליקציה באמולטור ובודקים אותה.
    כשהאמולטור הוא תוכל להשתמש באמולטור המסוף כדי להנפיק פקודות לפי הצורך.

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

המכשיר הווירטואלי שומר את האפליקציה ואת נתוני המצב שלה בכל הפעלה מחדש במחיצת דיסק של נתוני משתמש (userdata-qemu.img). כדי לנקות את ההגדרה הזו נתונים, יש להפעיל את האמולטור עם האפשרות -wipe-data או לאפס את הנתונים של במנהל ה-AVD. מידע נוסף על נתוני המשתמש ומחיצה אחרת, ראו את הקטע הבא.

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

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

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

האמולטור של Android משתמש ב-hypervisor (QEMU).

ספריית מערכת AVD

ספריית המערכת מכילה את תמונות מערכת Android שבהן האמולטור משתמש כדי לדמות את מערכת ההפעלה. בספרייה הזו יש קבצים לקריאה בלבד, ספציפיים לפלטפורמה שמשותף לכל רכיבי ה-AVD מאותו סוג, כולל רמת API, ארכיטקטורת מעבד (CPU) וריאציה של Android. מיקומי ברירת המחדל הם:

  • macOS ו-Linux – ~/Library/Android/sdk/system-images/android-apiLevel/variant/arch/
  • Windows – C:\Users\user\Library\Android\sdk\system-images\android-apiLevel\variant\arch\

איפה:

  • apiLevel היא רמת API מספרית או אות עבור גרסאות טרום-השקה. לדוגמה, android-V מציין את האפשרות Android תצוגה מקדימה של VanillaIceCream. עם ההשקה הוא הפך לרמת API 35, ייעודית על ידי android-35
  • variant הוא שם שתואם לתכונות ספציפיות שמוטמעת על ידי תמונת המערכת. לדוגמה, google_apis או android-wear.
  • arch היא ארכיטקטורת המעבד (CPU) המטורגטת. לדוגמה, x86

משתמשים באפשרות -sysdir כדי לציין ספריית מערכת אחרת עבור ה-AVD.

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

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

קובץ תיאור אפשרות לציין קובץ אחר
kernel-qemu או kernel-ranchu קובץ האימג' הבינארי של הליבה של ה-AVD. kernel-ranchu מבוסס על אמולטור QEMU. -kernel
ramdisk.img קובץ האימג' של מחיצת האתחול. זוהי קבוצת משנה של system.img שנטענה על ידי הליבה (kernel) בהתחלה לפני שתמונת המערכת נטענה. הוא בדרך כלל מכיל רק כמה קבצים בינאריים וסקריפטים של אתחול. -ramdisk
system.img הגרסה הראשונית של תמונת המערכת לקריאה בלבד. באופן ספציפי, מחיצה שמכילה את ספריות המערכת והנתונים שתואמים לרמת ה-API ווריאנט. -system
userdata.img הגרסה הראשונית של מחיצת הנתונים, שנראית כך: data/ במערכת האמולציה ומכיל את כל הנתונים לכתיבה עבור AVD. האמולטור משתמש בקובץ הזה כשיוצרים AVD חדש או משתמשים אפשרות ‑wipe-data. מידע נוסף זמין במאמר תיאור הקובץ userdata-qemu.img בקטע הבא. -initdata
-init-data

ספריית נתונים AVD

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

מיקום ברירת המחדל הוא המיקום הבא, כאשר name הוא שם AVD:

  • macOS ו-Linux – ~/.android/avd/name.avd/
  • Windows 10 ואילך – C:\Users\user\.android\name.avd\

משתמשים באפשרות -datadir כדי לציין ספריית נתונים אחרת של AVD.

בטבלה הבאה מפורטים הקבצים החשובים ביותר בספרייה הזו:

טבלה 2. קבצים חשובים בספריית הנתונים של ה-AVD

קובץ תיאור אפשרות לציין קובץ אחר
userdata-qemu.img

התוכן של מחיצת הנתונים, שמופיע כ-data/ ב- באמצעות האמולציה. כשיוצרים AVD חדש או כשמשתמשים האפשרות -wipe-data לאפס את ה-AVD להגדרות ברירת המחדל של היצרן, אמולטור מעתיק את הקובץ userdata.img בספריית המערכת אל יצירת הקובץ הזה.

כל מופע של מכשיר וירטואלי משתמש בתמונה של נתוני משתמש שניתנת לכתיבה כדי לאחסן את המשתמשים נתונים ספציפיים לסשן. לדוגמה, היא משתמשת בתמונה כדי לאחסן את נתוני האפליקציות, ההגדרות, מסדי הנתונים והקבצים שהותקנו. לכל משתמש יש ספריית ANDROID_SDK_HOME שונה שמאחסנת את ספריות הנתונים של קובצי AVD שנוצרו על ידי המשתמש הזה. לכל AVD יש userdata-qemu.img אחד חדש.

-data
cache.img תמונת מחיצת המטמון שמופיעה כ-cache/ אמולציה של המערכת. היא ריקה כשיוצרים לראשונה AVD או משתמשים אפשרות -wipe-data. היא מאחסנת קובצי הורדה זמניים מאוכלסים על ידי מנהל ההורדות ולפעמים המערכת. לדוגמה, הדפדפן משתמש בו כדי לשמור במטמון דפי אינטרנט ותמונות שהורדו בזמן שהאמולטור ריצה. כשמשביתים את המכשיר הווירטואלי, הקובץ נמחק. אפשר לשמור את הקובץ באמצעות האפשרות -cache. -cache
sdcard.img

(אופציונלי) תמונה של מחיצה בכרטיס SD שמאפשרת לדמות כרטיס SD במכשיר וירטואלי. אפשר ליצור קובץ תמונה של כרטיס SD דרך AVD מנהל או באמצעות mksdcard של Google. הקובץ מאוחסן במחשב הפיתוח וצריך לטעון אותו ב בזמן ההפעלה.

כשמגדירים AVD במנהל ה-AVD, ניתן לבחור כדי להשתמש בקובץ כרטיס SD שמנוהל באופן אוטומטי או בקובץ שיצרתם באמצעות הכלי mksdcard. אפשר להציג את הקובץ sdcard.img שמשויך ל-AVD במנהל ה-AVD. האפשרות -sdcard מבטל את הקובץ של כרטיס ה-SD שצוין ב-AVD. הערה: האפשרות הזו לכרטיס SD לא תעבוד ב-Mac עם Apple Silicon.

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

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

האמולטור מתייחס לקובץ כמאגר בייטים, כך שהפורמט של כרטיס ה-SD לא חשובות.

האפשרות -wipe-data לא משפיעה על הקובץ הזה. אם למחוק את הקובץ, למחוק אותו וליצור אותו מחדש באמצעות מנהל ה-AVD או הכלי mksdcard. שינוי גודל הקובץ מוחק גם את הקובץ ויוצר קובץ חדש.

-sdcard

הצגת רשימה של ספריות וקבצים שהאמולטור משתמש בהם

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

  • משתמשים ב האפשרות -verbose או -debug init כשמפעילים את האמולטור בשורת הפקודה. בודקים את הפלט.
  • משתמשים בפקודה emulator -help-option כדי מוצאים ספריית ברירת מחדל. לדוגמה:
    emulator -help-datadir
    Use '-datadir <dir>' to specify a directory where writable image files will be searched. On this system, the default directory is: /Users/me/.android See '-help-disk-images' for more information about disk image files.

אפשרויות להפעלה של שורת פקודה

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

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

אפשרויות נפוצות

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

טבלה 3. אפשרויות נפוצות של שורת הפקודה

אפשרות של שורת פקודה תיאור
הפעלה מהירה
-no-snapshot-load מבצע אתחול קר ושומר את מצב האמולטור ביציאה.
-no-snapshot-save מבצע אתחול מהיר אם אפשר, אבל לא שומר את מצב האמולטור ביציאה.
-no-snapshot ההגדרה משביתה לחלוטין את תכונת ההפעלה המהירה, ללא טעינה או שמירה של מצב האמולטור.
חומרת המכשיר
-camera-back mode
-camera-front mode
מגדיר את מצב האמולציה של מצלמה עם המצלמה האחורית או הקדמית. הפעולה הזו תבטל את ההגדרות של המצלמה ב-AVD.

mode יכול להיות כל אחד מהערכים הבאים:

  • emulated – האמולטור מדמה מצלמה בתוכנה.
  • webcamn – האמולטור משתמש במצלמת אינטרנט שמחוברת אל המכשיר של מחשב פיתוח, שמצוין במספר. כדי לראות רשימה של מצלמות אינטרנט, השתמשו אפשרות -webcam-list. לדוגמה: webcam0.
  • none – השבתת המצלמה במכשיר הווירטואלי.

לדוגמה:

emulator @Pixel8_API_34 -camera-back webcam0
-webcam-list רשימה של מצלמות האינטרנט במחשב הפיתוח שזמינות לאמולציה. עבור דוגמה:
emulator @Pixel8_API_34 -webcam-list
        List of web cameras connected to the computer:
        Camera 'webcam0' is connected to device 'webcam0'
        on channel 0 using pixel format 'UYVY'

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

החל מגרסה 25.2.4 של כלי ה-SDK, חובה לציין שם AVD.

תמונות מהדיסק וזיכרון
-memory size

מציין את גודל ה-RAM הפיזי, מ-1536 עד 8,192MB. לדוגמה:

emulator @Pixel8_API_34 -memory 2048

הערך הזה מבטל את הגדרת ה-AVD.

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

emulator @Pixel8_API_34 -sdcard C:/sd/sdcard.img

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

אם לא מציינים את האפשרות הזו, ברירת המחדל היא sdcard.img בספריית הנתונים, אלא אם מצוין ב-AVD משהו אחר. מידע נוסף על אמולציה של כרטיסי SD זמין במאמר ספריית הנתונים של AVD.

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

emulator @Pixel8_API_34 -wipe-data

כברירת מחדל, קובץ נתוני המשתמשים הוא userdata-qemu.img קובץ הנתונים הוא userdata.img. שני הקבצים האלה נמצאים בספריית הנתונים. האפשרות -wipe-data לא משפיעה על sdcard.img חדש. למידע נוסף על נתוני משתמש, אפשר לעיין בסעיף הסבר על הספריות והקבצים שמוגדרים כברירת מחדל.

ניפוי באגים
-debug tags המדיניות מפעילה או משביתה את ההצגה של הודעות ניפוי באגים בתג אחד או יותר. יש להפריד בין תגים באמצעות רווח, פסיק או עמודה. לדוגמה:

$ emulator @Pixel8_API_34 -debug init,metrics

כדי להשבית תג, מוסיפים לפניו מקף (-). לדוגמה, מציגה את כל ההודעות על ניפוי הבאגים, מלבד ההודעות הקשורות לשקעי רשת ומדדים:

-debug all,-socket,-metrics

לרשימת תגים ותיאורים אפשר להשתמש ב-help-debug-tags כאפשרות. לדוגמה:

emulator -help-debug-tags

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

ANDROID_VERBOSE=socket,gles

הדבר מקביל לשימוש:

-debug-socket -debug-gles

או

-debug socket,gles

-debug-tag
-debug-no-tag
מפעילה סוג ספציפי של הודעה לניפוי באגים. צריך להשתמש בטופס no כדי השבתה של סוג ההודעה לניפוי באגים. לדוגמה:

emulator @Pixel8_API_34 -debug-all -debug-no-metrics

כדי לראות את רשימת התגים, משתמשים בפקודה emulator -help-debug-tags.

-logcat logtags המדיניות הזו מאפשרת להציג הודעות Logcat לפחות בתג אחד או יותר כהודעות כתיבה אותם לחלון הטרמינל. לדוגמה, הפקודה הבאה מפעילה שגיאה הודעות מכל הרכיבים:

emulator @Pixel8_API_34 -logcat *:e

הפורמט של הפקודה logtags זהה לפורמט של הפקודה adb logcat logtags. צריך להזין adb logcat -help כדי לראות עוד מידע. זוהי רשימה של מסנני יומן של הפורמט, שמופרדים באמצעות רווחים או פסיקים componentName:logLevel componentName הוא כוכבית עם תו כללי לחיפוש (*) או שם של רכיב, כמו ActivityManager, SystemServer, InputManager, או WindowManager.

logLevel הוא אחד מהערכים הבאים:

  • v – דרגת מלל
  • d – ניפוי באגים
  • i – אינפורמטיבי
  • w – רמת יומן אזהרות
  • e – שגיאה
  • s – שקט

הדוגמה הבאה מציגה הודעות של רכיב GSM רמת היומן:

emulator @Pixel8_API_34 -logcat '*:s GSM:i'

אם לא תספקו את האפשרות -logcat בשורת הפקודה, אמולטור מחפש ANDROID_LOG_TAGS במשתנה הסביבה. אם ANDROID_LOG_TAGS מוגדר עם ערך חוקי הערך logtags ולא ריק, האמולטור משתמש בערך שלו כדי להפעיל פלט Logcat לטרמינל כברירת מחדל. אפשר גם להפנות באופן אוטומטי את אותן הודעות או הודעות יומן אחרות למסוף דרך adb.

לקבלת מידע נוסף מידע על Logcat ועל adb, ראו Logcat כלי שורת הפקודה, הצגה וכתיבה יומנים עם Logcat, Log class, ו-Issue adb פקודות.

-show-kernel הצגת הודעות על ניפוי באגים בליבה (kernel) בחלון הטרמינל. לדוגמה:

emulator @Pixel8_API_34 -show-kernel

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

-verbose מדפיסה הודעות אתחול של האמולטור לחלון הטרמינל. עבור דוגמה:

emulator @Pixel8_API_34 -verbose

מציג אילו קבצים והגדרות נבחרו בפועל בעת הפעלת מכשיר וירטואלי שמוגדר ב-AVD. האפשרות הזו זהה לציון -debug-init

רשת
-dns-server servers נעשה שימוש בשרתי ה-DNS שצוינו. servers הוא רשימה מופרדת בפסיקים של עד ארבעה שמות שרתי DNS או כתובות IP. עבור דוגמה:
emulator @Pixel8_API_34 -dns-server 192.0.2.0,
192.0.2.255

כברירת מחדל, האמולטור מנסה לזהות את שרתי ה-DNS שמשמשים אותך ומגדיר את יצירת כינויים מיוחדים ברשת האמולציה של חומת האש כדי לאפשר למערכת Android כדי להתחבר ישירות לשרתים. משתמשים באפשרות -dns-server כדי לציין או רשימה אחרת של שרתי DNS.

-http-proxy proxy יוצרת את כל חיבורי ה-TCP דרך שרת HTTP/HTTPS שצוין. אם האמולטור חייב לגשת לאינטרנט דרך שרת proxy, אפשר להשתמש או במשתנה הסביבה http_proxy כדי להגדיר הפניות אוטומטיות מתאימות. לדוגמה:

emulator @Pixel8_API_34 -http-proxy myserver:1981

proxy יכול להיות אחד מ- הבאים:

http://server:port
http://username:password@server:port

אפשר להשמיט את הקידומת http://.

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

-netdelay delay

הגדרת אמולציית זמן האחזור של הרשת לאחת מהאפשרויות הבאות delay ערכים באלפיות השנייה:

  • gsm – GSM/CSD (מינימום 150, מקסימום 550).
  • hscsd – HSCSD (לפחות 80, מקסימום 400).
  • gprs – GPRS (לפחות 35, מקסימום 200).
  • edge – EDGE/EGPRS (לפחות 80, מקסימום 400).
  • umts – UMTS/3G (לפחות 35, מקסימום 200).
  • hsdpa – HSDPA (מינימום 0, מקסימום 0).
  • lte – LTE (מינימום 0, מקסימום 0).
  • evdo – EVDO (מינימום 0, מקסימום 0).
  • none – ללא זמן אחזור, ברירת המחדל (מינימום 0, מקסימום 0).
  • num – מציין את זמן האחזור המדויק.
  • min:max – מציין פונקציות מינימליות זמן אחזור מקסימלי.

לדוגמה:

emulator @Pixel8_API_34 -netdelay gsm

האמולטור תומך בויסות רשת (throttle) ובזמני אחזור גבוהים יותר של החיבור. אפשר להגדיר אותו דרך תצורת הסקין או באמצעות אפשרויות של ‑netspeed ו--netdelay.

-netfast ההגדרה משביתה ויסות נתונים ברשת. לדוגמה:

emulator @Pixel8_API_34 -netfast

האפשרות הזו זהה לציון -netspeed full -netdelay none. אלה ערכי ברירת המחדל של האפשרויות האלה.

-netspeed speed

הגדרת אמולציית מהירות הרשת. מציינת את ההעלאה המקסימלית לרשת מהירויות הורדה עם אחד מערכי speed הבאים ב- קילו-סיביות לשנייה:

  • gsm – GSM/CSD (למעלה: 14.4, למטה: 14.4).
  • hscsd - HSCSD (למעלה: 14.4, למטה: 57.6).
  • gprs – GPRS (למעלה: 28.8, ירידה: 57.6).
  • edge - EDGE/EGPRS (למעלה: 473.6, למטה: 473.6).
  • umts – UMTS/3G (למעלה: 384.0, למטה: 384.0).
  • hsdpa – HSDPA (למעלה: 5760.0, למטה: 13,980.0).
  • lte – LTE (עלייה: 58,000, ירידה: 173,000).
  • evdo – EVDO (עלייה: 75,000, ירידה: 280,000).
  • full – ללא מגבלה, ברירת המחדל (עלייה: 0.0, ירידה: 0.0).
  • num – מציין גם את מהירות ההעלאה וגם את מהירות ההורדה.
  • up:down – ציון כלפי מעלה או כלפי מטה מהירויות גבוהות.

לדוגמה:

emulator @Pixel8_API_34 -netspeed edge

האמולטור תומך בויסות רשת (throttle) ובזמני אחזור גבוהים יותר של החיבור. אפשר להגדיר אותו דרך תצורת הסקין או באמצעות אפשרויות של ‑netspeed ו--netdelay.

-port port המדיניות הזו מגדירה את מספר יציאת ה-TCP שמשמשת את המסוף ואת adb. לדוגמה:

emulator @Pixel8_API_34 -port 5556

ערך ברירת המחדל הוא 5554 למופע של המכשיר הווירטואלי הראשון שפועל במחשב שלך. בדרך כלל למכשיר וירטואלי יש שתי יציאות סמוכות: יציאת המסוף ויציאה של adb. המסוף של המכשיר הווירטואלי הראשון שפועל על מכונה מסוימת משתמשת ביציאה 5554 במסוף וביציאה 5555 של adb. עוקב מכונות משתמשות במספרי היציאות שגדלים בשניים. לדוגמה, 5556/5557, 5558/5559 וכן הלאה. הטווח הוא 5,554 עד 5682, ואפשר להציג בו-זמנית 64 תווים של מכשירים וירטואליים.

הקצאות היציאות זהות לעיתים קרובות לציון -ports port,{port + 1}. חובה על {port + 1} יהיה בחינם ושמור ל-adb. אם אחת מהיציאות של המסוף או של adb הן האמולטור כבר נמצא בשימוש, לכן לא ניתן יהיה להפעיל אותו.

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

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

-ports
console-port,adb-port
מגדירה את יציאות ה-TCP שמשמשות את המסוף ואת adb. לדוגמה:

emulator @Pixel8_API_34 -ports 5556,5559

טווח היציאות החוקי הוא 5554 עד 5682, כך שאפשר להשתמש ב-64 יציאות וירטואליות בו-זמנית מכשירים. האפשרות -ports מדווחת אילו יציאות והמספר הסידורי שמופע האמולטור משתמש ומזהיר אם יש בעיות עם והערכים שסיפקת.

במקום זאת, מומלץ להשתמש באפשרות -port, כשהדבר אפשרי. האפשרות -ports זמינה להגדרות רשת שדורשות הגדרות מיוחדות.

למידע נוסף על הגדרת המסוף ויציאות של adb, אפשר להיעזר ב אפשרות -port.

-tcpdump filepath תיעוד של חבילות רשת ואחסון שלהן בקובץ. לדוגמה:

emulator @Pixel8_API_34 -tcpdump /path/dumpfile.cap

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

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

מערכת
-accel mode המדיניות הזו מגדירה את שיפור המהירות של מכונות VM באמולטור. לדוגמה:

emulator @Pixel8_API_34 -accel auto

אמולציה מואצת פועלת רק בתמונות מערכת מסוג x86 ו-x86_64. ב-Linux, היא מבוססת על KVM. ב-Windows וב-Mac, הוא מסתמך על מעבדי Intel ומעבדי Intel HAXM לנהג. אם לא מבצעים אמולציה של מכשיר x86 או x86_64, המערכת מתעלמת מהאפשרות הזו.

הערכים החוקיים עבור mode הם:

  • auto - קובע באופן אוטומטי אם יש תמיכה בתאוצה משתמש בה כשאפשר (ברירת מחדל).
  • off - משבית לחלוטין את ההאצה, וזה שימושי בעיקר לניפוי באגים.
  • on – מאלץ תאוצה. אם KVM או HAXM לא מותקנים או שאפשר להשתמש בו, האמולטור לא מתחיל לפעול ומדפיס הודעת שגיאה.

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

-accel-check הפונקציה בודקת אם hypervisor שנדרש להאצת ה-VM של האמולטור הוא (HAXM או KVM). לדוגמה:

emulator -accel-check

מידע נוסף זמין במאמר איך בודקים אם מותקנת hypervisor.

-engine engine

מציינת את מנוע האמולטור:

  • auto – בחירת מנוע באופן אוטומטי (ברירת מחדל).
  • classic – נעשה שימוש במנוע QEMU 1 הישן (הוצא משימוש).
  • qemu2 – נעשה שימוש במנוע QEMU 2 החדש יותר.

לדוגמה:

emulator @Pixel8_API_34 -engine auto

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

-gpu mode בחירה במצב אמולציית GPU. לדוגמה:

emulator @Pixel8_API_34 -gpu swiftshader_indirect

מידע נוסף מופיע כאן: הגדרה של האצת הגרפיקה.

-no-accel ההגדרה משביתה את האצת מהירות ה-VM של האמולטור בזמן השימוש במערכת x86 או x86_64 תמונה. הוא שימושי לניפוי באגים בלבד והוא זהה לציון -accel off. לדוגמה:

emulator @Pixel8_API_34 -no-accel

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

-nojni
-no-jni
השבתת הבדיקות המורחבות של Java Native Interface (JNI) ב-Android Dalvik או ART. לדוגמה:

emulator @Pixel8_API_34 -nojni

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

-selinux {disabled|permissive} מגדיר את Security-Enhanced Linux (SELinux) מודול אבטחה למצב disabled או permissive במצב Linux שפועל המערכת. לדוגמה:

me-linux$ emulator @Pixel8_API_34 -selinux permissive

כברירת מחדל, SELinux נמצא במצב enforcing. כלומר, מדיניות האבטחה אכיפה. מצב permissive טוען את מדיניות SELinux, אבל לא לאכוף אותו. האפשרות הזו מתעדת רק הפרות מדיניות. מצב disabled מושבת תמיכה בליבה (kernel) של SELinux.

-timezone timezone

מגדיר את אזור הזמן של המכשיר הווירטואלי כ- timezone במקום אזור הזמן של המארח. עבור דוגמה:

emulator @Pixel8_API_34 -timezone Europe/Paris

כברירת מחדל, האמולטור משתמש באזור הזמן של מחשב הפיתוח. כדאי להשתמש באפשרות הזו כדי לציין אזור זמן אחר, או אם הזיהוי האוטומטי לא פועלות כראוי. הערך של timezone חייב להופיע ב-zoneinfo בפורמט area/location, area/subarea/location לדוגמה:

  • America/Los_Angeles
  • Europe/Paris
  • America/Argentina/Buenos_Aires

אזור הזמן שצוין חייב להיות במסד הנתונים שלzoneinfo.

-version הצגת מספר הגרסה של האמולטור. לדוגמה:

emulator @Pixel8_API_34 -version

או

emulator -version
ממשק משתמש
-no-boot-anim ההגדרה משביתה את אנימציית האתחול במהלך ההפעלה של האמולטור לצורך אתחול מהיר יותר. לדוגמה:

emulator @Pixel8_API_34 -no-boot-anim

במחשבים איטיים יותר, האפשרות הזו יכולה לזרז משמעותית את רצף ההפעלה.

-screen mode מגדיר את מצב מסך מגע 'אמולציה'. לדוגמה:

emulator @Pixel8_API_34 -screen no-touch

mode יכול להיות כל אחד מהערכים הבאים:

  • touch – אמולציה של מסך מגע (ברירת מחדל).
  • multi-touch – אמולציה של מסך עם מספר מגע.
  • no-touch – השבתת מסך מגע ומסך מולטי-טאץ' אמולציה.

אפשרויות מתקדמות

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

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

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

טבלה 4. אפשרויות מתקדמות של שורת פקודה

אפשרות מתקדמת תיאור קצר
-bootchart timeout

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

לדוגמה:

emulator @Pixel8_API_34 -bootchart 120
-cache filepath

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

לדוגמה:

emulator @Pixel8_API_34 -cache
   ~/.android/avd/Pixel8_API_34.avd/cache_persistent.img

אם לא משתמשים באפשרות הזו, ברירת המחדל היא קובץ זמני בשם cache.img מידע נוסף זמין במאמר נתוני AVD לספרייה.

-cache-size size

מגדיר את גודל מחיצת המטמון ב-MB.

לדוגמה:

emulator @Pixel8_API_34 -cache-size 1000

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

-data filepath

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

לדוגמה:

emulator @Pixel8_API_34 -data
   ~/.android/avd/Pixel8_API_34.avd/userdata-test.img

אם לא משתמשים באפשרות הזו, ברירת המחדל היא קובץ בשם userdata-qemu.img. אפשר לקרוא מידע נוסף על קובץ נתוני המשתמשים במאמר נתוני AVD לספרייה.

-datadir dir

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

לדוגמה:

emulator @Pixel8_API_34 -datadir
   ~/.android/avd/Pixel8_API_34.avd/mytest
-force-32bit

נעשה שימוש באמולטור 32 ביט בפלטפורמות של 64 ביט. מדי פעם, האפשרות הזו שימושי לבדיקה או לניפוי באגים. לדוגמה, הייתה בעיה שבה לפעמים לא היה אפשר להריץ את האמולטור ב-Windows בגרסת 64 ביט, אבל גרסת 32 סיביות כן הריצה אותו. הזה עזרה בביצוע השוואות כדי לנפות את הבאגים שגרמו לבעיה. הנה דוגמה:

emulator @Pixel8_API_34 -force-32bit
-help-disk-images

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

emulator -help-disk-images
-help-char-devices

מקבל עזרה לגבי מפרטי הדמות device. א' יש אפשרויות של אמולטור שנדרשות לפרמטר device. לדוגמה:

emulator -help-char-devices
-help-sdk-images

קבלת עזרה לגבי קובצי אימג' בדיסק שרלוונטיים למפתחי אפליקציות. האפשרות הזו מקבלת מידע על המיקום של קובצי התמונה עבור AVD שנוצר עם כלי SDK. לדוגמה:

emulator -help-sdk-images
-help-build-images

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

emulator -help-build-images
-initdata filepath
-init-data filepath

מציין את הגרסה הראשונית של מחיצת הנתונים. לאחר איפוס הנתונים נתוני משתמש, האמולטור מעתיק את התוכן של הקובץ שצוין למשתמש (כברירת מחדל, הקובץ userdata-qemu.img) במקום להשתמש ברכיב כברירת מחדל של הקובץ userdata.img כגרסה הראשונית. מציינת את ונתיב מוחלט או נתיב יחסי לספריית העבודה.

לדוגמה:

emulator @Pixel8_API_34 -initdata
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/userdata-test.img

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

-kernel filepath

משתמשת באמולציית ליבה (kernel) ספציפית. אם לא מציינים נתיב, האמולטור מחפש בספריית המערכת.

משתמשים ב האפשרות ‑show‑kernel להצגת הודעות על תוצאות ניפוי באגים בליבה (kernel).

לדוגמה:

emulator @Pixel8_API_34 -kernel
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/kernel-test.img -show-kernel

אם לא מציינים את האפשרות הזו, ברירת המחדל היא kernel-ranchu. לקבלת מידע נוסף ראו ספריית מערכת של AVD.

-noaudio
-no-audio

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

לדוגמה:

emulator @Pixel8_API_34 -noaudio
-nocache
-no-cache

הפעלת האמולטור ללא מחיצת מטמון. אם אתם לא משתמשים בזה ברירת המחדל היא קובץ זמני בשם cache.img. הזה היא מיועדת למפתחים של פלטפורמות בלבד. מידע נוסף זמין במאמר ספריית הנתונים של AVD.

לדוגמה:

emulator @Pixel8_API_34 -nocache
-no-snapshot

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

לדוגמה:

emulator @Pixel8_API_34 -no-snapshot
-no-snapshot-load

מונע מהאמולטור לטעון את מצב ה-AVD מאחסון קובץ ה-snapshot. מבצע אתחול מלא.

לדוגמה:

emulator @Pixel8_API_34 -no-snapshot-load
-no-snapshot-save

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

לדוגמה:

emulator @Pixel8_API_34 -no-snapshot-save
-no-snapshot-update-time

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

לדוגמה:

emulator @Pixel8_API_34 -no-snapshot-update-time
-no-snapstorage

הפעלת האמולטור בלי לטעון קובץ לאחסון או לטעינה של מצב קובצי snapshot, לאלץ הפעלה מלאה והשבתת הפונקציונליות של מצב תמונת מצב. הזה האפשרות הזו מבטלת את -snapstorage ואת -snapshot אפשרויות.

לדוגמה:

emulator @Pixel8_API_34 -no-snapstorage
-no-window

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

emulator @Pixel8_API_34 -no-window
-partition-size size

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

emulator @Pixel8_API_34 -partition-size 1024
-prop name=value

הגדרת מאפיין של מערכת Android באמולטור בזמן האתחול. name חייב להיות שם נכס עם תווית של qemu_prop לכל היותר 32 תווים ללא רווחים, והמשתנה value חייב להיות מחרוזת של 92 תווים לכל היותר. לדוגמה, אפשר להיכנס אל קובץ אחד (property_contexts). אפשר לציין כמה אפשרויות של ‑prop בחשבון אחד בשורת הפקודה. האפשרות הזו יכולה להיות שימושית לניפוי באגים. לדוגמה:

emulator @Pixel8_API_34 -prop qemu.name=value -prop qemu.abc=xyz
-qemu args מעביר ארגומנטים לתוכנת האמולטור QEMU. כשמשתמשים באפשרות הזו, חשוב לוודא שזו הפעם האחרונה שצוינה, מאחר שכל האפשרויות לאחר מכן מפורשות כספציפיות ל-QEMU אפשרויות. אפשרות זו די מתקדמת ומומלץ להשתמש בה רק למפתחים מכירים מאוד את QEMU וגם את האמולציה של Android.
-qemu -h

הצגת העזרה של -qemu. לדוגמה:

emulator -qemu -h
-ramdisk filepath

מציין תמונת אתחול של Ramdisk. מציינת את שם הקובץ ונתיב מוחלט או נתיב יחסי לספריית העבודה.

לדוגמה:

emulator @Pixel8_API_34 -ramdisk
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/ramdisk-test.img

אם לא משתמשים באפשרות הזו, ברירת המחדל היא הקובץ ramdisk.img בספריית המערכת. לקבלת מידע נוסף ראו ספריית מערכת של AVD.

-report-console socket

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

  • tcp:port[,server][,max=seconds][,ipv6]
  • unix:port[,server][,max=seconds][,ipv6]

לקבלת מידע נוסף, אפשר להשתמש באפשרות -help-report-console כמו שמתואר לקבלת עזרה לגבי אפשרויות ספציפיות.

-shell

יצירת מסוף של מעטפת ברמה הבסיסית (root) בטרמינל הנוכחי. האפשרות הזו שונה הפקודה adb shell בדרכים הבאות:

  • היא יוצרת מעטפת root שמאפשרת לשנות חלקים רבים המערכת.
  • הוא פועל גם אם adb daemon במערכת האמולציה לא תקין.
  • כדי להפסיק את האמולטור במקום את המעטפת, לוחצים על Control+C (או על Command-C ב-macOS).

לדוגמה:

emulator @Pixel8_API_34 -shell
-snapshot name

מציין את השם של תמונת מצב בקובץ אחסון תמונת מצב להפעלה אוטומטית התחלה ושמירה של פעולות.

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

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

יש לעיין באפשרות -snapstorage לקבלת מידע על שמציין את קובץ האחסון של תמונת המצב ואת קובץ ברירת המחדל.

emulator @Pixel8_API_34 -snapshot snapshot2

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

ניתן גם ליצור תמונת מצב ממסוף האמולטור באמצעות הפקודה avd snapshot save name. מידע נוסף זמין במאמר הבא: שליחת פקודות במסוף האמולטור

-snapshot-list

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

לדוגמה:

emulator @Pixel8_API_34 -snapshot-list -snapstorage
   ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img

אפשר להשתמש בערכים של העמודה ID (מזהה) ו-TAG (תג) בפלט כארגומנטים לאפשרות -snapshot.

-snapstorage filepath

מציינת קובץ מאגר שמכיל את כל תמונות המצב של המצבים. הכול תמונות מצב שנוצרות במהלך הביצוע נשמרות בקובץ הזה. רק ניתן לשחזר תמונות מצב בקובץ הזה במהלך הרצת האמולטור.

לדוגמה:

emulator @Pixel8_API_34 -snapstorage
   ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img

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

-sysdir dir

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

emulator @Pixel8_API_34 -sysdir
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/test
-system filepath

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

לדוגמה:

emulator @Pixel8_API_34 -system
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/system-test.img

אם לא משתמשים באפשרות הזו, ברירת המחדל היא הקובץ system.img בספריית המערכת. לקבלת מידע נוסף ראו ספריית מערכת של AVD.

-use-system-libs

ב-Linux, נעשה שימוש במערכת libstdc++ במקום בגרסה המצורפת עם מערכת האמולטור. יש להשתמש באפשרות הזו רק אם האמולטור לא פועל כרגיל, הוא לא תמיד עובד. לחלופין, מגדירים את משתנה הסביבה ANDROID_EMULATOR_USE_SYSTEM_LIBS ל-1.

לדוגמה:

me-linux$ emulator @Pixel8_API_34 -use-system-libs
-writable-system

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

  1. ניתן להפעיל מכשיר וירטואלי עם האפשרות -writable-system.
  2. כדי לומר זאת, מזינים את הפקודה adb remount מטרמינל של הפקודה האמולטור כדי לטעון מחדש את system/ במצב קריאה/כתיבה. כברירת מחדל, הוא טעון בתור לקריאה בלבד.

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

אפשרויות שהוצאו משימוש

האפשרויות הבאות של שורת הפקודה הוצאו משימוש:

  • -audio-in
  • -audio-out
  • -charmap
  • -code-profile
  • -cpu-delay
  • -dpi-device
  • -dynamic_skin
  • -enable-kvm
  • -gps
  • -image
  • -keyset
  • -help-keys
  • -help-keyset-file
  • -nand-limits
  • -noskin
  • -no-skin
  • -onion
  • -onion-alpha
  • -onion-rotation
  • -radio
  • -ranchu
  • -raw-keys
  • -scale
  • -shared-net-id
  • -shell-serial
  • -skin
  • -skindir
  • -trace
  • -useaudio

קבלת עזרה לגבי אפשרויות של שורת הפקודה

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

הצגת רשימה של כל האפשרויות לאמולטור

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

emulator -help

קבלת עזרה מפורטת לגבי אפשרות ספציפית

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

emulator -help-option

לדוגמה:

emulator -help-netspeed

העזרה הזו מפורטת יותר מהתיאור שסופק על ידי אפשרות -help.

עזרה מפורטת לגבי כל האפשרויות

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

emulator -help-all

הצגת רשימה של משתני הסביבה של האמולטור

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

emulator -help-environment

אפשר להגדיר משתני סביבה בחלון הטרמינל לפני שמפעילים במכשיר וירטואלי, או להגדיר אותו דרך הגדרות המשתמש המערכת. לדוגמה, מגדירים אותו בקובץ .bashrc ב-Linux.

הצגת רשימה של תגי ניפוי באגים

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

emulator -help-debug-tags

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