2026'dan itibaren, kararlı ana geliştirme modelimizle uyumlu olmak ve ekosistem için platform kararlılığını sağlamak amacıyla kaynak kodunu 2. ve 4. çeyreklerde AOSP'de yayınlayacağız. AOSP'yi oluşturmak ve AOSP'ye katkıda bulunmak için aosp-main yerine android-latest-release kullanmanızı öneririz. android-latest-release manifest dalı her zaman AOSP'ye gönderilen en son sürümü referans alır. Daha fazla bilgi için AOSP'de yapılan değişiklikler başlıklı makaleye bakın.

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

Bilinen doğrudan alt sınıflar

BaseTestSuite, TfSuiteRunner

BaseTestSuite	Yeni paket sistemiyle Uyumluluk Test Paketi'ni çalıştırma testi.
TfSuiteRunner	`ITestSuite` uygulanarak TF jar'larındaki res/config/suite/ klasöründen testler yüklenir.

Bilinen dolaylı alt sınıflar

AtestRunner, TestMappingSuiteRunner

AtestRunner	`ITestSuite` uygulanması
TestMappingSuiteRunner	`BaseTestSuite`, include-filter seçeneğiyle belirtilen testleri veya derlemeden gelen TEST_MAPPING dosyalarını bir paket olarak çalıştırmak için uygulanır.

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`

Fields'ın oynadığı filmler
`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)` Meta veri filtresini yapılandırmaya uygulayın ve yapılandırmanın çalışıp çalışmaması gerektiğini görün.
	`getAbis(ITestDevice device)` Hem uyumluluk testi `AbiUtils.getAbisSupportedByCompatibility()` hem de test edilen cihaz tarafından desteklenen ABI'ler kümesini alır.
`static`	`getAbisForBuildTargetArchFromSuite()` TestSuiteInfo'dan olası ABI'leri 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ğırmayı `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ğırma 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.
	`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)` konumundaysak doğru değerini döndürür.
`abstract`	`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( 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`'ı ekler.
`void`	`setDevice(ITestDevice device)` Test edilen cihazı yerleştirin.
`void`	`setDirectModule(ModuleDefinition module)`
`void`	`setIntraModuleSharding(boolean intraModuleSharding)`
`void`	`setInvocationContext(IInvocationContext invocationContext)`
`void`	`setMetricCollectors( collectors)` Test çalıştırması için tanımlanan `IMetricCollector` listesini ayarlar.
`void`	`setMultiDeviceStrategy(ITestSuite.MultiDeviceModuleStrategy strategy)`
`void`	`setPrimaryAbiRun(boolean primaryAbiRun)` mPrimaryAbiRun 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( systemCheckers)` Test için yapılandırmadan `ISystemStatusChecker` değerlerini ayarlar.
`void`	`setTestLogger(ITestLogger testLogger)` `ITestLogger` örneğini yerleştirir.
	`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
	`createModuleListeners()` `ModuleListener` düzeyine uygulanan `ITestInvocationListener` listesini döndürür.
`boolean`	`filterByRunnerType(IConfiguration config, allowedRunners)` Çalıştırıcı beyaz liste filtresini uygulayın ve beyaz listeye eklenmemiş tüm çalıştırıcıları kaldırın.
	`getAbisForBuildTargetArch()` Ana makine derleme hedefi mimarisi tarafından desteklenen abi'leri döndürür.
	`getHostAbis()` Ana makinenin abis'ini 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"

ENABLE_RESOLVE_SYM_LINKS

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"

Fields'ın oynadığı filmler

mEnableResolveSymlinks

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)

Meta veri filtresini yapılandırmaya 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

İlerlemeler
`boolean`	Modülün çalışması gerekiyorsa doğru, aksi takdirde yanlış.

getAbis

public  getAbis (ITestDevice device)

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

Parametreler
`device`	`ITestDevice`

