Das APT-Plug-in fügt Eclipse Unterstützung für die Anmerkungsverarbeitung von Java 5 hinzu, indem Anmerkungsprozessoren ausgeführt werden, die für die Verwendung von Mirror APIs innerhalb von Eclipse geschrieben wurden.
Diese Anmerkungsprozessoren werden ausgelöst, wenn Sie innerhalb von Eclipse Eingaben vornehmen. Sie stellen Fehler und Warnungen direkt in den Editor und erzeugen normale Erstellungsartefakte, so als würden Sie das apt-Tool von Sun in der Befehlszeile ausführen.
Weitere Informationen zur Funktionsweise des Plug-ins finden Sie auf der Website zum JDT-APT-Projekt.
Anschließend müssen Sie die Anmerkungsverarbeitung unter 'Java->Compiler->Anmerkungsverarbeitung' aktivieren:
In diesem Dialogfenster können Sie ferner bei Bedarf das generierte Quellenverzeichnis angeben und alle notwendigen Prozessoroptionen zur Verfügung stellen.
Hinweis: Die Optionen "-Aclasspath" und "-Asourcepath" werden automatisch von Eclipse an alle Prozessoren übergeben, so dass Sie diese Optionen nicht zur Verfügung stellen müssen.
Sie müssen möglicherweise Pfade verwenden, da einige Optionen an Ihren Anmerkungsprozessor übergeben wurden. Wenn Sie jedoch das feste Codieren absoluter Pfade vermeiden, können Sie Ihre Konfiguration in der Quellcodeverwaltung gemeinsam nutzen.
Daher werden Klassenpfadvariable innerhalb von Prozessoroptionen unterstützt. Variablen müssen auf beiden Seiten durch % begrenzt werden und das erste Segment eines Pfades sein.
Wenn also FOO eine Klassenpfadvariable ist, die auf d:/foo zeigt, so wird %FOO%/bar.txt in d:/foo/bar.txt aufgelöst. Die Auflösung von Klassenpfaden hängt von der Existenz der Klassenpfadvariable ab. Wenn diese nicht vorhanden ist, wird die unformatierte Zeichenfolge den Umgebungsoptionen hinzugefügt. Die Datei bar.txt (in diesem Beispiel) muss jedoch nicht vorhanden sein.
Die reservierte Variable ROOT hat eine besondere Bedeutung. Es handelt sich um das Stammverzeichnis (Root) des Arbeitsbereichs, das eine Projektressource einführt. Wenn zum Beispiel quux der Name eines Projekts ist, so wird %ROOT%/quux in den absoluten Pfad von quux und % aufgelöst und ROOT%/quux/.classpath wird in den absoluten Pfad quux/.classpath aufgelöst. Bei der Verwendung von ROOT muss das erste Segment im Pfad tatsächlich vorhanden sein. In diesem Beispiel muss das Projekt quux vorhanden sein; .classpath muss jedoch nicht vorhanden sein.