ArtRunTest

public class ArtRunTest
extends Object implements IAbiReceiver, 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) 啟用或停用測試收集模式

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

欄位

CHECKER_PAR_FILENAME

public static final String CHECKER_PAR_FILENAME

公用建構函式

ArtRunTest

public ArtRunTest ()

公用方法

加入所有排除篩選器

public void addAllExcludeFilters ( filters)

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

參數
filters

加入所有篩選器

public void addAllIncludeFilters ( filters)

新增要納入測試的篩選器 ERROR(/Set)。

參數
filters

新增排除篩選器

public void addExcludeFilter (String filter)

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

參數
filter	String

加入篩選器

public void addIncludeFilter (String filter)

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

參數
filter	String

清除排除篩選器

public void clearExcludeFilters ()

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

ClearIncludeFilters

public void clearIncludeFilters ()

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

getAbi

public IAbi getAbi ()

傳回
IAbi

取得排除篩選器

public  getExcludeFilters ()

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

傳回

getIncludeFilters

public  getIncludeFilters ()

傳回「包含」篩選器的目前 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)

啟用或停用測試收集模式

保護方法

檢查結束程式碼

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) 物件。

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

runCheckerTest

protected  executeCheckerTest (TestInformation testInfo, 
                ITestInvocationListener listener)

執行 Checker 測試並檢查輸出結果。

檢查工具測試是部分 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)

找出 Checker 二進位檔 (Python Archive)。

參數
testInfo	TestInformation

傳回
File

RunChecker

protected  runChecker (String[] checkerCommandLine)

執行 Checker 指令並查看結果。

參數
checkerCommandLine	String：要執行的 Checker 指令列

傳回
	選用的錯誤訊息，如果 Checker 叫用成功，就會留空