İlerlemeler
	Testlerin üzerinde çalıştırılacağı ABI'ler kümesi

Dekoratif yastıklar
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

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

İlerlemeler

getBuildInfo

public IBuildInfo getBuildInfo ()

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

İlerlemeler
`IBuildInfo`

getConfiguration

public final IConfiguration getConfiguration ()

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

İlerlemeler
`IConfiguration`

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

İlerlemeler
`ITestLogger`

getDevice

public ITestDevice getDevice ()

Test edilecek cihazı alın.

İlerlemeler
`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).

İlerlemeler
`ModuleDefinition`

getIntraModuleSharding

public boolean getIntraModuleSharding ()

İlerlemeler
`boolean`

getInvocationContext

public IInvocationContext getInvocationContext ()

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

İlerlemeler
`IInvocationContext`

getModuleMetadataIncludeFilters

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

İlerlemeler
`MultiMap<String, String>`

getMultiDeviceStrategy

public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()

İlerlemeler
`ITestSuite.MultiDeviceModuleStrategy`

getRequestedAbi

public final String getRequestedAbi ()

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

İlerlemeler
`String`

getRequiredTokens

public  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`

İlerlemeler

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.

İlerlemeler
`long`

getTestsDir

public File getTestsDir ()

İlerlemeler
`File`

isRemoveModuleBuffering

public boolean isRemoveModuleBuffering ()

İlerlemeler
`boolean`

isSplitting

public boolean isSplitting ()

Şu anda IShardableTest.split(int) konumundaysak doğru değerini döndürür.

İlerlemeler
`boolean`

loadTests

public abstract  loadTests ()

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

İlerlemeler

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`: Çalıştırılmayan 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.

çalıştır

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`

Dekoratif yastıklar
`DeviceNotAvailableException`

setAbiName

public void setAbiName (String abiName)

mAbiName değerini ayarlayın

Parametreler
`abiName`	`String`

setAbis

public final void setAbis ( abis)

Parametreler
`abis`

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'ı 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`

setIntraModuleSharding

public void setIntraModuleSharding (boolean intraModuleSharding)

Parametreler
`intraModuleSharding`	`boolean`

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

Parametreler
`invocationContext`	`IInvocationContext`

setMetricCollectors

public void setMetricCollectors ( collectors)

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

Parametreler
`collectors`

setMultiDeviceStrategy

public void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

Parametreler
`strategy`	`ITestSuite.MultiDeviceModuleStrategy`

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

mPrimaryAbiRun değerini ayarlayın.

Parametreler
`primaryAbiRun`	`boolean`

setShouldMakeDynamicModule

public 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.

Parametreler
`dynamicModule`	`boolean`

setSkipContext

public void setSkipContext (SkipContext skipContext)

Parametreler
`skipContext`	`SkipContext`

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

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

Parametreler
`systemCheckers`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

ITestLogger örneğini yerleştirir.

Parametreler
`testLogger`	`ITestLogger`

ayır

public  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 özellik kullanışlıdır.

Parametreler
`shardCountHint`	`Integer`: denenmiş parça sayısı.
`testInfo`	`TestInformation`: Üst `TestInformation`

İlerlemeler
	ayrı ayrı yürütülecek bir alt test koleksiyonu veya `null` test şu anda parçalanamıyorsa

Korunan yöntemler

createModuleListeners

protected  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.

İlerlemeler

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

Çalıştırıcı beyaz liste filtresini 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`	: Mevcut koşucu beyaz listesi.

İlerlemeler
`boolean`	Yapılandırma modülünün çalışmasına izin veriliyorsa doğru, aksi takdirde yanlış.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

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

İlerlemeler

getHostAbis

protected  getHostAbis ()

Ana makinenin abis'ini döndürür.

İlerlemeler

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 (doğru). Yani mümkünse ana makine testi çalıştırılır.

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

Parametreler
`module`	`ModuleDefinition`

İlerlemeler
`boolean`