ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

既知の間接的なサブクラス GoogleTradefedSandbox、TradefedSandbox GoogleTradefedSandbox ラボ インフラストラクチャで使用される TradefedSandbox の内部特殊化。  TradefedSandbox Trade Federation 呼び出しを実行できるサンドボックス コンテナ。

---

呼び出しの実行に使用できるサンドボックスを定義するインターフェース。

概要

パブリック メソッド
abstract String	createClasspath(File workingDir) getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]) から返された環境と作業ディレクトリに基づいて、クラスパスを作成します。
abstract IConfiguration	createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig) スペシャル モードがメイン実行から切断された場合: 親に構成が存在しない場合、シン ランチャーにフォールバックし、現在既知の情報でサンドボックスを設定し、作業ディレクトリを埋めて、バージョン管理されたディレクトリに構成を完全に作成します。
default Map<String, List<String>>	discoverTests(IInvocationContext context, IConfiguration configuration) SandboxOptions.shouldUseTestDiscovery() が有効になっている場合にテストを検出する prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) のサブステップ。
default Map<String, List<String>>	discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)
default IFolderBuildInfo	fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args) サンドボックスに必要な追加のファイルを取得する prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) のサブステップ。
default File	getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args) コマンドライン引数に基づいて使用するサンドボックス環境 TF を返します。
default File	getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)
abstract Exception	prepareEnvironment(IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener) サンドボックスが適切に実行されるように環境を準備します。
abstract CommandResult	run(TestInformation info, IConfiguration configuration, ITestLogger logger) 設定された環境でサンドボックスを実行します。
abstract void	tearDown() 変更された可能性のある状態、ファイル、環境をクリーンアップします。

パブリック メソッド

createClasspath

public abstract String createClasspath (File workingDir)

getTradefedSandboxEnvironment(IInvocationContext,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 を返します。

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration)

SandboxOptions.shouldUseTestDiscovery() が有効になっている場合にテストを検出する prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) のサブステップ。

パラメータ
context	IInvocationContext: 現在の呼び出し IInvocationContext。
configuration	IConfiguration: 実行するコマンドの IConfiguration。

戻り値
Map<String, List<String>>	検出されたテストのマップ。サポートされていない場合や失敗した場合は null。

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

パラメータ
context	IInvocationContext
configuration	IConfiguration
logger	ITestLogger

戻り値
Map<String, List<String>>

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration configuration, 
                String[] args)

サンドボックスに必要な追加のファイルを取得する prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) のサブステップ。

パラメータ
context	IInvocationContext: 現在の呼び出し IInvocationContext。
configuration	IConfiguration: 実行するコマンドの IConfiguration。
args	String: コマンドライン引数。

戻り値
IFolderBuildInfo	追加のサンドボックス ファイル用にフェッチされたビルド。

例外
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	java.io.IOException
BuildRetrievalError
ConfigurationException
IOException

getTradefedSandboxEnvironment

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

コマンドライン引数に基づいて使用するサンドボックス環境 TF を返します。

パラメータ
context	IInvocationContext: 親の IInvocationContext。
nonVersionedConfig	IConfiguration: バージョニングされていないオブジェクトを表す IConfiguration。
args	String: コマンドライン引数。

戻り値
File	TF サンドボックス環境の jar を含む File ディレクトリ。

例外
Exception

getTradefedSandboxEnvironment

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

パラメータ
context	IInvocationContext
nonVersionedConfig	IConfiguration
logger	ITestLogger
args	String

戻り値
File

例外
Exception

prepareEnvironment

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

サンドボックスが適切に実行されるように環境を準備します。

パラメータ
context	IInvocationContext: 現在の呼び出し IInvocationContext。
configuration	IConfiguration: 実行するコマンドの IConfiguration。
listener	ITestInvocationListener: 最終結果をパイプ処理する現在の呼び出し ITestInvocationListener。

戻り値
Exception	失敗した場合は Exception。成功した場合は Null。

run

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

設定した環境でサンドボックスを実行します。

パラメータ
info	TestInformation: 呼び出しを説明する TestInformation
configuration	IConfiguration: 実行するコマンドの IConfiguration。
logger	ITestLogger: ログファイルを記録できる ITestLogger。

戻り値
CommandResult	サンドボックスの実行ステータスとログを含む CommandResult。

例外
Throwable

tearDown

public abstract void tearDown ()

変更された可能性のある状態、ファイル、環境をクリーンアップします。