יצירה ועריכה של הגדרות הרצה/ניפוי באגים

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

מידע נוסף זמין גם במאמרי העזרה הבאים של IntelliJ:

מידע על הגדרות הרצה/ניפוי באגים

הגדרות של הרצה או ניפוי באגים מציינות פרטים כמו התקנת האפליקציה, ההפעלה ואפשרויות הבדיקה. אתם יכולים להגדיר את ההגדרה לשימוש חד-פעמי או לשמור אותה לשימוש עתידי. אחרי ששומרים את ההגדרה, אפשר לבחור אותה מהרשימה הנפתחת Select Run/Debug Configuration (בחירת הגדרת הפעלה/ניפוי באגים) בסרגל הכלים. ‫Android Studio שומר את ההגדרות כחלק מהפרויקט.

הגדרות הרצה/ניפוי באגים שנוצרו בהתחלה

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

היקף הפרויקט וניהול גרסאות

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

פתיחת תיבת הדו-שיח Run/Debug Configurations (הגדרות הרצה/ניפוי באגים)

כדי לפתוח את תיבת הדו-שיח Run/Debug Configurations, בוחרים באפשרות Run ‏ > Edit Configurations. מופיעה תיבת הדו-שיח Run/Debug Configurations, כמו שמוצג באיור 1.

איור 1. תיבת הדו-שיח Run/Debug Configurations (הגדרות הרצה/ניפוי באגים)

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

בתיבת הדו-שיח הזו אפשר:

יצירת הגדרת הרצה או ניפוי באגים חדשה

אפשר להגדיר הגדרות חדשות להרצה או לניפוי באגים בתיבת הדו-שיח Run/Debug Configurations, בחלון Project או בכלי לעריכת קוד. ההגדרה החדשה צריכה להתבסס על תבנית הגדרה.

בתיבת הדו-שיח Run/Debug Configurations (הגדרות הרצה/ניפוי באגים) מוצגות הגדרות ההרצה/ניפוי הבאגים שלכם ותבניות ההגדרות שזמינות. אפשר להתחיל הגדרה חדשה ישירות מתבנית, או מהעתק של הגדרה אחרת. לאחר מכן תוכלו לשנות את ערכי השדות לפי הצורך.

אפשר גם ללחוץ לחיצה ימנית על פריט בחלון Project כדי ליצור באופן אוטומטי הגדרה שספציפית לפריט הזה. לדוגמה, אם רוצים להפעיל פעילות מסוימת, אפשר ללחוץ לחיצה ימנית על קובץ ה-Java של הפעילות ולבחור באפשרות הפעלה. בהתאם לפריט, Android Studio משתמש בתבנית הגדרה של Android App,‏ Android Instrumented Tests או JUnit כדי ליצור את ההגדרה.

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

כשיוצרים הגדרה מחוץ לתיבת הדו-שיח Run/Debug Configurations, ההגדרה היא זמנית אלא אם שומרים אותה. כברירת מחדל, אפשר להוסיף לפרויקט עד חמש הגדרות זמניות לפני ש-Android Studio יתחיל להסיר אותן. כדי לשנות את ברירת המחדל הזו, פותחים את ההגדרות של Android Studio ומשנים את ההגדרות המתקדמות > הפעלה/ניפוי באגים > מגבלת תצורות זמניות. מידע נוסף על הגדרות זמניות זמין במאמר יצירה ושמירה של הגדרות זמניות להרצה או לניפוי באגים.

התחלת הגדרה על סמך תבנית

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

  1. פותחים את תיבת הדו-שיח Run/Debug Configurations (הגדרות הפעלה/ניפוי באגים).
  2. לוחצים על הוספת הגדרה חדשה .
  3. בוחרים תבנית הגדרות.
  4. מקלידים שם בשדה שם.
  5. משנים את ההגדרות לפי הצורך.
  6. חשוב לתקן את השגיאות שמוצגות בתחתית תיבת הדו-שיח.

  7. לוחצים על החלה או על אישור.

התחלת הגדרה מהעתקה

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

  1. פותחים את תיבת הדו-שיח Run/Debug Configurations (הגדרות הפעלה/ניפוי באגים).
  2. בחלונית הימנית, בוחרים הגדרת הפעלה או ניפוי באגים קיימת.
  3. לוחצים על העתקת ההגדרה .
  4. מקלידים שם בשדה שם.
  5. משנים את ההגדרות לפי הצורך.
  6. חשוב לתקן את השגיאות שמוצגות בתחתית תיבת הדו-שיח.

  7. לוחצים על החלה או על אישור.

הגדרת פריט בפרויקט

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

כדי ליצור הגדרת הפעלה או ניפוי באגים לפריט בפרויקט:

  1. פותחים פרויקט בתצוגת Android או Project.
  2. בחלון Project, לוחצים לחיצה ימנית על פריט שאפשר לבדוק ובוחרים באפשרות Run filename או Debug filename. ‫Android Studio יוצר הגדרת הרצה/ניפוי באגים זמנית ומפעיל את האפליקציה.
  3. פותחים את הרשימה הנפתחת Select Run/Debug Configuration (בחירת הגדרות הרצה/ניפוי באגים) בסרגל הכלים.
  4. בוחרים באפשרות שמירת ההגדרה מתוך האפשרויות שמופיעות לצד ההגדרה שרוצים לשמור.

    איור 2. שמירת ההגדרה

