增量式项目构建器

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

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

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

构建器扩展点允许构建器编写者使用一个符号名来注册他们的构建器实现,然后,在工作区中使用此符号名来查找和运行构建器。符号名是构建器扩展的标识。当定义构建器扩展时,鼓励用户在“名称”属性中包含可供人阅读的值,“名称”属性标识它们的构建器,并且可能提供给用户。

配置标记:

   <!ELEMENT builder run?>
   <!ATTLIST builder
      hasNature    CDATA #IMPLIED
   >

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

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

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

如果在具有标识“com.xyz.coolplugin”的插件中定义了此扩展,则此构建器的全限定名将为“com.xyz.coolplugin.coolbuilder”。

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

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

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