增量式项目构建器

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

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

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

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

配置标记:

   <!ELEMENT extension (builder)>

   <!ATTLIST extension
     point CDATA #REQUIRED
     id    CDATA #IMPLIED
     name  CDATA #IMPLIED
   >

   <!ELEMENT builder (run?)>

   <!ATTLIST builder
     hasNature (true | false)
   >

   <!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 (c) 2003 IBM Corporation and others. All rights reserved. 该程序及附带提供的资料是基于“一般公共许可证”(Common Public License) v1.0 的条款提供的,本发行版中提供了该许可证条款,并且也可 在以下位置处找到该条款:http://www.eclipse.org/legal/cpl-v10.html