הערה: אם לוחצים לחיצה ימנית על אותו פריט ומריצים או מנפים בו באגים (אבל לא בפעילות), Android Studio יוצר הגדרה חדשה.

הגדרת תצורת בדיקה עבור מחלקה או שיטה

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

‫Android Studio משתמש בתבנית Android Instrumented Tests או בתבנית Android JUnit, בהתאם לקבוצת המקורות. בבדיקת יחידה מקומית, אפשר להריץ את הבדיקה עם כיסוי קוד.

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

  1. פותחים פרויקט בתצוגת Android או Project.
  2. פותחים קובץ Java בכלי לעריכת קוד.
  3. בוחרים מחלקה או שיטה בקוד, ואז מקישים על Control+Shift+T (או על Command+Shift+T).
  4. בתפריט שמופיע, בוחרים באפשרות יצירת בדיקה חדשה.
  5. בתיבת הדו-שיח יצירה, אפשר לשנות או להגדיר את הערכים וללחוץ על אישור.
  6. בתיבת הדו-שיח Choose Destination Directory, בוחרים את המיקום בפרויקט שבו רוצים ש-Android Studio ימקם את הבדיקה. אפשר לציין את המיקום לפי מבנה הספריות או על ידי בחירת מחלקה סמוכה.
  7. לוחצים על אישור.

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

  8. כדי להריץ את הבדיקה, מבצעים אחת מהפעולות הבאות:
    • בחלון Project, לוחצים לחיצה ימנית על הבדיקה ובוחרים באפשרות Run או Debug.
    • ב-Code Editor, לוחצים לחיצה ימנית על הגדרת מחלקה או על שם של שיטה בקובץ הבדיקה ובוחרים באפשרות Run (הפעלה) או Debug (ניפוי באגים) כדי לבדוק את כל השיטות במחלקה.
  9. פותחים את הרשימה הנפתחת Select Run/Debug Configuration (בחירת הגדרות הרצה/ניפוי באגים) בסרגל הכלים.
  10. בוחרים באפשרות שמירת ההגדרה מתוך האפשרויות שמופיעות לצד ההגדרה שרוצים לשמור.

    איור 3. שמירת ההגדרה

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

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

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

  1. בוחרים את הגדרת ההרצה/ניפוי הבאגים מהרשימה הנפתחת Select Run/Debug Configuration (בחירת הגדרת הרצה/ניפוי באגים) בסרגל הכלים.
  2. הרשימה הנפתחת נמצאת מימין ללחצנים הפעלה וניפוי באגים . לדוגמה, .

  3. בוחרים באפשרות Run ‏ > Run או באפשרות Run ‏ > Debug.
  4. אפשר גם ללחוץ על הפעלה או על ניפוי באגים .

עריכה של הגדרות הרצה או ניפוי באגים

כדי לערוך הגדרת הפעלה או ניפוי באגים, פועלים לפי השלבים הבאים:

  1. פותחים את תיבת הדו-שיח Run/Debug Configurations (הגדרות הפעלה/ניפוי באגים).
  2. בחלונית הימנית, בוחרים הגדרה.
  3. משנים את ההגדרות לפי הצורך.
  4. חשוב לתקן את השגיאות שמוצגות בתחתית תיבת הדו-שיח.

  5. לוחצים על החלה או על אישור.

עריכה של תבנית הגדרות הרצה או ניפוי באגים

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

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

כדי לערוך תבנית:

  1. פותחים את תיבת הדו-שיח Run/Debug Configurations (הגדרות הפעלה/ניפוי באגים).
  2. לוחצים על עריכת תבניות ההגדרה....
  3. בוחרים תבנית הגדרה.
  4. משנים את ההגדרות לפי הצורך.
  5. חשוב לתקן את השגיאות שמוצגות בתחתית תיבת הדו-שיח.

  6. לוחצים על החלה או על אישור.

מיון והגדרה של קבוצות

בתיבת הדו-שיח Run/Debug Configurations (הגדרות הרצה/ניפוי באגים), אפשר לסדר את ההגדרות כדי למצוא אותן במהירות. אפשר למיין את הפריטים בתיקייה לפי סדר אלפביתי, וליצור תיקיות חדשות כדי לקבץ הגדרות.

כדי למיין את ההגדרות לפי סדר אלפביתי:

  1. פותחים את תיבת הדו-שיח Run/Debug Configurations (הגדרות הפעלה/ניפוי באגים).
  2. בוחרים תיקייה שמכילה הגדרות.
  3. לוחצים על Sort Configurations (מיון הגדרות) .
  4. לוחצים על OK כדי לסגור את תיבת הדו-שיח.

