הפעלה וניפוי באגים של אפליקציית App Engine Standard באופן מקומי ב-Cloud Code ל-IntelliJ

שימו לב: החל מ-31 בינואר 2024, התמיכה ב-Java 8 ב-App Engine הסתיימה, והיא תצא משימוש ב-31 בינואר 2026. כתוצאה מכך, Cloud Code משבית את App Engine כברירת מחדל. כדי להפעיל את App Engine בסביבת הפיתוח המשולבת, עוברים אל הגדרות > Google Cloud Code > App Engine. מידע נוסף על לוח הזמנים של התמיכה בסביבת זמן הריצה של App Engine זמין במאמר לוח הזמנים של התמיכה בסביבת זמן הריצה.

לפני שפורסים את האפליקציה ב-App Engine, אפשר להריץ ולנפות באגים באפליקציה הרגילה של App Engine באופן מקומי. במאמר הזה מוסבר איך להגדיר את סביבת הפיתוח המשולבת (IDE) להרצה ולניפוי באגים מקומיים מתוך IntelliJ IDEA.

הערה: סביבות הפיתוח המשולבות (IDE) הבאות תומכות בתכונה הזו:

• ‫IntelliJ IDEA - Ultimate
• ‫IntelliJ IDEA – Community

הערה: בסביבה הרגילה של App Engine, רק אפליקציות Java שמשתמשות בזמן ריצה של Java 8 נתמכות ב-Cloud Code.

לפני שמתחילים

• מוודאים שהאפליקציה היא פרויקט רגיל של App Engine שמכיל קובץ appengine-web.xml

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

הערה: הגדרות הפעלה להפעלה ולניפוי באגים מקומיים זמינות רק ב-IntelliJ Ultimate Edition. אם אתם משתמשים ב-Community Edition, תוכלו לפעול לפי ההוראות בנושא ניפוי באגים באפליקציה באופן מקומי ב-Community Edition כדי להשתמש בתוספים של Maven או Gradle להרצה מקומית.

הרצת האפליקציה באופן מקומי

אם אתם משתמשים ב-IntelliJ IDEA Ultimate Edition, אתם יכולים להריץ אפליקציית App Engine באופן מקומי לפי ההוראות הבאות:

1. בוחרים באפשרות קובץ > פתיחה כדי לפתוח את הפרויקט שרוצים להריץ.

2. עוברים לספרייה שמכילה את הפרויקט.

3. בוחרים באפשרות Tools > Cloud Code > App Engine Run on a local App Engine Standard dev server.

תהליך הבנייה של הפרויקט יימשך כמה רגעים.

עריכת הגדרות ההרצה

הגדרת השרת

אפשר לערוך את הגדרות ההרצה של השרת המקומי:

1. בוחרים באפשרות הפעלה > עריכת הגדרות.

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

   • פריט מידע שנוצר בתהליך פיתוח (Artifact) לפריסה.
   • מארח App Engine.
   • App Engine Port.

הוספת משתני סביבה

אם צריך, מוסיפים משתני סביבה להגדרות.

1. בוחרים בכרטיסייה הפעלה/חיבור.

2. לוחצים על הפעלה.

3. מסמנים את תיבת הסימון העברת משתני סביבה.

4. מוסיפים את המשתנים הנדרשים.

5. בוחרים באפשרות ניפוי באגים.

6. מסמנים את תיבת הסימון העברת משתני סביבה.

7. מוסיפים את המשתנים הנדרשים.

   

8. בסיום, לוחצים על אישור.

הפסקת השרת

כדי להפסיק את שרת האפליקציה לפיתוח, בוחרים באפשרות Run ‏ > Stop 'Google App Engine Standard Local Server'.

ניפוי באגים באפליקציה

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

1. בוחרים באפשרות הפעלה > ניפוי באגים.

2. בתיבת הדו-שיח, לוחצים על Google App Engine Standard Local Server (שרת מקומי של Google App Engine Standard).

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

ניפוי באגים באפליקציה באופן מקומי ב-Community Edition

