使用入门 - 快速入门

• 安装 Google 网页工具包
• 构建示例应用程序
• 从头开始创建应用程序（不使用 Eclipse）
• 从头开始创建应用程序（使用 Eclipse）

安装 Google 网页工具包

使用 Eclipse 进行安装

如果您使用 Eclipse IDE，则可以使用 Eclipse Google 插件安装 Google 网页工具包。重新启动 Eclipse 后，便可以创建新的 GWT 应用程序了。

不使用 Eclipse 进行安装

1. 如果您还没有 Java SDK，可以安装 Java SDK。

Mac 用户注意事项：GWT 托管模式使用 32 位 SWT 绑定，并且需要 32 位 JVM。不过，用于 Mac 的 Java 6 使用 64 位 JVM。要使用 GWT 托管模式，您需要继续使用 Java 5。在本常见问题解答中，您可以进一步了解 32 位要求。

2. 如果您还没有 Apache Ant，可以下载 Apache Ant 并解压。
3. 下载 Google 网页工具包并解压。
   在 Windows 上，可以从压缩文件夹 gwt-windows-1.6.4.zip 中解压出这些文件（或使用 WinZip 之类的程序解压出这些文件）。在 Mac 或 Linux 上，您可以使用类似于以下所示的命令来解压包：

   tar zxvf gwt-mac-1.6.4.tar.gz

GWT 没有安装程序应用程序，运行和使用 GWT 所需的所有文件都位于解压的目录中。使用 GWT 所需的主要应用程序是 webAppCreator，我们将会在下文中进行介绍。先构建 GWT 随附的一个示例应用程序，学习起来可能会更容易。

构建示例应用程序

所有示例应用程序均位于 GWT 包中的 samples/ 目录中。每个示例都有一个 Ant 构建脚本 build.xml，您可以在托管模式下启动该脚本，也可以将其编译为 JavaScript 和 HTML 以在网页模式下运行。

在托管模式下运行

要在托管模式下运行 Mail 示例，请导航至 samples/Mail/ 目录并执行以下命令：

ant hosted

该命令会执行 samples/Mail/build.xml 中“hosted”Ant 目标，这样会打开 GWT 浏览器且在浏览器内部运行 Mail 应用程序：



由于您是在托管模式下运行，因此应用程序会在 Java 虚拟机 (JVM) 中运行。这是调试应用程序时通常使用的模式。

在网页模式下运行

要在网页模式下运行应用程序，请执行以下命令编译应用程序：

ant build

Ant 的执行目标“build”会调用 GWT 编译器，GWT 编译器根据 samples/Mail/war/ 子目录中的 Mail Java 源代码生成若干 JavaScript 和 HTML 文件。要查看该应用程序，请在您喜欢的网页浏览器中打开 samples/Mail/war/Mail.html 文件。



由于您已编译该项目，因此现在运行的是真正的 JavaScript 和 HTML，它们在 IE、Firefox、Safari 或 Opera 中都可以运行。如果您要将 Mail 示例项目部署到实际应用中，则应将 samples/Mail/war/ 目录中的文件分发到网页服务器上。

进行少许更改

Mail 的源代码位于 samples/Mail/src/ 子目录中。请关闭浏览器窗口，然后在文本编辑器中打开 samples/Mail/src/com/google/gwt/sample/mail/client/Shortcuts.java 文件。该文件的第 54 行是构建“Mail”标签的代码。

add(images, new Mailboxes(images), images.mailgroup(), "Mail");

将最后的参数 "Mail" 更改为 "My Mail"：

add(images, new Mailboxes(images), images.mailgroup(), "My Mail");

现在，保存文件并在托管模式应用程序中点击“刷新”便可看到刚才所做的更改了。如果您先前已关闭了托管模式，请重新运行 ant hosted 进入该模式。第一个标签现在应该已变为“My Mail”，而不再是“Mail”了。



从头开始创建应用程序（不使用 Eclipse）

GWT 附带了一个命令行实用工具，名为 webAppCreator。该实用工具可以自动生成启动 GWT 项目所需的所有文件，还可以生成 Eclipse 项目文件和启动配置文件，便于在托管模式下调试，具体情况如下所述。

您可以使用以下命令创建新的应用程序 MyApplication：

webAppCreator -out MyApplication com.mycompany.MyApplication

webAppCreator 脚本会在 MyApplication/ 中生成若干文件，包括 MyApplication/src/com/mycompany/client/MyApplication.java 类中的某些“Hello, world”基本功能。该脚本还会生成 Ant 构建脚本 MyApplication/build.xml，就像上述示例应用程序一样。

要在托管模式下运行新建的应用程序，请转到 MyApplication/ 目录并执行以下命令：

ant hosted



请尝试编辑 MyApplication/src/com/mycompany/client/MyApplication.java 和 MyApplication/war/MyApplication.html 文件，看看它们使应用程序发生哪些变化。

从头开始创建应用程序（使用 Eclipse）

使用插件

Eclipse Google 插件包含用于创建 GWT 应用程序的向导。安装该插件并重新启动 Eclipse 后，请执行以下创建启动程序应用程序的步骤。

1. 在工具栏中，点击“新建网络应用程序项目”按钮。
2. 填写项目详细信息：
   1. 输入项目名称“MyApplication”。
   2. 输入包“com.mycompany”。
   3. 确保已选中“Use Google Web Toolkit”且选择了“Use default SDK (GWT)”。
   4. （可选步骤）如果您使用的是 Google App Engine，请确保已选中“Use Google App Engine”且选择了“Use default SDK (App Engine)”。
   5. 如果您在安装 Eclipse Google 插件时没有安装 SDK，则应点击“Configure SDKs...”以指定 GWT（和 App Engine SDK）解压后所在的目录。
3. 点击“Finish”按钮。

不使用插件

如果您不想使用 Eclipse Google 插件，可以导入使用上文所述的使用 webAppCreator 创建的项目。要在 Eclipse 中打开项目，请执行以下操作：

1. 从“File”菜单中，选择“Import...”菜单选项。
2. 通过“常规”>“将现有项目导入工作空间”来选择导入源。点击“Next”按钮。
3. 浏览至使用 webAppCreator 创建的 MyApplication 目录，将其用作根目录。点击“Finish”按钮。

GWT 项目便会载入到 Eclipse 工作空间中：



只需点击窗口顶部的绿色“运行”按钮，便可在托管模式下启动您的项目了。