入门

注意: 从 GWT 2.11.0 开始,webAppCreator 已被弃用,请参阅 新的说明

先决条件

  1. 您将需要 Java SDK 版本 1.8 或更高版本。如有必要,请从 Oracle 下载并安装 Java SE Development Kit (JDK) from Oracle 或者从 Adopt OpenJDK from Adopt OpenJDK 为您的平台安装。
  2. Apache Ant 也用于在此示例中运行命令行参数。如果您还没有它,请安装 Apache Ant

如果您在 Mac 上运行 Ant 时遇到问题,请尝试使用 export JDK_HOME=“/Library/Java/Home” 设置 $JDK_HOME 环境变量

下载并安装 GWT SDK

下载 并解压缩 GWT SDK。它包含编写 Web 应用程序所需的核心库、编译器和开发服务器。

有关系统和浏览器要求,请参阅 FAQ

在 Windows 上,从压缩文件夹 gwt-2.10.0.zip 中解压缩文件。在 Mac 或 Linux 上,您可以使用类似于以下命令的命令解压缩该包

unzip gwt-2.10.0.zip

GWT SDK 没有安装程序应用程序。您运行和使用 SDK 所需的所有文件都位于解压缩的目录中。

创建您的第一个 Web 应用程序

GWT 附带一个名为 webAppCreator 的命令行实用程序,它会自动生成开始 GWT 项目所需的所有文件。它还会生成 Eclipse 项目文件和启动配置,以便在 GWT 的开发模式下轻松调试。

您可以通过运行 webAppCreator 在新的 MyWebApp 目录中创建一个新的演示应用程序

  • Windows
cd gwt-2.10.0

webAppCreator -out MyWebApp com.mycompany.mywebapp.MyWebApp
  • Mac 或 Linux - 您可能需要使脚本可执行
cd gwt-2.10.0

chmod u+x webAppCreator

./webAppCreator -out MyWebApp com.mycompany.mywebapp.MyWebApp

webAppCreator 脚本将在 MyWebApp/ 中生成许多文件,包括类 MyWebApp/src/com/mycompany/mywebapp/client/MyWebApp.java 中的一些基本的“Hello, world”功能。该脚本还会生成 Ant 构建脚本 MyWebApp/build.xml

在开发模式下本地运行

要在开发模式下运行新创建的应用程序,请执行以下操作

cd MyWebApp/

ant devmode

此命令将启动 GWT 的开发模式服务器,一个用于开发和调试的本地服务器,如下所示

Screenshot

通过 1) 点击“启动默认浏览器”或 2) 点击“复制到剪贴板”(复制其 URL),然后粘贴到 Firefox、Internet Explorer、Chrome 或 Safari 中,在浏览器中启动本地服务器。

启动应用程序将在超级开发模式下加载,如下所示

Screenshot

进行一些更改

启动应用程序的源代码位于 MyWebApp/src/ 子目录中,其中 MyWebApp 是您在上面赋予该项目的名称。您将看到两个包,com.mycompany.mywebapp.clientcom.mycompany.mywebapp.server。客户端包中的代码最终将被编译为 JavaScript 并作为客户端代码在浏览器中运行。服务器包中的 java 文件将在服务器上作为 Java 字节码运行,在本快速入门中是在 App Engine 服务器上。

查看 com/mycompany/mywebapp/client/MyWebApp.java。第 41 行构建了“发送”按钮。

final Button sendButton = new Button("Send");

将文本从“发送”更改为“发送到服务器”。

final Button sendButton = new Button("Send to Server");

现在,保存文件,只需点击浏览器中的“刷新”即可查看您的更改。该按钮现在将显示“发送到服务器”而不是“发送”。

编译并在生产模式下运行

要以 GWT 所谓的“生产模式”以 JavaScript 形式运行该应用程序,请通过执行以下命令编译该应用程序

ant build

“build” Ant 目标将调用 GWT 编译器,该编译器从 MyWebApp/war/ 子目录中的 MyWebApp Java 源代码生成许多 JavaScript 和 HTML 文件。要查看该应用程序,请在您的 Web 浏览器中打开文件 MyWebApp/war/MyWebApp.html。该应用程序应该看起来与上面的开发模式完全相同。

恭喜!您已使用 GWT 创建了第一个 Web 应用程序。由于您已编译了该项目,因此您现在正在运行纯 JavaScript 和 HTML,它可以在 IE、Chrome、Firefox、Safari 和 Opera 中使用。现在,您可以通过从您的 Web 服务器提供 MyWebApp/war/ 目录中的 HTML 和 JavaScript 文件来将您的应用程序部署到生产环境。

设置 IDE

既然您已经创建了第一个应用程序,您可能想要做一些更有趣的事情。但首先,如果您通常使用 IDE,您将需要设置 Eclipse 以使用 GWT SDK

设置 Eclipse

如果您打算继续使用命令行,请查看 Speed Tracer,然后转到 构建一个示例 GWT 应用程序