יצירה וניהול של מכשירים וירטואליים

מכשיר אנדרואיד וירטואלי (AVD) הוא הגדרה שמגדירה את המאפיינים של טלפון Android, טאבלט, Wear OS,‏ Android TV או מכשיר Automotive OS שרוצים לדמות באמולטור Android. הכלי Device Manager (ניהול מכשירים) הוא כלי שאפשר להפעיל מ-Android Studio. הוא עוזר ליצור ולנהל מכשירי AVD.

android emulator [create <profile-name>|start <device-name>|stop <device-serial-number>|list]

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

• במסך הפתיחה של Android Studio, בוחרים באפשרות פעולות נוספות > מנהל המכשירים הווירטואליים.

• אחרי שפותחים פרויקט, בוחרים באפשרות תצוגה > חלונות כלים > Device Manager מסרגל התפריטים הראשי, לוחצים על + ואז על יצירת מכשיר וירטואלי.

אחרי שיוצרים את המכשירים, אפשר לראות רשימה של כל המכשירים בחלונית Device Manager.

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

מידע על מכשירי AVD

מכשיר AVD מכיל פרופיל חומרה, קובץ אימג' של המערכת, אזור אחסון, סקין ומאפיינים אחרים.

מומלץ ליצור AVD לכל קובץ אימג' של מערכת שהאפליקציה עשויה לתמוך בו, על סמך ההגדרה <uses-sdk> במניפסט.

פרופיל חומרה

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

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

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

קובצי אימג' של המערכת

קובץ אימג' של המערכת עם התווית Google APIs כוללת גישה אל Google Play Services.

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

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

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

אם האפליקציה כוללת רכיב <uses-library> בקובץ המניפסט, האפליקציה דורשת קובץ אימג' של מערכת שכולל את הספרייה החיצונית הזו. כדי להריץ את האפליקציה באמולטור, צריך ליצור AVD שכולל את הספרייה הנדרשת. כדי לעשות זאת, יכול להיות שתצטרכו להשתמש ברכיב תוסף לפלטפורמת AVD. לדוגמה, התוסף Google APIs מכיל את ספריית מפות Google.

כדי להבטיח את אבטחת האפליקציות וחוויה עקבית במכשירים פיזיים, תמונות המערכת שכוללות את חנות Google Play חתומות באמצעות מפתח הפצה. המשמעות היא שאי אפשר לקבל הרשאות גבוהות יותר (root) באמצעות התמונות האלה.

אם אתם צריכים הרשאות מורחבות (root) כדי לפתור בעיות באפליקציה, אתם יכולים להשתמש בתמונות מערכת של פרויקט קוד פתוח של Android ‏ (AOSP) שלא כוללות אפליקציות או שירותים של Google. אחר כך תוכלו להשתמש בפקודות adb root ו-adb unroot כדי לעבור בין הרשאות רגילות להרשאות גבוהות:

  % adb shell
  emu64a:/ $
  emu64a:/ $ exit
  % adb root
  restarting adbd as root
  % adb shell
  emu64a:/ #
  emu64a:/ # exit
  % adb unroot
  restarting adbd as non root
  % adb shell
  emu64a:/ $
  emu64a:/ $ exit
  %
  

אזור אחסון

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

עור

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

תכונות של AVD ואפליקציות

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

יצירת AVD

כדי ליצור מכשיר AVD חדש:

1. פותחים את מנהל המכשירים.
2. לוחצים על יצירת מכשיר.

   מופיע החלון Select Hardware (בחירת ציוד).

   

   שימו לב שרק חלק מפרופילי החומרה כוללים את Play Store. הפרופילים האלה תואמים באופן מלא ל-CTS ויכול להיות שהם משתמשים בתמונות מערכת שכוללות את אפליקציית חנות Play.

3. בוחרים פרופיל חומרה ולוחצים על הבא.

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

   יופיע החלון System Image.

   
4. בוחרים את קובץ אימג' של המערכת לרמת API מסוימת ולוחצים על הבא.

יופיע החלון Verify Configuration (אימות ההגדרה).


5. משנים את מאפייני ה-AVD לפי הצורך, ואז לוחצים על סיום.

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

ה-AVD החדש מופיע בכרטיסייה Virtual של Device Manager ובתפריט של מכשיר היעד.

כדי ליצור מכשיר וירטואלי של Android (AVD) על סמך עותק:

1. בכרטיסייה Virtual (וירטואלי) של Device Manager (ניהול מכשירים), לוחצים על Menu (תפריט) ובוחרים באפשרות Duplicate (שכפול).

   יופיע החלון Verify Configuration.

