ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


Antarmuka yang menentukan sandbox yang dapat digunakan untuk menjalankan pemanggilan.

Ringkasan

Metode publik

abstract String createClasspath(File workingDir)

Buat classpath berdasarkan lingkungan dan direktori kerja yang ditampilkan oleh getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]).

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

Mode khusus terputus dari operasi utama: Saat konfigurasi tampaknya tidak ada di induk, kita kembali ke peluncur tipis tempat kita mencoba menyiapkan sandbox dengan informasi yang diketahui dan mengisi direktori kerja untuk membuat konfigurasi sepenuhnya di berversi.

default discoverTests(IInvocationContext context, IConfiguration configuration)

Sub-langkah dari prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) yang menemukan pengujian apakah SandboxOptions.shouldUseTestDiscovery() diaktifkan.

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

Sub-langkah dari prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) yang mengambil file tambahan yang diperlukan untuk sandbox.

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

Menampilkan TF lingkungan sandbox yang akan digunakan berdasarkan argumen command line.

default File getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)
abstract Exception prepareEnvironment(IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)

Siapkan lingkungan agar sandbox berjalan dengan baik.

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

Jalankan sandbox dengan lingkungan yang telah ditetapkan.

abstract void tearDown()

Bersihkan status, file, atau lingkungan apa pun yang mungkin telah berubah.

Metode publik

createClasspath

public abstract String createClasspath (File workingDir)

Buat classpath berdasarkan lingkungan dan direktori kerja yang ditampilkan oleh getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]).

Parameter
workingDir File: direktori kerja saat ini untuk sandbox.

Hasil
String Classpath yang akan digunakan.

Menampilkan
ConfigurationException

createThinLauncherConfig

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

Mode khusus terputus dari operasi utama: Saat konfigurasi tampaknya tidak ada di induk, kita kembali ke peluncur tipis tempat kita mencoba menyiapkan sandbox dengan informasi yang diketahui dan mengisi direktori kerja untuk membuat konfigurasi sepenuhnya di berversi.

Parameter
args String: argumen command line asli.

keyStoreClient IKeyStoreClient: klien keystore saat ini yang akan digunakan untuk membuat konfigurasi.

runUtil IRunUtil: IRunUtil saat ini untuk menjalankan perintah host.

globalConfig File: Konfigurasi global yang akan digunakan untuk menjalankan subproses TF.

Hasil
IConfiguration File yang mengarah ke XML konfigurasi TF untuk objek NON_VERSIONED. Hasil null jika tidak ada konfigurasi peluncur tipis yang dapat dibuat.

findTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Sub-langkah dari prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) yang menemukan pengujian apakah SandboxOptions.shouldUseTestDiscovery() diaktifkan.

Parameter
context IInvocationContext: pemanggilan IInvocationContext saat ini.

configuration IConfiguration: IConfiguration untuk menjalankan perintah.

Hasil
Peta pengujian yang ditemukan atau null jika tidak didukung atau gagal.

findTests

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

Parameter
context IInvocationContext

configuration IConfiguration

logger ITestLogger

Hasil

pengambilanSandboxExtraArtifacts

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

Sub-langkah dari prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) yang mengambil file tambahan yang diperlukan untuk sandbox.

Parameter
context IInvocationContext: pemanggilan IInvocationContext saat ini.

configuration IConfiguration: IConfiguration untuk menjalankan perintah.

args String: argumen command line.

Hasil
IFolderBuildInfo build yang diambil untuk file tambahan dalam sandbox.

Menampilkan
com.android.tradefed.build.BuildRetrievalError
com.android.tradefed.config.ConfigurationException
IOException
BuildRetrievalError
ConfigurationException

getTradefedSandboxLingkungan

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

Menampilkan TF lingkungan sandbox yang akan digunakan berdasarkan argumen command line.

Parameter
context IInvocationContext: IInvocationContext dari induk.

nonVersionedConfig IConfiguration: IConfiguration yang mewakili objek tanpa versi.

args String: argumen command line.

Hasil
File direktori ERROR(/File) yang berisi jar lingkungan sandbox TF.

getTradefedSandboxLingkungan

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

Parameter
context IInvocationContext

nonVersionedConfig IConfiguration

logger ITestLogger

args String

Hasil
File

prepareLingkungan

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

Siapkan lingkungan agar sandbox berjalan dengan baik.

Parameter
context IInvocationContext: pemanggilan IInvocationContext saat ini.

configuration IConfiguration: IConfiguration untuk menjalankan perintah.

listener ITestInvocationListener: pemanggilan ITestInvocationListener saat ini, dengan hasil akhir harus di-pipe.

Hasil
Exception Exception yang berisi kegagalan. atau Null jika berhasil.

lari

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

Jalankan sandbox dengan lingkungan yang telah ditetapkan.

Parameter
info TestInformation: TestInformation yang menjelaskan panggilan

configuration IConfiguration: IConfiguration untuk menjalankan perintah.

logger ITestLogger: ITestLogger tempat kita dapat mencatat file.

Hasil
CommandResult CommandResult dengan status operasi dan log sandbox.

pembongkaran

public abstract void tearDown ()

Bersihkan status, file, atau lingkungan apa pun yang mungkin telah berubah.