gwt

GWT 是 2.5 版本及以后版本的官方开源项目。

本文档提供了从源代码构建 SDK 并运行其测试的快速指南。

如需更详细的文档，请访问我们的网站。如果您有兴趣为项目做出贡献，请阅读让 GWT 变得更好部分。

构建 GWT SDK：

要构建 GWT，您的系统需要安装 java 和 ant。
您需要检出并更新 GWT 工具库。默认情况下，它应位于 ../tools 目录。您可以通过设置 GWT_TOOLS 环境变量或向 ant 传递 -Dgwt.tools= 参数来覆盖默认位置。
要创建 SDK 分发文件，请运行：

$ ant clean dist-dev

然后您将在 build/lib 文件夹中获得所有 .jar 文件，可重新分发的文件将是：build/dist/gwt-0.0.0.zip

如果您想指定不同的版本号，请运行：

$ ant clean dist-dev -Dgwt.version=x.x.x
要编译包括示例在内的所有内容，您需要运行：

$ ant clean dist
要创建 Maven 构件（在使用 ant 构建 .jar 之后），请使用以下指南。

如何验证 GWT 代码规范：

在 GWT 中，我们有一些约定，以使所有贡献者编写的代码看起来相似，更易于审查。
在进行任何修改后，运行以下命令来编译包括测试在内的所有内容，检查 API，并验证代码风格。这不应该花费超过 3-4 分钟。

$ ant compile.tests apicheck checkstyle

如何运行 GWT 测试

在运行任何测试之前，您需要设置一些环境变量，以确保所有开发人员在相同条件下运行测试。

在类 Unix 平台上，您可以使用 export 命令：

$ export TZ=America/Los_Angeles ANT_OPTS=-Dfile.encoding=UTF-8

但在 Windows™ 上，您需要在控制面板中设置时区，并使用 set 命令设置环境变量。
最后，您可以使用以下命令运行所有测试套件，但请做好准备，因为这可能需要数小时，并且可能会因超时等原因而失败。

$ ant test
因此，您可能只想运行某些测试，以便专注于检查您正在进行的修改。

GWT 构建脚本使用特定的 ant 任务和一系列系统属性（列在下表中）来指定要运行的测试以及如何运行。

例如，要在 user 模块中运行 test 任务，您需要切换到 user 文件夹并运行 ant，将任务作为参数，并使用 -D 标志添加任何其他属性：

$ ( cd user && ant test -Dtest.emma.htmlunit.disable=true ; cd .. ) 模块 | 任务 | 可跳过的属性 | 描述 -------------- | ---------------------- | ------------------------------ | ---------------------- dev | test | test.dev.disable | GWT编译器和开发库 codeserver | test | test.codeserver.disable | SuperDevMode服务器 user | test | test.user.disable | GWT用户API和JRE模拟 user | test.nongwt | test.nongwt.disable | 运行不需要GWTTestCase的测试 user | test.dev.htmlunit | test.dev.htmlunit.disable | 使用HtmlUnit运行开发模式测试 user | test.web.htmlunit | test.web.htmlunit.disable | 使用HtmlUnit运行Web模式测试 user | test.draft.htmlunit | test.draft.htmlunit.disable | 运行草稿编译的HtmlUnit测试 user | test.nometa.htmlunit | test.nometa.htmlunit.disable | 使用HtmlUnit运行-XdisableClassMetadata测试 user | test.emma.htmlunit | test.emma.htmlunit.disable | 使用HtmlUnit运行emma测试 user | test.coverage.htmlunit | test.coverage.htmlunit.disable | 运行覆盖率支持测试 user | test.dev.selenium | test.dev.selenium.disable | 使用Selenium RC服务器运行开发模式测试 user | test.web.selenium | test.web.selenium.disable | 使用Selenium RC服务器运行Web测试 user | test.draft.selenium | test.draft.selenium.disable | 使用Selenium RC服务器运行草稿编译测试 user | test.nometa.selenium | test.nometa.selenium.disable | 使用Selenium RC服务器运行-XdisableClassMetadata测试 user | test.emma.selenium | test.emma.selenium.disable | 使用Selenium RC服务器运行emma测试 requestfactory | test | test.requestfactory.disable | Request Factory库 tools | test | test.tools.disable | GWT开发中使用的一些工具

