כשמריצים את הקוד, לנפות באגים או בודקים אותו, מערכת 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.
החלונית השמאלית של תיבת הדו-שיח מקבצת את ההגדרות האישיות לפי סוג התבנית ומאפשרת לערוך תבניות של הגדרות אישיות בחלק התחתון. אפשר לערוך את ההגדרה שנבחרה בחלונית השמאלית. משנים את גודל תיבת הדו-שיח כדי לראות פריטים מוסתרים.
בתיבת הדו-שיח הזו אפשר:
- יוצרים הגדרות חדשות להרצה/לניפוי באגים.
- עריכת הגדרות ההרצה/ניפוי הבאגים
- עורכים תבניות של הגדרות אישיות.
- מיון וקיבוץ של הגדרות
יצירת הגדרה חדשה של run/debug
אפשר לקבוע הגדרות חדשות להרצה או לניפוי באגים דרך תיבת הדו-שיח Run/Debug Configurations, מהחלון Project או מ-Code Editor. ההגדרה החדשה צריכה להתבסס על תבנית הגדרה.
בתיבת הדו-שיח Run/Debug Configurations מוצגות הגדרות ההרצה/ניפוי הבאגים ותבניות התצורה הזמינות. אפשר להתחיל תצורה חדשה ישירות מתבנית, או מעתק של תצורה אחרת. לאחר מכן תוכלו לשנות את ערכי השדות לפי הצורך.
לחלופין, אפשר ללחוץ לחיצה ימנית על פריט בחלון Project כדי ליצור באופן אוטומטי הגדרה ספציפית לאותו פריט. לדוגמה, אם רוצים להריץ פעילות מסוימת, לוחצים לחיצה ימנית על קובץ Java של הפעילות ובוחרים באפשרות Run. בהתאם לפריט, תבנית התצורה של Android Studio היא Android App, Android Instrumented Tests או JUnit.
בכלי לעריכת קוד אפשר ליצור בקלות תצורת בדיקה והרצה/ניפוי באגים לכיתה או שיטה, ולאחר מכן להפעיל אותה.
כשאתם יוצרים הגדרה מחוץ לתיבת הדו-שיח Run/Debug Configurations, ההגדרה היא זמנית, אלא אם שומרים אותה. כברירת מחדל, אפשר לקבוע בפרויקט עד חמש הגדרות זמניות לפני שמערכת Android Studio תתחיל להסיר אותן. כדי לשנות את ברירת המחדל, פותחים את ההגדרות של Android Studio ומשנים את Advanced Settings > Run/Debug > Temporary configuration limit. למידע נוסף על הגדרות זמניות, ראו יצירה ושמירה של הגדרות זמניות להרצה או לניפוי באגים.
התחלת הגדרה על סמך תבנית
כדי להגדיר תצורה של הפעלה/ניפוי באגים על סמך תבנית:
- פותחים את תיבת הדו-שיח Run/Debug Configurations.
- לוחצים על Add New Configuration (הוספת הגדרה חדשה) .
- בוחרים תבנית הגדרה.
- מקלידים שם בשדה Name.
- משנים את ההגדרות לפי הצורך.
- לוחצים על אישור או על אישור.
חשוב לתקן את כל השגיאות שמוצגות בחלק התחתון של תיבת הדו-שיח.
התחלת הגדרה מעתק
כדי לקבוע הגדרה של הרצה או ניפוי באגים מעותק של הגדרה אחרת, מבצעים את השלבים הבאים:
- פותחים את תיבת הדו-שיח Run/Debug Configurations.
- בוחרים הגדרה קיימת של הרצה/ניפוי באגים בחלונית השמאלית.
- לוחצים על העתקת ההגדרות .
- מקלידים שם בשדה Name.
- משנים את ההגדרות לפי הצורך.
- לוחצים על אישור או על אישור.
חשוב לתקן את כל השגיאות שמוצגות בחלק התחתון של תיבת הדו-שיח.
הגדרת הגדרה אישית לפריט בפרויקט
ב-Android Studio אפשר ליצור הגדרה להרצה/ניפוי באגים של פריטים מסוימים שמוצגים בחלון Project. ההגדרות מבוססות על תבנית תצורה, באופן הבא:
- קובץ Java של הפעילות: התבנית Android App.
- חבילת תבניות: Android Instrumented Tests או Android JUnit, בהתאם ל-source set. אם בוחרים בבדיקה עם מכשור, המערכת משתמשת בתבנית של בדיקות עם מכשור ל-Android. אם בוחרים באפשרות בדיקת יחידה מקומית, המערכת משתמשת בתבנית JUnit של Android. בבדיקת יחידה מקומית, אפשר להריץ את הבדיקה עם כיסוי קוד. מידע נוסף זמין במאמר כיסוי קוד.
כדי ליצור הגדרת הפעלה/ניפוי באגים לפריט בפרויקט:
- פותחים פרויקט ב-Android או Project view.
- בחלון Project, לוחצים לחיצה ימנית על פריט שניתן לבדוק ובוחרים באפשרות Run filename או Debug filename. Android Studio יוצר הגדרה זמנית להרצה/ניפוי באגים ומפעיל את האפליקציה.
- פותחים את התפריט הנפתח Select Run/Debug Configuration (בחירת הגדרות הפעלה/ניפוי באגים) בסרגל הכלים.
- בוחרים באפשרות Save Configuration (שמירה של ההגדרות) מהאפשרויות שלצד ההגדרה שרוצים לשמור.
הערה: אם לוחצים לחיצה ימנית ומפעילים או מאתרים באגים באותו פריט (אבל לא בפעילות), מערכת Android Studio יוצרת הגדרה חדשה.
הגדרת הגדרות לבדיקה של מחלקה או שיטה
ב-Android Studio אפשר להגדיר הגדרות להרצת בדיקה לכיתה או לשיטה, ואז להריץ אותן. לדוגמה, אם יוצרים כיתה חדשה, אפשר ליצור ולבצע בה בדיקה. אם הבדיקה תעבור בהצלחה, תוכלו להריץ את הבדיקות של שאר הפרויקט כדי לוודא שהקוד החדש לא גורם לשיבושים במקום אחר.
ב-Android Studio נעשה שימוש בתבנית Android Instrumented Tests או Android JUnit, בהתאם לקבוצת המקור. כדי לבצע בדיקת יחידה מקומית, אפשר להריץ עם codecover (כיסוי הקוד).
כדי ליצור תצורה של הרצה/ניפוי באגים לכיתה או שיטה בקוד ה-Java, מבצעים את השלבים הבאים:
- פותחים פרויקט ב-Android או Project view.
- פותחים קובץ Java בכלי לעריכת קוד.
- בוחרים מחלקה או שיטה בקוד ולוחצים על Control+Shift+T (Command+Shift+T).
- בתפריט שמופיע, בוחרים באפשרות יצירת בדיקה חדשה.
- בתיבת הדו-שיח Create, משנים או מגדירים את הערכים לפי הצורך ולוחצים על OK.
- בתיבת הדו-שיח Choose Destination Directory, בוחרים את המיקום בפרויקט שבו רוצים ש-Android Studio תמקם את הבדיקה. אפשר לציין את המיקום לפי מבנה הספרייה או על ידי בחירה בכיתה שכנה.
- לוחצים על אישור.
הבדיקה החדשה תופיע בחלון Project בקבוצת מקורות הבדיקה המתאימה.
- כדי להריץ את הבדיקה, מבצעים אחת מהפעולות הבאות:
- בחלון Project לוחצים לחיצה ימנית על הבדיקה ובוחרים באפשרות Run או Debug.
- ב-Code Editor, לוחצים לחיצה ימנית על הגדרת הכיתה או על שם השיטה בקובץ הבדיקה ובוחרים באפשרות Run או Debug כדי לבדוק את כל השיטות בכיתה.
- פותחים את הרשימה הנפתחת Select Run/Debug Configuration (בחירת הגדרה של הרצה/ניפוי באגים) שבסרגל הכלים.
- בוחרים באפשרות Save Configuration מהאפשרויות שלצד ההגדרה שרוצים לשמור.
הפעלה או ניפוי באגים של אפליקציה באמצעות תצורה שמורה
אם שמרתם תצורה של הרצה או ניפוי באגים, תוכלו לבחור אותה לפני הרצת האפליקציה או ניפוי באגים.
כדי להשתמש בהגדרות אישיות ששמורות לצורך הפעלה או ניפוי באגים:
- בוחרים את תצורת ההרצה/ניפוי הבאגים מהרשימה הנפתחת Select Run/Debug Configuration שבסרגל הכלים.
- בוחרים באפשרות הפעלה > הפעלה או באפשרות הפעלה > ניפוי באגים.
הרשימה הנפתחת נמצאת משמאל להרצה ולניפוי באגים . לדוגמה, .
לחלופין, לוחצים על הפעלה או על ניפוי באגים .
עריכת הגדרות של הרצה או ניפוי באגים
כדי לערוך הגדרה של הפעלה/ניפוי באגים:
- פותחים את תיבת הדו-שיח Run/Debug Configurations.
- בוחרים הגדרה בחלונית הימנית.
- משנים את ההגדרות האישיות לפי הצורך.
- לוחצים על אישור או על אישור.
חשוב לתקן את כל השגיאות שמוצגות בחלק התחתון של תיבת הדו-שיח.
עריכת תבנית של הגדרת הרצה/ניפוי באגים
אתם יכולים לערוך את תבניות התצורה ש-Android Studio מספקת בהתאם לתהליך הפיתוח שלכם. כאשר עורכים תבנית, היא לא משפיעה על הגדרות קיימות שמשתמשות בתבנית. לדוגמה, אם צריך ליצור כמה הגדרות מסוג מסוים, אפשר לערוך את התבנית ואז לשנות אותה חזרה בסיום.
אי אפשר ליצור תבניות חדשות, אבל אפשר ליצור הגדרות לשימוש, בדומה לתבנית. תוכלו להעתיק מערך של הגדרות אישיות ולערוך את העותק כדי ליצור הגדרות חדשות.
כדי לערוך תבנית:
- פותחים את תיבת הדו-שיח Run/Debug Configurations.
- לוחצים על Edit configuration templates….
- בוחרים תבנית תצורה.
- משנים את ההגדרות לפי הצורך.
- לוחצים על אישור או על אישור.
חשוב לתקן את כל השגיאות שמוצגות בחלק התחתון של תיבת הדו-שיח.
מיון והצגה בקבוצות של הגדרות
בתיבת הדו-שיח Run/Debug Configurations אפשר למיין את ההגדרות כדי למצוא אותן במהירות. אפשר למיין את הפריטים בתיקייה לפי סדר אלפביתי וליצור תיקיות חדשות כדי לקבץ הגדרות.
כדי למיין את ההגדרות לפי סדר אלפביתי, פועלים לפי השלבים הבאים:
- פותחים את תיבת הדו-שיח Run/Debug Configurations.
- בוחרים תיקייה שמכילה הגדרות.
- לוחצים על מיון ההגדרות .
- לוחצים על OK כדי לסגור את תיבת הדו-שיח.
כדי לקבץ הגדרות בתיקיות, מבצעים את השלבים הבאים:
- פותחים את תיבת הדו-שיח Run/Debug Configurations.
- בוחרים תיקייה שמכילה הגדרות.
- לוחצים על Create New Folder .
- מקלידים שם בשדה Folder Name (שם התיקייה).
- לוחצים על אישור כדי לשמור את השם.
הגדרת פעולות לפני ההשקה
אפשר לציין משימות לביצוע לפני החלת ההגדרה של ההרצה/ניפוי הבאגים. המשימות מתבצעות לפי הסדר שבו הן מופיעות ברשימה.
הערה: הגדרת משימות לפני ההשקה היא תכונה מתקדמת. במקום להשתמש בתכונה הזו, מומלץ להעביר את לוגיקת ההכנה למשימות בקובץ build.gradle
כדי שהן יבוצעו בזמן הפיתוח משורת הפקודה.
כדי ליצור רשימת משימות:
- בתחתית תיבת הדו-שיח Run/Debug Configurations בקטע Before launch (יכול להיות שתצטרכו לגלול למטה), לוחצים על Add ובוחרים סוג משימה. אם תיפתח תיבת דו-שיח, ממלאים את השדות ולוחצים על אישור.
- מוסיפים עוד משימות לפי הצורך.
- כדי לסדר את המשימות, גוררים אותן או בוחרים משימה ולוחצים על למעלה או על למטה כדי להזיז אותה למעלה או למטה ברשימה.
- בוחרים באפשרות Show this page אם רוצים להציג את הגדרות התצורה של ההרצה/ניפוי הבאגים לפני החלתן.
האפשרות הזו לא מסומנת כברירת מחדל.
- בוחרים באפשרות Active tool window אם רוצים שחלון הכלים Run או Debug יופעל כשמפעילים או מאתרים באגים באפליקציה.
האפשרות הזו מסומנת כברירת מחדל.
כדי להסיר משימה מהרשימה:
- בוחרים משימה.
- לוחצים על Remove [הסרה] .
כדי לערוך משימה:
- בוחרים משימה.
- לוחצים על עריכה .
- עורכים את הגדרות המשימה בתיבת הדו-שיח שנפתחת ולוחצים על OK.
בטבלה הבאה מפורטות המשימות שאפשר להוסיף.
משימה | תיאור |
---|---|
הפעלת כלי חיצוני | להריץ אפליקציה שלא שייכת ל-Android Studio. בתיבת הדו-שיח External Tools, בוחרים אפליקציה אחת או יותר שרוצים להפעיל ולוחצים על OK. אם האפליקציה עדיין לא מוגדרת ב-Android Studio, מוסיפים את ההגדרה שלה בתיבת הדו-שיח Create Tools. מידע נוסף זמין במאמר הגדרת כלים של צד שלישי ובכלים חיצוניים. |
הפעלת הגדרה אישית אחרת | מריצים אחת מההגדרות הקיימות של run/debug. בתיבת הדו-שיח Choose Configuration to Execute, בוחרים הגדרה לביצוע ולוחצים על OK. |
יצרן | עורכים הידור של הפרויקט או המודול. אם מוגדרת מודול מסוים בהגדרות ההרצה/ניפוי הבאגים, Android Studio מריצה את הפקודה Make Module. אם לא מוגדרים מודולים, היא מריצה את הפקודה Make Project. |
Make Project | מריצים את הידור הפרויקט. Android Studio מפעיל את הפקודה Make Project. |
Make, ללא בדיקת שגיאות | האפשרות הזו זהה לאפשרות Make, מלבד העובדה ש-Android Studio מבצע את ההגדרה של run/debug ללא קשר לתוצאת הידור. |
פיתוח תוצרי הפגישה | לא נתמך ב-Android Studio. |
הפעלת משימה ב-Gradle | מריצים משימת Gradle. בתיבת הדו-שיח שנפתחת, מציינים את הפרטים ולוחצים על אישור. מידע נוסף זמין במאמר Gradle. |
Make עם תמיכה ב-Gradle | מריצים את Gradle ומאגדים את הפרויקט. |
ה-builder של App Engine Gradle | המשימה של ה-builder של Gradle ב-App Engine מסנכרנת את הפרויקט ואז יוצרת את המודול. |
תבניות תצורה
ב-Android Studio יש תבניות תצורה שיעזרו לכם להתחיל לעבוד במהירות. בקטעים הבאים מפורטות התבניות שחלות על פיתוח Android באמצעות Android Studio:
- אפליקציה ל-Android
- Android Tests
- שרת פיתוח של App Engine
- תכונות נוספות, משבצות ותצוגות שעון ב-Wear OS
הערה: ב-Android Studio 2.1.x ובגרסאות ישנות יותר היה תבנית לאפליקציות מקוריות, שאין בגרסאות חדשות יותר. אם יש לכם תבנית של אפליקציה ילידית בפרויקט, Android Studio ממירה אותה לאפליקציית Android כשאתם מעלים את הפרויקט. תיבת הדו-שיח Convert Project (המרת פרויקט) תלווה אתכם בתהליך.
תבניות לא נתמכות
התבניות הבאות לא נתמכות ומגיעות מ-IntelliJ IDEA, והן לא ספציפיות לפיתוח Android באמצעות Android Studio. מידע נוסף על השימוש בתבניות האלה זמין בקישורים למסמכי התיעוד של IntelliJ IDEA.
- אפליקציה
- Compound
- Gradle
- גרוב
- אפליקציית JAR
- Java Scratch
- JUnit
- קוטלין
- סקריפט Kotlin
- ניפוי באגים מרחוק
- סקריפט מעטפת
- TestNG
אפשרויות תצורה נפוצות
האפשרויות שם, הפעלה במקביל ושמירה כקובץ פרויקט הן נפוצות במספר תבניות תצורה. מידע נוסף זמין במאמר הגדרות נפוצות.
Android Studio שומר את תצורת ההרצה/ניפוי הבאגים המשותפת בקובצי XML נפרדים בתיקייה project_directory/.idea/runConfigurations/
.
מידע נוסף זמין במאמר פורמט מבוסס-ספרייה במסמכי העזרה של פרויקטים ב-IntelliJ.
אפליקציה ל-Android
אפשר להריץ או לנפות באגים באפליקציות ובפעילויות של Android במכשירים וירטואליים או במכשירי חומרה באמצעות הגדרות שמבוססות על התבנית הזו.
הכרטיסייה 'כללי'
בכרטיסייה General אפשר לציין אפשרויות התקנה, הפעלה ופריסה. הכרטיסייה Miscellaneous מכילה גם אפשרויות התקנה.
שדה | תיאור |
---|---|
מודול | בוחרים מודול שבו רוצים להחיל את ההגדרה הזו. |
אפשרויות התקנה: פריסה | בוחרים אפשרות:
|
אפשרויות התקנה: פריסה כאפליקציה ללא התקנה | אם האפליקציה תומכת בחוויות ללא התקנה – כלומר הוספת תמיכה באפליקציות ללא התקנה כשיוצרים פרויקט חדש או כשיוצרים מודול אחד או יותר של תכונות שמופעלות באופן מיידי – אפשר לבחור לפרוס את המודולים המופעלים ללא התקנה על ידי סימון התיבה לצד פריסה כאפליקציה ללא התקנה. |
אפשרויות התקנה: תכונות לפריסה |
אם האפליקציה כוללת מודולים של תכונות, מסמנים את התיבה לצד כל תכונה שרוצים לכלול בפריסה של האפליקציה. האפשרות הזו מוצגת רק אם האפליקציה כוללת מודולים של תכונות.
הערה: אם רוצים לבדוק את ההורדה וההתקנה של מודולים של תכונות על פי דרישה, צריך לעשות זאת אחרי שמפרסמים את חבילת האפליקציות ואז להשתמש במסלול הבדיקה הפנימי של Play Console. מידע נוסף זמין במאמר העלאת חבילת האפליקציות ל-Play Console. |
אפשרויות התקנה: דגלים להתקנה | מקלידים את אפשרויות ה-adb pm
install שבהן רוצים להשתמש. האפשרויות צריכות להיות בפורמט זהה לזה של שורת הפקודה, אבל בלי נתיב. הנה כמה דוגמאות:
וגם
ברירת המחדל: ללא אפשרויות. |
אפשרויות הפעלה: השקה | בוחרים אפשרות:
|
אפשרויות הפעלה: דגלים להפעלה | מקלידים את אפשרויות ה-adb am
start שבהן רוצים להשתמש. מעצבים את האפשרויות באותו אופן שבו מעצבים אותן בשורת הפקודה, אבל בלי כוונת שימוש. לדוגמה:
האפשרות הזו לא מופיעה אם בחרתם בערך Nothing (לא כלום) בשדה Launch (השקה). ברירת מחדל: אין אפשרויות. |
אפשרויות יעד לפריסה: יעד | בוחרים אפשרות:
|
אפשרויות יעד הפריסה: שימוש באותו מכשיר להשקות עתידיות |
כברירת מחדל, האפשרות הזו לא מסומנת, כך שלכל פעם שמפעילים אפליקציה, תיפתח תיבת הדו-שיח Select Deployment (בחירת פריסה) כדי לבחור מכשיר. כשבוחרים באפשרות הזו ומריצים אפליקציה, מופיעה תיבת הדו-שיח Select Deployment, שבה אפשר לבחור מכשיר. לאחר מכן, בכל פעם שמריצים את האפליקציה, היא מופעלת במכשיר שנבחר בלי להציג את תיבת הדו-שיח Select Deployment. כדי להפעיל את האפליקציה במכשיר אחר, צריך לבטל את הבחירה באפשרות שימוש באותו מכשיר להשקות עתידיות או להפסיק את האפליקציה באמצעות לחיצה על הפעלה > עצירה app או עצירה , ואז להפעיל אותה שוב. תיבת הדו-שיח Select Deployment תופיע, תוכלו לבחור מכשיר. |
לפני ההשקה | ראו הגדרה לפני הפעלה של פעולות. |
הכרטיסייה 'שונות'
בכרטיסייה שונות אפשר לציין אפשרויות Logcat, התקנה, הפעלה ופריסה. הכרטיסייה General כוללת גם את אפשרויות ההתקנה.
שדה | תיאור |
---|---|
Logcat: הצגת Logcat באופן אוטומטי | כשבוחרים באפשרות הזו, החלון Logcat נפתח בכל פעם שמפרסים אפליקציה ומפעילים אותה בהצלחה באמצעות ההגדרה הזו. ברירת מחדל: מסומן. |
Logcat: ניקוי היומן לפני ההשקה | בוחרים באפשרות הזו אם רוצים ש-Android Studio תסיר מקובץ היומן נתונים מפעילויות קודמות לפני הפעלת האפליקציה. ברירת המחדל: האפשרות לא מסומנת. |
אפשרויות התקנה: דילוג על ההתקנה אם ה-APK לא השתנה. | לאחר הבחירה באפשרות הזו, מערכת Android Studio לא תפרוס מחדש את ה-APK אם היא תזהה שהוא לא השתנה. אם רוצים ש-Android Studio תאלץ את ההתקנה של קובץ ה-APK, גם אם הוא לא השתנה, צריך לבטל את הבחירה באפשרות הזו. ברירת מחדל: נבחרה |
אפשרויות התקנה: אילוץ הפסקה של הפעלת האפליקציה לפני הפעלת הפעילות | אם תבחרו באפשרות הזו, כש-Android Studio תזהה שלא צריך להתקין מחדש קובץ APK כי הוא לא השתנה, היא תפסיק את האפליקציה בכוח כדי שהיא תתחיל מפעילות ברירת המחדל של מרכז האפליקציות. אם לא מבטלים את הבחירה באפשרות הזו, ב-Android Studio לא מתבצע אילוץ עצירה של האפליקציה. האפשרות הזו פועלת עם האפשרות הקודמת, שמאפשרת לקבוע אם חבילת APK תותקן או לא. בשני השדות של אפשרויות ההתקנה, משאירים את הגדרות ברירת המחדל אלא אם רוצים לאלץ את ההתקנה בכל פעם. במקרים מסוימים, כדאי לבטל את הסימון של האפשרות הזו. לדוגמה, אם אתם כותבים במנוע שיטת קלט (IME), עצירת האפליקציה בכוח תגרום לביטול הבחירה שלה כמקלדת הנוכחית, ויכול להיות שזה לא מה שאתם רוצים. ברירת מחדל: נבחרה |
לפני ההשקה | כדאי לעיין בקטע הגדרה לפני פעולות השקה. |
הכרטיסייה 'כלי לניפוי באגים'
מציינים את אפשרויות ניפוי הבאגים בכרטיסייה Debugger.
בקוד C ו-C++, Android Studio משתמש בניפוי הבאגים LLDB. בנוסף לממשק המשתמש הרגיל של Android Studio, בחלון של הכלי לניפוי באגים יש כרטיסיית LLDB שמאפשרת להזין פקודות LLDB במהלך ניפוי באגים. תוכלו להזין את אותן פקודות שבהן מערכת Android Studio משתמשת כדי להציג מידע בממשק המשתמש של הכלי לניפוי באגים, ותוכלו לבצע פעולות נוספות.
בכרטיסייה Debugger, תוכלו להוסיף ספריות סמלים בפרויקטים של C ו-C++ וגם פקודות הפעלה ושליחה של LLDB בפורמט של LLDB. כדי לעשות זאת, משתמשים בלחצנים דומים לאלה:
- הוספה - הוספת ספרייה או פקודה.
- הסרה – בוחרים ספרייה או פקודה ולוחצים על הלחצן הזה כדי להסיר את הפריט.
- למעלה - בוחרים ספרייה או פקודה ולוחצים על הלחצן הזה כדי להזיז את הפריט למעלה ברשימה.
- למטה - בוחרים ספרייה או פקודה ולוחצים על הלחצן הזה כדי להזיז את הפריט למטה ברשימה.
מידע נוסף על ניפוי באגים ב-Android Studio זמין במאמר ניפוי באגים באפליקציה.
שדה | תיאור |
---|---|
סוג ניפוי באגים | בחר באחת מהאפשרויות הבאות:
מומלץ לבחור באפשרות זיהוי אוטומטי כי היא בוחרת את סוג ניפוי הבאגים המתאים לפרויקט. |
ספריות סמלים | אם רוצים להוסיף קובצי סמל כדי לספק למעבד הבאגים מידע ב-C או ב-C++ שנוצר מחוץ ל-Android Studio, אפשר להוסיף כאן ספרייה אחת או יותר. מערכת Android Studio מעדיפה להשתמש בקובצים שבספריות האלה על פני קבצים שנוצרו על ידי הפלאגין Android ל-Gradle. הכלי לניפוי באגים מחפש את הספריות מלמעלה למטה, לפי הסדר, עד שהוא מוצא את מה שהוא צריך. הוא מחפש באופן רפלוקטיבי דרך הקבצים במאגר. כדי לבצע אופטימיזציה לרשימה ולחסוך זמן, מציבים את הספריות שנמצאות בשימוש לעיתים קרובות בראש הרשימה. אם מציינים ספרייה שנמצאת במיקום גבוה בעץ, יכול להיות שייקח יותר זמן לחפש בכל ספריות המשנה. אם מוסיפים ספרייה ספציפית מאוד, החיפוש יהיה מהיר יותר. צריך למצוא את האיזון הנכון בין מהירות לבין מציאת הקבצים שנדרשים לניפוי הבאגים. לדוגמה, אם יש לכם ספרייה שמכילה ספריות משנה ל-Android Binary Interfaces (ממשקים בינאריים שונים של Android), תוכלו להוסיף ספרייה ל-ABI ספציפי או לכל ממשקי ה-ABI. חיפוש בספרייה ברמה העליונה עשוי להימשך זמן רב יותר, אבל הוא גם בטוח יותר אם תחליטו לנפות באגים במכשיר אחר. שימו לב שלא צריך להוסיף ספריות שמכילות קובצי סמלים של Gradle, כי הכלי לניפוי באגים משתמש בהן באופן אוטומטי. |
פקודות לטעינה של LLDB | מוסיפים את פקודות LLDB שרוצים להריץ לפני שהכלי לניפוי באגים יתחבר לתהליך. לדוגמה, אפשר להגדיר הגדרות לסביבה, כפי שמתואר בפקודה הבאה:
LLDB מבצע את הפקודות לפי הסדר, מלמעלה למטה. |
פקודות LLDB צירוף פוסט | מוסיפים את פקודות LLDB שרוצים להריץ מיד אחרי שמאתר הבאגים מצורף לתהליך. לדוגמה:
LLDB מבצע את הפקודות לפי הסדר, מלמעלה למטה. |
ספריית העבודה של המארח | מציינים את ספריית העבודה של LLDB. |
רישום ביומן: טירגוט ערוצים | לציין אפשרויות יומן LLDB. אפשרויות ברירת המחדל של Android Studio מוגדרות על סמך הניסיון של הצוות, כך שהן לא איטיות מדי אבל מכילות את המידע הנדרש לפתרון בעיות. לרוב מבקשים את היומן כדי לדווח על באגים ב-Android Studio. ברירת המחדל הזו היא
אפשר לשנות את ברירת המחדל כדי לאסוף מידע נוסף. לדוגמה, אפשרויות היומן הבאות אוספות מידע על lldb process
platform:gdb-remote packets
כדי לראות את הרשימה המלאה של פקודות היומן, מזינים את הפקודה
Android Studio ממוקם את יומני המכשיר במיקום הבא, שבו
לחלופין, אם מספר משתמשים ניגשים למכשיר, היומנים ממוקמים במיקום הבא, שבו
למידע נוסף על השימוש ב-LLDB לניפוי באגים מרחוק, ראו ניפוי באגים מרחוק. |
לפני ההשקה | מידע נוסף זמין במאמר הגדרת פעולות לפני ההשקה. |
הכרטיסייה 'יצירת פרופילים'
צריך לסמן את האפשרות Enable advanced profiling כדי להפעיל תכונות מסוימות ב-Android Profiler כשבמכשיר פועלת גרסת Android 7.1 ומטה.
בדיקות ב-Android
תבנית הבדיקה שבה צריך להשתמש תלויה בקבוצת המקור. התבנית של Android Instrumented Tests מיועדת לבדיקה של מכשירים. התבנית של JUnit ל-Android מיועדת לבדיקת יחידה מקומית.
הערה: אם אתם משתמשים ב-Firebase Test Lab כדי לבדוק במגוון מכשירים, תוכלו להשתמש בתבנית Android JUnit כדי להגדיר את הבדיקות המכשוריות. למידע נוסף, ראו הרצת הבדיקות באמצעות Firebase Test Lab.
התיאורים הבאים של הכרטיסיות מתייחסים לכרטיסיות ולשדות של תבנית הבדיקה של Android Instrumented. מידע על הכרטיסיות והשדות בתבנית הבדיקה של JUnit של Android זמין בדף Run/Debug Configuration: JUnit של IntelliJ.
הכרטיסייה 'כללי'
בכרטיסייה General אפשר לציין את מיקום הבדיקה, את הכלי להפעלת כלי המדידה, את מעטפת adb ואת אפשרויות הפריסה.
שדה | תיאור |
---|---|
מודול | בוחרים מודול שבו רוצים להחיל את ההגדרה הזו. |
בדיקה | כאן מציינים את המיקום של הבדיקות שרוצים להריץ:
|
מפעיל ספציפי של מכשירי מדידה (אופציונלי) | מקלידים את המיקום של כלי ההפעלה של המדידה. לוחצים על עוד כדי להשתמש בתיבת דו-שיח. הקובץ build.gradle מציין את המיקום של הכלי להרצת המדידה. הערך הזה מבטל את הערך שמוגדר בקובץ. ברירת המחדל היא בדרך כלל הכיתה AndroidJUnitRunner מ-AndroidX Test.
|
אפשרויות נוספות | מקלידים את אפשרויות ה-adb ברירת מחדל: ללא אפשרויות |
אפשרויות יעד לפריסה: יעד | בוחרים אפשרות:
|
אפשרויות יעד הפריסה: שימוש באותו מכשיר להשקות עתידיות | כדי להשתמש בעתיד באופן אוטומטי במכשיר שבחרתם דרך תיבת הדו-שיח Select Deployment Target, בוחרים באפשרות הזו. אם המכשיר לא זמין, תוצג תיבת דו-שיח. ברירת המחדל: הבחירה בוטלה |
לפני ההשקה | מידע נוסף זמין במאמר הגדרת פעולות לפני ההשקה. |
הכרטיסייה 'שונות'
הכרטיסייה Miscellaneous מכילה אפשרויות ל-logcat ולהתקנה.
שדה | תיאור |
---|---|
Logcat: ניקוי היומן לפני ההשקה | בוחרים באפשרות הזו אם רוצים ש-Android Studio תסיר מקובץ היומן נתונים מפעילויות קודמות לפני הפעלת האפליקציה. ברירת המחדל: האפשרות לא מסומנת. |
אפשרויות התקנה: דילוג על ההתקנה אם קובץ ה-APK לא השתנה | אם בוחרים באפשרות הזו, Android Studio לא פורסת מחדש את קובץ ה-APK אם הוא לא השתנה. אם אתם רוצים ש-Android Studio יאלץ התקנה של ה-APK, גם אם הוא לא השתנה, עליכם לבטל את הבחירה באפשרות הזו. ברירת המחדל: נבחרה |
אפשרויות התקנה: אילוץ הפסקה של הפעלת האפליקציה לפני הפעלת הפעילות | אם נבחר ב-Android Studio, כשמערכת Android Studio מזהה שאין צורך להתקין מחדש APK כי הוא לא השתנה, האפליקציה תיאלץ לעצור את האפליקציה כך שהאפליקציה תתחיל מפעילות ברירת המחדל של מרכז האפליקציות. אם לא מבטלים את הבחירה באפשרות הזו, ב-Android Studio לא מתבצעת סגירה ידנית של האפליקציה. האפשרות הזו פועלת בשילוב עם האפשרות הקודמת, שמאפשרת לקבוע אם חבילת ה-APK תותקן או לא. בשני השדות של אפשרויות ההתקנה, משאירים את הגדרות ברירת המחדל אלא אם רוצים לאלץ את ההתקנה בכל פעם. במקרים מסוימים, כדאי לבטל את הסימון של האפשרות הזו. לדוגמה, אם אתם כותבים במנוע שיטת קלט (IME), עצירת האפליקציה בכוח תגרום לביטול הבחירה שלה כמקלדת הנוכחית, ויכול להיות שזה לא מה שאתם רוצים. ברירת מחדל: נבחרה |
לפני ההשקה | מידע נוסף זמין במאמר הגדרת פעולות לפני ההשקה. |
הכרטיסייה 'כלי לניפוי באגים'
מציינים את אפשרויות ניפוי הבאגים בכרטיסייה Debugger.
אם מדובר בקוד C ו-C++, מערכת Android Studio משתמשת בכלי לניפוי באגים LLDB. בנוסף לממשק המשתמש הרגיל של Android Studio, בחלון ניפוי הבאגים יש כרטיסייה LLDB שמאפשרת להזין פקודות LLDB במהלך ניפוי הבאגים. תוכלו להזין את אותן פקודות שבהן מערכת Android Studio משתמשת כדי להציג מידע בממשק המשתמש של הכלי לניפוי באגים, ותוכלו לבצע פעולות נוספות.
בכרטיסייה Debugger, תוכלו להוסיף ספריות סמלים בפרויקטים של C ו-C++ וגם פקודות הפעלה ושליחה של LLDB בפורמט של LLDB. כדי לעשות זאת, משתמשים בלחצנים דומים לאלה:
- הוספה - הוספת ספרייה או פקודה.
- הסרה – בוחרים ספרייה או פקודה ולוחצים על הלחצן הזה כדי להסיר את הפריט.
- למעלה - בוחרים ספרייה או פקודה ולוחצים על הלחצן הזה כדי להזיז את הפריט למעלה ברשימה.
- למטה - בוחרים ספרייה או פקודה ולוחצים על הלחצן הזה כדי להזיז את הפריט למטה ברשימה.
מידע נוסף על ניפוי באגים ב-Android Studio זמין במאמר ניפוי באגים באפליקציה.
שדה | תיאור |
---|---|
סוג ניפוי באגים | בחר באחת מהאפשרויות הבאות:
מומלץ לבחור באפשרות זיהוי אוטומטי כי היא בוחרת את סוג ניפוי הבאגים המתאים לפרויקט. |
ספריות סמלים | אם רוצים להוסיף קובצי סמל כדי לספק למעבד הבאגים מידע ב-C או ב-C++ שנוצר מחוץ ל-Android Studio, אפשר להוסיף כאן ספרייה אחת או יותר. מערכת Android Studio מעדיפה להשתמש בקובצים שבספריות האלה על פני קבצים שנוצרו על ידי הפלאגין Android ל-Gradle. מנתח הבאגים מחפש את הספריות מלמעלה למטה, לפי הסדר, עד שהוא מוצא את מה שהוא צריך. הוא מחפש באופן רספונסיבי בקבצים שבספרייה. כדי לבצע אופטימיזציה של הרשימה ולחסוך זמן, כדאי למקם את הספריות שבהן אתם משתמשים בתדירות הגבוהה ביותר בחלק העליון של הרשימה. אם מציינים ספרייה גבוהה בעץ, יכול להיות שיחלוף זמן רב יותר עד שהחיפוש בכל ספריות המשנה יושלם. אם מוסיפים ספרייה ספציפית מאוד, החיפוש יהיה מהיר יותר. צריך למצוא את האיזון הנכון בין מהירות לבין איתור הקבצים שאתם צריכים לניפוי באגים. לדוגמה, אם יש לכם ספרייה שמכילה ספריות משנה של Android Binary Interfaces (ABI) שונים, תוכלו להוסיף ספרייה ל-ABI ספציפי או לכל ה-ABI. למרות שהחיפוש בספרייה ברמה העליונה עשוי להימשך זמן רב יותר, הוא גם בטוח יותר אם תחליטו לנפות באגים במכשיר אחר. שימו לב שלא צריך להוסיף ספריות שמכילות קובצי סמלים של Gradle, כי הכלי לניפוי באגים משתמש בהן באופן אוטומטי. |
פקודות לטעינה של LLDB | מוסיפים את פקודות LLDB שרוצים להריץ לפני שהכלי לניפוי באגים יתחבר לתהליך. לדוגמה, אפשר להגדיר הגדרות לסביבה, כפי שמתואר בפקודה הבאה:
LLDB מבצע את הפקודות לפי הסדר, מלמעלה למטה. |
פקודות LLDB צירוף פוסט | מוסיפים את פקודות LLDB שרוצים להריץ מיד אחרי שמאתר הבאגים מצורף לתהליך. לדוגמה:
LLDB מבצע את הפקודות לפי הסדר, מלמעלה למטה. |
ספריית העבודה של המארח | מציינים את ספריית העבודה של LLDB. |
רישום ביומן: טירגוט ערוצים | לציין אפשרויות יומן LLDB. אפשרויות ברירת המחדל של Android Studio מוגדרות על סמך הניסיון של הצוות, כך שהן לא איטיות מדי אבל מכילות את המידע הנדרש לפתרון בעיות. לרוב מבקשים את היומן כדי לדווח על באגים ב-Android Studio. ברירת המחדל הזו היא
אפשר לשנות את ברירת המחדל כדי לאסוף מידע נוסף. לדוגמה, אפשרויות היומן הבאות אוספות מידע על lldb process
platform:gdb-remote packets
כדי לראות את הרשימה המלאה של פקודות היומן, מזינים את הפקודה
Android Studio ממוקם את יומני המכשיר במיקום הבא, שבו
לחלופין, אם מספר משתמשים ניגשים למכשיר, היומנים ממוקמים במיקום הבא, שבו
מידע על השימוש ב-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 כדי לסנכרן את הפרויקט. ברירת מחדל: נבחרה
|
SDK של App Engine | מקלידים נתיב SDK של Google App Engine ל-Java במחשב המקומי. לוחצים על ... כדי לבחור אותו מתיבת דו-שיח. |
War Path | מקלידים נתיב לספריית הארכיון של אפליקציית האינטרנט (WAR) של האפליקציה שמפרסים בשרת הפיתוח המקומי. לוחצים על ... כדי לבחור אותו מתיבת דו-שיח. |
מערכי VM | מציינים את אפשרויות שורת הפקודה שרוצים להעביר ל-VM כדי להפעיל את DevAppServer. כשמציינים את האפשרויות:
מידע נוסף על אפשרויות של מכונות וירטואליות זמין במסמכי העזרה של גרסת J2SE, למשל ברירת מחדל: ללא אפשרויות |
כתובת השרת | מקלידים את הכתובת של המארח שבה רוצים להשתמש בשרת. יכול להיות שתצטרכו לספק את הכתובת כדי לקבל גישה לשרת הפיתוח ממחשב אחר ברשת. כתובת 0.0.0.0 מאפשרת גישה גם ל-localhost וגם לשם המארח. ברירת מחדל: Localhost |
יציאת שרת | מקלידים את מספר היציאה שישמש את השרת. ברירת מחדל: 8080 |
השבתת הבדיקה של עדכוני SDK של App Engine | אם תספקו את הפרמטר הזה, שרת הפיתוח לא ייצור קשר עם App Engine כדי לבדוק אם יש גרסה חדשה של ה-SDK. כברירת מחדל, השרת בודק אם יש גרסה חדשה בזמן ההפעלה, ומדפיס הודעה אם יש גרסה חדשה. |
לפני ההשקה | מידע נוסף זמין במאמר הגדרת פעולות לפני ההשקה. |
הגדרות הרצה/ניפוי באגים ב-Wear OS
התבניות לרכיבים, כרטיסי מידע ותצוגות השעון של Wear OS מאפשרות להריץ אפליקציות ל-Wear OS או לנפות באגים באפליקציות ל-Wear OS במכשירים וירטואליים או במכשירים חומרה. רוב אפשרויות ההגדרה של התבנית זהות לאפשרויות של אפליקציית Android. אלה האפשרויות שספציפיות יותר להגדרות ההרצה/ניפוי הבאגים של Wear OS:
- בכל ההגדרות של Wear להפעלה או לניפוי באגים, צריך לבחור מקור נתונים ספציפי של רכיב מורכב, משבצת או לוח שעון (בהתאם לתבנית) כדי להחיל את ההגדרה. בדרך כלל כל אחת מהישויות האלה תואמת לכיתה בקוד.
- בהגדרה של הפעלה/ניפוי באגים של Wear OS Complication, צריך לבחור את החריץ שבו רוצים להציב את נתוני התוסף שסופקו על ידי מקור הנתונים של התוסף. אפשר להציב אותו בחלק העליון, הימני, התחתון, השמאלי או הרקע של תצוגת השעון.
- בהגדרה של הפעלה/ניפוי באגים של התוסף ל-Wear OS, צריך גם לבחור את הסוג של נתוני התוסף שסופקו על ידי מקור הנתונים של התוסף. סוגי הנתונים שבהם אפשר לבחור מוגבלים לנתונים שמספק מקור הנתונים שנבחר ל-Complication ומתאימים לשקע שנבחר. רשימה של סוגי הנתונים של סיבוכים מפורטת בקטע סוגים ושדות.
לחלופין, אפשר להריץ את המשטחים האלה גם מהסמל של פס ההפרדה שנמצא ליד ההצהרה על המשטח, כפי שמוצג בתמונה הבאה.