ITestSuite
public
abstract
class
ITestSuite
extends Object
implements
IRemoteTest,
IDeviceTest,
IBuildReceiver,
ISystemStatusCheckerReceiver,
IShardableTest,
ITestCollector,
IInvocationContextReceiver,
IRuntimeHintProvider,
IMetricCollectorReceiver,
IConfigurationReceiver,
IReportNotExecuted,
ITokenRequest,
ITestLoggerReceiver
java.lang.Object | |
↳ | com.android.tradefed.testtype.suite.ITestSuite |
Class abstrak yang digunakan untuk menjalankan Test Suite. Class ini memberikan dasar bagaimana Suite akan dijalankan.
Setiap implementasi dapat menentukan daftar pengujian melalui metode loadTests()
.
Ringkasan
Kolom | |
---|---|
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 |
REBOOT_BEFORE_TEST
|
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)
|
final
void
|
enableRebootBeforeTest()
Menyetel reboot-before-test ke true. |
|
getAbis(ITestDevice device)
Mendapatkan kumpulan ABI yang didukung oleh |
static
|
getAbisForBuildTargetArchFromSuite()
Menampilkan kemungkinan abis dari TestSuiteInfo. |
IBuildInfo
|
getBuildInfo()
Implementasi |
final
IConfiguration
|
getConfiguration()
Menampilkan pemanggilan |
ITestLogger
|
getCurrentTestLogger()
|
ITestDevice
|
getDevice()
Uji perangkat. |
ModuleDefinition
|
getDirectModule()
Menampilkan |
IInvocationContext
|
getInvocationContext()
Menampilkan konteks pemanggilan. |
final
String
|
getRequestedAbi()
Menampilkan abi yang diminta dengan opsi -a atau --abi. |
|
getRequiredTokens()
|
long
|
getRuntimeHint()
Menampilkan runtime pengujian yang diharapkan di dalam milidetik. |
File
|
getTestsDir()
|
boolean
|
isSplitting()
Menampilkan true (benar) jika saat ini kita 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 pemroses utama yang disediakan. |
void
|
reportNotExecuted(ITestInvocationListener listener)
Laporkan pengujian yang tidak dijalankan ke pemroses utama yang disediakan. |
final
void
|
run(TestInformation testInfo, ITestInvocationListener listener)
Metode run generik untuk semua pengujian yang dimuat dari |
void
|
setAbiName(String abiName)
Tetapkan nilai mAbiName |
final
void
|
setAbis(
|
void
|
setBuild(IBuildInfo buildInfo)
|
void
|
setCollectTestsOnly(boolean shouldCollectTest)
Jalankan paket pengujian dalam mode khusus kolektor, hal ini memerlukan semua sub-pengujian untuk mengimplementasikannya antarmuka pengguna. |
void
|
setConfiguration(IConfiguration configuration)
Memasukkan |
void
|
setDevice(ITestDevice device)
Memasukkan perangkat yang sedang diuji. |
void
|
setInvocationContext(IInvocationContext invocationContext)
|
void
|
setInvocationInjector(Injector injector)
Dapatkan Guice |
void
|
setMetricCollectors(
Menetapkan daftar |
void
|
setPrimaryAbiRun(boolean primaryAbiRun)
Menetapkan nilai mPrimaryAbiRun |
void
|
setShouldMakeDynamicModule(boolean dynamicModule)
Saat melakukan sharding terdistribusi, kita tidak dapat memiliki ModuleDefinition yang membagikan pengujian dalam kumpulan jika tidak, sharding intra-modul tidak akan berfungsi, jadi kami boleh menonaktifkannya. |
void
|
setSystemStatusChecker(
Menetapkan |
void
|
setTestLogger(ITestLogger testLogger)
|
|
split(Integer shardCountHint, TestInformation testInfo)
Versi alternatif |
Metode yang dilindungi | |
---|---|
|
createModuleListeners()
Menampilkan 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,
Terapkan pemfilteran daftar yang diizinkan Runner, hapus semua runner yang tidak diizinkan. |
|
getAbisForBuildTargetArch()
Menampilkan abis yang didukung oleh arsitektur target build Host. |
|
getHostAbis()
Menampilkan mesin host abis. |
boolean
|
shouldModuleRun(ModuleDefinition module)
|
Kolom
OPSI_ABI
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
{i>PARAMETER_KEY<i}
public static final String PARAMETER_KEY
DAFTAR_PREPARER_IZIN
public static final String PREPARER_WHITELIST
BERJALAN_ABI_UTAMA
public static final String PRIMARY_ABI_RUN
{i>RANDOM_SEED<i}
public static final String RANDOM_SEED
REBOOT_SEBELUM_PENGUJIAN
public static final String REBOOT_BEFORE_TEST
RUNNER_WHITELIST
public static final String RUNNER_WHITELIST
LEWATI_HOST_ARCH_CHECK
public static final String SKIP_HOST_ARCH_CHECK
SKIP_SYSTEM_STATUS_CHECKER
public static final String SKIP_SYSTEM_STATUS_CHECKER
KUNCI_TOKEN
public static final String TOKEN_KEY
Konstruktor publik
ITestSuite
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 |
{i>enableRebootBeforeTest<i}
public final void enableRebootBeforeTest ()
Menyetel reboot-before-test ke true.
GetAbis
publicgetAbis (ITestDevice device)
Mendapatkan kumpulan ABI yang didukung oleh AbiUtils.getAbisSupportedByCompatibility()
Pengujian kompatibilitas dan perangkat yang sedang diuji.
Parameter | |
---|---|
device |
ITestDevice |
Hasil | |
---|---|
|
Kumpulan ABI yang akan menjalankan pengujian |
Menampilkan | |
---|---|
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
Menampilkan kemungkinan abis dari TestSuiteInfo.
Hasil | |
---|---|
|
getBuildInfo
public IBuildInfo getBuildInfo ()
Implementasi ITestSuite
mungkin memerlukan info build untuk memuat pengujian.
Hasil | |
---|---|
IBuildInfo |
getConfiguration
public final IConfiguration getConfiguration ()
Menampilkan pemanggilan IConfiguration
.
Hasil | |
---|---|
IConfiguration |
getCurrentTestLogger
public ITestLogger getCurrentTestLogger ()
Hasil | |
---|---|
ITestLogger |
getDirectModule
public ModuleDefinition getDirectModule ()
Menampilkan ModuleDefinition
yang akan dieksekusi secara langsung, atau null jika belum ada (jika
ITestSuite belum di-sharding).
Hasil | |
---|---|
ModuleDefinition |
getInvocationContext
public IInvocationContext getInvocationContext ()
Menampilkan konteks pemanggilan.
Hasil | |
---|---|
IInvocationContext |
getRequestAbi
public final String getRequestedAbi ()
Menampilkan abi yang diminta dengan opsi -a atau --abi.
Hasil | |
---|---|
String |
getRequiredTokens
publicgetRequiredTokens ()
Hasil | |
---|---|
|
getRuntimeHint
public long getRuntimeHint ()
Menampilkan runtime pengujian yang diharapkan di dalam milidetik. Waktu yang digunakan untuk melakukan load balancing pada eksekusi yang di-sharding
Hasil | |
---|---|
long |
getTestsDir
public File getTestsDir ()
Hasil | |
---|---|
File |
Memisahkan
public boolean isSplitting ()
Menampilkan true (benar) jika saat ini kita berada di IShardableTest.split(int)
.
Hasil | |
---|---|
boolean |
loadTest
public abstractloadTests ()
Metode abstrak untuk memuat konfigurasi pengujian yang akan dijalankan. Setiap pengujian ditentukan oleh
IConfiguration
dan nama unik yang akan digunakan untuk melaporkan hasil.
Hasil | |
---|---|
|
reportNotExecuted
public void reportNotExecuted (ITestInvocationListener listener, String message)
Laporkan pengujian yang tidak dijalankan ke pemroses utama yang disediakan. Mereka harus dilaporkan sebagai
gagal dengan pesan NOT_EXECUTED_FAILURE
.
Parameter | |
---|---|
listener |
ITestInvocationListener : pemroses utama tempat melaporkan hasil yang tidak dijalankan. |
message |
String : pesan yang akan dikaitkan dengan kegagalan yang tidak dijalankan.
|
reportNotExecuted
public void reportNotExecuted (ITestInvocationListener listener)
Laporkan pengujian yang tidak dijalankan ke pemroses utama yang disediakan. Mereka harus dilaporkan sebagai
gagal dengan pesan NOT_EXECUTED_FAILURE
.
Parameter | |
---|---|
listener |
ITestInvocationListener : pemroses utama tempat melaporkan hasil yang tidak dijalankan.
|
lari
public final void run (TestInformation testInfo, ITestInvocationListener listener)
Metode run generik untuk semua pengujian yang dimuat dari loadTests()
.
Parameter | |
---|---|
testInfo |
TestInformation |
listener |
ITestInvocationListener |
Menampilkan | |
---|---|
DeviceNotAvailableException |
setAbiName
public void setAbiName (String abiName)
Tetapkan nilai mAbiName
Parameter | |
---|---|
abiName |
String |
SetAbis
public final void setAbis (abis)
Parameter | |
---|---|
abis |
|
setBuild
public void setBuild (IBuildInfo buildInfo)
Parameter | |
---|---|
buildInfo |
IBuildInfo |
Hanya setCollectTests
public void setCollectTestsOnly (boolean shouldCollectTest)
Jalankan paket pengujian dalam mode khusus kolektor, hal ini memerlukan semua sub-pengujian untuk mengimplementasikannya antarmuka pengguna.
setConfiguration
public void setConfiguration (IConfiguration configuration)
Memasukkan IConfiguration
yang digunakan.
Parameter | |
---|---|
configuration |
IConfiguration |
setelPerangkat
public void setDevice (ITestDevice device)
Memasukkan perangkat yang sedang diuji.
Parameter | |
---|---|
device |
ITestDevice : ITestDevice yang akan digunakan
|
{i>setInvocationContext<i}
public void setInvocationContext (IInvocationContext invocationContext)
Parameter | |
---|---|
invocationContext |
IInvocationContext |
setInvocationInjector
public void setInvocationInjector (Injector injector)
Dapatkan Guice Injector
saat ini dari panggilan. Ini akan memungkinkan
kita untuk melanjutkan
injeksi objek modul.
Parameter | |
---|---|
injector |
Injector |
setMetricCollectors
public void setMetricCollectors (collectors)
Menetapkan daftar IMetricCollector
yang ditentukan untuk pengujian.
Parameter | |
---|---|
collectors |
|
setPrimaryAbiRun
public void setPrimaryAbiRun (boolean primaryAbiRun)
Menetapkan nilai mPrimaryAbiRun
Parameter | |
---|---|
primaryAbiRun |
boolean |
setHarusMakeDynamicModule
public void setShouldMakeDynamicModule (boolean dynamicModule)
Saat melakukan sharding terdistribusi, kita tidak dapat memiliki ModuleDefinition yang membagikan pengujian dalam kumpulan jika tidak, sharding intra-modul tidak akan berfungsi, jadi kami boleh menonaktifkannya.
Parameter | |
---|---|
dynamicModule |
boolean |
setSystemStatusChecker
public void setSystemStatusChecker (systemCheckers)
Menetapkan ISystemStatusChecker
dari konfigurasi untuk pengujian.
Parameter | |
---|---|
systemCheckers |
|
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Parameter | |
---|---|
testLogger |
ITestLogger |
pisahkan
publicsplit (Integer shardCountHint, TestInformation testInfo)
Versi alternatif split(int)
yang juga menyediakan TestInformation
yang berisi info awal dari induk yang membuat shard. Akan berguna jika hal-hal seperti
informasi perangkat atau build perlu diakses selama sharding.
Parameter | |
---|---|
shardCountHint |
Integer : jumlah shard yang dicoba. |
testInfo |
TestInformation : Induk TestInformation |
Hasil | |
---|---|
|
kumpulan sub-pengujian yang akan dijalankan secara terpisah, atau null jika pengujian
saat ini tidak dapat di-sharding
|
Metode yang dilindungi
createModuleListeners
protectedcreateModuleListeners ()
Menampilkan daftar ITestInvocationListener
yang berlaku untuk ModuleListener
level organisasi. Pemroses ini akan digunakan kembali untuk setiap modul, dan tidak akan dibuat instance ulangnya, sehingga
mereka tidak boleh mengasumsikan status internal.
Hasil | |
---|---|
|
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 yang sedang dievaluasi. |
include |
MultiMap : metadata yang disertakan |
exclude |
MultiMap : filter pengecualian metadata |
Hasil | |
---|---|
boolean |
True jika modul harus berjalan, false jika tidak. |
filterByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
Terapkan pemfilteran daftar yang diizinkan Runner, hapus semua runner yang tidak diizinkan. Jika memiliki beberapa runner, beberapa mungkin dihapus dan konfigurasi akan tetap berjalan.
Parameter | |
---|---|
config |
IConfiguration : IConfiguration yang sedang dievaluasi. |
allowedRunners |
: Daftar runner saat ini yang diizinkan. |
Hasil | |
---|---|
boolean |
True jika modul konfigurasi boleh dijalankan, false jika tidak. |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
Menampilkan abis yang didukung oleh arsitektur target build Host. Terekspos untuk pengujian.
Hasil | |
---|---|
|
getHostAbis
protectedgetHostAbis ()
Menampilkan mesin host abis.
Hasil | |
---|---|
|
seharusnyaModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
Parameter | |
---|---|
module |
ModuleDefinition |
Hasil | |
---|---|
boolean |