ITestSuite

public abstract class ITestSuite
extends Object implements IBuildReceiver, IConfigurationReceiver, IDeviceTest, IInvocationContextReceiver, IMetricCollectorReceiver, IRemoteTest, IReportNotExecuted, IRuntimeHintProvider, IShardableTest, ISystemStatusCheckerReceiver, ITestCollector, ITestLoggerReceiver, ITokenRequest

java.lang.Object
   ↳ com.android.tradefed.testtype.suite.ITestSuite

Test paketi çalıştırmak için kullanılan soyut sınıf. Bu sınıf, paketin nasıl çalıştırılacağının temelini oluşturur. Her uygulama, loadTests() yöntemiyle test listesini tanımlayabilir.

Özet

Sabitler

String ABI_OPTION

String ACTIVE_MAINLINE_PARAMETER_KEY

String BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

String ENABLE_RESOLVE_SYM_LINKS

String MAINLINE_PARAMETER_KEY

String MODULE_CHECKER_POST

String MODULE_CHECKER_PRE

String MODULE_END_TIME

String MODULE_METADATA_EXCLUDE_FILTER

String MODULE_METADATA_INCLUDE_FILTER

String MODULE_START_TIME

String PARAMETER_KEY

String PREPARER_WHITELIST

String PRIMARY_ABI_RUN

String RANDOM_SEED

String RUNNER_WHITELIST

String SKIP_HOST_ARCH_CHECK

String SKIP_STAGING_ARTIFACTS

String SKIP_SYSTEM_STATUS_CHECKER

String STAGE_MODULE_ARTIFACTS

String TEST_TYPE_KEY

String TEST_TYPE_VALUE_PERFORMANCE

String TOKEN_KEY

Alanlar

protected boolean mEnableResolveSymlinks

protected boolean mRecoverDeviceByCvd

Herkese açık oluşturucular

ITestSuite()

Herkese açık yöntemler

void addModuleMetadataExcludeFilters(MultiMap<String, String> filters)
void addModuleMetadataIncludeFilters(MultiMap<String, String> filters)
void cleanUpSuiteSetup()

Paket kurulumu sırasında gerekli olan ancak testlerin çalıştırılması için gerekli olmayan tüm öğeleri temizleme fırsatı.

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ışmaması gerektiğini görün.

Set<IAbi> getAbis(ITestDevice device)

Hem uyumluluk testi AbiUtils.getAbisSupportedByCompatibility() hem de test edilen cihaz tarafından desteklenen ABI'ler grubunu alır.

static Set<String> getAbisForBuildTargetArchFromSuite()

TestSuiteInfo'dan olası abileri döndürür.

IBuildInfo getBuildInfo()

ITestSuite özelliğinin uygulanması için testlerin yüklenmesi amacıyla derleme bilgilerinin yüklenmesi gerekebilir.

final IConfiguration getConfiguration()

Çağrıyı IConfiguration döndürür.

ITestLogger getCurrentTestLogger()
ITestDevice getDevice()

Test edilecek cihazı alın.

ModuleDefinition getDirectModule()

Doğrudan yürütülecek ModuleDefinition değerini veya henüz yoksa boş değerini döndürür (ITestSuite henüz parçalanmamışsa).

boolean getIntraModuleSharding()
IInvocationContext getInvocationContext()

Çağrı bağlamını döndürür.

MultiMap<String, String> getModuleMetadataIncludeFilters()
ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy()
final String getRequestedAbi()

-a veya --abi seçeneğiyle istenen abi'yi döndürür.

Set<TokenProperty> getRequiredTokens(TestInformation testInfo)

Teste göre gerekli jetonların listesini döndürür.

long getRuntimeHint()

Testin beklenen çalışma süresini milisaniye cinsinden döndürür.

File getTestsDir()
boolean isRemoveModuleBuffering()
boolean isSplitting()

Şu anda IShardableTest.split(int) içinde bulunuyorsak true değerini döndürür.

