APT 外掛程式藉由執行撰寫成在 Eclipse 內使用鏡映 API 的註解處理器,而在 Eclipse 中增加了 Java 5 註解處理支援。
當您在 Eclipse 內輸入時,會觸發這些註解處理器,它們會在編輯器內直接提供錯誤和警告,且會如同您是從指令行執行 Sun 的 Apt 工具一樣,產生正常的建置構件。
如需外掛程式如何運作的詳細資訊,您可以檢視 JDT-APT 專案網站。
之後,您必須在「Java -> 編譯器 -> 註解處理」之下,啟用註解處理。
在這個對話框中,必要的話,您也可以指定產生的來源目錄,且可以提供任何必要的處理器選項。
附註:Eclipse 會將 "-Aclasspath" 和 "-Asourcepath" 選項自動傳給您的所有處理器,因此,您不需要提供它們。
您可能需要利用路徑來作為某些傳給註解處理器的選項。 同樣地,藉由避免將絕對路徑寫在程式中,您也可以在來源控制中共用您的配置。
為了做到這一點,我們支援在處理器選項中使用類別路徑變數。 變數兩端都必須用 % 來定界,且必須是路徑中的第一個區段。
因此,如果 FOO 是指向 d:/foo 的類別路徑變數,%FOO%/bar.txt 便會解析成 d:/foo/bar.txt。 類別路徑的解析會隨著類別路徑變數的存在而不同;如果不存在,便會將原始字串加到環境選項中。 不過,bar.txt(這個範例)不必存在。
保留的變數 ROOT 有特殊意義:它是工作區的根,用來引進專案資源。 因此比方說,如果專案名稱是 quux,%ROOT%/quux 便會解析成 quux 的絕對路徑,%ROOT%/quux/.classpath 會解析成 quux/.classpath 的絕對路徑。 當使用 ROO 時,路徑的第一個區段必須實際存在:在這個範例中,quux 專案必須存在,但 .classpath 不需要存在。