沙盒

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


定義可用於運行調用的沙箱的接口。

概括

公共方法

abstract String createClasspath (File workingDir)

根據環境和getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])返回的工作目錄創建一個類路徑。

abstract IConfiguration createThinLauncherConfig (String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)

與主運行斷開連接的特殊模式:當父項中似乎不存在配置時,我們回退到精簡啟動器,在那裡我們嘗試使用當前已知信息設置沙箱並填充工作目錄以在版本化目錄中完全創建配置.

abstract File getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)

根據命令行參數返回要使用的沙盒環境 TF。

abstract Exception prepareEnvironment ( IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)

為沙盒正常運行準備環境。

abstract CommandResult run ( TestInformation info, IConfiguration configuration, ITestLogger logger)

使用設置的環境運行沙箱。

abstract void tearDown ()

清理任何可能已更改的狀態、文件或環境。

公共方法

創建類路徑

public abstract String createClasspath (File workingDir)

根據環境和getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])返回的工作目錄創建一個類路徑。

參數
workingDir File :沙箱的當前工作目錄。

退貨
String要使用的類路徑。

投擲
ConfigurationException

createThinLauncherConfig

public abstract IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

與主運行斷開連接的特殊模式:當父項中似乎不存在配置時,我們回退到精簡啟動器,在那裡我們嘗試使用當前已知信息設置沙箱並填充工作目錄以在版本化目錄中完全創建配置.

參數
args String :原始命令行參數。

keyStoreClient IKeyStoreClient :用於創建配置的當前密鑰庫客戶端。

runUtil IRunUtil :當前運行主機命令的IRunUtil

globalConfig File :用於運行 TF 子進程的全局配置。

退貨
IConfiguration指向 NON_VERSIONED 對象的 TF 配置 XML 的文件。如果無法創建精簡啟動器配置,則返回 null。

getTradefedSandboxEnvironment

public abstract File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                String[] args)

根據命令行參數返回要使用的沙盒環境 TF。

參數
context IInvocationContext :父級的IInvocationContext

nonVersionedConfig IConfiguration :表示非版本化對象的IConfiguration

args String : 命令行參數。

退貨
File包含 TF 沙箱環境 jar 的ERROR(/File)目錄。

準備環境

public abstract Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration configuration, 
                ITestInvocationListener listener)

為沙盒正常運行準備環境。

參數
context IInvocationContext :當前調用IInvocationContext

configuration IConfiguration :要運行的命令的IConfiguration

listener ITestInvocationListener :當前調用ITestInvocationListener最終結果應通過管道傳輸。

退貨
Exception包含失敗的Exception 。如果成功,則為 Null。

public abstract CommandResult run (TestInformation info, 
                IConfiguration configuration, 
                ITestLogger logger)

使用設置的環境運行沙箱。

參數
info TestInformation : 描述調用的TestInformation

configuration IConfiguration :要運行的命令的IConfiguration

logger ITestLogger :我們可以記錄文件的ITestLogger

退貨
CommandResult帶有沙盒運行和日誌狀態的CommandResult

拆除

public abstract void tearDown ()

清理任何可能已更改的狀態、文件或環境。