此外，您可以使用一些变量来过滤每个任务中要运行的测试：

模块	任务	属性	默认值
dev/core	test	gwt.junit.testcase.dev.core.includes	`/com/google//*Test.class`
		gwt.junit.testcase.dev.core.excludes
user	test	gwt.junit.testcase.includes	`*/Suite.class`
user	test.nongwt	gwt.nongwt.testcase.includes	`*/JreSuite.class`
		gwt.nongwt.testcase.excludes
user	test.web.* test.draft.* test.nometa.*	gwt.junit.testcase.web.includes	`*/Suite.class`
		gwt.junit.testcase.web.excludes	`*/JsInteropSuite.class,*/JreSuite.class,**/OptimizedOnly`
user	test.dev.* test.emma.*	gwt.junit.testcase.dev.includes	`*/Suite.class`
		gwt.junit.testcase.dev.excludes	`*/JsInteropSuite.class,*/JreSuite.class,**/OptimizedOnly`

示例

在dev中运行所有测试

$ ( cd dev && ant test ; cd .. )

注意：最后的cd ..仅在Windows中需要。
还有另一种方法可以实现相同的目的，无需切换到模块文件夹。我们需要将模块指定为ant任务，将任务指定为目标参数。

$ ant dev -Dtarget=test
在codeserver中运行所有测试

$ ( cd dev/codeserver && ant test )

或

$ ant codeserver -Dtarget=test -Dtest.dev.disable=true

注意：我们禁用dev测试，因为codeserver依赖于dev，我们不想运行它的测试。
在tools中运行所有测试

$ ant tools -Dtarget=test -Dtest.dev.disable=true -Dtest.user.disable=true

仅在dev中运行JsniRefTest

$ ant dev -Dtarget=test \
    -Dgwt.junit.testcase.dev.core.includes="**/JsniRefTest.class"

在dev中运行几个测试

$ ant dev -Dtarget=test \
    -Dgwt.junit.testcase.dev.core.includes="**/JsniRefTest.class,**/JsParserTest.class"

注意：您必须使用逗号分隔的正则表达式来选择要执行的测试类。

在user中运行所有Jre测试，它们应该不超过3分钟。我们有两种方法来运行它们。尽管第二种方法更复杂，但它在这里是为了了解禁用属性的工作原理。

$ ( cd user && ant test.nongwt )

或

$ ant user -Dtarget=test
       -Dtest.dev.disable=true \
       -Dtest.codeserver.disable=true \
       -Dtest.requestfactory.disable=true \
       -Dtest.tools.disable=true \
       -Dtest.dev.htmlunit.disable=true \
       -Dtest.web.htmlunit.disable=true \
       -Dtest.coverage.htmlunit.disable=true \
       -Dtest.dev.selenium.disable=true \
       -Dtest.draft.htmlunit.disable=true \
       -Dtest.draft.selenium.disable=true \
       -Dtest.emma.htmlunit.disable=true \
       -Dtest.emma.selenium.disable=true \
       -Dtest.nometa.htmlunit.disable=true \
       -Dtest.nometa.selenium.disable=true \
       -Dtest.web.selenium.disable=true

注意：我们必须设置所有的禁用变量，除了test.nongwt.disable

在user模块中运行特定的Jre测试。

$ ( cd user && ant test.nongwt -Dgwt.nongwt.testcase.includes="**/I18NJreSuite.class" )

在开发模式下使用htmlunit运行user中的所有GWT测试。

$ ( cd user && ant test.dev.htmlunit )