入门
注意: 从 GWT 2.11.0 开始,webAppCreator 已被弃用,请参阅 新的说明。
先决条件
- 您将需要 Java SDK 版本 1.8 或更高版本。如有必要,请从 Oracle 下载并安装 Java SE Development Kit (JDK) from Oracle 或者从 Adopt OpenJDK from Adopt OpenJDK 为您的平台安装。
- 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 的开发模式服务器,一个用于开发和调试的本地服务器,如下所示
通过 1) 点击“启动默认浏览器”或 2) 点击“复制到剪贴板”(复制其 URL),然后粘贴到 Firefox、Internet Explorer、Chrome 或 Safari 中,在浏览器中启动本地服务器。
启动应用程序将在超级开发模式下加载,如下所示
进行一些更改
启动应用程序的源代码位于 MyWebApp/src/
子目录中,其中 MyWebApp 是您在上面赋予该项目的名称。您将看到两个包,com.mycompany.mywebapp.client
和 com.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
如果您打算继续使用命令行,请查看 Speed Tracer,然后转到 构建一个示例 GWT 应用程序。