為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將自 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，請使用 android-latest-release。android-latest-release 資訊清單分支版本一律會參照推送至 Android 開放原始碼計畫的最新版本。詳情請參閱「Android 開放原始碼計畫變更」。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

HostUtils

public final class HostUtils
extends Object

java.lang.Object
↳	com.android.tradefed.lite.HostUtils

實作一些實用的公用程式方法，用於執行主機測試。

這會實作幾種方法，用於在主機上尋找測試，並模擬執行 JUnit 測試，以便「試執行」這些測試。

摘要

公用方法
`static List<Class<?>>`	`getJUnitClasses(Set<String> classNames, Set<String> jarAbsPaths, ClassLoader pcl)`
`static List<Class<?>>`	`getJUnitClasses(Set<String> classNames, Set<String> jarAbsPaths, List<String> excludePaths, ClassLoader pcl)` 從提供的類別名稱和 JAR 路徑取得 JUnit4 測試案例。
`static boolean`	`hasJUnitAnnotation(Class<?> classObj)` 檢查類別是否類似 JUnit 測試。
`static boolean`	`testLoadClass(String className, URLClassLoader cl, String jarName)` 測試類別是否為合適的測試類別。

公用方法

getJUnitClasses

public static List<Class<?>> getJUnitClasses (Set<String> classNames, 
                Set<String> jarAbsPaths, 
                ClassLoader pcl)

參數
`classNames`	`Set`
`jarAbsPaths`	`Set`
`pcl`	`ClassLoader`

傳回
`List<Class<?>>`

擲回
`IllegalArgumentException`

getJUnitClasses

public static List<Class<?>> getJUnitClasses (Set<String> classNames, 
                Set<String> jarAbsPaths, 
                List<String> excludePaths, 
                ClassLoader pcl)

從提供的類別名稱和 JAR 路徑取得 JUnit4 測試案例。

參數
`classNames`	`Set`：目前類別路徑中存在的類別，用於檢查 JUnit 測試
`jarAbsPaths`	`Set`：要搜尋含有測試註解的類別的 JAR。
`excludePaths`	`List`
`pcl`	`ClassLoader`

傳回
`List<Class<?>>`	要執行的測試類別物件清單。

擲回
	java.lang.IllegalArgumentException
`IllegalArgumentException`

hasJUnitAnnotation

public static boolean hasJUnitAnnotation (Class<?> classObj)

檢查類別是否類似 JUnit 測試。

參數
`classObj`	`Class`：要檢查註解的類別

傳回
`boolean`	類別物件是否具有 JUnit4 測試註解

testLoadClass

public static boolean testLoadClass (String className, 
                URLClassLoader cl, 
                String jarName)

測試類別是否為合適的測試類別。

在本例中，「合適」是指使用其中一個標準執行器或其子類別的有效 JUnit 測試類別。類別也應會載入。

傳回
`boolean`	如果應將這個類別視為測試類別，則為 true，否則為 false

擲回
`IllegalArgumentException`