创建项目构建器 Ant 构建文件

要了解项目构建器是如何工作的,我们将创建一个简单项目,带有单个源文件和压缩单个类文件的 Ant 构建文件。尽管此示例使用 Java,应注意项目构建器对所有项目(Java 或非 Java)都可用。

  1. 创建名为 HW 的 Java 项目。
  2. 使用 main 方法创建名为 HelloWorld 的 Java 源文件。
  3. 将单个 System.out.println() 语句放置在 main 方法中,并使它打印您选择的欢迎词。
  4. 保存更改。
  5. 创建名为 projectBuilder.xml 的文件,对它打开 Ant 编辑器,输入以下内容并保存更改。
    <?xml version="1.0" encoding="UTF-8"?>
       <project name="HW.makejar" default="makejar" basedir=".">
          <target name ="makejar" description="Create a jar for the HW project">
             <jar jarfile="HelloWorld.jar" includes="*.class" basedir="bin"/>
          </target>
    </project>
    
  6. 在其中一个导航视图中,选择 HW 项目并从其上下文菜单中选择属性
  7. 在项目属性对话框中,选择构建器,然后单击新建...
  8. 选择配置类型对话框中,选择 Ant 构建,然后单击确定
  9. 外部工具对话框出现。将名称设置为 Makejar。在选项卡中,单击构建文件 浏览工作空间... 并将位置设置为上面所创建的 projectBuilder.xml 构建文件。然后单击基本目录 浏览工作空间... 并将“基本目录”设置为 HW 项目。

    外部工具对话框的“主”选项卡

  10. 刷新选项卡中,我们想要确定何时创建了 HelloWorld.jar(在 Eclipse 中看到它)。缺省情况下,当项目构建器完成运行时不执行任何刷新,因此,选择完成时刷新资源,然后在作用域变量的列表中选择包含所选资源的项目。因为刷新成本较高,所以通常应刷新包含构建文件将影响到的所有资源的最小实体。

    “外部工具”对话框的“刷新”选项卡

  11. 目标选项卡中,可以指定何时执行此项目构建器以及目标。缺省情况下,缺省目标设置为运行执行“清除”后手动构建。您可以指定其他目标和其他触发器。在自动构建可行的同时运行项目构建器,尽管由于性能关系不建议这样做。

    “外部工具”对话框的“目标”选项卡

  12. 应用更改并单击确定
  13. 返回项目属性对话框中,现在将看到设置为在缺省 Java 构建器之后运行的名为 Makejar 的项目构建器。单击确定以保存项目构建器并关闭对话框。
    注意:您可以更改顺序以便 Ant 构建文件在 Java 构建器之前运行,尽管在此示例中没有意义。

    项目属性对话框

Java 构建器运行内部 Eclipse Java 编译器,该编译器本身也负责对源建立索引以便搜索、重构并使许多其他功能部件可用。因此,不可能通过使用项目构建器来替换内部 Eclipse Java 编译器。您可以禁用 Java 构建器并可根据定义的项目构建器控制“Java 构建器”在何时运行。

相关任务
创建 Ant 构建文件
编辑 Ant 构建文件
保存和复用 Ant 选项
运行 Ant 构建文件
作为项目构建器的 Ant 构建文件
执行项目构建器
外部工具
非 Ant 项目构建器
独立的外部工具