在 Cloud Code for IntelliJ 中，在本機上執行 App Engine 標準應用程式並進行偵錯

將應用程式部署到 App Engine 之前，您可以在本機執行 App Engine 標準應用程式並進行偵錯。本文說明如何設定 IDE 以供在 IntelliJ IDEA 中本機執行和偵錯。

事前準備

在本機執行您的應用程式

如果您使用的是 IntelliJ IDEA Ultimate 版，可以按照下列操作說明，在本機上執行 App Engine 應用程式：

  1. 依序選取 [File] > [Open] 以開啟您要執行的專案。

  2. 瀏覽至包含您專案的目錄。

  3. 依序選取「Tools」>「Cloud Code」>「App Engine」>「Run on a local App Engine Standard dev server」。

專案建構作業需要一些時間才能完成。

編輯執行設定

設定伺服器

您可以編輯本機伺服器的執行設定：

  1. 依序選取 [Run] > [Edit Configurations]。

  2. 在「Run/Debug Configurations」對話方塊中，視需要更新設定。常見的設定包括：

    • 要部署的成果。
    • App Engine 主機。
    • App Engine 通訊埠。

新增環境變數

視需要將環境變數新增至您的設定中。

  1. 選取 [Startup/Connection] 分頁標籤。

  2. 選取 [Run]。

  3. 選取 [Pass environment variables] 核取方塊。

  4. 新增需要的變數。

  5. 選取 [Debug]。

  6. 選取 [Pass environment variables] 核取方塊。

  7. 新增需要的變數。

    顯示執行/偵錯設定對話方塊的螢幕擷取畫面，焦點位於本機伺服器的環境變數

  8. 完成時，請按一下 [OK]。

停止伺服器

如要停止開發應用程式伺服器，請依序選擇 [Run] > [Stop 'Google App Engine Standard Local Server']。

對應用程式進行偵錯

您可以按照下列步驟，使用之前建立的執行設定在偵錯模式中執行應用程式：

  1. 依序選取 [Run] > [Debug]。

  2. 在對話方塊中，按一下 [Google App Engine Standard Local Server]。

  3. 建立專案之後，您可以設定中斷點來對應用程式進行偵錯。

使用 Community 版本在本機對應用程式進行偵錯

IntelliJ Community 版本沒有內建支援，無法執行本機以 Java Servlet 為基礎的應用程式。如要使用 IntelliJ Community 版本在本機對應用程式進行偵錯，請將您的專案設定為使用 Maven 或 Gradle 外掛程式。

Maven

使用 Maven 外掛程式設定您的專案

  1. 將 App Engine Maven 外掛程式新增至專案的 pom.xml 檔案。

  2. 在開發伺服器上設定偵錯。

  3. 為 Maven 建立執行/偵錯設定。

    顯示 [Run/Debug Configurations] 對話方塊的螢幕擷取畫面。

    1. 依序選取 [Run] > [Edit Configurations]。

    2. 按一下「+ 新增設定」。

    3. 選取 [Maven]。

    4. 在「Command line」欄位中輸入 appengine:run。

    5. 按一下 [確定]。

  4. 建立遠端偵錯設定。

    顯示「Run/Debug Configurations」對話方塊的螢幕截圖。

    1. 依序選取 [Run] > [Edit Configurations]。

    2. 按一下「+ 新增設定」。

    3. 選取 [Remote]。

    4. 確認通訊埠編號與您在 Maven App Engine 外掛程式設定中設定的通訊埠編號相同。預設值為通訊埠 5005。

    5. 在「Before launch」部分中，按一下「+ 新增」。

    6. 選取 [Run Another Configuration]。

    7. 為 Maven 專案選取執行設定。

    8. 按一下 [OK]。

  5. 如何在本機上對應用程式進行偵錯：

    1. 依序選取 [Run] > [Debug]。

    2. 選取遠端偵錯設定。

      顯示「Run/Debug Configurations」對話方塊的螢幕截圖。

      您現在可以在本機上對應用程式進行偵錯了。

Gradle

使用 Gradle 外掛程式設定您的專案

  1. 建立新的 Gradle 專案。

  2. 在開發伺服器上設定偵錯。

  3. 為 Gradle 建立執行/偵錯設定。

    顯示 [Run/Debug Configurations] 對話方塊的螢幕擷取畫面。

    1. 依序選取 [Run] > [Edit Configurations]。

    2. 按一下「+ 新增設定」。

    3. 選取 [Gradle]。

    4. 在「Gradle project」欄位中，選取您設定 appengine-gradle-plugin 外掛程式的模組。

    5. 在「Tasks」欄位中輸入 appengineRun。

    6. 按一下 [確定]。

  4. 建立遠端偵錯設定。

    顯示「Debug Configurations」對話方塊的螢幕截圖。

    1. 依序選取 [Run] > [Edit Configurations]。

    2. 按一下「+ 新增設定」。

    3. 選取 [Remote]。

    4. 確認通訊埠編號與您在 Gradle App Engine 外掛程式設定中設定的通訊埠編號相同。預設值為通訊埠「5005」。

    5. 在「Before launch」部分中，按一下「+ 新增」。

    6. 選取 [Run Another Configuration]。

    7. 為 Gradle 專案選取執行設定。

    8. 按一下 [確定]。

  5. 如何在本機上對應用程式進行偵錯：

    1. 依序選取 [Run] > [Debug]。

    2. 選取遠端偵錯設定。

      顯示「Debug Configurations」對話方塊的螢幕截圖。

      您現在可以在本機上對應用程式進行偵錯了。

    3. 如果控制台記錄中顯示「Attach Debugger」連結，請按一下該連結。

後續步驟

取得支援

如要在 IntelliJ IDE 中提交意見回饋或回報問題，請依序前往「Tools」 >「Cloud Code」 >「Help / About」 >「Submit feedback or report an issue」，即可在 GitHub 上回報問題。