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
להתקנה, הרצה ובדיקה של האפליקציה,
בצעו את השלבים הכלליים הבאים:
- בונים וארוזים את האפליקציה ב-APK, כפי שמתואר במאמר יצירה והפעלה של app.
- מפעילים את האמולטור משורת הפקודה, כפי שתואר קודם באמצעות אפשרויות ההפעלה הנדרשות.
- התקנת האפליקציה באמצעות
adb
. - מריצים את האפליקציה באמולטור ובודקים אותה.
כשהאמולטור הוא תוכל להשתמש באמולטור המסוף כדי להנפיק פקודות לפי הצורך.
כדי להסיר אפליקציה, מסירים אותה בדיוק כמו במכשיר 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.
האמולטור קורא את הקבצים הבאים מספריית המערכת:
קובץ | תיאור | אפשרות לציין קובץ אחר |
---|---|---|
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.
בטבלה הבאה מפורטים הקבצים החשובים ביותר בספרייה הזו:
קובץ | תיאור | אפשרות לציין קובץ אחר |
---|---|---|
userdata-qemu.img
|
התוכן של מחיצת הנתונים, שמופיע כ-
כל מופע של מכשיר וירטואלי משתמש בתמונה של נתוני משתמש שניתנת לכתיבה כדי לאחסן את המשתמשים
נתונים ספציפיים לסשן. לדוגמה, היא משתמשת בתמונה כדי לאחסן את
נתוני האפליקציות, ההגדרות, מסדי הנתונים והקבצים שהותקנו. לכל משתמש יש
ספריית |
-data
|
cache.img
|
תמונת מחיצת המטמון שמופיעה כ-cache/
אמולציה של המערכת. היא ריקה כשיוצרים לראשונה AVD או משתמשים
אפשרות -wipe-data . היא מאחסנת קובצי הורדה זמניים
מאוכלסים על ידי מנהל ההורדות ולפעמים המערכת. לדוגמה,
הדפדפן משתמש בו כדי לשמור במטמון דפי אינטרנט ותמונות שהורדו בזמן שהאמולטור
ריצה. כשמשביתים את המכשיר הווירטואלי, הקובץ נמחק. אפשר
לשמור את הקובץ באמצעות האפשרות -cache .
|
-cache
|
sdcard.img
|
(אופציונלי) תמונה של מחיצה בכרטיס SD שמאפשרת לדמות כרטיס SD
במכשיר וירטואלי. אפשר ליצור קובץ תמונה של כרטיס SD דרך AVD
מנהל או באמצעות
כשמגדירים AVD במנהל ה-AVD, ניתן לבחור
כדי להשתמש בקובץ כרטיס SD שמנוהל באופן אוטומטי או בקובץ שיצרתם באמצעות
הכלי
אפשר לעיין בקבצים, לשלוח קבצים, להעתיק ולהסיר קבצים מסימולציה של SD
באמצעות ממשק המשתמש של האמולטור או
כדי להעתיק קבצים לקובץ של כרטיס ה-SD לפני שטוענים אותו, צריך לטעון את התמונה
את הקובץ בתור מכשיר לולאה, ולאחר מכן מעתיקים את הקבצים. או להשתמש בכלי עזר כמו
חבילת האמולטור מתייחס לקובץ כמאגר בייטים, כך שהפורמט של כרטיס ה-SD לא חשובות.
האפשרות |
-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.
אפשרויות נפוצות
בטבלה הבאה מפורטות אפשרויות ההפעלה של שורת הפקודה שעשויות להיות בשימוש לעיתים קרובות יותר:
אפשרות של שורת פקודה | תיאור |
---|---|
הפעלה מהירה | |
-no-snapshot-load
|
מבצע אתחול קר ושומר את מצב האמולטור ביציאה. |
-no-snapshot-save
|
מבצע אתחול מהיר אם אפשר, אבל לא שומר את מצב האמולטור ביציאה. |
-no-snapshot
|
ההגדרה משביתה לחלוטין את תכונת ההפעלה המהירה, ללא טעינה או שמירה של מצב האמולטור. |
חומרת המכשיר | |
-camera-back mode -camera-front mode
|
מגדיר את מצב האמולציה של מצלמה עם המצלמה האחורית או הקדמית. הפעולה הזו תבטל את ההגדרות של המצלמה
ב-AVD.
לדוגמה: 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' בדוגמה, החל מגרסה 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.
אם לא מציינים את האפשרות הזו, ברירת המחדל היא |
-wipe-data
|
מחיקת נתוני המשתמשים והעתקת הנתונים מקובץ הנתונים הראשוני. האפשרות הזו
מנקה את הנתונים של המכשיר הווירטואלי ומחזיר אותו למצב שבו הוא היה
הוא הוגדר לראשונה. כל האפליקציות וההגדרות שהותקנו יוסרו. לדוגמה:
emulator @Pixel8_API_34 -wipe-data
כברירת מחדל, קובץ נתוני המשתמשים הוא |
ניפוי באגים | |
-debug tags
|
המדיניות מפעילה או משביתה את ההצגה של הודעות ניפוי באגים בתג אחד או יותר.
יש להפריד בין תגים באמצעות רווח, פסיק או עמודה. לדוגמה:
$ emulator @Pixel8_API_34 -debug init,metrics כדי להשבית תג, מוסיפים לפניו מקף (-). לדוגמה, מציגה את כל ההודעות על ניפוי הבאגים, מלבד ההודעות הקשורות לשקעי רשת ומדדים:
לרשימת תגים ותיאורים אפשר להשתמש ב
emulator -help-debug-tags
אפשר להגדיר את תגי ברירת המחדל לניפוי באגים בקטע
ANDROID_VERBOSE=socket,gles הדבר מקביל לשימוש:
או
|
-debug-tag -debug-no-tag
|
מפעילה סוג ספציפי של הודעה לניפוי באגים. צריך להשתמש בטופס no כדי
השבתה של סוג ההודעה לניפוי באגים. לדוגמה:
emulator @Pixel8_API_34 -debug-all -debug-no-metrics
כדי לראות את רשימת התגים, משתמשים בפקודה |
-logcat logtags
|
המדיניות הזו מאפשרת להציג הודעות Logcat לפחות בתג אחד או יותר כהודעות כתיבה
אותם לחלון הטרמינל. לדוגמה, הפקודה הבאה מפעילה שגיאה
הודעות מכל הרכיבים:
emulator @Pixel8_API_34 -logcat *:e
הפורמט של הפקודה
הדוגמה הבאה מציגה הודעות של רכיב GSM רמת היומן:
emulator @Pixel8_API_34 -logcat '*:s GSM:i'
אם לא תספקו את האפשרות לקבלת מידע נוסף
מידע על Logcat ועל |
-show-kernel
|
הצגת הודעות על ניפוי באגים בליבה (kernel) בחלון הטרמינל. לדוגמה:
emulator @Pixel8_API_34 -show-kernel אפשרות אחת היא לבדוק שתהליך האתחול פועל כמו שצריך. |
-verbose
|
מדפיסה הודעות אתחול של האמולטור לחלון הטרמינל. עבור
דוגמה:
emulator @Pixel8_API_34 -verbose
מציג אילו קבצים והגדרות נבחרו בפועל בעת הפעלת
מכשיר וירטואלי שמוגדר ב-AVD. האפשרות הזו זהה לציון
|
רשת | |
-dns-server servers
|
נעשה שימוש בשרתי ה-DNS שצוינו. servers הוא
רשימה מופרדת בפסיקים של עד ארבעה שמות שרתי DNS או כתובות IP. עבור
דוגמה:
emulator @Pixel8_API_34 -dns-server 192.0.2.0,
כברירת מחדל, האמולטור מנסה לזהות את שרתי ה-DNS שמשמשים אותך ומגדיר את
יצירת כינויים מיוחדים ברשת האמולציה של חומת האש כדי לאפשר למערכת Android
כדי להתחבר ישירות לשרתים. משתמשים באפשרות |
-http-proxy proxy
|
יוצרת את כל חיבורי ה-TCP דרך שרת HTTP/HTTPS שצוין. אם
האמולטור חייב לגשת לאינטרנט דרך שרת proxy, אפשר להשתמש
או במשתנה הסביבה http_proxy כדי להגדיר
הפניות אוטומטיות מתאימות. לדוגמה:
emulator @Pixel8_API_34 -http-proxy myserver:1981
אפשר להשמיט את הקידומת
אם האפשרות הזו לא זמינה, האמולטור מחפש את |
-netdelay delay
|
הגדרת אמולציית זמן האחזור של הרשת לאחת מהאפשרויות הבאות
לדוגמה: emulator @Pixel8_API_34 -netdelay gsm
האמולטור תומך בויסות רשת (throttle) ובזמני אחזור גבוהים יותר של החיבור.
אפשר להגדיר אותו דרך תצורת הסקין או באמצעות
אפשרויות של |
-netfast
|
ההגדרה משביתה ויסות נתונים ברשת. לדוגמה:
emulator @Pixel8_API_34 -netfast
האפשרות הזו זהה לציון |
-netspeed speed
|
הגדרת אמולציית מהירות הרשת. מציינת את ההעלאה המקסימלית לרשת
מהירויות הורדה עם אחד מערכי
לדוגמה: emulator @Pixel8_API_34 -netspeed edge
האמולטור תומך בויסות רשת (throttle) ובזמני אחזור גבוהים יותר של החיבור.
אפשר להגדיר אותו דרך תצורת הסקין או באמצעות
אפשרויות של |
-port port
|
המדיניות הזו מגדירה את מספר יציאת ה-TCP שמשמשת את המסוף ואת adb . לדוגמה:
emulator @Pixel8_API_34 -port 5556
ערך ברירת המחדל הוא 5554 למופע של המכשיר הווירטואלי הראשון שפועל
במחשב שלך. בדרך כלל למכשיר וירטואלי יש שתי יציאות סמוכות:
יציאת המסוף ויציאה של
הקצאות היציאות זהות לעיתים קרובות לציון האפשרות
שימו לב שאם הערך של |
-ports
|
מגדירה את יציאות ה-TCP שמשמשות את המסוף ואת adb . לדוגמה:
emulator @Pixel8_API_34 -ports 5556,5559
טווח היציאות החוקי הוא 5554 עד 5682, כך שאפשר להשתמש ב-64 יציאות וירטואליות בו-זמנית
מכשירים. האפשרות
במקום זאת, מומלץ להשתמש באפשרות
למידע נוסף על הגדרת המסוף ויציאות של |
-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, המערכת מתעלמת מהאפשרות הזו.
הערכים החוקיים עבור
מידע נוסף זמין במאמר הגדרה שיפור המהירות באמצעות חומרה לאמולטור Android. |
-accel-check
|
הפונקציה בודקת אם hypervisor שנדרש להאצת ה-VM של האמולטור הוא
(HAXM או KVM). לדוגמה:
emulator -accel-check מידע נוסף זמין במאמר איך בודקים אם מותקנת hypervisor. |
-engine engine
|
מציינת את מנוע האמולטור:
לדוגמה:
emulator @Pixel8_API_34 -engine auto
על הזיהוי האוטומטי לבחור את הערך שמספק את הביצועים הטובים ביותר
אמולציה של AVD ספציפי. שימוש באפשרות |
-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 נמצא במצב |
-timezone timezone
|
מגדיר את אזור הזמן של המכשיר הווירטואלי כ-
emulator @Pixel8_API_34 -timezone Europe/Paris
כברירת מחדל, האמולטור משתמש באזור הזמן של מחשב הפיתוח. כדאי להשתמש
באפשרות הזו כדי לציין אזור זמן אחר, או אם הזיהוי האוטומטי לא
פועלות כראוי. הערך של
אזור הזמן שצוין חייב להיות במסד הנתונים של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
|
אפשרויות מתקדמות
אפשרויות ההפעלה של שורת הפקודה שמפורטות בטבלה הבאה זמינות אבל לא נפוצות מאת מפַתח אפליקציות ממוצע.
בתיאורים, ספריית העבודה היא הספרייה הנוכחית הטרמינל שבו אתם מזינים פקודות. מידע נוסף על ה-AVD ספריית המערכת וספריית הנתונים והקבצים המאוחסנים בתוכם, תוכלו לעיין בסעיף על ספריות וקבצים שמוגדרים כברירת מחדל.
חלק מהאפשרויות האלה מתאימות למפתחי אפליקציות חיצוניים, וחלק משתמשים בהם בעיקר מפתחי פלטפורמות. יצירה של מפתחי אפליקציות אפליקציות ל-Android ולהריץ אותן בהתקני AVD ספציפיים. מפתחי פלטפורמות עובדים על במערכת Android ולהריץ אותו בתוך האמולטור ללא AVD מוכן מראש.
אפשרות מתקדמת | תיאור קצר |
---|---|
-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-size size
|
מגדיר את גודל מחיצת המטמון ב-MB. לדוגמה: emulator @Pixel8_API_34 -cache-size 1000 אחרת לציין אפשרות זו. ברירת המחדל היא 66MB. בדרך כלל, רוב מפתחי האפליקציות לא זקוקים לאפשרות הזו, אלא אם הם צריכים להוריד קבצים גדולים מאוד שגדולים מברירת המחדל של Google. מידע נוסף על המטמון ראו את ספריית הנתונים של AVD. |
-data filepath
|
מגדיר את קובץ התמונה של מחיצת נתוני המשתמשים. מספקת שם קובץ
נתיב מוחלט או נתיב יחסי לספריית העבודה, כדי להגדיר
קובץ של נתוני משתמשים קבועים. אם הקובץ לא קיים, האמולטור יוצר
תמונה מקובץ ברירת המחדל לדוגמה: emulator @Pixel8_API_34 -data ~/.android/avd/Pixel8_API_34.avd/userdata-test.img אם לא משתמשים באפשרות הזו, ברירת המחדל היא קובץ בשם |
-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
|
מקבל עזרה לגבי מפרטי הדמות 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
|
מציין את הגרסה הראשונית של מחיצת הנתונים. לאחר איפוס הנתונים
נתוני משתמש, האמולטור מעתיק את התוכן של הקובץ שצוין למשתמש
(כברירת מחדל, הקובץ לדוגמה: 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 אם לא מציינים את האפשרות הזו, ברירת המחדל היא |
-noaudio
-no-audio
|
השבתת התמיכה באודיו במכשיר הווירטואלי הזה. חלק מ-Linux ומ-Windows
למחשבים יש מנהלי התקנים אודיו פגומים שגורמים לתסמינים שונים, כמו
שמונעת את הפעלת האמולטור. במקרה הזה, כדאי להשתמש באפשרות הזאת כדי
להתגבר על הבעיה. אפשר גם להשתמש ב- לדוגמה: emulator @Pixel8_API_34 -noaudio |
-nocache
-no-cache
|
הפעלת האמולטור ללא מחיצת מטמון. אם אתם לא משתמשים בזה
ברירת המחדל היא קובץ זמני בשם לדוגמה: emulator @Pixel8_API_34 -nocache |
-no-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, לאלץ הפעלה מלאה והשבתת הפונקציונליות של מצב תמונת מצב. הזה
האפשרות הזו מבטלת את לדוגמה: emulator @Pixel8_API_34 -no-snapstorage |
-no-window
|
השבתה של תצוגת חלון גרפי באמולטור. האפשרות הזו מועילה
כשמריצים את האמולטור בשרתים שאין להם תצוגה. ניתן לגשת לאמולטור דרך
emulator @Pixel8_API_34 -no-window |
-partition-size size
|
מציינת את גודל המחיצה של נתוני המערכת ב-MB. לדוגמה: emulator @Pixel8_API_34 -partition-size 1024 |
-prop name=value
|
הגדרת מאפיין של מערכת Android באמולטור בזמן האתחול.
emulator @Pixel8_API_34 -prop qemu.name=value -prop qemu.abc=xyz |
-qemu args
|
מעביר ארגומנטים לתוכנת האמולטור QEMU. כשמשתמשים באפשרות הזו, חשוב לוודא שזו הפעם האחרונה שצוינה, מאחר שכל האפשרויות לאחר מכן מפורשות כספציפיות ל-QEMU אפשרויות. אפשרות זו די מתקדמת ומומלץ להשתמש בה רק למפתחים מכירים מאוד את QEMU וגם את האמולציה של Android. |
-qemu -h
|
הצגת העזרה של 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 אם לא משתמשים באפשרות הזו,
ברירת המחדל היא הקובץ |
-report-console socket
|
דיווח על יציאת המסוף לצד שלישי מרוחק לפני שמתחילים
אמולציה. הכלי יכול להיות שימושי לסקריפט בדיקה אוטומטי.
חובה על
לקבלת מידע נוסף, אפשר להשתמש באפשרות |
-shell
|
יצירת מסוף של מעטפת ברמה הבסיסית (root) בטרמינל הנוכחי. האפשרות הזו שונה
הפקודה
לדוגמה: emulator @Pixel8_API_34 -shell |
-snapshot name
|
מציין את השם של תמונת מצב בקובץ אחסון תמונת מצב להפעלה אוטומטית התחלה ושמירה של פעולות. במקום לבצע רצף אתחול מלא, האמולטור יכול להמשיך בביצוע מתמונת מצב קודמת, בדרך כלל מהיר יותר בצורה משמעותית. כשמציינים את האפשרות הזו, האמולטור טוען את ה-snapshot של השם מתמונת ה-snapshot ושומר אותו שוב מתחת לאותו שם ביציאה. אם לא משתמשים באפשרות הזו, ברירת המחדל היא רצף אתחול מלא. אם תמונת המצב שצוינה לא קיימת, האמולטור מבצע במקום זאת רצף אתחול מלא ומבצע פעולת שמירה. יש לעיין באפשרות emulator @Pixel8_API_34 -snapshot snapshot2 חשוב לזכור שבעת הטעינה של קובץ snapshot, כל תוכן המערכת, נתוני המשתמש והתמונות בכרטיס ה-SD יוחלפו עם התכנים שהם שמרו בעת יצירת קובץ ה-snapshot. אלא אם שומרים את המידע הזה בתמונת מצב אחרת, וכל השינויים שבוצעו מאז יאבדו. ניתן גם ליצור תמונת מצב ממסוף האמולטור באמצעות
הפקודה |
-snapshot-list
|
הצגת רשימה של תמונות מצב זמינות. הפקודה הזו מדפיסה טבלה של תמונות מצב
שמורים בקובץ האחסון בתמונת המצב שהאמולטור הופעל
ב- ואז לצאת. אם מציינים לדוגמה: emulator @Pixel8_API_34 -snapshot-list -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img אפשר להשתמש בערכים של העמודה ID (מזהה) ו-TAG (תג) בפלט
כארגומנטים לאפשרות |
-snapstorage filepath
|
מציינת קובץ מאגר שמכיל את כל תמונות המצב של המצבים. הכול תמונות מצב שנוצרות במהלך הביצוע נשמרות בקובץ הזה. רק ניתן לשחזר תמונות מצב בקובץ הזה במהלך הרצת האמולטור. לדוגמה: emulator @Pixel8_API_34 -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.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 אם לא משתמשים באפשרות הזו,
ברירת המחדל היא הקובץ |
-use-system-libs
|
ב-Linux, נעשה שימוש במערכת לדוגמה: me-linux$ emulator @Pixel8_API_34 -use-system-libs |
-writable-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
אפשר להפעיל או להשבית הודעות ניפוי באגים מ:
או ברכיבים ספציפיים של אמולטור, כפי שצוינו על ידי התגים.