abstract LinkedHashMap<String, IConfiguration> loadTests()

Çalıştırılacak test yapılandırmasını yüklemek için kullanılan soyut yöntem.

void reportNotExecuted(ITestInvocationListener listener, String message)

Çalıştırılmayan testleri, sağlanan ana dinleyiciye bildirin.

void reportNotExecuted(ITestInvocationListener listener)

Çalıştırılmayan testleri, sağlanan ana dinleyiciye bildirin.

final void run(TestInformation testInfo, ITestInvocationListener listener)

loadTests() konumundan yüklenen tüm testler için genel çalıştırma yöntemi.

void setAbiName(String abiName)

mAbiName değerini ayarlayın

final void setAbis(Set<IAbi> abis)
void setBuild(IBuildInfo buildInfo)

void setCollectTestsOnly(boolean shouldCollectTest)

Test paketini yalnızca toplayıcı modunda çalıştırın. Bunun için tüm alt testlerin de bu arayüzü uygulaması gerekir.

void setConfiguration(IConfiguration configuration)

Kullanımdaki IConfiguration örneğini ekler.

void setDevice(ITestDevice device)

Test edilen cihazı yerleştirin.

void setDirectModule(ModuleDefinition module)
void setInLocalRetry(boolean inLocalRetry)
void setIntraModuleSharding(boolean intraModuleSharding)
void setInvocationContext(IInvocationContext invocationContext)

void setMetricCollectors(List<IMetricCollector> collectors)

Test çalıştırması için tanımlanan IMetricCollector listesini ayarlar.

void setMultiDeviceStrategy(ITestSuite.MultiDeviceModuleStrategy strategy)
void setPrimaryAbiRun(boolean primaryAbiRun)

mPrimaryAbiRun değişkeninin değerini ayarlayın.

void setShouldMakeDynamicModule(boolean dynamicModule)

Dağıtılmış parçalama işlemi yaparken bir havuzda testleri paylaşan ModuleDefinition'a sahip olamayız. Aksi takdirde modüller arası parçalama çalışmaz. Bu nedenle, devre dışı bırakılmasına izin verilir.

void setSkipContext(SkipContext skipContext)
void setSystemStatusChecker(List<ISystemStatusChecker> systemCheckers)

Test için yapılandırmadan ISystemStatusChecker değerlerini ayarlar.

void setTestLogger(ITestLogger testLogger)

ITestLogger örneğini ekler.

Collection<IRemoteTest> split(Integer shardCountHint, TestInformation testInfo)

split(int) öğesinin alternatif sürümü. Bu sürüm, parçaları oluşturan üst öğeden alınan erken bilgileri içeren bir TestInformation de sağlar.

Korunan yöntemler

List<ITestInvocationListener> createModuleListeners()

ModuleListener düzeyine uygulanan ITestInvocationListener listesini döndürür.

boolean filterByRunnerType(IConfiguration config, Set<String> allowedRunners)

Çalıştırıcı beyaz liste filtrelemesini uygulayın ve beyaz listeye eklenmemiş tüm çalıştırıcıları kaldırın.

Set<String> getAbisForBuildTargetArch()

Ana makine derleme hedefi mimarisi tarafından desteklenen ABI'leri döndürür.

Set<String> getHostAbis()

Ana makinenin abilerini döndürür.

void setPrioritizeHostConfig(boolean prioritizeHostConfig)

prioritize-host-config seçeneğini ayarlayın.

boolean shouldModuleRun(ModuleDefinition module)

Sabitler

ABI_OPTION

public static final String ABI_OPTION

Sabit Değer: "abi"

ACTIVE_MAINLINE_PARAMETER_KEY

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

Sabit Değer: "active-mainline-parameter"

BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

Sabit Değer: "flag-overrides" 

public static final String ENABLE_RESOLVE_SYM_LINKS

Sabit Değer: "enable-resolve-sym-links"

MAINLINE_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

Sabit Değer: "mainline-param"

