מעבר ל-Cloud Code ל-IntelliJ

במאמר הזה מוסבר איך להעביר פרויקט App Engine מבוסס-IntelliJ ל-Cloud Code ל-IntelliJ.

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

  • אם הפרויקט שלכם מבוסס על Maven או Gradle ומשתמש בתוספים ישנים יותר של App Engine SDK (לדוגמה, com.google.appengine.appengine-maven-plugin ו-com.google.appengine:gradle-appengine-plugin), אתם צריכים קודם לעבור לתוספים החדשים של Maven ו-Gradle שמבוססים על ה-CLI של gcloud.

  • הפלאגין החדש לא תומך בשיפור של Datanucleus. אם אתם מסתמכים על התכונה הזו, תצטרכו להגדיר ידנית את שיפור Datanucleus ‏(JDO,‏ JPA) בפרויקט כדי להעביר אותו אל Cloud Code. כדאי להשתמש ב-Objectify כשכבת ORM כשקוראים מ-Datastore או כותבים ל-Datastore.

התקנת הפלאגין החדש

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

  • מוודאים שיש במחשב את גרסת ה-IDE הנתמכת, JetBrains IDE גרסה 2022.3 ואילך (כמו IntelliJ Ultimate/Community,‏ PyCharm Professional/Community,‏ WebStorm,‏ GoLand).PATH
  • פותחים את IntelliJ IDEA (או כל סביבת פיתוח משולבת (IDE) נתמכת של JetBrains).
  • פותחים את חלון חנות הפלאגינים באמצעות קובץ > הגדרות > פלאגינים. ב-Mac OS X, משתמשים באפשרות IntelliJ IDEA > Preferences > Plugins.

  • מחפשים את הפלאגין Cloud Code ומתקינים אותו.

    יכול להיות שתתבקשו להפעיל מחדש את סביבת הפיתוח המשולבת כדי להפעיל את הפלאגין.

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

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

  1. כשמקבלים הודעה שהתוסף החדש מתנגש עם השילוב הקיים של App Engine, לוחצים על הקישור בהודעה.

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

  2. בהנחיה הבאה להשבתת הפלאגין, בוחרים באפשרות 'השבתה והפעלה מחדש' כדי להשבית את הפלאגין App Engine ולהפעיל מחדש את סביבת הפיתוח המשולבת (IDE) כדי שהשינויים בהגדרת הפלאגין ייכנסו לתוקף.

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

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

  4. צריך למחוק את השרתים הקיימים של App Engine ואת המכונות של Cloud, וליצור אותם מחדש באמצעות ה-CLI החדש של gcloud.

    1. עוברים אל הגדרות > Build, Execution, Deployment > Application Servers.

    2. בוחרים את המופעים של App Engine Dev ולוחצים על מחיקה (-).

    3. לוחצים על הוספה (+) ובוחרים באפשרות Google App Engine Dev Server.

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

    4. עוברים אל הגדרות > Build, Execution, Deployment > Clouds.

    5. בוחרים את מופעי הענן של Google App Engine ולוחצים על מחיקה (-).

    6. לוחצים על הוספה (+) כדי להגדיר יעד לפריסה בענן של App Engine.

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

  5. אם יש לכם הגדרות הפעלה של שרת מקומי של App Engine, אתם צריכים לעדכן אותן כדי להשתמש בשרת האפליקציות שהגדרתם.

  6. כדי לראות את רשימת הפעולות שזמינות לכם להרצה ולפריסה של האפליקציה, עוברים אל כלים > Cloud Code > App Engine. אפשר גם לעיין במסמכי התיעוד לקבלת מידע נוסף.

  7. בפרויקטים שמבוססים על Maven או Gradle, צריך לוודא שאתם משתמשים בגרסה העדכנית של התוספים Gradle ו-Maven App Engine.

הגדרת פרויקטים ספציפיים ל-IntelliJ

לפרויקטים ספציפיים ל-IntelliJ בלבד (כלומר, פרויקטים שהגדרות הפרויקט שלהם הוגדרו ידנית באמצעות היבט App Engine הישן ולא מסונכרנים מ-Gradle או מ-Maven), צריך לעדכן את התלות ב-App Engine.

יחסי התלות של App Engine עדיין מוגדרים כ-External Libraries (ספריות חיצוניות) ומסופקים על ידי ההתקנה הישנה של App Engine SDK. אם תמחקו את ההתקנה של App EngineSDK, לא תהיה אפשרות לקמפל את האפליקציה.

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

כדי להסיר את התלות הזו ב-App Engine SDK הישן, צריך להגדיר את התלויות ב-App Engine API באמצעות התכונה לייבוא ספריות של App Engine Facet, באופן הבא:

  1. משתמשים בתכונת השיפור Datanucleus JDO/JPA של הפלאגין הישן צריכים להעביר את האפליקציות שלהם ל-Maven או ל-Gradle, כי שיפור Datanucleus לא נתמך בפלאגין Cloud Code.

  2. בממשק המשתמש של Project Structure (מבנה הפרויקט) ב-IntelliJ, עוברים לכרטיסייה dependencies (יחסי תלות) של מודול App Engine Standard.

  3. מסירים את כל הספריות שקשורות ל-App Engine.

    צילום מסך שבו מוצגת רשימה של ספריות חיצוניות וסמלים למחיקה שלהן.

  4. באותו ממשק משתמש של Project Structure (מבנה הפרויקט), עוברים אל Google App Engine facet (היבט) של מודול App Engine.

  5. בחלונית Libraries, בוחרים את יחסי התלות של App Engine שבהם אתם משתמשים.

    צילום מסך שמציג רשימה של ספריות שזמינות לבחירה.

    הפעולה הזו תאחזר באופן אוטומטי את יחסי התלות האלה מ-Maven Central ותוסיף אותם לנתיב המחלקות של המודול.

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

  7. בשלב הזה, אפשר למחוק בבטחה את App Engine SDK הישן.

פנייה לתמיכה

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