Suite ITest
public abstract class ITestSuite
extends Object
implements IRemoteTest , IDeviceTest , IBuildReceiver , ISystemStatusCheckerReceiver , IShardableTest , ITestCollector , IInvocationContextReceiver , IRuntimeHintProvider , IMetricCollectorReceiver , IConfigurationReceiver , IReportNotExecuted , ITokenRequest , ITestLoggerReceiver
java.lang.Objek | |
↳ | com.android.tradefed.testtype.suite.ITestSuite |
Kelas abstrak digunakan untuk menjalankan Test Suite. Kelas ini memberikan dasar bagaimana Suite akan dijalankan. Setiap implementasi dapat menentukan daftar pengujian melalui metode loadTests()
.
Ringkasan
Bidang | |
---|---|
public static final String | ABI_OPTION |
public static final String | ACTIVE_MAINLINE_PARAMETER_KEY |
public static final String | MAINLINE_PARAMETER_KEY |
public static final String | MODULE_CHECKER_POST |
public static final String | MODULE_CHECKER_PRE |
public static final String | MODULE_END_TIME |
public static final String | MODULE_METADATA_EXCLUDE_FILTER |
public static final String | MODULE_METADATA_INCLUDE_FILTER |
public static final String | MODULE_START_TIME |
public static final String | PARAMETER_KEY |
public static final String | PREPARER_WHITELIST |
public static final String | PRIMARY_ABI_RUN |
public static final String | RANDOM_SEED |
public static final String | RUNNER_WHITELIST |
public static final String | SKIP_HOST_ARCH_CHECK |
public static final String | SKIP_STAGING_ARTIFACTS |
public static final String | SKIP_SYSTEM_STATUS_CHECKER |
public static final String | TOKEN_KEY |
protected boolean | mRecoverDeviceByCvd
|
Konstruktor publik | |
---|---|
ITestSuite () |
Metode publik | |
---|---|
void | addModuleMetadataExcludeFilters ( MultiMap <String, String> filters) |
void | addModuleMetadataIncludeFilters ( MultiMap <String, String> filters) |
void | cleanUpSuiteSetup () Peluang untuk membersihkan semua hal yang diperlukan selama pengaturan suite tetapi tidak diperlukan untuk menjalankan pengujian. |
boolean | filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude) Terapkan filter metadata ke konfigurasi dan lihat apakah konfigurasi harus dijalankan. |
getAbis ( ITestDevice device) Mendapatkan kumpulan ABI yang didukung oleh pengujian Kompatibilitas | |
static | getAbisForBuildTargetArchFromSuite () Mengembalikan kemungkinan abis dari TestSuiteInfo. |
IBuildInfo | getBuildInfo () Implementasi |
final IConfiguration | getConfiguration () Mengembalikan pemanggilan |
ITestLogger | getCurrentTestLogger () |
ITestDevice | getDevice () Uji perangkat. |
ModuleDefinition | getDirectModule () Mengembalikan |
IInvocationContext | getInvocationContext () Mengembalikan konteks pemanggilan. |
MultiMap <String, String> | getModuleMetadataIncludeFilters () |
ITestSuite.MultiDeviceModuleStrategy | getMultiDeviceStrategy () |
final String | getRequestedAbi () Mengembalikan abi yang diminta dengan opsi -a atau --abi. |
getRequiredTokens ( TestInformation testInfo) Mengembalikan daftar token yang diperlukan oleh pengujian. | |
long | getRuntimeHint () Menampilkan perkiraan waktu proses pengujian dalam milidetik. |
File | getTestsDir () |
boolean | isSplitting () Mengembalikan nilai benar jika kita saat ini berada di |
abstract | loadTests () Metode abstrak untuk memuat konfigurasi pengujian yang akan dijalankan. |
void | reportNotExecuted ( ITestInvocationListener listener, String message) Laporkan tes yang tidak dijalankan ke pendengar utama yang disediakan. |
void | reportNotExecuted ( ITestInvocationListener listener) Laporkan tes yang tidak dijalankan ke pendengar utama yang disediakan. |
final void | run ( TestInformation testInfo, ITestInvocationListener listener) Metode eksekusi umum untuk semua pengujian yang dimuat dari |
void | setAbiName (String abiName) Tetapkan nilai mAbiName |
final void | setAbis ( abis) setAbis ( abis) |
void | setBuild ( IBuildInfo buildInfo) |
void | setCollectTestsOnly (boolean shouldCollectTest) Jalankan rangkaian pengujian dalam mode kolektor saja, ini memerlukan semua sub-tes untuk mengimplementasikan antarmuka ini juga. |
void | setConfiguration ( IConfiguration configuration) Menyuntikkan |
void | setDevice ( ITestDevice device) Suntikkan perangkat yang sedang diuji. |
void | setDirectModule ( ModuleDefinition module) |
void | setIntraModuleSharding (boolean intraModuleSharding) |
void | setInvocationContext ( IInvocationContext invocationContext) |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) Menetapkan daftar |
void | setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy) |
void | setPrimaryAbiRun (boolean primaryAbiRun) Tetapkan nilai mPrimaryAbiRun |
void | setShouldMakeDynamicModule (boolean dynamicModule) Saat melakukan sharding terdistribusi, kami tidak dapat memiliki ModuleDefinition yang membagikan pengujian dalam kumpulan jika tidak, sharding intra-modul tidak akan berfungsi, jadi kami mengizinkan untuk menonaktifkannya. |
void | setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers) Menyetel |
void | setTestLogger ( ITestLogger testLogger) Menyuntikkan instance |
split (Integer shardCountHint, TestInformation testInfo) Versi alternatif |
Metode yang dilindungi | |
---|---|
createModuleListeners () Mengembalikan daftar | |
boolean | filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners) Terapkan pemfilteran daftar putih Pelari, hapus pelari mana pun yang tidak masuk daftar putih. |
getAbisForBuildTargetArch () Kembalikan abis yang didukung oleh arsitektur target build Host. | |
getHostAbis () Mengembalikan mesin host abis. | |
boolean | shouldModuleRun ( ModuleDefinition module) |
Bidang
ABI_OPTION
public static final String ABI_OPTION
ACTIVE_MAINLINE_PARAMETER_KEY
public static final String ACTIVE_MAINLINE_PARAMETER_KEY
MAINLINE_PARAMETER_KEY
public static final String MAINLINE_PARAMETER_KEY
MODULE_CHECKER_POST
public static final String MODULE_CHECKER_POST
MODULE_CHECKER_PRE
public static final String MODULE_CHECKER_PRE
MODUL_END_TIME
public static final String MODULE_END_TIME
MODULE_METADATA_EXCLUDE_FILTER
public static final String MODULE_METADATA_EXCLUDE_FILTER
MODULE_METADATA_INCLUDE_FILTER
public static final String MODULE_METADATA_INCLUDE_FILTER
MODUL_START_TIME
public static final String MODULE_START_TIME
PARAMETER_KEY
public static final String PARAMETER_KEY
PREPARER_WHITELIST
public static final String PREPARER_WHITELIST
PRIMARY_ABI_RUN
public static final String PRIMARY_ABI_RUN
RANDOM_SEED
public static final String RANDOM_SEED
RUNNER_WHITELIST
public static final String RUNNER_WHITELIST
SKIP_HOST_ARCH_CHECK
public static final String SKIP_HOST_ARCH_CHECK
SKIP_STAGING_ARTIFACTS
public static final String SKIP_STAGING_ARTIFACTS
SKIP_SYSTEM_STATUS_CHECKER
public static final String SKIP_SYSTEM_STATUS_CHECKER
TOKEN_KEY
public static final String TOKEN_KEY
mRecoverDeviceByCvd
protected boolean mRecoverDeviceByCvd
Konstruktor publik
Suite ITest
public ITestSuite ()
Metode publik
addModuleMetadataExcludeFilters
public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)
Parameter | |
---|---|
filters | MultiMap |
addModuleMetadataIncludeFilters
public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)
Parameter | |
---|---|
filters | MultiMap |
cleanUpSuiteSetup
public void cleanUpSuiteSetup ()
Peluang untuk membersihkan semua hal yang diperlukan selama pengaturan suite tetapi tidak diperlukan untuk menjalankan pengujian.
filterByConfigMetadata
public boolean filterByConfigMetadata (IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)
Terapkan filter metadata ke konfigurasi dan lihat apakah konfigurasi harus dijalankan.
Parameter | |
---|---|
config | IConfiguration : IConfiguration sedang dievaluasi. |
include | MultiMap : metadata menyertakan filter |
exclude | MultiMap : filter pengecualian metadata |
Kembali | |
---|---|
boolean | Benar jika modul harus dijalankan, salah jika sebaliknya. |
dapatkanAbis
publicgetAbis (ITestDevice device)
Mendapatkan kumpulan ABI yang didukung oleh pengujian Kompatibilitas AbiUtils.getAbisSupportedByCompatibility()
dan perangkat yang diuji.
Parameter | |
---|---|
device | ITestDevice |
Kembali | |
---|---|
Kumpulan ABI untuk menjalankan pengujian |
Melempar | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
Mengembalikan kemungkinan abis dari TestSuiteInfo.
Kembali | |
---|---|
dapatkanBuildInfo
public IBuildInfo getBuildInfo ()
Implementasi ITestSuite
mungkin memerlukan info build untuk memuat pengujian.
Kembali | |
---|---|
IBuildInfo |
dapatkan Konfigurasi
public final IConfiguration getConfiguration ()
Mengembalikan pemanggilan IConfiguration
.
Kembali | |
---|---|
IConfiguration |
dapatkanDirectModule
public ModuleDefinition getDirectModule ()
Mengembalikan ModuleDefinition
untuk dieksekusi secara langsung, atau null jika belum ada (bila ITestSuite belum di-sharding).
Kembali | |
---|---|
ModuleDefinition |
getInvocationContext
public IInvocationContext getInvocationContext ()
Mengembalikan konteks pemanggilan.
Kembali | |
---|---|
IInvocationContext |
getModuleMetadataIncludeFilters
public MultiMap<String, String> getModuleMetadataIncludeFilters ()
Kembali | |
---|---|
MultiMap <String, String> |
getMultiDeviceStrategy
public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()
Kembali | |
---|---|
ITestSuite.MultiDeviceModuleStrategy |
dapatkan DimintaAbi
public final String getRequestedAbi ()
Mengembalikan abi yang diminta dengan opsi -a atau --abi.
Kembali | |
---|---|
String |
dapatkanToken yang Diperlukan
publicgetRequiredTokens (TestInformation testInfo)
Mengembalikan daftar token yang diperlukan oleh pengujian. Mengembalikan null jika tidak ada dukungan token.
Parameter | |
---|---|
testInfo | TestInformation |
Kembali | |
---|---|
dapatkan RuntimeHint
public long getRuntimeHint ()
Menampilkan perkiraan waktu proses pengujian dalam milidetik. Waktu digunakan untuk memuat keseimbangan eksekusi sharded
Kembali | |
---|---|
long |
dapatkanTestsDir
public File getTestsDir ()
Kembali | |
---|---|
File |
adalah Pemisahan
public boolean isSplitting ()
Mengembalikan nilai benar jika kita saat ini berada di IShardableTest.split(int)
.
Kembali | |
---|---|
boolean |
loadTests
public abstractloadTests ()
Metode abstrak untuk memuat konfigurasi pengujian yang akan dijalankan. Setiap pengujian ditentukan oleh IConfiguration
dan nama unik yang akan digunakan untuk melaporkan hasilnya.
Kembali | |
---|---|
laporanTidak Dieksekusi
public void reportNotExecuted (ITestInvocationListener listener, String message)
Laporkan tes yang tidak dijalankan ke pendengar utama yang disediakan. Mereka harus dilaporkan gagal dengan pesan NOT_EXECUTED_FAILURE
.
Parameter | |
---|---|
listener | ITestInvocationListener : pendengar utama tempat melaporkan hasil yang tidak dieksekusi. |
message | String : pesan yang akan dikaitkan dengan kegagalan yang tidak dijalankan. |
laporanTidak Dieksekusi
public void reportNotExecuted (ITestInvocationListener listener)
Laporkan tes yang tidak dijalankan ke pendengar utama yang disediakan. Mereka harus dilaporkan gagal dengan pesan NOT_EXECUTED_FAILURE
.
Parameter | |
---|---|
listener | ITestInvocationListener : pendengar utama tempat melaporkan hasil yang tidak dieksekusi. |
berlari
public final void run (TestInformation testInfo, ITestInvocationListener listener)
Metode eksekusi umum untuk semua pengujian yang dimuat dari loadTests()
.
Parameter | |
---|---|
testInfo | TestInformation : Objek TestInformation berisi informasi berguna untuk menjalankan pengujian. |
listener | ITestInvocationListener : ITestInvocationListener hasil pengujian |
Melempar | |
---|---|
DeviceNotAvailableException |
setAbiName
public void setAbiName (String abiName)
Tetapkan nilai mAbiName
Parameter | |
---|---|
abiName | String |
setAbis
public final void setAbis (abis)
Parameter | |
---|---|
abis |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Jalankan rangkaian pengujian dalam mode kolektor saja, ini memerlukan semua sub-tes untuk mengimplementasikan antarmuka ini juga.
setKonfigurasi
public void setConfiguration (IConfiguration configuration)
Menyuntikkan IConfiguration
yang digunakan.
Parameter | |
---|---|
configuration | IConfiguration |
setPerangkat
public void setDevice (ITestDevice device)
Suntikkan perangkat yang sedang diuji.
Parameter | |
---|---|
device | ITestDevice : ITestDevice yang akan digunakan |
setDirectModule
public void setDirectModule (ModuleDefinition module)
Parameter | |
---|---|
module | ModuleDefinition |
setIntraModuleSharding
public void setIntraModuleSharding (boolean intraModuleSharding)
Parameter | |
---|---|
intraModuleSharding | boolean |
setInvocationContext
public void setInvocationContext (IInvocationContext invocationContext)
Parameter | |
---|---|
invocationContext | IInvocationContext |
setMetricCollectors
public void setMetricCollectors (collectors)
Menetapkan daftar IMetricCollector
yang ditentukan untuk uji coba.
Parameter | |
---|---|
collectors |
setMultiDeviceStrategy
public void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)
Parameter | |
---|---|
strategy | ITestSuite.MultiDeviceModuleStrategy |
setPrimaryAbiRun
public void setPrimaryAbiRun (boolean primaryAbiRun)
Tetapkan nilai mPrimaryAbiRun
Parameter | |
---|---|
primaryAbiRun | boolean |
setShouldMakeDynamicModule
public void setShouldMakeDynamicModule (boolean dynamicModule)
Saat melakukan sharding terdistribusi, kami tidak dapat memiliki ModuleDefinition yang membagikan pengujian dalam kumpulan jika tidak, sharding intra-modul tidak akan berfungsi, jadi kami mengizinkan untuk menonaktifkannya.
Parameter | |
---|---|
dynamicModule | boolean |
setSystemStatusChecker
public void setSystemStatusChecker (systemCheckers)
Menyetel ISystemStatusChecker
dari konfigurasi untuk pengujian.
Parameter | |
---|---|
systemCheckers |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Menyuntikkan instance ITestLogger
Parameter | |
---|---|
testLogger | ITestLogger |
membelah
publicsplit (Integer shardCountHint, TestInformation testInfo)
Versi alternatif split(int)
yang juga menyediakan TestInformation
yang berisi info awal dari induk yang membuat pecahan. Hal ini berguna jika hal-hal seperti informasi perangkat atau build perlu diakses selama sharding.
Parameter | |
---|---|
shardCountHint | Integer : jumlah pecahan yang dicoba. |
testInfo | TestInformation : TestInformation induk |
Kembali | |
---|---|
kumpulan subtes yang akan dieksekusi secara terpisah atau null jika tes saat ini tidak dapat di-sharding |
Metode yang dilindungi
buatModuleListeners
protectedcreateModuleListeners ()
Mengembalikan daftar ITestInvocationListener
yang berlaku pada tingkat ModuleListener
. Listener ini akan digunakan kembali untuk setiap modul, mereka tidak akan dipakai ulang sehingga mereka tidak mengambil keadaan internal.
Kembali | |
---|---|
filterByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
Terapkan pemfilteran daftar putih Pelari, hapus pelari mana pun yang tidak masuk daftar putih. Jika suatu konfigurasi memiliki beberapa runner, beberapa mungkin akan dihapus dan konfigurasi akan tetap berjalan.
Parameter | |
---|---|
config | IConfiguration : IConfiguration sedang dievaluasi. |
allowedRunners |
Kembali | |
---|---|
boolean | Benar jika modul konfigurasi diizinkan berjalan, salah jika sebaliknya. |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
Kembalikan abis yang didukung oleh arsitektur target build Host. Terkena untuk pengujian.
Kembali | |
---|---|
dapatkan HostAbis
protectedgetHostAbis ()
Mengembalikan mesin host abis.
Kembali | |
---|---|
harusModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
Parameter | |
---|---|
module | ModuleDefinition |
Kembali | |
---|---|
boolean |