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

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

    איור 2. שמירת התצורה

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

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

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

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

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

  1. פותחים פרויקט בAndroid או בתצוגת הפרויקט.
  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. בוחרים באפשרות הרצה > הרצה או באפשרות הרצה > ניפוי באגים.
  4. לחלופין, לוחצים על Run או על Debug .

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

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

  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. לוחצים על Create New Folder (יצירת תיקייה חדשה) .
  4. מקלידים שם בשדה שם התיקייה.
  5. לוחצים על אישור כדי לשמור את השם.
  • גוררים פריטים מאותה קטגוריית תבניות לתיקייה.
  • כדי לשנות את הסדר של התיקיות וההגדרות באותה קטגוריית תבניות, גוררים אותן למיקום הרצוי.
  • לוחצים על OK כדי לסגור את תיבת הדו-שיח.
  • הגדרת פעולות לפני ההשקה

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

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

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

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

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

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

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

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

    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 מריץ את הגדרת ההפעלה או הניפוי באגים בלי קשר לתוצאת הקומפילציה.
    יצירת תוצרי פיתוח (Artifacts) לא נתמך ב-Android Studio.
    הפעלת משימת Gradle מריצים משימת Gradle. בתיבת הדו-שיח שנפתחת, מציינים את הפרטים ולוחצים על אישור. מידע נוסף זמין במאמר בנושא Gradle.
    ‫Make עם תמיכה ב-Gradle קומפילציה של הפרויקט והרצת Gradle.
    ה-builder של App Engine Gradle משימת ה-builder של App Engine Gradle מסנכרנת את הפרויקט ואז בונה את המודול.

    תבניות הגדרה

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

    הערה: ב-Android Studio 2.1.x ובגרסאות מוקדמות יותר היה תבנית Native Application, שלא קיימת בגרסאות חדשות יותר. אם יש לכם תבנית של אפליקציה מקומית בפרויקט, 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 מכילה גם אפשרויות התקנה.

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

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

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

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

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

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

    וגם

    -d -r

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

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

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

    • שום דבר – לא מפעילים שום דבר כשבוחרים באפשרות הפעלה או ניפוי באגים. עם זאת, אם האפליקציה כבר פועלת ואתם בוחרים באפשרות Debug, ‏ Android Studio מצרף את מאתר הבאגים לתהליך של האפליקציה.
    • פעילות ברירת המחדל – הפעלת הפעילות שסימנתם כהפעלה במניפסט. לדוגמה:
      <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

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

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

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

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

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

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

    כברירת מחדל, האפשרות הזו לא מסומנת, כך שבכל פעם שמפעילים אפליקציה, מופיעה תיבת הדו-שיח Select Deployment שבה צריך לבחור מכשיר. כשבוחרים באפשרות הזו ואז מפעילים אפליקציה, מופיעה תיבת הדו-שיח 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 - Debug Java code only.
    • זיהוי אוטומטי – מאפשר ל-Android Studio לבחור את סוג הניפוי באגים הטוב ביותר לפרויקט.
    • Native Only – ניפוי באגים בקוד C או C++‎ מותאם.
    • כפול (Java + Native) – ניפוי באגים של קוד Java וקוד מקורי בשתי סשנים נפרדים של ניפוי באגים.

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

    ספריות סמלים

    אם רוצים להוסיף קובצי סמלים כדי לספק למנפה הבאגים מידע על 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 מיועדת לבדיקה מכשירה. תבנית Android JUnit מיועדת לבדיקת יחידה מקומית.

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

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

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

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

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

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

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

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

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

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

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

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

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

    הכרטיסייה שונות מכילה אפשרויות של 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 - Debug Java code only.
    • זיהוי אוטומטי – מאפשר ל-Android Studio לבחור את סוג הניפוי באגים הטוב ביותר לפרויקט.
    • Native Only – ניפוי באגים בקוד C או C++‎ מותאם.
    • כפול (Java + Native) – ניפוי באגים של קוד Java וקוד מקורי בשתי סשנים נפרדים של ניפוי באגים.

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

    ספריות סמלים

    אם רוצים להוסיף קובצי סמלים כדי לספק למנפה הבאגים מידע על 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.

    שימו לב שתבנית IntellJ IDEA App Engine Server היא תבנית אחרת שלא זמינה ב-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

    מציינים את האפשרויות של שורת הפקודה שרוצים להעביר למכונה הווירטואלית כדי להפעיל את 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, צריך לבחור מקור נתונים ספציפי של מידע על תוסף, משבצת או פני שעון (בהתאם לתבנית) כדי להחיל עליו את ההגדרה. בדרך כלל, כל אחת מהישויות האלה מתאימה למחלקה בקוד.
    • בהגדרת ההרצה/ניפוי הבאגים של רכיב Complication ב-Wear OS, צריך לבחור את המשבצת שבה רוצים להציב את נתוני ה-Complication שמסופקים על ידי מקור נתוני ה-Complication. אפשר להציב אותו בחלק העליון, בצד ימין, בחלק התחתון, בצד שמאל או ברקע של תצוגת השעון.
    • בנוסף, בהגדרת ההרצה או הניפוי באגים של רכיב Complication ב-Wear OS, צריך לבחור את הסוג של נתוני ה-Complication שסופקו על ידי מקור נתוני ה-Complication. סוגי הנתונים שניתן לבחור מוגבלים לאלה שמסופקים על ידי מקור הנתונים של הסיבוך שנבחר ושנתמכים על ידי המשבצת שנבחרה. רשימה של סוגי נתונים של סיבוכים זמינה במאמר בנושא סוגים ושדות.

    אפשר גם להפעיל את הפלטפורמות האלה באמצעות סמל השוליים שנמצא ליד ההצהרה של הפלטפורמה, כמו שמוצג בתמונה הבאה. אם מתרחשת שגיאה, כמו 'Error while setting the tile' (שגיאה בהגדרת הרכיב), צריך לבדוק שהגדרתם את המשטח בצורה נכונה, כולל הצהרה על המשטח בקובץ המניפסט.

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