Komma igång

APT i Eclipse

APT-insticksprogrammen lägger till Java 5-anteckningsbearbetningsfunktion till Eclipse, genom att köra anteckningsprocessorer som skrivits för att använda spegel-API:er i Eclipse.

Anteckningsbearbetningsfunktionerna utlöses sedan när du skriver i Eclipse, anger fel och varningar direkt i redigeraren och producerar normala byggtestobjektsamlingar på samma sätt som om du körde Suns apt-verktyg direkt från kommandoraden.

Mer ingående information om hur insticksprogrammen fungerar finns på JDT-APT-projektwebbplatsen.

Aktivera anteckningsbearbetning

Projektets kompilator måste vara konfigurerad att använda Java 5.0-nivåkompatibilitet i inställningarna under Java->Kompilator:

Skärmbild av inställningssidan Kompilator

Sedan måste du aktivera anteckningsbearbetningsfunktionen genom att välja Java->Kompilator->Anteckningsbearbetning:

Skärmbild av egenskapssidan Anteckningsbearbetning

Om du vill kan du i dialogrutan också ange den genererade källkatalogen och andra bearbetningsalternativ som behövs.

Obs! Alternativen "-Aclasspath" och "-Asourcepath" överförs automatiskt av Eclipse till alla dina processorer. De behöver alltså inte anges.

Lägga till anteckningsprocessor

Du kan lägga till anteckningsprocessor till projektet genom att välja Java->Kompilator->Anteckningsbearbetning->Fabrikssökväg:

Skärmbild av egenskapssidan Fabrikssökväg

Fabrikssökväg och källkontroll

Fabrikssökvägen liknar klassökvägen på så sätt att den interagerar med källkontroll. Du undviker hårdkodade sökvägar till fabriks-JAR-filer genom att antingen använda projektrelativa jar-filer med knappen "Lägg till JAR-filer..." eller använda en klassökvägsvariabel med knappen "Lägg till variabel..."

Processoralternativ och källkontroll

Du behöver kanske använda sökvägar då en del av alternativen har överförts till dina anteckningsprocessorer. Genom att undvika hårdkodade absoluta sökvägar kan du dela din konfiguration i källkontroll.

Det gör du genom att stödja klassökvägsvariabler inuti processoralternativ. Variablerna måste dels avgränsas i båda ändar med %, dels utgöra sökvägens första segment.

Om FOO är en klassökvägsvariabel som pekar på d:/foo, då kommer %FOO%/bar.txt att tolkas som d:/foo/bar.txt. Tolkningen av klassökväg är beroende av klassökvägsvariabeln. Om ingen sådan finns, läggs den råa strängen till miljöalternativen. Däremot behöver inte bar.txt (i detta exempel) finnas.

Den reserverade variabeln ROOT har en särskild betydelse. Den är arbetsytans rot och introducerar en projektresurs. Om t.ex. quux är namnet på ett projekt, kommer %ROOT%/quux tolkas som absolut sökväg för quux och % ROOT%/quux/.classpath att tolkas som absolut sökväg för quux/.classpath. När du använder ROOT, måste sökvägens första segment faktiskt finnas. I exemplet måste projektet quux finnas, men inte .classpath.