ArtRunTest

public class ArtRunTest
extends Object implements IAbiReceiver, IConfigurationReceiver, IRemoteTest, ITestCollector, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.ArtRunTest

---

執行 ART 測試的測試執行工具。

摘要

巢狀類別
class	ArtRunTest.AdbShellCommandException 這個例外狀況類別可回報執行 ADB 殼層指令期間發生的錯誤。

欄位
public static final String	CHECKER_PAR_FILENAME

公用建構函式
ArtRunTest()

公用方法
void	addAllExcludeFilters( filters) 新增篩選器的 ERROR(/Set)，用於排除要排除的測試。
void	addAllIncludeFilters( filters) 新增篩選器的 ERROR(/Set)，用於指定要納入哪些測試。
void	addExcludeFilter(String filter) 新增篩選器，用於排除要排除的測試。
void	addIncludeFilter(String filter) 新增篩選器，用於指定要納入哪些測試。
void	clearExcludeFilters() 刪除目前追蹤的所有排除篩選條件。
void	clearIncludeFilters() 刪除目前追蹤的所有包含篩選器。
IAbi	getAbi()
	getExcludeFilters() 傳回排除篩選器的目前 ERROR(/Set)。
	getIncludeFilters() 傳回目前的包含篩選器 ERROR(/Set)。
void	run(TestInformation testInfo, ITestInvocationListener listener) 執行測試，並將結果回報給事件監聽器。
void	setAbi(IAbi abi)
void	setCollectTestsOnly(boolean shouldCollectTest) 啟用或停用測試收集模式
void	setConfiguration(IConfiguration configuration) 插入目前使用的 IConfiguration。

保護方法
	checkExitCode(Integer exitCode) 檢查測試指令傳回的結束程式碼。
	checkTestOutput(TestInformation testInfo, String actualOutputText, String outputShortName, String outputPrettyName) 檢查測試指令產生的輸出內容。
File	createTestLocalTempDirectory(TestInformation testInfo) 在測試的依附元件資料夾中建立本機暫存目錄，用於收集從裝置下測試提取的測試輸出內容。
	executeCheckerTest(TestInformation testInfo, ITestInvocationListener listener) 執行檢查器測試並查看輸出內容。
void	extractSourcesFromJar(File tmpCheckerLocalDir, File jar) 將指定 jar 檔案中的 src 目錄擷取至指定的目錄。
File	getCheckerBinaryPath(TestInformation testInfo) 找出 Checker 二進位檔 (Python Archive)。
	runChecker(String[] checkerCommandLine) 執行檢查器指令並查看結果。

欄位

CHECKER_PAR_FILENAME

public static final String CHECKER_PAR_FILENAME

公用建構函式

ArtRunTest

public ArtRunTest ()

公用方法

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

新增要排除測試的篩選器 ERROR(/Set)。

參數
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

新增篩選器的 ERROR(/Set)，用於指定要納入哪些測試。

參數
filters

addExcludeFilter

public void addExcludeFilter (String filter)

新增篩選器，用於排除要排除的測試。

參數
filter	String

加入篩選器

public void addIncludeFilter (String filter)

新增篩選器，選取要納入的測試。

參數
filter	String

clearExcludeFilters

public void clearExcludeFilters ()

刪除目前追蹤的所有「排除」篩選器。

clearIncludeFilters

public void clearIncludeFilters ()

刪除目前追蹤的所有「包含」篩選器。

getAbi

public IAbi getAbi ()

傳回
IAbi

取得排除篩選器

public  getExcludeFilters ()

傳回排除篩選器的目前 ERROR(/Set)。

傳回

getIncludeFilters

public  getIncludeFilters ()

傳回目前的「include」篩選器 ERROR(/Set)。

傳回

得分

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

執行測試，並將結果回報給監聽器。

參數
testInfo	TestInformation：包含執行測試所需實用資訊的 TestInformation 物件。
listener	ITestInvocationListener：測試結果的 ITestInvocationListener

擲回
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

參數
abi	IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

啟用或停用測試收集模式

setConfiguration

public void setConfiguration (IConfiguration configuration)

插入使用中的 IConfiguration。

參數
configuration	IConfiguration

受保護的方法

checkExitCode

protected  checkExitCode (Integer exitCode)

檢查測試指令傳回的結束程式碼。

參數
exitCode	Integer：測試指令傳回的結束代碼

傳回
	選用的錯誤訊息，如果測試結束代碼表示成功，則為空白

checkTestOutput

protected  checkTestOutput (TestInformation testInfo, 
                String actualOutputText, 
                String outputShortName, 
                String outputPrettyName)

檢查測試指令產生的輸出內容。

用於檢查測試的標準輸出內容和標準錯誤。

參數
testInfo	TestInformation：與執行的測試相關聯的 TestInformation 物件
actualOutputText	String：測試產生的輸出內容
outputShortName	String：輸出頻道的簡稱
outputPrettyName	String：輸出管道的更美觀名稱，用於錯誤訊息

傳回
	選用錯誤訊息，如果檢查的輸出內容有效，則為空白

createTestLocalTempDirectory

protected File createTestLocalTempDirectory (TestInformation testInfo)

在測試的依附元件資料夾中建立本機暫存目錄，收集從測試裝置拉取的測試輸出內容。

參數
testInfo	TestInformation：與執行的測試相關聯的 TestInformation 物件

傳回
File	ERROR(/File) 物件會指向已建立的臨時目錄。

擲回
	如果無法建立臨時目錄。

executeCheckerTest

protected  executeCheckerTest (TestInformation testInfo, 
                ITestInvocationListener listener)

執行檢查器測試並查看輸出內容。

檢查器測試是 ART 執行測試中包含的額外測試，會以註解的形式寫入測試來源檔案的註解中，用於驗證 ART 的編譯器。

參數
testInfo	TestInformation：與執行的測試相關聯的 TestInformation 物件
listener	ITestInvocationListener：與執行的測試相關聯的 ITestInvocationListener 物件

傳回
	選用的錯誤訊息，如果檢查工具測試成功，則為空白

擲回
ArtRunTest.AdbShellCommandException
DeviceNotAvailableException

extractSourcesFromJar

protected void extractSourcesFromJar (File tmpCheckerLocalDir, 
                File jar)

從指定的 JAR 檔案中擷取 src 目錄，並將其解壓縮至指定目錄。

參數
tmpCheckerLocalDir	File
jar	File

getCheckerBinaryPath

protected File getCheckerBinaryPath (TestInformation testInfo)

找出檢查器二進位檔 (Python 封存檔)。

參數
testInfo	TestInformation

傳回
File

runChecker

protected  runChecker (String[] checkerCommandLine)

執行檢查器指令並查看結果。

參數
checkerCommandLine	String：要執行的檢查器命令列

傳回
	可選的錯誤訊息，如果檢查器叫用成功，則為空白