在 Cloud Code for IntelliJ 中在本地运行和调试 App Engine 标准应用

在将应用部署到 App Engine 之前，您可以在本地运行和调试 App Engine 标准应用。本文档介绍如何从 IntelliJ IDEA 中配置 IDE 以在本地运行和调试应用。

准备工作

在本地运行应用

如果您使用的是 IntelliJ IDEA Ultimate 版，则可以按照以下说明在本地运行 App Engine 应用：

  1. 选择文件 > 打开以打开要运行的项目。

  2. 转到包含项目的目录。

  3. 依次选择工具 > Cloud Code > App Engine 在本地 App Engine 标准开发服务器上运行。

构建项目需要一些时间。

修改运行配置

配置服务器

您可以修改本地服务器的运行配置：

  1. 选择 Run > Edit Configurations。

  2. 在 Run/Debug Configurations 对话框中，根据需要更新配置设置。以下是一些常规设置：

    • 要部署的工件。
    • App Engine 主机。
    • App Engine 端口。

添加环境变量

如果需要，将环境变量添加到配置中。

  1. 选择启动/连接 (Startup/Connection) 标签。

  2. 选择运行。

  3. 选中传递环境变量 (Pass environment variables) 复选框。

  4. 添加必要的变量。

  5. 选择调试。

  6. 选中传递环境变量 (Pass environment variables) 复选框。

  7. 添加必要的变量。

    显示“Run/Debug Configurations”对话框的屏幕截图，其中突出显示本地服务器的环境变量。

  8. 完成后，点击 OK。

停止服务器

要停止开发应用服务器，请选择运行 > 停止“Google App Engine 标准本地服务器”(Stop 'Google App Engine Standard Local Server')。

调试应用

您可以使用先前创建的运行配置在调试模式下运行应用，如下所示：

  1. 选择运行 > 调试。

  2. 在对话框中，点击 Google App Engine 标准本地服务器 (Google App Engine Standard Local Server)。

  3. 项目构建完成后，您可以设置断点来调试应用。

在 Community 版中本地调试应用

如果运行基于 Java servlet 的本地应用，IntelliJ Community 版不提供内置支持。如需使用 IntelliJ Community 版在本地调试应用，请将项目配置为使用 Maven 或 Gradle 插件。

Maven

使用 Maven 插件配置项目

  1. 将 App Engine Maven 插件添加到项目的 pom.xml 文件中。

  2. 在开发服务器上配置调试。

  3. 为 Maven 创建运行/调试配置。

    显示“Run/Debug Configurations”对话框的屏幕截图。

    1. 选择 Run > Edit Configurations。

    2. 点击 + Add New Configuration 图标。

    3. 选择 Maven。

    4. 在 Command line 字段中，输入 appengine:run。

    5. 点击 OK。

  4. 创建远程调试配置。

    显示“Run/Debug Configurations”对话框的屏幕截图。

    1. 选择 Run > Edit Configurations。

    2. 点击 + Add New Configuration 图标。

    3. 选择远程 (Remote)。

    4. 确保端口号与您在 Maven App Engine 插件配置中配置的端口号相同。默认端口为 5005。

    5. 在 Before launch 部分中，点击 + Add。

    6. 选择运行另一个配置 (Run Another Configuration)。

    7. 选择 Maven 项目的运行配置。

    8. 点击确定。

  5. 要在本地调试应用，请执行以下操作：

    1. 选择运行 > 调试。

    2. 选择您的远程调试配置。

      显示“Run/Debug Configurations”对话框的屏幕截图。

      您现在可以在本地调试应用。

Gradle

使用 Gradle 插件配置项目

  1. 创建一个新的 Gradle 项目。

  2. 在开发服务器上配置调试。

  3. 为 Gradle 创建运行/调试配置。

    显示“Run/Debug Configurations”对话框的屏幕截图。

    1. 选择 Run > Edit Configurations。

    2. 点击 + Add New Configuration 图标。

    3. 选择 Gradle。

    4. 在 Gradle project 字段中，选择您在其中配置了 appengine-gradle-plugin 插件的模块。

    5. 在 Tasks 字段中，输入 appengineRun。

    6. 点击 OK。

  4. 创建远程调试配置。

    显示调试配置对话框的屏幕截图。

    1. 选择 Run > Edit Configurations。

    2. 点击 + Add New Configuration 图标。

    3. 选择远程 (Remote)。

    4. 确保端口号与您在 Gradle App Engine 插件配置中配置的端口号相同。默认端口为 5005。

    5. 在 Before launch 部分中，点击 + Add。

    6. 选择运行另一个配置 (Run Another Configuration)。

    7. 选择 Gradle 项目的运行配置。

    8. 点击 OK。

  5. 要在本地调试应用，请执行以下操作：

    1. 选择运行 > 调试。

    2. 选择您的远程调试配置。

      显示调试配置对话框的屏幕截图。

      您现在可以在本地调试应用。

    3. 如果控制台日志中显示 Attach Debugger 链接，请点击该链接。

后续步骤

获取支持

如需在 IntelliJ IDE 中提交反馈或报告问题，请依次前往工具 > Cloud Code > 帮助 / 简介 > 提交反馈或报告问题，以便在 GitHub 上报告问题。