Komme i gang

APT i Eclipse

APT-plugin-modulen legger til støtte for annotasjonsbehandling i Eclipse, ved å kjøre annotasjonsbehandlere som er skrevet for å bruke Mirror APIs i Eclipse.

Disse annotasjonsbehandlerne blir deretter utløst når du skriver i Eclipse, og gir opplysninger om feil og advarsler direkte i redigeringsprogrammet, og produserer vanlige bygg-artefakter på samme måte som om du hadde kjørt Suns apt-verktøy fra kommandolinjen.

Du finner mer detaljert informasjon om hvordan plugin-modulens virker på JDT-APT-prosjektets nettsted..

Slå på annotasjonsbehandling

Prosjektets kompilator må være konfigurert til å bruke Java 5.0-nivå i preferansene, under Java->Kompilator:

Bilde av preferansesiden for kompilator

Deretter aktiverer du annotasjonsbehandling under Java->Kompilator->Annotasjonsbehandling:

Bilde av preferansesiden for annotasjonsbehandling

I denne dialogboksen kan du også angi den genererte kildedialogen hvis du ønsker det, og oppgi eventuelle nødvendige behandleralternativer.

Merk: alternativene "-Aclasspath" og "-Asourcepath" blir automatisk overført til samtlige behandlere av eclipse, så det er ikke nødvendig å oppgi dem.

Legge til annotasjonsbehandlere

Du kan legge til annotasjonsbehandlere i prosjektet under Java->Kompilator->Annotasjonsbehandling->Factory-bane:

Bilde av egenskapssiden for factory-bane

Factory-bane og kildekontroll

Factory-banen tilsvarer klassebanen med hensyn til hvordan den samhandler med kildekontroll. For å unngå hardkoding av baner til factory-JAR-filer, kan du enten bruke prosjektrelative JAR-filer via knappen "Legg til Jar-filer...", eller bruke en klassebanevariabel med knappen "Legg til variabel".

Behandleralternativer og kildekontroll

Du må kanskje bruke baner som noen av alternativene som overføres til annotasjonsbehandlerne. Ved å unngå å hardkode fullstendige baner, vil du kunne dele konfigurasjonen i kildekontroll.

For å oppnå dette støtter vi bruk av klassebanevariabler i behandleralternativer. Variabler må avgrenses på begge sider med %, og må være det første segmentet i en bane.

Hvis FOO er en klassebanevariabel som peker til d:/foo, vil %FOO%/bar.txt tolkes som d:/foo/bar.txt. Klassebanetolkningen avhenger av at klassebanevariabelen finnes. Hvis den ikke finnes, blir den rå strengen lagt til miljøalternativene. Derimot trenger ikke bar.txt (i dette eksempelet) finnes.

Den reserverte variabelen ROOT er gitt spesiell betydning: det er arbeidsområdets rot, og introduserer en prosjektressurs. Hvis for eksempel quux er navnet på et prosjekt, blir %ROOT%/quux tolket som den fullstendige banen til quux, og % ROOT%/quux/.classpath blir tolket som den fullstendige banen til quux/.classpath. Hvis du bruker ROOT, må det første segmentet i banen faktisk finnes: i eksempelet må quux finnes, mens det ikke er nødvendig at .classpath finnes.