從指令行啟用程式碼涵蓋面

若要驗證程式碼是否符合您指定的程式碼涵蓋面接受準則，可以從指令行啟用程式碼涵蓋面。為此，您需要：

• 配置 CLASSPATH 來啟用程式碼涵蓋面
• 執行程式碼涵蓋面設備測試 Script

您也可以從工作台外部產生程式碼涵蓋面報告，以及從指令行停用程式碼涵蓋面。

配置 CLASSPATH 來啟用程式碼涵蓋面

若要配置 CLASSPATH 來啟用程式碼涵蓋面，請設定下列 CLASSPATH 環境變數：

• ECLIPSE_HOME － eclipse 的安裝目錄。若未定義，則此環境變數預設為預設的 Rational 安裝目錄。
• JAVA_HOME － Java 的安裝目錄。<JAVA_HOME>/bin 必須包含 java.exe。若未定義，則此環境變數預設為預設的 RAD JRE 目錄。

執行程式碼涵蓋面設備測試 Script

在 Windows 上，設備測試 Script 為 instrument.bat；在 Linux 上，則為 instrument.sh。

設備測試 Script 的格式為：

instrument.bat/sh -in <src-input-directory> [-baseline <baseline-file>] [-saveBackup] [-verbose] [-output <output-dir>]

其中：

in：

指定「以路徑區隔」的目錄清單，這些目錄包含要進行設備測試的類別檔。路徑分隔字元視作業系統而定（在 Windows 上為分號 ";"，在 Linux 上為冒號 ":"）。

baseline：

指定儲存基準線檔案的路徑。僅在您想從工作台外部產生程式碼涵蓋面報告時使用此項目。基準線檔案是經過設備測試的程式碼與其比較，並針對其產生程式碼涵蓋面統計的檔案。它用來作為程式碼涵蓋面報告產生器的輸入。

saveBackup：

指定是否要將原始類別和 jar 檔重新命名為 *.bak。包含 saveBackup 選項會產生備份檔；省略此選項會導致改寫（並因此而流失）原始檔案。

verbose：

指定應列印參考訊息。

output：

指定要用來儲存經過設備測試的檔案的輸出目錄；否則，經過設備測試的檔案會儲存在輸入目錄中。

範例 1

在下列範例中，為 Windows 目錄 C:\java_code 和 C:\java_tests 中的檔案啟用了程式碼涵蓋面，但是未產生這些檔案的備份。基準線檔案儲存在 C:\llc\coverage_reports 中，列印了參考訊息，而輸出檔則儲存在 C:\instrumented_files 中

instrument.bat -in C:\java_code;C:\java_tests -baseline C:\llc\coverage_reports -verbose -output C:\instrumented_files

範例 2

在下列範例中，為 Linux 目錄 C:/java_source 和 C:/testcase_source 中的檔案啟用了程式碼涵蓋面，並產生了這些檔案的備份。未建立基準線檔案，未列印參考訊息，而輸出檔則儲存在 C:/instrumented_files 中

instrument.sh -in /java_source:/testcase_source -saveBackup -output /instrumented_files

從工作台外部產生程式碼涵蓋面報告

請參閱產生程式碼涵蓋面報告

從指令行停用程式碼涵蓋面

若要從指令行停用經過設備測試的類別，請重新編譯專案，或將 .class 檔案取代為 .class.bak 檔案（若 saveBackup 已啟用）。

© Copyright IBM Corporation 2007, 2008. All Rights Reserved.