2. לוחצים על הקודם אם צריך לבצע שינויים בחלונות System Image או Select Hardware.
3. מבצעים את השינויים הרצויים ולוחצים על סיום.

   ה-AVD מופיע בכרטיסייה Virtual (וירטואלי) של מנהל המכשירים.

יצירת פרופיל חומרה

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

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

כדי ליצור פרופיל חומרה חדש מאפס:

1. בחלון Select Hardware (בחירת חומרה), לוחצים על New Hardware Profile (פרופיל חומרה חדש).

2. בחלון Configure Hardware Profile, משנים את מאפייני פרופיל החומרה לפי הצורך.

   
3. לוחצים על סיום.

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

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

1. בחלון Select Hardware (בחירת חומרה), בוחרים פרופיל חומרה ולוחצים על Clone Device (שיבוט המכשיר), או לוחצים לחיצה ימנית על פרופיל חומרה ובוחרים באפשרות Clone (שיבוט).

2. בחלון Configure Hardware Profile, משנים את מאפייני פרופיל החומרה לפי הצורך.
3. לוחצים על סיום.

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

עריכה של מכשירי AVD קיימים

אפשר לבצע את הפעולות הבאות ב-AVD מתוך הכרטיסייה Virtual בכלי לניהול מכשירים:

• כדי לערוך מכשיר AVD, לוחצים על עריכת מכשיר ה-AVD הזה ומבצעים את השינויים.
• כדי למחוק מכשיר וירטואלי, לוחצים על תפריט ואז על מחיקה.
• כדי להציג את קובצי ה-INI וה-IMG המשויכים של ה-AVD בדיסק, לוחצים על תפריט ובוחרים באפשרות הצגה בדיסק.
• כדי לראות את פרטי ההגדרה של ה-AVD שאפשר לכלול בדוחות על באגים שנשלחים לצוות Android Studio, לוחצים על Menu (תפריט) ואז על View Details (הצגת פרטים).

עריכה של פרופילי חומרה קיימים

אי אפשר לערוך או למחוק את פרופילי החומרה שנטענו מראש, אבל אפשר לבצע את הפעולות הבאות בפרופילי חומרה אחרים מהחלון בחירת חומרה:

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

הפעלה והפסקה של אמולטור ומחיקת נתונים

בכרטיסייה Virtual (ווירטואלי), אפשר לבצע את הפעולות הבאות באמולטור:

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

ייבוא וייצוא של פרופילי חומרה

בחלון Select Hardware (בחירת חומרה), אפשר לייבא ולייצא פרופילי חומרה באופן הבא:

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

מאפייני AVD

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

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

טבלה 1. מאפייני ההגדרה של AVD

מאפייני פרופיל החומרה

אפשר לציין את המאפיינים הבאים לפרופילי חומרה בחלון Configure Hardware Profile. מאפייני ההגדרות של AVD מבטלים את המאפיינים של פרופיל החומרה, ומאפייני האמולטור שאתם מגדירים בזמן שהאמולטור פועל מבטלים את שניהם.

אי אפשר לערוך את פרופילי החומרה המוגדרים מראש שכלולים ב-Device Manager. עם זאת, אפשר להעתיק את הפרופילים ולערוך את העותקים.

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

טבלה 2. מאפייני ההגדרה של פרופיל החומרה

יצירת סקין לאמולטור

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

כל סקין של אמולטור מכיל:

• קובץ hardware.ini
• קובצי פריסה לאוריינטציות נתמכות ולתצורות פיזיות
• קובצי תמונות של רכיבי תצוגה, כמו רקע, מקשים ולחצנים

כדי ליצור סקין בהתאמה אישית ולהשתמש בו:

1. יוצרים ספרייה שבה אפשר לשמור את קובצי ההגדרות של הסקין.
2. מגדירים את המראה החזותי של הסקין בקובץ טקסט בשם layout. בקובץ הזה מוגדרות הרבה מאפיינים של הסקין, כמו הגודל ונכסי התמונות של לחצנים ספציפיים. לדוגמה:

   parts {
       device {
           display {
               width   320
               height  480
               x       0
               y       0
           }
       }
   
       portrait {
           background {
               image background_port.png
           }
   
           buttons {
               power {
                   image  button_vertical.png
                   x 1229
                   y 616
               }
           }
       }
       ...
   }
   

3. מוסיפים לאותה ספרייה קבצים של תמונות המכשיר בפורמט bitmap.
4. מציינים הגדרות נוספות של מכשירים ספציפיים לחומרה בקובץ INI להגדרות המכשיר, כמו hw.keyboard ו-hw.lcd.density.
5. מכניסים לארכיון את הקבצים בתיקיית הסקין ובוחרים את קובץ הארכיון כסקין מותאם אישית.

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