כשמריצים את הקוד, לנפות באגים או בודקים אותו, מערכת Android Studio משתמשת בהרצה או בניפוי באגים כדי לקבוע איך לבצע את הפעולה. בדרך כלל, שנוצרה בהתחלה מספיק כדי להריץ או לנפות באגים באפליקציה. עם זאת, אפשר לשנות וליצור הגדרות אישיות חדשות ולשנות את ההגדרות האישיות כדי שיתאימו לתהליך הפיתוח שלך כפי שמתואר בדף הזה.
מידע נוסף זמין גם במסמכי התיעוד הבאים של IntelliJ:
מידע על הגדרות הרצה או ניפוי באגים
תצורות של הרצה או ניפוי באגים מציינות פרטים כמו של אפליקציות להתקנה, להפעלה ולבדיקה של אפליקציות. אפשר לקבוע הגדרה לשימוש חד-פעמי, או לשמור אותה לשימוש עתידי. אחרי השמירה אפשר לבחור את ההגדרות האישיות לוחצים על הרשימה הנפתחת 'הפעלה/ניפוי באגים' בסרגל הכלים. מערכת Android Studio שומרת הגדרות כחלק מהפרויקט.
הגדרת הרצה/ניפוי באגים שנוצרה לראשונה
כשיוצרים פרויקט בפעם הראשונה, מערכת Android Studio יוצרת הרצה או ניפוי באגים את התצורה של הפעילות העיקרית על סמך תבנית האפליקציה ל-Android. כדי להפעיל או לנפות באגים תמיד צריכה להיות לכם לפחות הגדרה אחת של הרצה/ניפוי באגים. לכן מומלץ לא למחוק את ההגדרות האישיות שנוצרו במקור.
ניהול הגרסאות וההיקף של הפרויקט
הגדרות של הרצה או ניפוי באגים ושינויים בתבנית חלים רק על הפרויקט הנוכחי. אפשר לשתף תצורה של הרצה או ניפוי באגים (אבל לא באמצעות תבנית) באמצעות במערכת לניהול גרסאות. למידע נוסף על שיתוף הגדרות אישיות, ראה אפשרויות תצורה של שם ושיתוף.
פתיחת תיבת הדו-שיח 'תצורה של הרצה/ניפוי באגים'
כדי לפתוח את תיבת הדו-שיח 'תצורה של הרצה/ניפוי באגים', בוחרים באפשרות הפעלה > לעריכת ההגדרות האישיות מופיעה תיבת הדו-שיח Run/Debug Configuration (הפעלה/ניפוי באגים), כפי שמוצג באיור 1.
איור 1. תיבת הדו-שיח הפעלה/ניפוי באגים בהגדרות
החלונית השמאלית של תיבת הדו-שיח מקבצת את ההגדרות האישיות לפי סוג התבנית. מאפשרת לערוך תבניות הגדרות אישיות בחלק התחתון. אפשר לערוך את ההגדרות האישיות שנבחרו בחלונית השמאלית. כדי לראות פריטים מוסתרים, אפשר לשנות את הגודל של תיבת הדו-שיח.
בתיבת הדו-שיח הזו אפשר:
- יוצרים הגדרות הרצה או ניפוי באגים.
- עריכה של הגדרות הרצה או ניפוי באגים
- עורכים תבניות של הגדרות אישיות.
- מיון וקיבוץ של הגדרות
יצירת הגדרה חדשה של הרצה או ניפוי באגים
אפשר לקבוע הגדרות חדשות להרצה או לניפוי באגים דרך קובץ ההרצה/ניפוי הבאגים. הגדרות אישיות, תיבת הדו-שיח Project או הקוד עריכה. ההגדרה החדשה חייבת להתבסס על תבנית הגדרה.
תיבת הדו-שיח 'תצורה של הרצה/ניפוי באגים' מציגה את הגדרות ההרצה/ניפוי הבאגים הזמינות ותבניות אישיות. אפשר להתחיל מערך חדש של הגדרות אישיות ישירות מתבנית או עותק של הגדרה אחרת. אחר כך אפשר לשנות את הערכים בשדות לפי הצורך.
אפשר גם ללחוץ לחיצה ימנית על פריט בפרויקט חלון ליצירת הגדרות אישיות ספציפיות לפריט הזה באופן אוטומטי. עבור לדוגמה, אם רוצים להריץ פעילות מסוימת, אפשר ללחוץ לחיצה ימנית על של activity Java ובוחרים באפשרות Run. בהתאם לפריט, Android Studio משתמש באפליקציה ל-Android, Android Instrumented Tests, או JUnit את תבנית ההגדרות האישיות כדי ליצור את ההגדרות האישיות.
ב-Code Editor אפשר ליצור בקלות תצורת בדיקה והרצה/ניפוי באגים מחלקה או שיטה, ולאחר מכן מריצים אותה.
כשיוצרים תצורה מחוץ לכלי Run/Debug הגדרות אישיות, ההגדרה היא זמנית אלא אם שומרים אותו. כברירת מחדל, אפשר לקבוע עד חמש הגדרות זמניות בפרויקט לפני שמערכת Android Studio תתחיל להסיר אותן. כדי לשנות את זה, כברירת מחדל, פותחים את ההגדרות של Android Studio ומשנים הגדרות מתקדמות > הרצה/ניפוי באגים > מגבלת הגדרות זמניות. למידע נוסף על תצורות זמניות, אפשר לעיין במאמר יצירה ושמירה של הגדרות זמניות להרצה/ניפוי באגים
הפעלת הגדרות אישיות שמבוססות על תבנית
כדי להגדיר תצורה של הרצה או ניפוי באגים על סמך תבנית, מבצעים את השלבים הבאים:
- פתיחת ההרצה/ניפוי הבאגים תיבת דו-שיח להגדרות.
- לוחצים על Add New Configuration (הוספת הגדרה חדשה)
.
- בוחרים תבנית הגדרה.
- מקלידים שם בשדה שם.
- משנים את ההגדרות האישיות לפי הצורך.
- לוחצים על אישור או על אישור.
חשוב לתקן את כל השגיאות שמוצגות בחלק התחתון של תיבת הדו-שיח.
הפעלת הגדרות מעותק
כדי להגדיר תצורה של הרצה/ניפוי באגים שמתחילה בעותק של הגדרה אחרת להגדרה, בצעו את השלבים הבאים:
- פתיחת ההרצה/ניפוי הבאגים תיבת דו-שיח להגדרות.
- בוחרים הגדרה קיימת של הרצה/ניפוי באגים בחלונית השמאלית.
- לוחצים על העתקת ההגדרה
.
- מקלידים שם בשדה שם.
- משנים את ההגדרות האישיות לפי הצורך.
- לוחצים על אישור או על אישור.
חשוב לתקן את כל השגיאות שמוצגות בחלק התחתון של תיבת הדו-שיח.
הגדרת תצורה לפריט ב- הפרויקט
אפשר ליצור ב-Android Studio הגדרות של הרצה או ניפוי באגים לפריטים מסוימים שמוצג בחלון Project. ההגדרה מבוססת על תבנית הגדרות אישיות, באופן הבא:
- קובץ Java של פעילות: התבנית של האפליקציה ל-Android.
- Package: בדיקות מכשירים של Android או תבנית JUnit של Android, בהתאם קבוצת מקור. אם בוחרים בדיקה שמודדים אינסטרומנטציה, לאחר מכן היא משתמשת בתבנית הבדיקות של Android Instrument. אם תבחר local unit test, הוא משתמש בתבנית JUnit של Android. כדי לבצע בדיקת יחידה מקומית, אפשר: להפעיל אותו עם כיסוי קוד. מידע נוסף זמין במאמר Code כיסוי.
כדי ליצור הגדרה של הרצה או ניפוי באגים לפריט בפרויקט:
- פתיחת פרויקט ב-Android או תצוגת פרויקט.
- בחלון Project, לוחצים לחיצה ימנית על פריט שניתן לבדיקה ובוחרים באחת מהאפשרויות מריצים את filename או את ניפוי באגים filename. Android Studio יוצר הגדרה זמנית של הרצה/ניפוי באגים ומפעיל את האפליקציה שלכם.
- פותחים את הרשימה הנפתחת Select Run/Debug Configuration (בחירת הגדרה של הרצה/ניפוי באגים) שבסרגל הכלים.
- בוחרים באפשרות Save Configuration (שמירת ההגדרות האישיות) מתוך האפשרויות לצד ההגדרה שבחרתם.
שרוצים לשמור.
איור 2. שמירת ההגדרות האישיות
הערה: אם לוחצים לחיצה ימנית ומריצים או מנקים באגים של אותו פריט (אבל לא פעילות), Android Studio יוצר מערך הגדרות אישיות חדש.
הגדרת הגדרות לבדיקה לכיתה או method
בעזרת Android Studio תוכלו להגדיר תצורה של הרצת בדיקה לכיתה או שיטה, ואז לבצע אותה. לדוגמה, אם יוצרים כיתה חדשה, אפשר ליצור ולהריץ בדיקה עבורו. אם הבדיקה תעבור בהצלחה, תוכל להריץ את הבדיקות עבור את שאר הפרויקט כדי לוודא שהקוד החדש לא גורם נזק למקום אחר.
Android Studio משתמש בבדיקות אינסטרומנטליות של Android או ב-Android JUnit בהתאם למקור הנתונים שלכם הגדרה. עבור בדיקת יחידה מקומית, אפשר להריץ עם code כיסוי.
כדי ליצור תצורה של הרצה/ניפוי באגים לכיתה או שיטה בקוד ה-Java, מבצעים את השלבים הבאים:
- פתיחת פרויקט ב-Android או תצוגת פרויקט.
- פותחים קובץ Java בעורך הקוד.
- בוחרים כיתה או שיטה בקוד ולוחצים על Control+Shift+T (Command+Shift+T).
- בתפריט שמופיע, בוחרים באפשרות Create New Test (יצירת בדיקה חדשה).
- ב יצירה Test, אם רוצים, משנים או מגדירים את הערכים ולוחצים על OK.
- בתיבת הדו-שיח בחירת ספריית יעדים, בוחרים איפה בפרויקט רוצים ש-Android Studio יבצע את הבדיקה. אפשר לציין את המיקום לפי של הספרייה או על ידי בחירת מחלקה קרובה.
- לוחצים על OK (אישור).
הבדיקה החדשה תופיע בחלון Project בהתאם מקור הבדיקה שהוגדר.
- כדי להפעיל את הבדיקה, מבצעים את אחת מהפעולות הבאות:
- בחלון Project, לוחצים לחיצה ימנית על הבדיקה ובוחרים הפעלה או ניפוי באגים.
- בעורך הקוד, לוחצים לחיצה ימנית על הגדרת מחלקה או על שם שיטה בקובץ הבדיקה. בוחרים באפשרות הפעלה או ניפוי באגים כדי לבדוק את כל השיטות בכיתה.
- פותחים את הרשימה הנפתחת Select Run/Debug Configuration (בחירת הגדרה של הרצה/ניפוי באגים) שבסרגל הכלים.
- בוחרים באפשרות Save Configuration (שמירת ההגדרות האישיות) מתוך האפשרויות לצד ההגדרה שבחרתם.
שרוצים לשמור.
איור 3. שמירת ההגדרות האישיות
הרצה או ניפוי באגים של אפליקציה באמצעות הגדרה שמורה
אם שמרתם תצורה של הרצה/ניפוי באגים, תוכלו לבחור אותה לפני ההרצה או לנפות באגים באפליקציה.
כדי להשתמש בתצורה שמורה של הרצה או ניפוי באגים, מבצעים את השלבים הבאים:
- בוחרים את הגדרת ההרצה/ניפוי הבאגים בקטע בחירת תצורה של הרצה/ניפוי באגים. בסרגל הכלים.
- בוחרים באפשרות הפעלה > הפעלה או Run > ניפוי באגים.
הרשימה הנפתחת נמצאת משמאל להפעלה
וניפוי באגים.
;
לדוגמה,
.
לחלופין, לוחצים על Run (הפעלה) או
ניפוי באגים
עריכת הגדרות של הרצה או ניפוי באגים
כדי לערוך תצורה של הרצה או ניפוי באגים, מבצעים את השלבים הבאים:
- פתיחת ההרצה/ניפוי הבאגים תיבת דו-שיח להגדרות.
- בוחרים הגדרה בחלונית הימנית.
- משנים את ההגדרות האישיות לפי הצורך.
- לוחצים על אישור או על אישור.
חשוב לתקן את כל השגיאות שמוצגות בחלק התחתון של תיבת הדו-שיח.
עריכת תבנית של הגדרות הרצה/ניפוי באגים
אפשר לערוך את תבניות ההגדרות האישיות שסופקו על ידי Android Studio כך שיתאימו או בלתי מונחית. כשעורכים תבנית, אין לה השפעה על תבניות קיימות בתצורות שמשתמשות בתבנית. לדוגמה, אם אתם צריכים ליצור מספר הגדרות מסוג מסוים, אפשר לערוך את התבנית ואז משנים אותו בחזרה אחרי שמסיימים.
למרות שלא ניתן ליצור תבניות חדשות, אפשר ליצור הגדרות אישיות ולהשתמש בהן בדומה לתבנית. אפשר להעתיק הגדרה אישית ולערוך את העותק כדי ליצור הגדרות חדשות.
כך עורכים תבנית:
- פתיחת ההרצה/ניפוי הבאגים תיבת דו-שיח להגדרות.
- לוחצים על Edit configuration templates... (עריכת תבניות תצורה).
- בוחרים תבנית הגדרות אישיות.
- משנים את ההגדרות האישיות לפי הצורך.
- לוחצים על אישור או על אישור.
חשוב לתקן את כל השגיאות שמוצגות בחלק התחתון של תיבת הדו-שיח.
מיון וקיבוץ מערכי הגדרות אישיות
בתיבת הדו-שיח הגדרות הפעלה/ניפוי באגים, אפשר לסדר את כדי למצוא אותם במהירות. אפשר למיין את הפריטים ליצור תיקיות לפי סדר אלפביתי וליצור תיקיות חדשות לקיבוץ של מערכי הגדרות אישיות.
כדי למיין את ההגדרות לפי סדר אלפביתי, פועלים לפי השלבים הבאים:
- פתיחת ההרצה/ניפוי הבאגים תיבת דו-שיח להגדרות.
- צריך לבחור תיקייה שמכילה הגדרות.
- לוחצים על מיון ההגדרות
.
- לוחצים על OK כדי לסגור את תיבת הדו-שיח.
כדי לקבץ הגדרות אישיות בתיקיות, מבצעים את השלבים הבאים:
- פתיחת ההרצה/ניפוי הבאגים תיבת דו-שיח להגדרות.
- צריך לבחור תיקייה שמכילה הגדרות.
- לוחצים על יצירת תיקייה חדשה.
.
- מקלידים שם בשדה שם התיקייה.
- לוחצים על אישור כדי לשמור את השם.
הגדרה לפני השקה פעולות
אפשר להגדיר משימות לביצוע לפני שמחילים את ההרצה או ניפוי הבאגים הגדרה אישית. המשימות מתבצעות לפי הסדר שבו הן מופיעות ברשימה.
הערה: הגדרה של משימות לפני ההפעלה היא תכונה מתקדמת. במקום
באמצעות התכונה הזאת, מומלץ להשתמש בלוגיקת הכנה כלשהי כמשימות
build.gradle
, כך שהם יופעלו כשמפתחים משורת הפקודה.
כדי ליצור רשימת משימות, מבצעים את השלבים הבאים:
- בחלק התחתון של תיבת הדו-שיח הגדרות הרצה/ניפוי באגים בקטע לפני ההפעלה
(יכול להיות שתצטרכו לגלול למטה),
לוחצים על הוספה
ובוחרים סוג משימה. אם נפתחת תיבת דו-שיח, ממלאים את השדות לוחצים על OK (אישור).
- מוסיפים עוד משימות לפי הצורך.
- כדי לשנות את סדר המשימות, גוררים אותן או בוחרים משימה ולוחצים על למעלה.
ולמטה
כדי להזיז אותו למעלה או למטה ברשימה.
- בוחרים באפשרות הצגת הדף הזה אם רוצים להציג את ההרצה או ניפוי הבאגים.
הגדרות אישיות לפני ההחלה שלהן.
הבחירה באפשרות זו בוטלה על ידי כברירת מחדל.
- בוחרים באפשרות Active Tool window אם רוצים
הפעלה
או
ניפוי באגים
חלון הכלים שיופעל במהלך הרצה של אפליקציה או ניפוי באגים באפליקציה.
האפשרות הזו מסומנת כברירת מחדל.
כדי להסיר משימה מהרשימה, מבצעים את הפעולות הבאות:
- בוחרים משימה.
- לוחצים על הסרה.
.
כך עורכים משימות:
- בוחרים משימה.
- לוחצים על עריכה.
.
- עורכים את הגדרות המשימה בתיבת הדו-שיח שנפתחת ולוחצים על אישור.
בטבלה הבאה מפורטות המשימות הזמינות שאפשר להוסיף.
משימה | תיאור |
---|---|
הפעלת הכלי החיצוני | להפעיל אפליקציה שאינה חלק מ-Android Studio. בחיצוני תיבת הדו-שיח 'כלים', בוחרים אפליקציה אחת או יותר שרוצים להפעיל. ולאחר מכן לוחצים על OK. אם האפליקציה לא מוגדרת ב-Android עדיין, מוסיפים את ההגדרה שלו בקטע יצירה תיבת הדו-שיח 'כלים'. למידע נוסף, ראו הגדרה כלים של צד שלישי וחיצוני כלים. |
הרצה של הגדרות אישיות נוספות | מפעילים אחת מהגדרות ההרצה/ניפוי הבאגים הקיימות. ב בחירת תצורה לביצוע, בחירת הגדרה לוחצים על 'הפעלה' ולוחצים על OK. |
יצרן | עורכים את הפרויקט או את המודול. Android Studio מפעיל את פקודת מודול אם תצורת ההרצה/ניפוי הבאגים מציינת מודול מסוים, או מבצעת את אם לא צוינו מודולים, פקודת הפרויקט. |
יצירת פרויקט | עורכים את הפרויקט. Android Studio מפעיל את פקודה בפרויקט. |
יצירה, ללא בדיקת שגיאות | האפשרות הזו זהה לאפשרות Make, למעט האפשרות הזו ב-Android. אפליקציית Studio מפעילה את הגדרות ההרצה או ניפוי הבאגים ללא קשר להרכבה. תוצאה אחת. |
פיתוח תוצרי הפגישה | התכונה לא נתמכת ב-Android Studio. |
הרצת המשימה של Gradle | מריצים משימת Gradle. בתיבת הדו-שיח שנפתח, מציינים את הפרטים ולוחצים על אישור. לקבלת מידע נוסף, ראו Gradle. |
יצרן מבוסס-Gradle | יוצרים את הפרויקט ומריצים את Gradle. |
ה-builder של App Engine Gradle | המשימה של ה-builder של App Engine Gradle מסנכרנת את הפרויקט ולאחר מכן יוצרת את המודול. |
תבניות הגדרה
ב-Android Studio יש תבניות הגדרה כדי לעזור לך להתחיל במהירות. בקטעים הבאים מתוארות התבניות שחלות על פיתוח של Android עם Android Studio:
- אפליקציה ל-Android
- בדיקות Android
- שרת פיתוח של App Engine
- רכיבים של Wear OS, כרטיס מידע ותצוגת השעון
הערה: ב-Android Studio גרסה 2.1.x ומטה היה מקורי תבנית אפליקציה, שאין בגרסאות חדשות יותר. אם יש לכם תבנית של אפליקציה מותאמת בפרויקט, מערכת Android Studio ממירה אותו ל-Android App כשטוענים את הפרויקט. תיבת הדו-שיח Convert Project מציגה הנחיות לתהליך.
תבניות לא נתמכות
התבניות הבאות שלא נתמכות מגיעות מ-IntelliJ IDEA, והן לא ספציפיות על פיתוח של Android באמצעות Android Studio. לקבלת מידע על השימוש בתבניות האלה, נכנסים לקישורים למסמכי התיעוד של IntelliJ IDEA.
- אפליקציה
- מורכב
- Gradle
- גרוב
- JAR אפליקציה
- Java גירוד
- JUnit
- Kotlin
- סקריפט Kotlin
- ניפוי באגים מרחוק
- סקריפט מעטפת
- TestNG
אפשרויות הגדרה נפוצות
האפשרויות Name, Allow parallel run ו-Store as project, הן נפוצות לכמה תבניות הגדרה. מידע נוסף עליהם זמין במאמר הגדרות נפוצות.
ההגדרות של ההרצה או ניפוי הבאגים המשותפים ב-Android Studio נשמרות ב-XML נפרד.
קבצים בתיקייה project_directory/.idea/runConfigurations/
.
מידע נוסף זמין במאמר הבא:
פורמט מבוסס ספרייה במסמכי התיעוד של הפרויקטים של IntelliJ.
אפליקציה ל-Android
אפשר להריץ או לנפות באגים באפליקציות ובפעילויות ל-Android במכשירים וירטואליים או במכשירים חומרה באמצעות הגדרות אישיות שמבוססות על התבנית הזו.
הכרטיסייה 'כללי'
בכרטיסייה כללי אפשר לציין התקנה, הפעלה, אפשרויות פריסה. הכרטיסייה שונות מכילה גם אפשרויות התקנה.
שדה | תיאור |
---|---|
מודול | בוחרים את מודול כדי להחיל את ההגדרה הזו עליו. |
אפשרויות התקנה: פריסה | בוחרים אפשרות:
|
אפשרויות התקנה: פריסה כאפליקציה ללא התקנה | אם האפליקציה תומכת בחוויות שימוש מיידיות, כלומר מוסיפים תמיכה באפליקציות ללא התקנה כאשר יוצרים פרויקט חדש או כשיוצרים פרויקט או יותר מופעלות באופן מיידי למודולים של תכונות בהתאמה אישית – אפשר לבחור לפרוס את המודולים המופעלים ללא התקנה על ידי סימון שלצד פריסה כאפליקציה ללא התקנה. |
אפשרויות התקנה: תכונות לפריסה |
אם האפליקציה כוללת
מודולים של תכונות,
מסמנים את התיבה לצד כל תכונה שרוצים לכלול בפריסה של האפליקציה. אתם יכולים לראות
את האפשרות הזו רק אם האפליקציה כוללת מודולים של תכונות.
הערה: אם רוצים לבדוק הורדה והתקנה של מודולים של תכונות ב- חובה לעשות זאת אחרי פרסום ה-App Bundle ואז להשתמש ב-Play Console מסלול לבדיקה פנימית. מידע נוסף זמין במאמר הבא: מעלים את ה-App Bundle ל-Play מסוף. |
אפשרויות התקנה: התקנת סימונים | מקלידים את כל אפשרויות adb pm
install שבהן רוצים להשתמש. עיצוב האפשרויות באותו אופן שבו מעצבות
את שורת הפקודה, אבל בלי נתיב. הנה כמה דוגמאות:
וגם
ברירת מחדל: אין אפשרויות. |
אפשרויות הפעלה: השקה | בוחרים אפשרות:
|
אפשרויות הפעלה: הפעלת דגלים | מקלידים את כל אפשרויות adb am
start שבהן רוצים להשתמש. הפורמט של האפשרויות צריך להיות זהה לפורמט
אבל בלי כוונה. לדוגמה:
האפשרות הזו לא תופיע אם בחרתם בערך Launch [הפעלה] של שום דבר. ברירת מחדל: אין אפשרויות. |
אפשרויות יעדי פריסה: יעד | בוחרים אפשרות:
|
אפשרויות יעדי פריסה: שימוש באותו מכשיר בהשקות עתידיות |
כברירת מחדל, האפשרות הזו לא מסומנת, כך שבכל פעם שמפעילים אפליקציה, האפשרות Select (בחירה)
תיבת הדו-שיח Deployment (פריסה) תופיע ותוכלו לבחור את המכשיר. כשבוחרים באפשרות הזו ו
לאחר מכן הריצו אפליקציה, תופיע תיבת הדו-שיח Select Deployment, שבה תוכלו לבחור את המכשיר. לאחר מכן:
בכל פעם שמפעילים את האפליקציה, היא מופעלת במכשיר שבחרת מבלי להציג
תיבת הדו-שיח בחירת פריסה. כדי להפעיל את האפליקציה במכשיר אחר, צריך לבטל את הבחירה באפשרות שימוש
אותו מכשיר בהשקות עתידיות, או מפסיקים את האפליקציה באמצעות הפעלה > עצירת הפעולה של app
או Stop ![]() |
לפני ההשקה | למידע נוסף, ראו הגדרה לפני ההשקה תפעול. |
הכרטיסייה 'שונות'
בכרטיסייה שונות, אפשר לציין Logcat, אפשרויות של התקנה, השקה ופריסה. הכרטיסייה כללי מכילה גם אפשרויות התקנה.
שדה | תיאור |
---|---|
Logcat: הצגת Logcat באופן אוטומטי | כשבוחרים באפשרות הזו, חלון Logcat נפתח בכל פעם לפרוס ולהפעיל אפליקציה בהצלחה באמצעות התצורה הזו. ברירת מחדל: נבחרה. |
Logcat: ניקוי היומן לפני ההשקה | צריך לבחור באפשרות הזו אם רוצים שהמערכת של Android Studio תסיר נתונים מ: מהסשנים הקודמים מקובץ היומן לפני הפעלת האפליקציה. ברירת מחדל: לא מסומנת. |
אפשרויות התקנה: דילוג על ההתקנה אם ה-APK לא השתנה. | לאחר הבחירה באפשרות הזו, מערכת Android Studio לא תפרוס מחדש את ה-APK אם היא תזהה שהוא לא השתנה. אם רוצים ש-Android Studio יאלץ התקנה של ה-APK, גם אם היא לא השתנתה, ולאחר מכן ביטול הבחירה באפשרות הזו. ברירת מחדל: נבחרה |
אפשרויות התקנה: אילוץ הפסקה של הפעלת האפליקציה לפני ההפעלה פעילות | אם האפשרות מופעלת, כשמערכת Android Studio מזהה שהיא לא חייבת להתקין מחדש APK כי הוא לא השתנה, הוא יאלץ עצירה של האפליקציה כך האפליקציה תתחיל מפעילות ברירת המחדל של מרכז האפליקציות. אם לא מבטלים את הבחירה באפשרות הזו, אי אפשר לסגור ידנית את האפליקציה ב-Android Studio. האפשרות הזו פועלת עם האפשרות הקודמת שקובעת אם מותקן או לא מותקן APK. לשתי אפשרויות ההתקנה להשאיר את ערכי ברירת המחדל, אלא אם רוצים לאלץ התקנה באופן מפורש בכל פעם. במקרים מסוימים כדאי לבטל את הבחירה באפשרות הזו. לדוגמה, אם כתיבת מנוע שיטת קלט (IME), עצירת האפליקציה באופן מאולץ תבטל את הבחירה שלו בתור במקלדת הנוכחית, שאולי לא תרצו. ברירת מחדל: נבחרה |
לפני ההשקה | כדאי לעיין בקטע הגדרה לפני פעולות השקה. |
הכרטיסייה 'כלי לניפוי באגים'
מציינים אפשרויות לניפוי באגים בכרטיסייה כלי לניפוי באגים.
אם מדובר בקוד C ו-C++, מערכת Android Studio משתמשת בכלי לניפוי באגים LLDB. בנוסף לתרחיש הרגיל בממשק המשתמש של Android Studio, בחלון של הכלי לניפוי באגים יש כרטיסיית LLDB. מאפשרת להזין פקודות LLDB במהלך ניפוי באגים. אפשר להזין את אותן פקודות ש-Android Studio משתמש בו כדי להציג מידע בממשק המשתמש של הכלי לניפוי באגים, ואפשר לבצע פעולות נוספות.
בפרויקטים C ו-C++ , ניתן להוסיף ספריות סמלים וגם הפעלה של LLDB ופרסם פקודות לצירוף, בכרטיסייה כלי לניפוי באגים. כדי לעשות את זה, לחצנים שדומים לדברים הבאים:
- הוספה של
- הוספת ספרייה או פקודה.
- הסרה של
- בחר ספרייה או פקודה, ולאחר מכן לחץ על לחצן זה כדי להסיר את הפריט.
- עלייה
- יש לבחור ספרייה או פקודה ולאחר מכן ללחוץ על הלחצן הזה כדי להעביר את הפריט כלפי מעלה לרשימה.
- ירידה
- יש לבחור ספרייה או פקודה, ולאחר מכן ללחוץ על הלחצן הזה כדי להעביר את הפריט כלפי מטה לרשימה.
ראו ניפוי באגים באפליקציה מופיע מידע נוסף על ניפוי באגים ב-Android Studio.
שדה | תיאור |
---|---|
סוג ניפוי באגים | בחר באחת מהאפשרויות הבאות:
האפשרות זיהוי אוטומטי מומלצת כי היא בוחרת לסוג ניפוי הבאגים המתאים לפרויקט שלכם. |
ספריות סמלים | אם רוצים להוסיף קובצי סמלים כדי לספק לכלי לניפוי באגים באמצעות C או C++ מידע שנוצר מחוץ ל-Android Studio, אפשר להוסיף אחד או יותר כאן. העדיפות ב-Android Studio היא להשתמש בכל אחד מהקבצים מעל קבצים שנוצרו על ידי ב-Android פלאגין ל-Gradle. הכלי לניפוי באגים מחפש בספריות מלמעלה למטה, לפי הסדר, עד שהוא ימצא את מה שהוא צריך. החיפוש מתבצע באופן רקורסיבי דרך קבצים בספרייה. כדי לבצע אופטימיזציה של הרשימה ולחסוך זמן, מניחים את הספריות בראש הרשימה. אם תציינו ספרייה שנמצאת במיקום גבוה בעץ, ייתכן שייקח זמן רב יותר לחפש בכל את ספריות המשנה. אם מוסיפים ספרייה ספציפית מאוד, לוקח פחות זמן לחפש צריך למצוא את האיזון הנכון בין מהירות לבין איתור הקבצים הדרושים לניפוי באגים. לדוגמה, אם יש לכם ספרייה שמכילה לספריות משנה Android Binary ממשקים (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 לניפוי באגים מרחוק זמין במאמר ניפוי באגים מרחוק. |
לפני ההשקה | למידע נוסף, ראו הגדרה לפני ההשקה תפעול. |
כרטיסייה של יצירת פרופילים
חובה לסמן את האפשרות הפעלת פרופיל מתקדם כדי להפעיל סוגים מסוימים של פרופילים. ב-Android Profiler, כאשר מערכת ההפעלה במכשיר היא Android 7.1 ומטה.
בדיקות Android
תבנית הבדיקה שבה צריך להשתמש תלויה קבוצת מקור. מכשירי Android תבנית הבדיקות היא עבור בדיקה. תבנית ה-JUnit של Android מיועדת לבדיקת יחידה מקומית.
הערה: אם אתם משתמשים ב-Firebase Test Lab כדי לבצע בדיקה במגוון מכשירים, תוכלו להשתמש ב-JUnit של Android להגדרת הבדיקות האינסטרומנטליות. למידע נוסף, ראה הרצת הבדיקות שלך בעזרת Firebase Test Lab.
תיאורי הכרטיסיות הבאים כוללים את הכרטיסיות והשדות בבדיקה של Android Instrument תבנית. למידע על הכרטיסיות והשדות של תבנית הבדיקה של JUnit של Android, אפשר לעיין במאמר הרצה/ניפוי באגים ב-IntelliJ הגדרה: הדף JUnit.
הכרטיסייה 'כללי'
בכרטיסייה כללי אפשר לציין את מיקום הבדיקה, הפעלת אינסטרומנטציה, מעטפת adb ואפשרויות פריסה.
שדה | תיאור |
---|---|
מודול | בחירת מודול כדי להחיל את ההגדרה הזו עליו. |
בדיקה | באזור הזה צריך לציין את המיקום של הבדיקות שרוצים להריץ:
|
הפעלת אינסטרומנטציה ספציפית (אופציונלי) | הקלד את המיקום של האינסטרומנטציה
runner; לוחצים על עוד כדי להשתמש בתיבת דו-שיח.
הקובץ build.gradle מציין את המיקום של ההגדרה
runer; הערך הזה מבטל אותו. ברירת המחדל היא בדרך כלל AndroidJUnitRunner
מ-AndroidX Test.
|
אפשרויות נוספות | מקלידים את כל אפשרויות adb ברירת מחדל: אין אפשרויות |
אפשרויות יעדי פריסה: יעד | בוחרים אפשרות:
|
אפשרויות יעדי פריסה: שימוש באותו מכשיר בהשקות עתידיות | אם ברצונך להשתמש באופן אוטומטי במכשיר שבחרת דרך בתיבת הדו-שיח בחירת יעד פריסה בעתיד, צריך לבחור באפשרות הזו כאפשרות. אם המכשיר לא זמין, תופיע תיבת דו-שיח. ברירת מחדל: הבחירה בוטלה |
לפני ההשקה | למידע נוסף, ראו הגדרה לפני ההשקה תפעול. |
הכרטיסייה 'שונות'
הכרטיסייה שונות מכילה אפשרויות Logcat ואפשרויות התקנה.
שדה | תיאור |
---|---|
Logcat: ניקוי היומן לפני ההשקה | צריך לבחור באפשרות הזו אם רוצים שהמערכת של Android Studio תסיר נתונים מ: מהסשנים הקודמים מקובץ היומן לפני הפעלת האפליקציה. ברירת מחדל: לא מסומנת. |
אפשרויות התקנה: דילוג על ההתקנה אם ה-APK לא השתנה | לאחר הבחירה באפשרות הזו, מערכת Android Studio לא תפרוס מחדש את ה-APK אם היא מזהה שלא משתנה. אם רוצים ש-Android Studio יאלץ התקנה של ה-APK: גם אם הערך לא השתנה, צריך לבטל את הבחירה באפשרות הזו. ברירת מחדל: נבחרה |
אפשרויות התקנה: אילוץ הפסקה של הפעלת האפליקציה לפני ההפעלה פעילות | אם האפשרות מופעלת, כשמערכת Android Studio מזהה שהיא לא חייבת להתקין מחדש APK כי הוא לא השתנה, הוא יאלץ עצירה של האפליקציה כך האפליקציה תתחיל מפעילות ברירת המחדל של מרכז האפליקציות. אם לא מבטלים את הבחירה באפשרות הזו, אי אפשר לסגור ידנית את האפליקציה ב-Android Studio. אפשרות זו פועלת יחד עם האפשרות הקודמת שקובעת אם מותקן או לא מותקן APK. לשתי אפשרויות ההתקנה להשאיר את ערכי ברירת המחדל, אלא אם רוצים לאלץ התקנה באופן מפורש בכל פעם. במקרים מסוימים כדאי לבטל את הבחירה באפשרות הזו. לדוגמה, אם כתיבת מנוע שיטת קלט (IME), עצירת האפליקציה באופן מאולץ תבטל את הבחירה שלו בתור במקלדת הנוכחית, שאולי לא תרצו. ברירת מחדל: נבחרה |
לפני ההשקה | למידע נוסף, ראו הגדרה לפני ההשקה תפעול. |
הכרטיסייה 'כלי לניפוי באגים'
מציינים אפשרויות לניפוי באגים בכרטיסייה כלי לניפוי באגים.
אם מדובר בקוד C ו-C++, מערכת Android Studio משתמשת בכלי לניפוי באגים LLDB. בנוסף לתרחיש הרגיל בממשק המשתמש של Android Studio, בחלון של הכלי לניפוי באגים יש כרטיסיית LLDB. מאפשרת להזין פקודות LLDB במהלך ניפוי באגים. אפשר להזין את אותן פקודות ש-Android Studio משתמש בו כדי להציג מידע בממשק המשתמש של הכלי לניפוי באגים, ואפשר לבצע פעולות נוספות.
בפרויקטים C ו-C++ , ניתן להוסיף ספריות סמלים וגם הפעלה של LLDB ופרסם פקודות לצירוף, בכרטיסייה כלי לניפוי באגים. כדי לעשות את זה, לחצנים שדומים לדברים הבאים:
- הוספה של
- הוספת ספרייה או פקודה.
- הסרה של
- בחר ספרייה או פקודה, ולאחר מכן לחץ על לחצן זה כדי להסיר את הפריט.
- עלייה
- יש לבחור ספרייה או פקודה ולאחר מכן ללחוץ על הלחצן הזה כדי להעביר את הפריט כלפי מעלה לרשימה.
- ירידה
- יש לבחור ספרייה או פקודה, ולאחר מכן ללחוץ על הלחצן הזה כדי להעביר את הפריט כלפי מטה לרשימה.
ראו ניפוי באגים באפליקציה מופיע מידע נוסף על ניפוי באגים ב-Android Studio.
שדה | תיאור |
---|---|
סוג ניפוי באגים | בחר באחת מהאפשרויות הבאות:
האפשרות זיהוי אוטומטי מומלצת כי היא בוחרת לסוג ניפוי הבאגים המתאים לפרויקט שלכם. |
ספריות סמלים | אם רוצים להוסיף קובצי סמלים כדי לספק לכלי לניפוי באגים באמצעות C או C++ מידע שנוצר מחוץ ל-Android Studio, אפשר להוסיף אחד או יותר כאן. העדיפות ב-Android Studio היא להשתמש בכל אחד מהקבצים מעל קבצים שנוצרו על ידי ב-Android פלאגין ל-Gradle. הכלי לניפוי באגים מחפש בספריות מלמעלה למטה, לפי הסדר, עד שהוא ימצא את מה שהוא צריך. החיפוש מתבצע באופן רקורסיבי דרך קבצים בספרייה. כדי לבצע אופטימיזציה של הרשימה ולחסוך זמן, מניחים את הספריות בראש הרשימה. אם תציינו ספרייה שנמצאת במיקום גבוה בעץ, ייתכן שייקח זמן רב יותר לחפש בכל את ספריות המשנה. אם מוסיפים ספרייה ספציפית מאוד, לוקח פחות זמן לחפש צריך למצוא את האיזון הנכון בין מהירות לבין איתור הקבצים הדרושים לניפוי באגים. לדוגמה, אם יש לכם ספרייה שמכילה לספריות משנה Android Binary ממשקים (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 יוצרת DevAppServer של App Engine
עבורך.
שימו לב שאפליקציית IntellJ IDEA התבנית של שרת המנועים היא תבנית אחרת שלא זמינה ב- ב-Android Studio.
שדה | תיאור |
---|---|
מופע יחיד בלבד | אם רוצים לוודא שרק מופע אחד של ההרצה או ניפוי הבאגים ההגדרה האישית מתבצעת כרגע. צריך לבחור באפשרות הזו. אסור מספר הפעלות של אותה הגדרה בו-זמנית. ברירת מחדל: נבחרה |
מודול | בחירת מודול כדי להחיל את ההגדרה הזו עליו. |
סנכרון עם תצורת build.gradle | אם מוסיפים מודול של App Engine ומסנכרנים עם build.gradle
ימולאו שדות התצורה של App Engine DevAppServer (מומלץ).
בחירה באפשרות קובץ > סנכרון בין פרויקט עם Gradle Files מסנכרן גם את הפרויקט. ברירת מחדל: נבחרה
|
SDK של App Engine | הקלד נתיב אל Google App Engine SDK ל-Java במחשב המקומי. לוחצים על ... כדי לבחור באפשרות בתיבת דו-שיח. |
נתיב מלחמה | צריך להקליד נתיב לאפליקציית האינטרנט ספריית ארכיון (WAR) של האפליקציה שאתם פורסים שרת פיתוח מקומי. לוחצים על ... כדי לבחור אותה מתיבת דו-שיח. |
מערכי VM | מציינים את האפשרויות של שורת הפקודה שרוצים להעביר ל-VM להפעלת DevAppServer. כשמציינים את האפשרויות:
מידע נוסף על אפשרויות VM זמין במסמכי התיעוד של ה-J2SE
, כמו
ברירת מחדל: אין אפשרויות |
כתובת השרת | מקלידים את כתובת המארח. לשימוש עבור השרת. ייתכן שנבקש ממך לספק את הכתובת כדי שנוכל לגשת לשרת הפיתוח ממחשב אחר ברשת. כתובת בגרסה 0.0.0.0 מאפשרת גישה למארחים מקומיים וגם גישה לשם מארחים. ברירת מחדל: Localhost |
יציאת שרת | מקלידים את היציאה. המספר שישמש עבור השרת. ברירת מחדל: 8080 |
השבתת הבדיקה אם יש עדכונים ל-App Engine SDK | אם הנתונים יהיו זמינים, שרת הפיתוח לא ליצור קשר עם App Engine כדי לבדוק את הזמינות של גרסה חדשה של SDK. כברירת מחדל, השרת בודק אם יש גרסה חדשה במהלך ההפעלה ומדפיס הודעה אם יש גרסה חדשה. |
לפני ההשקה | למידע נוסף, ראו הגדרה לפני ההשקה תפעול. |
הגדרות הרצה/ניפוי באגים ב-Wear OS
התבניות של התכונות 'רכיבים', 'כרטיסי מידע' ו'תצוגות שעון' מאפשרות להריץ אפליקציות ל-Wear OS או לנפות באגים באפליקציות ל-Wear OS וירטואלי או מכשיר חומרה. רוב אפשרויות ההגדרה של התבנית זהות אפשרויות לאפליקציות ל-Android. האפשרויות הן ספציפיות להגדרות ההרצה/ניפוי הבאגים של Wear OS:
- בכל הגדרות ההרצה או ניפוי הבאגים של Wear, צריך לבחור מקור נתונים ספציפי לרכיבים, הלחצן הראשי או תצוגת השעון (בהתאם לתבנית) שעליהם רוצים להחיל את ההגדרה. בדרך כלל כל אחד הישויות האלה תואמות למחלקה בקוד.
- בתצורה של ההרצה או ניפוי הבאגים של Wear OS, צריך לבחור את ה-Slot שבו רוצים להזין את נתוני הרכיבים הנוספים שסופקו על ידי מקור הנתונים של הרכיבים. אפשר להציב אותו בחלק העליון, הימני, התחתון, השמאלי או הרקע של תצוגת השעון.
- בשביל ההגדרה של הרצה/ניפוי באגים ל-Wear OS, צריך לבחור גם את הסוג של את נתוני הרכיבים שצוינו על ידי מקור הנתונים של הרכיבים. הסוגים שאפשר לבחור מתוכם מוגבלים לאלה שסופקו על ידי מקור הנתונים של הרכיבים שנבחרו וגם נתמכים על ידי למשבצת שנבחרה. רשימה של סוגי נתונים של רכיבים זמינים סוגים ושדות.
לחלופין, אפשר להריץ את הפלטפורמות האלה גם דרך סמל המרזב לצד ההצהרה על פני השטח, כמו שמוצג בתמונה הבאה.
![לחצן הפעלה במרזב לצד מחלקה של WatchFaceService.](https://developer.android.com/static/studio/images/run/wearos_os_gutter_run.png?authuser=9&hl=he)