MODULE_CHECKER_POST

public static final String MODULE_CHECKER_POST

Sabit Değer: "PostModuleChecker"

MODULE_CHECKER_PRE

public static final String MODULE_CHECKER_PRE

Sabit Değer: "PreModuleChecker"

MODULE_END_TIME

public static final String MODULE_END_TIME

Sabit Değer: "MODULE_END_TIME"

MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

Sabit Değer: "module-metadata-exclude-filter"

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

Sabit Değer: "module-metadata-include-filter"

MODULE_START_TIME

public static final String MODULE_START_TIME

Sabit Değer: "MODULE_START_TIME"

PARAMETER_KEY

public static final String PARAMETER_KEY

Sabit Değer: "parameter"

PREPARER_WHITELIST

public static final String PREPARER_WHITELIST

Sabit Değer: "preparer-whitelist"

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

Sabit Değer: "primary-abi-only"

RANDOM_SEED

public static final String RANDOM_SEED

Sabit Değer: "random-seed"

RUNNER_WHITELIST

public static final String RUNNER_WHITELIST

Sabit Değer: "runner-whitelist"

SKIP_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

Sabit Değer: "skip-host-arch-check"

SKIP_STAGING_ARTIFACTS

public static final String SKIP_STAGING_ARTIFACTS

Sabit Değer: "skip-staging-artifacts"

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

Sabit Değer: "skip-system-status-check"

STAGE_MODULE_ARTIFACTS

public static final String STAGE_MODULE_ARTIFACTS

Sabit Değer: "stage-module-artifacts"

TEST_TYPE_KEY

public static final String TEST_TYPE_KEY

Sabit Değer: "test-type"

TEST_TYPE_VALUE_PERFORMANCE

public static final String TEST_TYPE_VALUE_PERFORMANCE

Sabit Değer: "performance"

TOKEN_KEY

public static final String TOKEN_KEY

Sabit Değer: "token"

Alanlar

protected boolean mEnableResolveSymlinks

mRecoverDeviceByCvd

protected boolean mRecoverDeviceByCvd

Herkese açık oluşturucular

ITestSuite

public ITestSuite ()

Herkese açık yöntemler

addModuleMetadataExcludeFilters

public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)

Parametreler
filters MultiMap

addModuleMetadataIncludeFilters

public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)

Parametreler
filters MultiMap

cleanUpSuiteSetup

public void cleanUpSuiteSetup ()

Paket kurulumu sırasında gerekli olan ancak testlerin çalıştırılması için gerekli olmayan tüm öğeleri temizleme fırsatı.

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ışmaması gerektiğini görün.

Parametreler
config IConfiguration: Değerlendirilen IConfiguration.
include MultiMap: Meta verilerde filtreleme
exclude MultiMap: Meta veri hariç tutma filtresi
İadeler
boolean Modülün çalışması gerekiyorsa doğru, aksi takdirde yanlış.

getAbis

public Set<IAbi> getAbis (ITestDevice device)

Hem uyumluluk testi AbiUtils.getAbisSupportedByCompatibility() hem de test edilen cihaz tarafından desteklenen ABI'ler grubunu alır.

Parametreler
device ITestDevice

İadeler
Set<IAbi> Testlerin üzerinde çalıştırılacağı ABI'ler kümesi
Verdiği hatalar
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static Set<String> getAbisForBuildTargetArchFromSuite ()

TestSuiteInfo'dan olası abis'leri döndürür.

İadeler
Set<String>

getBuildInfo

public IBuildInfo getBuildInfo ()

ITestSuite özelliğinin uygulanması için testlerin yüklenmesi amacıyla derleme bilgilerinin yüklenmesi gerekebilir.

İadeler
IBuildInfo

getConfiguration

public final IConfiguration getConfiguration ()

Çağrıyı IConfiguration döndürür.

İadeler
IConfiguration

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

İadeler
ITestLogger

getDevice

public ITestDevice getDevice ()

