Trinnvise prosjektbyggere
Identifikator:
org.eclipse.core.resources.builders
Beskrivelse:
Arbeidsområdet støtter
begrepet trinnvis prosjektbygger (eller kortformen "bygger"). En byggers jobb er
å behandle et sett av ressursendringer (levert som en ressursdelta). En Java-bygger vil
for eksempel kompilere endrede Java-filer på nytt og produsere nye klassefiler.
Byggere konfigureres per prosjekt, og kjøres
automatisk når ressursene i prosjektene endres. På denne måten kan
byggere være raske og skalere mengden av endring i stedet for antall
ressurser i prosjektet. Dette betyr vanligvis at byggere
kan utføre en trinnvis oppdatering av "byggetilstanden".
Med byggerutvidelsespunktet kan
en byggerforfatter registrere byggerimplementeringen under et symbolsk navn
som så brukes fra innsiden av arbeidsområdet til å finne og kjøre
byggere. Det symbolske navnet er IDen for
byggerutvidelsen. Ved definering av en byggerutvidelse, blir
brukerne oppfordret til å inkludere en lesbar verdi for attributtet "name" som
identifiserer byggeren, og som kan presenteres for brukerne.
Konfigurasjonskodetype:
<!ELEMENT extension (builder)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #REQUIRED
name CDATA #IMPLIED>
- point - en fullt kvalifisert ID for målutvidelsespunktet
- id - en valgfri ID for utvidelsesforekomsten
- name - et valgfritt navn på utvidelsesforekomsten
<!ELEMENT builder (run?)>
<!ATTLIST builder
hasNature (true | false)
isConfigurable (true | false) >
- hasNature - "true" eller "false" oppgir om
byggeren eies av en prosjektnatur. Hvis "true" og ingen tilsvarende natur blir
funnet, vil denne byggeren ikke kjøre, men den vil bli værende i prosjektets
byggespesifikasjon. Hvis attributtet ikke er oppgitt,
blir det antatt å være "false".
- isConfigurable - "true" eller "false" oppgir om
byggeren tillater tilpassing av hvilke byggeutløsere den skal reagere på. Hvis "true", kan
klienter bruke APIet ICommand.setBuilding til å oppgi om denne byggeren
skal kjøres for en bestemt byggeutløser. Hvis attributtet ikke er oppgitt,
blir det antatt å være "false".
<!ELEMENT run (parameter*)>
<!ATTLIST run
class CDATA #REQUIRED>
- class - det fullt kvalifiserte navnet på en subklasse
av org.eclipse.core.resources.IncrementalProjectBuilder.
<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
- name - navnet på denne parameteren gjøres tilgjengelig
for forekomster av den oppgitte byggerklassen.
- value - en tilfeldig verdi som er knyttet til
det gitte navnet, og gjort tilgjengelig for forekomster av den oppgitte byggerklassen.
Eksempler:
Nedenfor finner du et
eksempel på en byggerkonfigurasjon:
<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>
Hvis denne utvidelsen er
definert i en plugin-modul med IDen "com.xyz.coolplugin", vil det fullt kvalifiserte navnet
på denne byggeren være "com.xyz.coolplugin.coolbuilder".
API-informasjon:
Verdien av class-attributtet
må representere en subklasse av org.eclipse.core.resources.IncrementalProjectBuilder.
Levert implementering:
Selve plattformen har ikke
noen forhåndsdefinerte byggere. Installasjoner av deltakerprodukter kan
omfatte byggere etter behov.
Copyright (c) 2002, 2005 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made
available under the terms of the Eclipse Public License v1.0 which
accompanies
this distribution, and is available at
http://www.eclipse.org/legal/epl-v10.html