כדי לקבץ הגדרות בתיקיות, פועלים לפי השלבים הבאים:

  1. פותחים את תיבת הדו-שיח Run/Debug Configurations (הגדרות הפעלה/ניפוי באגים).
  2. בוחרים תיקייה שמכילה הגדרות.
  3. לוחצים על יצירת תיקייה חדשה .
  4. מקלידים שם בשדה שם התיקייה.
  5. לוחצים על אישור כדי לשמור את השם.
  • גוררים פריטים מאותה קטגוריית תבניות לתיקייה.
  • כדי לשנות את הסדר של התיקיות וההגדרות באותה קטגוריית תבניות, גוררים אותן למיקום הרצוי.
  • לוחצים על OK כדי לסגור את תיבת הדו-שיח.
  • הגדרת פעולות לפני ההשקה

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

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

    כדי ליצור רשימת משימות:

    1. בתחתית תיבת הדו-שיח Run/Debug Configurations (הגדרות הרצה/ניפוי באגים) בקטע Before launch (לפני ההפעלה) (יכול להיות שתצטרכו לגלול למטה), לוחצים על Add (הוספה) ובוחרים סוג משימה. אם נפתחת תיבת דו-שיח, ממלאים את השדות ולוחצים על אישור.
    2. מוסיפים עוד משימות לפי הצורך.
    3. כדי לשנות את הסדר של המשימות, גוררים אותן או בוחרים משימה ולוחצים על למעלה ועל למטה כדי להעביר אותה למעלה או למטה ברשימה.
    4. בוחרים באפשרות הצגת הדף הזה אם רוצים להציג את הגדרות ההרצה/ניפוי הבאגים לפני שמחילים אותן.

      האפשרות הזו לא מסומנת כברירת מחדל.

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

      האפשרות הזו מסומנת כברירת מחדל.

    כדי להסיר משימה מהרשימה:

    1. בוחרים משימה.
    2. לוחצים על הסרה .

    כדי לערוך משימה:

    1. בוחרים משימה.
    2. לוחצים על עריכה .
    3. עורכים את הגדרות המשימה בתיבת הדו-שיח שנפתחת ולוחצים על אישור.

    בטבלה הבאה מפורטות המשימות הזמינות שאפשר להוסיף.

    משימה תיאור
    הפעלת כלי חיצוני הפעלת אפליקציה חיצונית ל-Android Studio. בתיבת הדו-שיח External Tools (כלים חיצוניים), בוחרים אפליקציה אחת או יותר שרוצים להפעיל ואז לוחצים על OK (אישור). אם האפליקציה עדיין לא מוגדרת ב-Android Studio, מוסיפים את ההגדרה שלה בתיבת הדו-שיח Create Tools. מידע נוסף זמין במאמרים בנושא הגדרת כלים של צד שלישי וכלים חיצוניים.
    הפעלת הגדרה אחרת מריצים אחת מהגדרות ההרצה או הניפוי באגים הקיימות. בתיבת הדו-שיח Choose Configuration to Execute (בחירת הגדרה להפעלה), בוחרים הגדרה להפעלה ולוחצים על OK (אישור).
    יצרן קומפילציה של הפרויקט או המודול. ‫Android Studio מפעיל את הפקודה Make Module אם בהגדרת ההפעלה או הניפוי באגים צוין מודול מסוים, או שהוא מפעיל את הפקודה Make Project אם לא צוינו מודולים.
    יצירת פרויקט קומפילציה של הפרויקט. ‫Android Studio מריץ את הפקודה Make Project (יצירת פרויקט).
    Make, no error check האפשרות הזו זהה לאפשרות Make, אבל Android Studio מריץ את הגדרת ההפעלה או ניפוי הבאגים בלי קשר לתוצאת הקומפילציה.
    יצירת ארטיפקטים התכונה לא נתמכת ב-Android Studio.
    הפעלת משימת Gradle מריצים משימת Gradle. בתיבת הדו-שיח שנפתחת, מציינים את הפרטים ולוחצים על אישור. מידע נוסף זמין במאמר בנושא Gradle.
    ‫Make עם תמיכה ב-Gradle קומפילציה של הפרויקט והרצת Gradle.
    App Engine Gradle builder משימת ה-builder של App Engine Gradle מסנכרנת את הפרויקט ואז בונה את המודול.

    תבניות של הגדרות

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

    הערה: ב-Android Studio 2.1.x ובגרסאות מוקדמות יותר הייתה תבנית NativeApplication, שלא קיימת בגרסאות חדשות יותר. אם יש לכם תבנית של אפליקציה מקומית בפרויקט, Android Studio ממיר אותה לאפליקציית Android כשאתם טוענים את הפרויקט. בתיבת הדו-שיח המרת פרויקט מופיעות הנחיות מפורטות לגבי התהליך.

    תבניות שלא נתמכות

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

    אפשרויות הגדרה נפוצות

    האפשרויות Name,‏ Allow parallel run ו-Store as project file משותפות לכמה תבניות הגדרה. מידע נוסף על ההגדרות האלה זמין במאמר בנושא הגדרות נפוצות.

    ‫Android Studio מאחסן את תצורת ההפעלה/ניפוי הבאגים המשותפת בקובצי XML נפרדים בתיקייה project_directory/.idea/runConfigurations/. מידע נוסף זמין במאמר בנושא פורמט מבוסס-ספרייה במסמכי התיעוד של פרויקטים ב-IntelliJ.

    אפליקציה ל-Android

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

    הכרטיסייה 'כללי'

    בכרטיסייה כללי, אפשר לציין אפשרויות התקנה, הפעלה ופריסה. בכרטיסייה Miscellaneous יש גם אפשרויות התקנה.

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

    בחרו אפשרות:

    • ‫Default APK (קובץ APK שמוגדר כברירת מחדל) – יצירה ופריסה של קובץ APK עבור הווריאציה שנבחרה כרגע.
    • ‫APK מ-קובץ AAB – יצירה ופריסה של האפליקציה מתוך קובץ Android App Bundle. כלומר, קודם כל Android Studio ממיר את פרויקט האפליקציה לקובץ AAB שכולל את כל הקוד והמשאבים המהודרים של האפליקציה. לאחר מכן, מתוך קובץ ה-AAB הזה, ‏ Android Studio יוצר רק את קובצי ה-APK שנדרשים כדי לפרוס את האפליקציה במכשיר המחובר. בדרך כלל כדאי להשתמש באפשרות הזו כשבודקים את קובץ ה-AAB שרוצים להעלות ל-Google Play, כי פריסה מקובץ AAB מאריכה את משך זמן של תהליך build הכולל.
    • Custom Artifact – לא נתמך ב-Android Studio.
    • ללא – לא מותקן קובץ APK במכשיר. לדוגמה, אם אתם מעדיפים להתקין את ה-APK באופן ידני, אתם לא צריכים את Android Studio כדי להתקין אותו.
    אפשרויות התקנה: פריסה כאפליקציה ללא התקנה אם האפליקציה שלכם תומכת בחוויות שימוש מיידי – כלומר, אם הוספתם תמיכה באפליקציות ללא התקנה כשיצרתם פרויקט חדש, או אם יצרתם מודול תכונות אחד או יותר בגרסה ללא התקנה – תוכלו לבחור לפרוס את המודולים האלה בגרסה ללא התקנה על ידי סימון התיבה שליד פריסה כאפליקציה ללא התקנה.
    אפשרויות התקנה: תכונות לפריסה אם האפליקציה כוללת מודולים של תכונות, מסמנים את התיבה לצד כל תכונה שרוצים לכלול כשפורסים את האפליקציה. האפשרות הזו מוצגת רק אם האפליקציה כוללת מודולים של תכונות.

    הערה: אם רוצים לבדוק הורדה והתקנה של מודולים של תכונות לפי דרישה, צריך לעשות זאת אחרי שמפרסמים את קובץ ה-AAB ואז משתמשים במסלול לבדיקה פנימית ב-Play Console. מידע נוסף זמין במאמר בנושא העלאת חבילת האפליקציות ל-Play Console.

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

    -i foo.bar.baz -r /path/to/apk

    וגם

    -d -r

    ברירת מחדל: ללא אפשרויות.

    אפשרויות הפעלה: הפעלה

    בחרו אפשרות:

    • ללא – לא מפעילים שום דבר כשבוחרים באפשרות הרצה או ניפוי באגים. עם זאת, אם האפליקציה כבר פועלת ואתם בוחרים באפשרות Debug, ‏ Android Studio מצרף את מאתר הבאגים לתהליך של האפליקציה.
    • Default Activity (פעילות ברירת המחדל) – הפעלת הפעילות שסימנתם כפעילות הפעלה במניפסט. לדוגמה:
      <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
    • פעילות שצוינה – הפעלה של פעילות ספציפית באפליקציה במודול. כשבוחרים באפשרות הזו, השדה פעילות מופיע למטה. בשדה הזה אפשר להקליד את שם הפעילות שרוצים להפעיל, או ללחוץ על עוד כדי לבחור פעילות מתוך רשימה.
    • כתובת URL – הפעלת כתובת URL שתואמת למסנן Intent במניפסט של האפליקציה. כשבוחרים באפשרות הזו, מופיע מתחתיה השדה כתובת URL, שבו אפשר להזין את כתובת ה-URL.

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

    אפשרויות הפעלה: דגלי הפעלה מקלידים את האפשרויות של adb am start שרוצים להשתמש בהן. מעצבים את האפשרויות באותה דרך שבה מעצבים אותן בשורת הפקודה, אבל בלי כוונה. לדוגמה:

    -W

    האפשרות הזו לא מופיעה אם בחרתם בערך Nothing (ללא) לאפשרות Launch (הפעלה).

    ברירת מחדל: ללא אפשרויות.

    אפשרויות יעד הפריסה: יעד

    בחרו אפשרות:

    • Open Select Deployment Target Dialog (פתיחת תיבת הדו-שיח לבחירת יעד פריסה) – פותחת את תיבת הדו-שיח Select Deployment Target (בחירת יעד פריסה) כדי לבחור מכשיר וירטואלי או מכשיר חומרה.
    • ‫USB Device (מכשיר USB) – שימוש במכשיר חומרה שמחובר למחשב הפיתוח דרך יציאת USB. אם יש יותר מאחד, מופיעה תיבת דו-שיח שבה אפשר לבחור אותו.
    • ‫Emulator – שימוש במכשיר וירטואלי. בהגדרה, אפשר לבחור מכשיר AVD. אחרת, המערכת פשוט משתמשת במכשיר ה-AVD הראשון ברשימה.

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

    כברירת מחדל, האפשרות הזו לא מסומנת, כך שבכל פעם שמפעילים אפליקציה, מופיעה תיבת הדו-שיח Select Deployment שבה צריך לבחור מכשיר. כשבוחרים באפשרות הזו ואז מפעילים אפליקציה, מופיעה תיבת הדו-שיח בחירת פריסה שבה אפשר לבחור מכשיר. אחר כך, בכל פעם שמפעילים את האפליקציה, היא מופעלת במכשיר שנבחר בלי להציג את תיבת הדו-שיח Select Deployment (בחירת פריסה). כדי להריץ את האפליקציה במכשיר אחר, מבטלים את הסימון של Use same device for future launches (שימוש באותו מכשיר להפעלות עתידיות), או מפסיקים את האפליקציה באמצעות Run > Stop app (הפעלה > עצירה) או Stop (עצירה), ואז מפעילים אותה מחדש. תיבת הדו-שיח בחירת פריסת עדכון תוצג כדי שתוכלו לבחור מכשיר.
    לפני ההשקה מידע על הגדרת פעולות לפני ההשקה

    הכרטיסייה 'שונות'

    בכרטיסייה Miscellaneous (שונות), אפשר לציין אפשרויות של logcat, התקנה, הפעלה ופריסה. בכרטיסייה כללי יש גם אפשרויות התקנה.

    שדה תיאור
    Logcat: הצגת Logcat באופן אוטומטי כשבוחרים באפשרות הזו, החלון Logcat נפתח בכל פעם שמבצעים פריסה של אפליקציה ומפעילים אותה בהצלחה באמצעות ההגדרה הזו. ברירת מחדל: נבחר.
    Logcat: Clear log before launch בוחרים באפשרות הזו אם רוצים ש-Android Studio יסיר נתונים מסשנים קודמים מקובץ היומן לפני הפעלת האפליקציה. ברירת מחדל: לא מסומן.
    אפשרויות התקנה: דילוג על ההתקנה אם קובץ ה-APK לא השתנה. כשבוחרים באפשרות הזו, Android Studio לא פורס מחדש את ה-APK אם הוא מזהה שהוא לא השתנה. אם רוצים ש-Android Studio יכפה התקנה של ה-APK, גם אם הוא לא השתנה, צריך לבטל את הסימון של האפשרות הזו. ברירת מחדל: נבחר
    אפשרויות התקנה: סגירה ידנית של האפליקציה לפני הפעלת הפעילות

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

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

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

    ברירת מחדל: נבחר

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

    הכרטיסייה 'כלי לניפוי באגים&#39

    מציינים את אפשרויות ניפוי הבאגים בכרטיסייה Debugger (ניפוי באגים).

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

    בפרויקטים של C ו-C++, אפשר להוסיף ספריות של סמלים, וגם פקודות הפעלה של LLDB ופקודות אחרי צירוף, בכרטיסייה Debugger. כדי לעשות את זה, משתמשים בלחצנים שדומים ללחצנים הבאים:

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

    מידע נוסף על ניפוי באגים ב-Android Studio זמין במאמר ניפוי באגים באפליקציה.

    שדה תיאור
    סוג ניפוי הבאגים

    בוחרים באחת מהאפשרויות הבאות:

    • ‫Java only – ניפוי באגים בקוד Java בלבד.
    • Detect Automatically (זיהוי אוטומטי) – מאפשרים ל-Android Studio לבחור את סוג הניפוי באגים הכי טוב לפרויקט.
    • Native Only (נייטיב בלבד) – ניפוי באגים בקוד נייטיב של C או C++‎.
    • ‫Dual (Java + Native) (כפול (Java + Native)) – ניפוי באגים בקוד Java ובקוד Native בשני סשנים נפרדים של ניפוי באגים.

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

    ספריות סמלים

    אם רוצים להוסיף קובצי סמלים כדי לספק למאבחן הבאגים מידע על C או C++‎ שנוצר מחוץ ל-Android Studio, אפשר להוסיף כאן ספרייה אחת או יותר. ‫Android Studio משתמש בקבצים בספריות האלה לפני שהוא משתמש בקבצים שנוצרו על ידי הפלאגין Android ל-Gradle. כלי הניפוי באגים מחפש בספריות מלמעלה למטה, לפי הסדר, עד שהוא מוצא את מה שהוא צריך. החיפוש מתבצע באופן רקורסיבי בקבצים שבספרייה. כדי לבצע אופטימיזציה של הרשימה ולחסוך זמן, כדאי להציב את הספריות שבהן משתמשים הכי הרבה בחלק העליון של הרשימה.

    אם מציינים ספריה ברמה גבוהה בעץ, יכול להיות שיעבור זמן רב יותר עד שכל ספריות המשנה ייסרקו. אם מוסיפים ספרייה ספציפית מאוד, החיפוש יימשך פחות זמן. צריך למצוא את האיזון הנכון בין מהירות לבין מציאת הקבצים שדרושים לניפוי הבאגים. לדוגמה, אם יש לכם ספרייה שמכילה ספריות משנה של ממשקי Android Binary (‏ABI), אתם יכולים להוסיף ספרייה ל-ABI ספציפי או לכל ה-ABI. יכול להיות שייקח יותר זמן לחפש בספרייה ברמה העליונה, אבל אם תחליטו לבצע ניפוי באגים במכשיר אחר, זה גם יהיה יותר פשוט.

    שימו לב: אין צורך להוסיף ספריות שמכילות קובצי סמלים של Gradle, כי המאבחן משתמש בהם באופן אוטומטי.

    פקודות הפעלה של LLDB

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

    settings set target.max-memory-read-size 2048

    הפקודות מופעלות ב-LLDB לפי הסדר, מלמעלה למטה.

    פקודות LLDB אחרי ההצמדה

    מוסיפים פקודות LLDB שרוצים להריץ מיד אחרי שהדיבאגר מתחבר לתהליך. לדוגמה:

    process handle SIGPIPE -n true -p true -s false

    הפקודות מופעלות ב-LLDB לפי הסדר, מלמעלה למטה.

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

    מציינים את אפשרויות היומן של LLDB. ‫Android Studio מגדיר את אפשרויות ברירת המחדל על סמך הניסיון של הצוות – כך שהבנייה לא איטית מדי אבל היא מכילה את המידע שנדרש לפתרון בעיות. לרוב נדרש יומן כזה כדי לדווח על באגים ב-Android Studio. ברירת המחדל היא

    lldb process:gdb-remote packets

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

    lldb process platform:gdb-remote packets

    כדי לראות את רשימת הפקודות המלאה של היומן, מזינים את הפקודה log list מחלון מעטפת LLDB ב-Android Studio.

    ‫Android Studio ממקם את יומני המכשיר במיקום הבא, כאשר ApplicationId הוא מזהה האפליקציה הייחודי שמשמש במניפסט של ה-APK שנוצר, ומזהה את האפליקציה במכשיר ובחנות Google Play:

    /data/data/ApplicationId/lldb/log

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

    /data/user/AndroidUserId/ApplicationId/lldb/log

    מידע על שימוש ב-LLDB לניפוי באגים מרחוק זמין במאמר בנושא ניפוי באגים מרחוק.

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

    הכרטיסייה 'פרופילים'

    כדי להפעיל תכונות מסוימות ב-Android Profiler כשבמכשיר פועלת מערכת Android בגרסה 7.1 או בגרסה מוקדמת יותר, צריך לסמן את האפשרות Enable advanced profiling (הפעלת פרופילים מתקדמים).

    בדיקות ב-Android

    תבנית הבדיקה שבה צריך להשתמש תלויה בקבוצת המקורות. תבנית הבדיקה Android Instrumented Tests מיועדת לבדיקה עם מכשור. תבנית Android JUnit מיועדת לבדיקת יחידה מקומית.

    הערה: אם אתם משתמשים ב-Firebase Test Lab כדי לבצע בדיקות במגוון מכשירים, אתם יכולים להשתמש בתבנית Android JUnit כדי להגדיר את הבדיקות עם מכשור. מידע נוסף זמין במאמר בנושא הרצת בדיקות באמצעות Firebase Test Lab.

    בתיאורים הבאים של הכרטיסיות מפורטות הכרטיסיות והשדות בתבנית Android Instrumented test. מידע על הכרטיסיות והשדות בתבנית הבדיקה של Android JUnit זמין בדף הגדרות של IntelliJ: JUnit.

    הכרטיסייה 'כללי'

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

    שדה תיאור
    מודול בוחרים מודול להחלת ההגדרה.
    בדיקה

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

    • הכל במודול – הפעלת כל הבדיקות מהמודול שנבחר.
    • הכול בחבילה – מפעילים את כל הבדיקות מהחבילה שצוינה בשדה Package. מקלידים את השם או לוחצים על עוד כדי לבחור את החבילה מתיבת דו-שיח.
    • ‫Class – הפעלת בדיקות של הכיתה שצוינה בשדה Class. מקלידים את השם או לוחצים על עוד כדי לבחור את הכיתה מתיבת דו-שיח.
    • שיטה – הפעלת שיטת בדיקה. בשדה Class (מחלקה), מציינים את המחלקה שמכילה את המתודה. בשדה Method (שיטה), מציינים את השיטה. מקלידים את השם או לוחצים על עוד כדי לבחור את הכיתה או את השיטה מתיבת דו-שיח.
    כלי ספציפי להרצת בדיקות (אופציונלי) מקלידים את המיקום של instrumentation runner ולוחצים על More כדי להשתמש בתיבת דו-שיח. הערך הזה משנה את המיקום של כלי ההרצה של המדידה שמוגדר בקובץ build.gradle. בדרך כלל ברירת המחדל היא המחלקה AndroidJUnitRunner מ-AndroidX Test.
    אפשרויות נוספות

    מקלידים את האפשרויות של adb am instrument שרוצים להשתמש בהן. לא מקלידים את הרכיב. לדוגמה, אם משתמשים ב- AndroidJUnitRunner מ-AndroidX Test, אפשר להשתמש בשדה הזה כדי להעביר אפשרויות נוספות ל-runner, כמו -e size small.

    ברירת מחדל: ללא אפשרויות

    אפשרויות יעד הפריסה: יעד

    בחרו אפשרות:

    • Open Select Deployment Target Dialog (פתיחת תיבת הדו-שיח לבחירת יעד פריסה) – פותחת את תיבת הדו-שיח Select Deployment Target (בחירת יעד פריסה) כדי לבחור מכשיר וירטואלי או מכשיר חומרה.
    • ‫USB Device (מכשיר USB) – שימוש במכשיר חומרה שמחובר למחשב הפיתוח דרך יציאת USB. אם יש יותר מאחד, מופיעה תיבת דו-שיח שבה אפשר לבחור אותו.
    • ‫Emulator – שימוש במכשיר וירטואלי. בהגדרה, אפשר לבחור מכשיר AVD. אחרת, המערכת פשוט משתמשת במכשיר ה-AVD הראשון ברשימה.
    • מטריצת המכשירים של Firebase Test Lab – ראו הרצת הבדיקות באמצעות Firebase Test Lab.
    אפשרויות של יעד הפריסה: שימוש באותו מכשיר להפעלות עתידיות אם רוצים להשתמש באופן אוטומטי במכשיר שבחרתם בעתיד דרך תיבת הדו-שיח Select Deployment Target, בוחרים באפשרות הזו. אם המכשיר לא זמין, תוצג תיבת דו-שיח. ברירת מחדל: הבחירה בוטלה
    לפני ההשקה מידע נוסף זמין במאמר הגדרת פעולות לפני ההשקה.

    הכרטיסייה 'שונות'

    הכרטיסייה Miscellaneous (שונות) מכילה אפשרויות של logcat והתקנה.

    שדה תיאור
    Logcat: Clear log before launch בוחרים באפשרות הזו אם רוצים ש-Android Studio יסיר נתונים מסשנים קודמים מקובץ היומן לפני הפעלת האפליקציה. ברירת מחדל: לא מסומן.
    אפשרויות התקנה: דילוג על ההתקנה אם קובץ ה-APK לא השתנה כשבוחרים באפשרות הזו, Android Studio לא פורס מחדש את ה-APK אם הוא מזהה שהוא לא השתנה. אם רוצים ש-Android Studio יכפה התקנה של ה-APK, גם אם הוא לא השתנה, צריך לבטל את הסימון של האפשרות הזו. ברירת מחדל: נבחר
    אפשרויות התקנה: סגירה ידנית של האפליקציה לפני הפעלת הפעילות

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

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

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

    ברירת מחדל: נבחר

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

    הכרטיסייה 'כלי לניפוי באגים&#39

    מציינים את אפשרויות ניפוי הבאגים בכרטיסייה Debugger (ניפוי באגים).

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

    בפרויקטים של C ו-C++, אפשר להוסיף ספריות של סמלים, וגם פקודות הפעלה של LLDB ופקודות אחרי צירוף, בכרטיסייה Debugger. כדי לעשות את זה, משתמשים בלחצנים שדומים ללחצנים הבאים:

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

    מידע נוסף על ניפוי באגים ב-Android Studio זמין במאמר ניפוי באגים באפליקציה.

    שדה תיאור
    סוג ניפוי הבאגים

    בוחרים באחת מהאפשרויות הבאות:

    • ‫Java only – ניפוי באגים בקוד Java בלבד.
    • Detect Automatically (זיהוי אוטומטי) – מאפשרים ל-Android Studio לבחור את סוג הניפוי באגים הכי טוב לפרויקט.
    • Native Only (נייטיב בלבד) – ניפוי באגים בקוד נייטיב של C או C++‎.
    • ‫Dual (Java + Native) (כפול (Java + Native)) – ניפוי באגים בקוד Java ובקוד Native בשני סשנים נפרדים של ניפוי באגים.

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

    ספריות סמלים

    אם רוצים להוסיף קובצי סמלים כדי לספק למאבחן הבאגים מידע על C או C++‎ שנוצר מחוץ ל-Android Studio, אפשר להוסיף כאן ספרייה אחת או יותר. ‫Android Studio משתמש בקבצים בספריות האלה לפני שהוא משתמש בקבצים שנוצרו על ידי הפלאגין Android ל-Gradle. כלי הניפוי באגים מחפש בספריות מלמעלה למטה, לפי הסדר, עד שהוא מוצא את מה שהוא צריך. החיפוש מתבצע באופן רקורסיבי בקבצים שבספרייה. כדי לבצע אופטימיזציה של הרשימה ולחסוך זמן, כדאי להעביר את הספריות שבהן משתמשים הכי הרבה לראש הרשימה.

    אם מציינים ספריה ברמה גבוהה בעץ, יכול להיות שיעבור זמן רב יותר עד שכל ספריות המשנה ייסרקו. אם מוסיפים ספרייה ספציפית מאוד, החיפוש יימשך פחות זמן. צריך למצוא את האיזון הנכון בין מהירות לבין מציאת הקבצים שדרושים לניפוי הבאגים. לדוגמה, אם יש לכם ספרייה שמכילה ספריות משנה של ממשקי Android Binary (‏ABI), אתם יכולים להוסיף ספרייה ל-ABI ספציפי או לכל ה-ABI. יכול להיות שייקח יותר זמן לחפש בספרייה ברמה העליונה, אבל אם תחליטו לבצע ניפוי באגים במכשיר אחר, זה גם יהיה יותר פשוט.

    שימו לב: אין צורך להוסיף ספריות שמכילות קובצי סמלים של Gradle, כי המאבחן משתמש בהם באופן אוטומטי.

    פקודות הפעלה של LLDB

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

    settings set target.max-memory-read-size 2048

    הפקודות מופעלות ב-LLDB לפי הסדר, מלמעלה למטה.

    פקודות LLDB אחרי ההצמדה

    מוסיפים פקודות LLDB שרוצים להריץ מיד אחרי שהדיבאגר מתחבר לתהליך. לדוגמה:

    process handle SIGPIPE -n true -p true -s false

    הפקודות מופעלות ב-LLDB לפי הסדר, מלמעלה למטה.

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

    מציינים את אפשרויות היומן של LLDB. ‫Android Studio מגדיר את אפשרויות ברירת המחדל על סמך הניסיון של הצוות – כך שהבנייה לא איטית מדי אבל היא מכילה את המידע שנדרש לפתרון בעיות. לרוב נדרש יומן כזה כדי לדווח על באגים ב-Android Studio. ברירת המחדל היא

    lldb process:gdb-remote packets

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

    lldb process platform:gdb-remote packets

    כדי לראות את רשימת הפקודות המלאה של היומן, מזינים את הפקודה log list מחלון מעטפת LLDB ב-Android Studio.

    ‫Android Studio ממקם את יומני המכשיר במיקום הבא, כאשר ApplicationId הוא מזהה האפליקציה הייחודי שמשמש במניפסט של ה-APK שנוצר, ומזהה את האפליקציה במכשיר ובחנות Google Play:

    /data/data/ApplicationId/lldb/log

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

    /data/user/AndroidUserId/ApplicationId/lldb/log

    מידע על שימוש ב-LLDB לניפוי באגים מרחוק זמין במאמר בנושא ניפוי באגים מרחוק.

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

    App Engine DevAppServer

    הגדרת ההרצה/ניפוי הבאגים הזו חלה על Google Cloud Platform. כשפועלים לפי השלבים האלה ומסנכרנים את הפרויקט עם הקובץ build.gradle, ‏ Android Studio יוצר בשבילכם הגדרה של App Engine DevAppServer.

    שימו לב שהתבנית App Engine Server של IntellJ IDEA היא תבנית אחרת שלא זמינה ב-Android Studio.

    שדה תיאור
    רק מופע יחיד אם רוצים לוודא שרק מופע אחד של הגדרת ההרצה או הניפוי באגים מופעל כרגע, בוחרים באפשרות הזו. אי אפשר להריץ כמה פעמים את אותה הגדרה בו-זמנית. ברירת מחדל: נבחר
    מודול בוחרים מודול להחלת ההגדרה.
    סנכרון עם ההגדרה של build.gradle אם מוסיפים מודול App Engine ומסנכרנים עם הקובץ build.gradle, שדות ההגדרה של App Engine DevAppServer ימולאו אוטומטית (מומלץ). אפשר גם לסנכרן את הפרויקט על ידי בחירה באפשרות File > Sync Project with Gradle Files. ברירת מחדל: נבחר
    App Engine SDK מקלידים נתיב אל Google App Engine SDK ל-Java במחשב המקומי. לוחצים על ... כדי לבחור אותו מתיבת דו-שיח.
    War Path מקלידים נתיב לתיקיית הארכיון של אפליקציית האינטרנט (WAR) של האפליקציה שפורסים בשרת הפיתוח המקומי. לוחצים על ... כדי לבחור אותו מתיבת דו-שיח.
    VM Args

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

    • כדי להפריד בין האפשרויות השונות, צריך להשתמש ברווחים.
    • אם יש רווחים באפשרויות, צריך לתחום את הרווחים במירכאות (" ").
    • אם אפשרות כוללת מירכאות, מוסיפים לוכסן הפוך לפני המירכאות (\").

    מידע נוסף על אפשרויות של מכונות וירטואליות זמין במסמכי התיעוד של גרסת J2SE, כמו java JDK 7 ו-java JDK 8.

    ברירת מחדל: לא נבחרו אפשרויות

    כתובת השרת מקלידים את הכתובת של המארח לשימוש בשרת. יכול להיות שתצטרכו לספק את הכתובת כדי לגשת לשרת הפיתוח ממחשב אחר ברשת. כתובת של 0.0.0.0 מאפשרת גישה למארח המקומי ולשם המארח. ברירת מחדל: localhost
    יציאה בשרת מקלידים את מספר היציאה שבו רוצים להשתמש עבור השרת. ברירת מחדל: 8080
    השבתה של האפשרות 'בדיקה אם יש עדכונים ל-App Engine SDK' אם מציינים שרת פיתוח, הוא לא ייצור קשר עם App Engine כדי לבדוק אם יש גרסה חדשה של ה-SDK. כברירת מחדל, השרת בודק אם יש גרסה חדשה בזמן ההפעלה, ומציג הודעה אם יש גרסה חדשה.
    לפני ההשקה מידע נוסף זמין במאמר הגדרת פעולות לפני ההשקה.

    הגדרות הפעלה/ניפוי באגים ב-Wear OS

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

    • בכל ההגדרות של הרצה/ניפוי באגים ב-Wear, צריך לבחור מקור נתונים ספציפי של קומפליקציה, משבצת או תצוגת שעון (בהתאם לתבנית) כדי להחיל עליו את ההגדרה. בדרך כלל כל אחד מהרכיבים האלה תואם למחלקה בקוד.
    • בהגדרת ההרצה או הניפוי באגים של רכיב Wear OS, צריך לבחור את המיקום שבו רוצים להציב את נתוני הרכיב שמסופקים על ידי מקור נתוני הרכיב. אפשר להציב אותו בחלק העליון, בצד ימין, בחלק התחתון, בצד שמאל או ברקע של תצוגת השעון.
    • בנוסף, בהגדרת ההרצה/ניפוי הבאגים של רכיב Wear OS, צריך לבחור את הסוג של נתוני הרכיב שסופקו על ידי מקור נתוני הרכיב. סוגי הנתונים שניתן לבחור מוגבלים לאלה שמסופקים על ידי מקור הנתונים של הסיבוך שנבחר ונתמכים על ידי המשבצת שנבחרה. רשימה של סוגי נתונים של סיבוכים מופיעה במאמר סוגים ושדות.

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

    לחצן ההפעלה במרווח הריק לצד המחלקה WatchFaceService.
    איור 1. מריצים משטח Wear OS ישירות באמצעות הסמל שבשוליים.