Test edilecek cihazı alın.

İadeler
ITestDevice ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

Doğrudan yürütülecek ModuleDefinition değerini veya henüz yoksa boş değerini döndürür (ITestSuite henüz parçalanmamışsa).

İadeler
ModuleDefinition

getIntraModuleSharding

public boolean getIntraModuleSharding ()

İadeler
boolean

getInvocationContext

public IInvocationContext getInvocationContext ()

Çağrı bağlamını döndürür.

İadeler
IInvocationContext

getModuleMetadataIncludeFilters

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

İadeler
MultiMap<String, String>

getMultiDeviceStrategy

public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()

İadeler
ITestSuite.MultiDeviceModuleStrategy

getRequestedAbi

public final String getRequestedAbi ()

-a veya --abi seçeneğiyle istenen abi'yi döndürür.

İadeler
String

getRequiredTokens

public Set<TokenProperty> getRequiredTokens (TestInformation testInfo)

Teste göre gerekli jetonların listesini döndürür. Jeton desteği yoksa null değerini döndürür.

Parametreler
testInfo TestInformation

İadeler
Set<TokenProperty>

getRuntimeHint

public long getRuntimeHint ()

Testin beklenen çalışma süresini milisaniye cinsinden döndürür. Bu süre, parçalanmış yürütmenin yükünü dengelemek için kullanılır.

İadeler
long

getTestsDir

public File getTestsDir ()

İadeler
File

Verdiği hatalar
FileNotFoundException

isRemoveModuleBuffering

public boolean isRemoveModuleBuffering ()

İadeler
boolean

isSplitting

public boolean isSplitting ()

Şu anda IShardableTest.split(int) içinde bulunuyorsak true değerini döndürür.

İadeler
boolean

loadTests

public abstract LinkedHashMap<String, IConfiguration> loadTests ()

Çalıştırılacak test yapılandırmasını yüklemek için kullanılan soyut yöntem. Her test bir IConfiguration ile tanımlanır ve sonuçları raporlayacağı benzersiz bir adı vardır.

İadeler
LinkedHashMap<String, IConfiguration>

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Çalıştırılmayan testleri, sağlanan ana dinleyiciye bildirin. Bu iletiler, NOT_EXECUTED_FAILURE mesajıyla birlikte başarısız olarak bildirilmelidir.

Parametreler
listener ITestInvocationListener: Yürütülmeyen sonuçların bildirileceği ana dinleyici.
message String: Yürütülmeyen hatayla ilişkilendirilecek mesaj.

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener)

Çalıştırılmayan testleri, sağlanan ana dinleyiciye bildirin. Bu iletiler, NOT_EXECUTED_FAILURE mesajıyla birlikte başarısız olarak bildirilmelidir.

Parametreler
listener ITestInvocationListener: Yürütülmeyen sonuçların bildirileceği ana dinleyici.

run

public final void run (TestInformation testInfo, 
                ITestInvocationListener listener)

loadTests() konumundan 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
Verdiği hatalar
DeviceNotAvailableException

setAbiName

public void setAbiName (String abiName)

mAbiName değerini ayarlayın

Parametreler
abiName String

setAbis

public final void setAbis (Set<IAbi> abis)

Parametreler
abis Set

setBuild

public void setBuild (IBuildInfo buildInfo)

Parametreler
buildInfo IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Test paketini yalnızca toplayıcı modunda çalıştırın. Bunun için tüm alt testlerin de bu arayüzü uygulaması gerekir.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Kullanımdaki IConfiguration örneğini ekler.

Parametreler
configuration IConfiguration

setDevice

public void setDevice (ITestDevice device)

Test edilen cihazı yerleştirin.

Parametreler
device ITestDevice: kullanılacak ITestDevice

setDirectModule

public void setDirectModule (ModuleDefinition module)

Parametreler
module ModuleDefinition

setInLocalRetry

public void setInLocalRetry (boolean inLocalRetry)

Parametreler
inLocalRetry boolean

