增量式项目构建器

标识符:org.eclipse.core.resources.builders

描述:工作区支持增量式项目构建器(或者简称为“构建器”)的概念。构建器的任务是处理一组资源更改(作为资源变化来提供)。例如,Java 构建器将重新编译更改过的 Java 文件,并生成新的类文件。

构建器是根据每个项目来配置的, 并且,当更改它们的项目中的资源时,就会自动运行构建器。因此,构建器应当运行得很快,并且是根据项目中的更改量而不是资源数目来进行缩放。这通常意味着构建器能够增量式更新它们的“构建状态”。

标记扩展点允许构建器编写者使用符号名注册他们的构建器实现, 然后,在工作区中使用此符号名来查找和运行构建器。该符号名是构建器扩展的标识。

配置标记:

   <!ELEMENT builder run?>

   <!ELEMENT run parameter*>
   <!ATTLIST run
      class          CDATA #REQUIRED
   >

   <!ELEMENT parameter EMPTY>
   <!ATTLIST parameter
      name         CDATA #REQUIRED
      value        CDATA #REQUIRED
   > 示例:

以下是构建器配置的示例:

   <extension point="org.eclipse.core.resources.builders">
      <builder id="com.xyz.coolBuilder" name="Cool Builder">
         <run class="com.xyz.builders.Cool">
            <parameter name="optimize" value="true"/>
            <parameter name="comment" value="Produced by the Cool Builder"/>
         </run>
      </builder>
   </extension>

API 信息属性的值必须表示 org.eclipse.core.resources.IncrementalProjectBuilder 的子类。

所提供的实现:平台本身没有任何预定义的构建器。必要时,特定产品安装可能包含构建器。

Copyright IBM Corp. 2000, 2001.  All Rights Reserved.