מהדורת הקהילה של IntelliJ לא מספקת תמיכה מובנית בהרצת אפליקציות מקומיות שמבוססות על Java servlet. כדי לנפות באגים באפליקציה באופן מקומי באמצעות IntelliJ Community Edition, צריך להגדיר את הפרויקט לשימוש בפלאגין Maven או Gradle.

Maven

הגדרת הפרויקט באמצעות Maven Plugin

1. מוסיפים את התוסף App Engine Maven לקובץ pom.xml של הפרויקט.

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

3. יצירת הגדרת הרצה/ניפוי באגים עבור Maven.

   

   1. בוחרים באפשרות הפעלה > עריכת הגדרות.

   2. לוחצים על + הוספת הגדרה חדשה.

   3. בוחרים באפשרות Maven.

   4. בשדה Command line (שורת פקודה), מזינים appengine:run.

   5. לוחצים על OK.

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

   

   1. בוחרים באפשרות הפעלה > עריכת הגדרות.

   2. לוחצים על + הוספת הגדרה חדשה.

   3. בוחרים באפשרות שלט רחוק.

   4. מוודאים שמספר היציאה זהה ליציאה שהגדרתם בהגדרות של Maven App Engine Plugin. יציאה 5005 היא ברירת המחדל.

   5. בקטע לפני ההשקה, לוחצים על + הוספה.

   6. לוחצים על Run Another Configuration (הפעלת הגדרה נוספת).

   7. בוחרים את הגדרת ההרצה של פרויקט Maven.

   8. לוחצים על OK.

5. כדי לנפות באגים באפליקציה באופן מקומי:

   1. בוחרים באפשרות הפעלה > ניפוי באגים.

   2. בוחרים את הגדרת הניפוי באגים מרחוק.

      

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

Gradle

הגדרת הפרויקט באמצעות פלאגין Gradle

1. יוצרים פרויקט חדש ב-Gradle.

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

3. יוצרים הגדרת הרצה/ניפוי באגים ל-Gradle.

   

   1. בוחרים באפשרות הפעלה > עריכת הגדרות.

   2. לוחצים על + הוספת הגדרה חדשה.

   3. בוחרים באפשרות Gradle.

   4. בשדה Gradle project, בוחרים את המודול שבו הגדרתם את התוסף appengine-gradle-plugin.

   5. בשדה Tasks (משימות), מזינים appengineRun.

   6. לוחצים על OK.

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

   

   1. בוחרים באפשרות הפעלה > עריכת הגדרות.

   2. לוחצים על + הוספת הגדרה חדשה.

   3. בוחרים באפשרות שלט רחוק.

   4. מוודאים שמספר היציאה זהה ליציאה שהגדרתם בהגדרות של תוסף Gradle App Engine. יציאה 5005 היא ברירת המחדל.

   5. בקטע לפני ההשקה, לוחצים על + הוספה.

   6. לוחצים על Run Another Configuration (הפעלת הגדרה נוספת).

   7. בוחרים את הגדרת ההרצה של פרויקט Gradle.

   8. לוחצים על OK.

5. כדי לנפות באגים באפליקציה באופן מקומי:

   1. בוחרים באפשרות הפעלה > ניפוי באגים.

   2. בוחרים את הגדרת הניפוי באגים מרחוק.

      

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

   3. אם הקישור Attach Debugger מופיע ביומן המסוף, לוחצים על הקישור.

      הערה: אם היציאה שבחרתם חסומה, צריך להגדיר מספר יציאה אחר (לדוגמה, 5009) בהגדרות של התוסף Gradle App Engine, ולעדכן את מספר היציאה בהגדרות המרוחקות לאותו מספר יציאה.

המאמרים הבאים

• לאחר מכן, אפשר לפרוס את האפליקציה בסביבה הרגילה של App Engine.

פנייה לתמיכה

כדי לשלוח משוב או לדווח על בעיה ב-IntelliJ IDE, עוברים אל Tools (כלים) > Cloud Code > Help / About (עזרה / מידע) > Submit feedback or report an issue (שליחת משוב או דיווח על בעיה) כדי לדווח על בעיה ב-GitHub.