setIntraModuleSharding

public void setIntraModuleSharding (boolean intraModuleSharding)

Parametreler
intraModuleSharding boolean

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

Parametreler
invocationContext IInvocationContext

setMetricCollectors

public void setMetricCollectors (List<IMetricCollector> collectors)

Test çalıştırması için tanımlanan IMetricCollector listesini ayarlar.

Parametreler
collectors List

setMultiDeviceStrategy

public void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

Parametreler
strategy ITestSuite.MultiDeviceModuleStrategy

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

mPrimaryAbiRun değişkeninin değerini ayarlayın.

Parametreler
primaryAbiRun boolean

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

Dağıtılmış parçalama işlemi yapılırken bir havuzda testleri paylaşan ModuleDefinition'a sahip olamayız. Aksi takdirde modüller arası parçalama çalışmaz. Bu nedenle, devre dışı bırakılmasına izin verilir.

Parametreler
dynamicModule boolean

setSkipContext

public void setSkipContext (SkipContext skipContext)

Parametreler
skipContext SkipContext

setSystemStatusChecker

public void setSystemStatusChecker (List<ISystemStatusChecker> systemCheckers)

Test için yapılandırmadan ISystemStatusChecker değerlerini ayarlar.

Parametreler
systemCheckers List

setTestLogger

public void setTestLogger (ITestLogger testLogger)

ITestLogger örneğini ekler.

Parametreler
testLogger ITestLogger

bölüşmek

public Collection<IRemoteTest> split (Integer shardCountHint, 
                TestInformation testInfo)

split(int) öğesinin alternatif sürümü. Bu sürüm, parçaları oluşturan üst öğeden alınan erken bilgileri içeren bir TestInformation de sağlar. Parçalama sırasında cihaz veya derleme bilgileri gibi öğelere erişilmesi gerektiğinde bu özellikten yararlanabilirsiniz.

Parametreler
shardCountHint Integer: denenmiş parça sayısı.
testInfo TestInformation: Üst öğe TestInformation
İadeler
Collection<IRemoteTest> ayrı ayrı yürütülecek bir alt test koleksiyonu veya test şu anda parçalanamıyorsa null

Korunan yöntemler

createModuleListeners

protected List<ITestInvocationListener> createModuleListeners ()

ModuleListener düzeyine uygulanan ITestInvocationListener listesini döndürür. Bu dinleyiciler her modül için yeniden kullanılacak, yeniden oluşturulmayacak. Bu nedenle, dahili bir durum varsaymamaları gerekir.

İadeler
List<ITestInvocationListener>

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                Set<String> allowedRunners)

Çalıştırıcı beyaz liste filtrelemesini uygulayın ve beyaz listeye eklenmemiş tüm çalıştırıcıları kaldırın. Bir yapılandırmada birden fazla koşucu varsa bazıları kaldırılabilir ve yapılandırma yine de çalışır.

Parametreler
config IConfiguration: Değerlendirilen IConfiguration.
allowedRunners Set: Mevcut koşucu beyaz listesi.
İadeler
boolean Yapılandırma modülünün çalışmasına izin veriliyorsa doğru, aksi takdirde yanlış.

getAbisForBuildTargetArch

protected Set<String> getAbisForBuildTargetArch ()

Ana makine derleme hedefi mimarisi tarafından desteklenen ABI'leri döndürür. Test için kullanıma sunulmuştur.

İadeler
Set<String>

getHostAbis

protected Set<String> getHostAbis ()

Ana makinenin abilerini döndürür.

İadeler
Set<String>

setPrioritizeHostConfig

protected void setPrioritizeHostConfig (boolean prioritizeHostConfig)

prioritize-host-config seçeneğini ayarlayın.

Parametreler
prioritizeHostConfig boolean: Ana makine yapılandırmasına öncelik vermek için true (yani mümkünse ana makine testini çalıştırın).

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

Parametreler
module ModuleDefinition

Return'ler
boolean