サンドボックス

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)

特別なモードがメイン実行から切断: 構成が存在しない場合 シン ランチャーにフォールバックして、現在使用中のサンドボックスを 作業ディレクトリに格納して、構成ファイルを ディレクトリを作成します。

default discoverTests(IInvocationContext context, IConfiguration configuration)

prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) のサブステップ。SandboxOptions.shouldUseTestDiscovery() が有効になっているかどうかテストを検出します。

default discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)
default IFolderBuildInfo fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)

prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.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(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。

DiscoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) のサブステップ。SandboxOptions.shouldUseTestDiscovery() が有効になっているかどうかテストを検出します。

パラメータ
context IInvocationContext: 現在の呼び出し IInvocationContext

configuration IConfiguration: コマンドを実行する IConfiguration

戻り値
検出されたテストのマップ。サポートされていないか失敗した場合は null。

DiscoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

パラメータ
context IInvocationContext

configuration IConfiguration

logger ITestLogger

戻り値

fetchSandboxExtraArtifacts

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

prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) のサブステップ。サンドボックスに必要な追加のファイルを取得します。

パラメータ
context IInvocationContext: 現在の呼び出し IInvocationContext

configuration IConfiguration: コマンドを実行する IConfiguration

args String: コマンドライン引数。

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

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

getTradefedSandboxEnvironment

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

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

パラメータ
context IInvocationContext: 親の IInvocationContext

nonVersionedConfig IConfiguration: バージョニングされていないオブジェクトを表す IConfiguration

args String: コマンドライン引数。

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

getTradefedSandboxEnvironment

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

パラメータ
context IInvocationContext

nonVersionedConfig IConfiguration

logger ITestLogger

args String

戻り値
File

prepareEnvironment

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 ()

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