ITestSuite
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
Kelas bersarang | |
---|---|
enum | ITestSuite.MultiDeviceModuleStrategy
|
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_METADATA_EXCLUDE_FILTER |
public static final String | MODULE_METADATA_INCLUDE_FILTER |
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_SYSTEM_STATUS_CHECKER |
public static final String | TOKEN_KEY
|
Konstruktor publik | |
---|---|
ITestSuite () |
Metode publik | |
---|---|
void | addModuleMetadataExcludeFilters ( MultiMap <String, String> filters) |
void | addModuleMetadataIncludeFilters ( MultiMap <String, String> filters) |
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 panggilan |
ITestLogger | getCurrentTestLogger () |
ITestDevice | getDevice () Dapatkan perangkat dalam pengujian. |
ModuleDefinition | getDirectModule () Mengembalikan |
IInvocationContext | getInvocationContext () Mengembalikan konteks pemanggilan. |
MultiMap <String, String> | getModuleMetadataIncludeFilters () |
final String | getRequestedAbi () Mengembalikan abi yang diminta dengan opsi -a atau --abi. |
getRequiredTokens ( TestInformation testInfo) Mengembalikan daftar token yang diperlukan oleh pengujian. | |
long | getRuntimeHint () Kembalikan waktu proses pengujian yang diharapkan dalam milidetik. |
File | getTestsDir () |
boolean | isSplitting () Mengembalikan nilai true jika kita saat ini berada di |
abstract | loadTests () Metode abstrak untuk memuat konfigurasi pengujian yang akan dijalankan. |
void | reportNotExecuted ( ITestInvocationListener listener, String message) Laporkan pengujian yang tidak dijalankan ke pendengar utama yang disediakan. |
void | reportNotExecuted ( ITestInvocationListener listener) Laporkan pengujian yang tidak dijalankan ke pendengar utama yang disediakan. |
final void | run ( TestInformation testInfo, ITestInvocationListener listener) Metode run generik untuk semua tes 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 test suite dalam mode kolektor saja, ini membutuhkan 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 | setInvocationContext ( IInvocationContext invocationContext) |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) Menyetel daftar |
void | setPrimaryAbiRun (boolean primaryAbiRun) Setel nilai mPrimaryAbiRun |
void | setShouldMakeDynamicModule (boolean dynamicModule) Saat melakukan sharding terdistribusi, kami tidak dapat memiliki ModuleDefinition yang membagikan tes di kumpulan jika tidak, sharding intra-modul tidak akan berfungsi, jadi kami mengizinkannya untuk menonaktifkannya. |
void | setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers) Menetapkan |
void | setTestLogger ( ITestLogger testLogger) Menyuntikkan instance |
split (Integer shardCountHint, TestInformation testInfo) Versi alternatif |
Metode yang dilindungi | |
---|---|
createModuleListeners () Mengembalikan daftar | |
boolean | filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude) Terapkan filter metadata ke konfigurasi dan lihat apakah konfigurasi harus dijalankan. |
boolean | filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners) Terapkan pemfilteran daftar putih Pelari, hapus semua pelari yang tidak masuk daftar putih. |
getAbisForBuildTargetArch () Kembalikan yang abis didukung oleh arsitektur target build Host. | |
getHostAbis () Mengembalikan mesin host abis. | |
void | setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy) |
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
MODULE_METADATA_EXCLUDE_FILTER
public static final String MODULE_METADATA_EXCLUDE_FILTER
MODULE_METADATA_INCLUDE_FILTER
public static final String MODULE_METADATA_INCLUDE_FILTER
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_SYSTEM_STATUS_CHECKER
public static final String SKIP_SYSTEM_STATUS_CHECKER
TOKEN_KEY
public static final String TOKEN_KEY
Konstruktor publik
ITestSuite
public ITestSuite ()
Metode publik
tambahkanModuleMetadataExcludeFilters
public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)
Parameter | |
---|---|
filters | MultiMap |
tambahkanModuleMetadataIncludeFilters
public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)
Parameter | |
---|---|
filters | MultiMap |
dapatkan Abis
publicgetAbis (ITestDevice device)
Mendapatkan kumpulan ABI yang didukung oleh pengujian Kompatibilitas AbiUtils.getAbisSupportedByCompatibility()
dan perangkat yang sedang diuji.
Parameter | |
---|---|
device | ITestDevice |
Kembali | |
---|---|
Kumpulan ABI untuk menjalankan tes pada |
Melempar | |
---|---|
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
Mengembalikan kemungkinan abis dari TestSuiteInfo.
Kembali | |
---|---|
getBuildInfo
public IBuildInfo getBuildInfo ()
Implementasi ITestSuite
mungkin memerlukan info build untuk memuat tes.
Kembali | |
---|---|
IBuildInfo |
getConfiguration
public final IConfiguration getConfiguration ()
Mengembalikan panggilan IConfiguration
.
Kembali | |
---|---|
IConfiguration |
dapatkanPerangkat
public ITestDevice getDevice ()
Dapatkan perangkat dalam pengujian.
Kembali | |
---|---|
ITestDevice | perangkat ITestDevice |
getDirectModule
public ModuleDefinition getDirectModule ()
Mengembalikan ModuleDefinition
untuk dieksekusi secara langsung, atau null jika belum ada (bila ITestSuite belum di-sharding).
Kembali | |
---|---|
ModuleDefinition |
dapatkanKonteksPemanggilan
public IInvocationContext getInvocationContext ()
Mengembalikan konteks pemanggilan.
Kembali | |
---|---|
IInvocationContext |
getModuleMetadataIncludeFilters
public MultiMap<String, String> getModuleMetadataIncludeFilters ()
Kembali | |
---|---|
MultiMap <String, String> |
dapatkanDimintaAbi
public final String getRequestedAbi ()
Mengembalikan abi yang diminta dengan opsi -a atau --abi.
Kembali | |
---|---|
String |
getRequiredTokens
publicgetRequiredTokens (TestInformation testInfo)
Mengembalikan daftar token yang diperlukan oleh pengujian. Mengembalikan null jika tidak ada dukungan token.
Parameter | |
---|---|
testInfo | TestInformation |
Kembali | |
---|---|
getRuntimeHint
public long getRuntimeHint ()
Kembalikan waktu proses pengujian yang diharapkan dalam milidetik. Waktu digunakan untuk memuat eksekusi sharded keseimbangan
Kembali | |
---|---|
long |
getTestsDir
public File getTestsDir ()
Kembali | |
---|---|
File |
adalah Memisahkan
public boolean isSplitting ()
Mengembalikan nilai true jika kita saat ini berada di IShardableTest.split(int)
.
Kembali | |
---|---|
boolean |
bebanTes
public abstractloadTests ()
Metode abstrak untuk memuat konfigurasi pengujian yang akan dijalankan. Setiap tes didefinisikan oleh IConfiguration
dan nama unik di mana ia akan melaporkan hasil.
Kembali | |
---|---|
reportNotExecuted
public void reportNotExecuted (ITestInvocationListener listener, String message)
Laporkan pengujian yang tidak dijalankan ke pendengar utama yang disediakan. Mereka harus dilaporkan sebagai 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 dieksekusi. |
reportNotExecuted
public void reportNotExecuted (ITestInvocationListener listener)
Laporkan pengujian yang tidak dijalankan ke pendengar utama yang disediakan. Mereka harus dilaporkan sebagai gagal dengan pesan NOT_EXECUTED_FAILURE
.
Parameter | |
---|---|
listener | ITestInvocationListener : pendengar utama tempat melaporkan hasil yang tidak dieksekusi. |
Lari
public final void run (TestInformation testInfo, ITestInvocationListener listener)
Metode run generik untuk semua tes yang dimuat dari loadTests()
.
Parameter | |
---|---|
testInfo | TestInformation : Objek TestInformation yang berisi informasi berguna untuk menjalankan tes. |
listener | ITestInvocationListener : ITestInvocationListener dari hasil tes |
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 test suite dalam mode kolektor saja, ini membutuhkan 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 untuk digunakan |
setDirectModul
public void setDirectModule (ModuleDefinition module)
Parameter | |
---|---|
module | ModuleDefinition |
setInvocationContext
public void setInvocationContext (IInvocationContext invocationContext)
Parameter | |
---|---|
invocationContext | IInvocationContext |
setMetricCollektor
public void setMetricCollectors (collectors)
Menyetel daftar IMetricCollector
s yang ditentukan untuk uji coba.
Parameter | |
---|---|
collectors |
setPrimaryAbiRun
public void setPrimaryAbiRun (boolean primaryAbiRun)
Setel nilai mPrimaryAbiRun
Parameter | |
---|---|
primaryAbiRun | boolean |
setShouldMakeDynamicModule
public void setShouldMakeDynamicModule (boolean dynamicModule)
Saat melakukan sharding terdistribusi, kami tidak dapat memiliki ModuleDefinition yang membagikan tes di kumpulan jika tidak, sharding intra-modul tidak akan berfungsi, jadi kami mengizinkannya untuk menonaktifkannya.
Parameter | |
---|---|
dynamicModule | boolean |
setSystemStatusChecker
public void setSystemStatusChecker (systemCheckers)
Menetapkan ISystemStatusChecker
s 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. Ini berguna jika hal-hal seperti perangkat atau informasi build perlu diakses selama sharding.
Parameter | |
---|---|
shardCountHint | Integer : jumlah pecahan yang dicoba. |
testInfo | TestInformation : Induk TestInformation |
Kembali | |
---|---|
kumpulan subtes yang akan dieksekusi secara terpisah atau null jika tes saat ini tidak dapat di-shardable |
Metode yang dilindungi
createModuleListeners
protectedcreateModuleListeners ()
Mengembalikan daftar ITestInvocationListener
yang berlaku untuk level ModuleListener
. Listener ini akan digunakan kembali untuk setiap modul, mereka tidak akan diinstansiasi ulang sehingga mereka tidak boleh mengasumsikan status internal.
Kembali | |
---|---|
filterByConfigMetadata
protected 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 termasuk filter |
exclude | MultiMap : metadata tidak termasuk filter |
Kembali | |
---|---|
boolean | Benar jika modul harus dijalankan, salah jika tidak. |
filterByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
Terapkan pemfilteran daftar putih Pelari, hapus semua pelari yang tidak masuk daftar putih. Jika konfigurasi memiliki beberapa runner, beberapa mungkin dihapus dan konfigurasi akan tetap berjalan.
Parameter | |
---|---|
config | IConfiguration : IConfiguration sedang dievaluasi. |
allowedRunners |
Kembali | |
---|---|
boolean | Benar jika modul konfigurasi diizinkan untuk dijalankan, salah jika tidak. |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
Kembalikan yang abis didukung oleh arsitektur target build Host. Diekspos untuk pengujian.
Kembali | |
---|---|
dapatkanHostAbis
protectedgetHostAbis ()
Mengembalikan mesin host abis.
Kembali | |
---|---|
setMultiDeviceStrategy
protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)
Parameter | |
---|---|
strategy | ITestSuite.MultiDeviceModuleStrategy |
harusModulBerjalan
protected boolean shouldModuleRun (ModuleDefinition module)
Parameter | |
---|---|
module | ModuleDefinition |
Kembali | |
---|---|
boolean |
Konten dan contoh kode di halaman ini tunduk pada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2022-11-07 UTC.