編譯器選項
「PDE/建置」支援若干選項來控制個別外掛程式的編譯器。如需來源和目標層次與 bootclasspath 的相關設定,請參閱「設定編譯環境」。
警告和錯誤
「PDE/建置」容許在 build.properties 檔中指定自訂的編譯警告和錯誤。您可以使用 javacWarnings.<library> 和 javacErrors.<library> 選項,依每個程式庫(單一外掛程式可包含多個 JAR 程式庫)來設定警告和錯誤。關於這些內容的值,請參閱(Java 開發使用手冊)使用批次編譯器頁面的 "-warn:..." 小節。
範例:
javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
「專案」喜好設定中的警告和錯誤
現在,在「PDE/建置」期間也可以使用 JDT 專案喜好設定。「PDE/建置」本身無法讀取喜好設定檔,但是它能夠將這些檔案傳遞給可讀懂它們的 JDT 編譯器。如果要使用此項,外掛程式應在其 build.properties 檔中指定
javacProjectSettings 內容。值應該是:
- javacProjectSettings=true:使用預設 .settings/org.eclipse.jdt.core.prefs 喜好設定檔中指定的專案設定。
- javacProjectSettings=path/to/jdt.prefs:使用指定的喜好設定檔。
相較於 Releng 建置,有些專案可能希望在工作區中使用不同的警告和錯誤設定。相較於
"javacWarnings.<library>" 內容,指定這些設定的方法更為簡便。
檔案編碼
「PDE/建置」可依每個程式庫、資料夾或檔案,來接受自訂檔案編碼。
- javacDefaultEncoding.<library> - 設定編譯給定程式庫時所用的預設編碼。
- javacCustomEncodings.<library> - 編譯給定程式庫時所用的路徑和編碼清單(以逗點區隔)。
指定資料夾時,編碼會用於該資料夾所包含的每一個項目。指定檔案時,編碼僅會用於該檔案。範例:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
自訂編譯器引數
現在,您可以在軟體組的 build.properties 檔中,使用 compilerArg 內容來指定各軟體組的自訂編譯器引數。這個內容類似於建置器配置中的
compilerArg 內容,只不過它只會影響單一外掛程式,而非所有的外掛程式。這裡的特定引數,取決於所用的編譯器。JDT 編譯器引數列示在這裡。
編譯器選項的優先順序
有各種不同的方法來指定不同的編譯器選項。一般而言,選項的優先順序如下:
- javacDefaultEncoding.<library> 的優先順序高於自訂 -encoding 指令行選項。
- 對於一般的選項,出現在編譯器指令行之後的選項,會置換先前指定的選項。選項會依照下列順序來提供給 JDT:
- 建置器配置中的 compilerArg 內容(會影響所有的軟體組)。
- 這個外掛程式的 build.properties 當中的 compilerArg 內容。
- 以 javacProjectSettings 指定的編譯器喜好設定檔。
- 含有檔案編碼、javacWarnings、javacErrors 與存取規則之產生的編譯器引數檔 (javaCompiler.<library>.args)。
使用自訂編譯器
現在,軟體組可以設定 compilerAdapter 內容,以使用自訂編譯器。指定的編譯器配接器必須可在 Ant 環境中使用。依預設,所用的 JDT 編譯器配接器是 org.eclipse.jdt.core.JDTCompilerAdapter。指定替代編譯器的一個特定原因是,要用於 Aspect J 或 Groovy 軟體組。指定自訂編譯器配接器的軟體組可能也需要指定下列某些內容:
- sourceFileExtensions:應視為來源的副檔名清單(例如 *.java、*.aj、*.groovy)。
- compilerAdapter.useLog:是否將 "-log" 引數傳遞給編譯器
- compilerAdapter.useArgFile:是否傳遞產生的 javaCompiler.<library>.args 引數檔(包含存取規則、檔案編碼,以及警告/錯誤層次)。