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 |
Test Suite'i çalıştırmak için kullanılan soyut sınıf. Bu sınıf, Suite'in nasıl çalıştırılacağının temelini sağlar. Her uygulama, loadTests()
yöntemi aracılığıyla testlerin listesini tanımlayabilir.
Özet
alanlar | |
---|---|
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_STAGING_ARTIFACTS |
public static final String | SKIP_SYSTEM_STATUS_CHECKER |
public static final String | TOKEN_KEY
|
kamu inşaatçılar | |
---|---|
ITestSuite () |
Genel yöntemler | |
---|---|
void | addModuleMetadataExcludeFilters ( MultiMap <String, String> filters) |
void | addModuleMetadataIncludeFilters ( MultiMap <String, String> filters) |
boolean | filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude) Yapılandırmaya meta veri filtresini uygulayın ve yapılandırmanın çalışıp çalışmayacağını görün. |
getAbis ( ITestDevice device) Hem Uyumluluk testi | |
static | getAbisForBuildTargetArchFromSuite () TestSuiteInfo'dan olası abis'i döndürür. |
IBuildInfo | getBuildInfo () |
final IConfiguration | getConfiguration () |
ITestLogger | getCurrentTestLogger () |
ITestDevice | getDevice () Cihazı teste alın. |
ModuleDefinition | getDirectModule () Doğrudan yürütülecek |
IInvocationContext | getInvocationContext () Çağırma bağlamını döndürür. |
MultiMap <String, String> | getModuleMetadataIncludeFilters () |
final String | getRequestedAbi () -a veya --abi seçeneğiyle talep edilen abi'yi döndürür. |
getRequiredTokens ( TestInformation testInfo) Test tarafından gerekli belirteçlerin listesini döndürür. | |
long | getRuntimeHint () Testin beklenen çalışma zamanını milisaniye cinsinden döndürür. |
File | getTestsDir () |
boolean | isSplitting () Şu anda |
abstract | loadTests () Çalıştırılacak test yapılandırmasını yüklemek için soyut yöntem. |
void | reportNotExecuted ( ITestInvocationListener listener, String message) Gerçekleştirilmeyen testleri sağlanan ana dinleyiciye bildirin. |
void | reportNotExecuted ( ITestInvocationListener listener) Gerçekleştirilmeyen testleri sağlanan ana dinleyiciye bildirin. |
final void | run ( TestInformation testInfo, ITestInvocationListener listener) |
void | setAbiName (String abiName) mAbiName değerini ayarlayın |
final void | setAbis ( abis) setAbis ( abis) |
void | setBuild ( IBuildInfo buildInfo) |
void | setCollectTestsOnly (boolean shouldCollectTest) Test paketini yalnızca toplayıcı modunda çalıştırın; bu, tüm alt testlerin de bu arabirimi uygulamasını gerektirir. |
void | setConfiguration ( IConfiguration configuration) Kullanımdaki |
void | setDevice ( ITestDevice device) Test edilen cihazı enjekte edin. |
void | setDirectModule ( ModuleDefinition module) |
void | setInvocationContext ( IInvocationContext invocationContext) |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) Test çalıştırması için tanımlanan |
void | setPrimaryAbiRun (boolean primaryAbiRun) mPrimaryAbiRun değerini ayarlayın |
void | setShouldMakeDynamicModule (boolean dynamicModule) Dağıtılmış sharding yaparken bir havuzda testleri paylaşan ModuleDefinition'a sahip olamayız, aksi takdirde modül içi sharding çalışmayacaktır, bu yüzden devre dışı bırakmaya izin veriyoruz. |
void | setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers) Test için yapılandırmadan |
void | setTestLogger ( ITestLogger testLogger) |
split (Integer shardCountHint, TestInformation testInfo) Kırıkları oluşturan üst öğeden erken bilgi içeren bir |
Korumalı yöntemler | |
---|---|
createModuleListeners () | |
boolean | filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners) Beyaz listede olmayan herhangi bir koşucuyu kaldırarak Runner beyaz listesi filtrelemesini uygulayın. |
getAbisForBuildTargetArch () Host yapı hedef mimarisi tarafından desteklenen abis'i döndürün. | |
getHostAbis () Ana makine abisini döndürür. | |
void | setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy) |
boolean | shouldModuleRun ( ModuleDefinition module) |
alanlar
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
HAZIRLAYICI_BEYAZ LİSTE
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
kamu inşaatçılar
ITestSuite
public ITestSuite ()
Genel yöntemler
addModuleMetadataExcludeFilters
public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)
parametreler | |
---|---|
filters | MultiMap |
addModuleMetadataIncludeFilters
public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)
parametreler | |
---|---|
filters | MultiMap |
filterByConfigMetadata
public boolean filterByConfigMetadata (IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)
Yapılandırmaya meta veri filtresini uygulayın ve yapılandırmanın çalışıp çalışmayacağını görün.
parametreler | |
---|---|
config | IConfiguration : Değerlendirilen IConfiguration . |
include | MultiMap : meta veri içerme filtresi |
exclude | MultiMap : meta veri dışlama filtresi |
İadeler | |
---|---|
boolean | Modülün çalışması gerekiyorsa true, aksi takdirde false. |
alabis
publicgetAbis (ITestDevice device)
Hem Uyumluluk testi AbiUtils.getAbisSupportedByCompatibility()
hem de test edilen cihaz tarafından desteklenen ABI kümesini alır.
parametreler | |
---|---|
device | ITestDevice |
İadeler | |
---|---|
Testleri çalıştırmak için ABI seti |
Atar | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
TestSuiteInfo'dan olası abis'i döndürür.
İadeler | |
---|---|
getBuildInfo
public IBuildInfo getBuildInfo ()
ITestSuite
uygulaması, testleri yüklemek için derleme bilgisi gerektirebilir.
İadeler | |
---|---|
IBuildInfo |
getConfiguration
public final IConfiguration getConfiguration ()
IConfiguration
çağrısını döndürür.
İadeler | |
---|---|
IConfiguration |
getDirectModule
public ModuleDefinition getDirectModule ()
Doğrudan yürütülecek ModuleDefinition
değerini veya henüz hiçbiri yoksa null değerini döndürür (ITestSuite henüz parçalanmadığında).
İadeler | |
---|---|
ModuleDefinition |
getInvocationContext
public IInvocationContext getInvocationContext ()
Çağırma bağlamını döndürür.
İadeler | |
---|---|
IInvocationContext |
getModuleMetadataIncludeFilters
public MultiMap<String, String> getModuleMetadataIncludeFilters ()
İadeler | |
---|---|
MultiMap <String, String> |
getRequestedAbi
public final String getRequestedAbi ()
-a veya --abi seçeneğiyle talep edilen abi'yi döndürür.
İadeler | |
---|---|
String |
getRequiredTokens
publicgetRequiredTokens (TestInformation testInfo)
Test tarafından gerekli belirteçlerin listesini döndürür. Belirteç desteği yoksa null döndürür.
parametreler | |
---|---|
testInfo | TestInformation |
İadeler | |
---|---|
getRuntimeHint
public long getRuntimeHint ()
Testin beklenen çalışma zamanını milisaniye cinsinden döndürür. Süre, parçalanmış yürütmeyi dengelemek için kullanılır
İadeler | |
---|---|
long |
getTestsDir
public File getTestsDir ()
İadeler | |
---|---|
File |
isBölme
public boolean isSplitting ()
Şu anda IShardableTest.split(int)
içindeysek true değerini döndürür.
İadeler | |
---|---|
boolean |
yük testleri
public abstractloadTests ()
Çalıştırılacak test yapılandırmasını yüklemek için soyut yöntem. Her test, bir IConfiguration
ve altında sonuçları raporlayacağı benzersiz bir adla tanımlanır.
İadeler | |
---|---|
raporYürütülemedi
public void reportNotExecuted (ITestInvocationListener listener, String message)
Gerçekleştirilmeyen testleri sağlanan ana dinleyiciye bildirin. NOT_EXECUTED_FAILURE
mesajı ile başarısız olarak bildirilmelidirler.
parametreler | |
---|---|
listener | ITestInvocationListener : yürütülmeyen sonuçların bildirileceği ana dinleyici. |
message | String : yürütülmeyen hatayla ilişkilendirilecek mesaj. |
raporYürütülemedi
public void reportNotExecuted (ITestInvocationListener listener)
Gerçekleştirilmeyen testleri sağlanan ana dinleyiciye bildirin. NOT_EXECUTED_FAILURE
mesajı ile başarısız olarak bildirilmelidirler.
parametreler | |
---|---|
listener | ITestInvocationListener : yürütülmeyen sonuçların bildirileceği ana dinleyici. |
koşmak
public final void run (TestInformation testInfo, ITestInvocationListener listener)
loadTests()
ten yüklenen tüm testler için genel çalıştırma yöntemi.
parametreler | |
---|---|
testInfo | TestInformation : Testleri çalıştırmak için yararlı bilgiler içeren TestInformation nesnesi. |
listener | ITestInvocationListener : test sonuçlarının ITestInvocationListener |
Atar | |
---|---|
DeviceNotAvailableException |
setAbiName
public void setAbiName (String abiName)
mAbiName değerini ayarlayın
parametreler | |
---|---|
abiName | String |
setAbis
public final void setAbis (abis)
parametreler | |
---|---|
abis |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Test paketini yalnızca toplayıcı modunda çalıştırın; bu, tüm alt testlerin de bu arabirimi uygulamasını gerektirir.
setConfiguration
public void setConfiguration (IConfiguration configuration)
Kullanımdaki IConfiguration
enjekte eder.
parametreler | |
---|---|
configuration | IConfiguration |
setCihaz
public void setDevice (ITestDevice device)
Test edilen cihazı enjekte edin.
parametreler | |
---|---|
device | ITestDevice : kullanılacak ITestDevice |
setDirectModule
public void setDirectModule (ModuleDefinition module)
parametreler | |
---|---|
module | ModuleDefinition |
setInvocationContext
public void setInvocationContext (IInvocationContext invocationContext)
parametreler | |
---|---|
invocationContext | IInvocationContext |
setMetricToplayıcılar
public void setMetricCollectors (collectors)
Test çalıştırması için tanımlanan IMetricCollector
s listesini ayarlar.
parametreler | |
---|---|
collectors |
setPrimaryAbiRun
public void setPrimaryAbiRun (boolean primaryAbiRun)
mPrimaryAbiRun değerini ayarlayın
parametreler | |
---|---|
primaryAbiRun | boolean |
setShouldMakeDynamicModule
public void setShouldMakeDynamicModule (boolean dynamicModule)
Dağıtılmış sharding yaparken bir havuzda testleri paylaşan ModuleDefinition'a sahip olamayız, aksi takdirde modül içi sharding çalışmayacaktır, bu yüzden devre dışı bırakmaya izin veriyoruz.
parametreler | |
---|---|
dynamicModule | boolean |
setSystemStatusChecker
public void setSystemStatusChecker (systemCheckers)
Test için yapılandırmadan ISystemStatusChecker
s'yi ayarlar.
parametreler | |
---|---|
systemCheckers |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
ITestLogger
örneğini enjekte eder
parametreler | |
---|---|
testLogger | ITestLogger |
bölmek
publicsplit (Integer shardCountHint, TestInformation testInfo)
Kırıkları oluşturan üst öğeden erken bilgi içeren bir TestInformation
sağlayan alternatif split(int)
sürümü. Parçalama sırasında cihaz veya yapı bilgileri gibi şeylere erişilmesi gerekiyorsa kullanışlıdır.
parametreler | |
---|---|
shardCountHint | Integer : denenen kırık sayısı. |
testInfo | TestInformation : Üst TestInformation |
İadeler | |
---|---|
ayrı olarak yürütülecek bir alt testler koleksiyonu veya test şu anda parçalanabilir değilse null |
Korumalı yöntemler
createModuleListener'lar
protectedcreateModuleListeners ()
ModuleListener
düzeyine uygulanabilir ITestInvocationListener
listesini döndürür. Bu dinleyiciler her modül için yeniden kullanılacaktır, yeniden somutlaştırılmayacaktır, bu nedenle dahili bir durum almamaları gerekir.
İadeler | |
---|---|
filterByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
Beyaz listede olmayan herhangi bir koşucuyu kaldırarak Runner beyaz listesi filtrelemesini uygulayın. Bir yapılandırmanın birkaç çalıştırıcısı varsa, bazıları kaldırılabilir ve yapılandırma çalışmaya devam eder.
parametreler | |
---|---|
config | IConfiguration : Değerlendirilen IConfiguration . |
allowedRunners |
İadeler | |
---|---|
boolean | Yapılandırma modülünün çalışmasına izin verilirse true, aksi takdirde false olur. |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
Host yapı hedef mimarisi tarafından desteklenen abis'i döndürün. Test için sergilendi.
İadeler | |
---|---|
getHostAbis
protectedgetHostAbis ()
Ana makine abisini döndürür.
İadeler | |
---|---|
setMultiDeviceStrateji
protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)
parametreler | |
---|---|
strategy | ITestSuite.MultiDeviceModuleStrategy |
gerekirModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
parametreler | |
---|---|
module | ModuleDefinition |
İadeler | |
---|---|
boolean |