2026'dan itibaren, ana kararlı 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 android-latest-release kullanın. 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ı makaleyi inceleyin.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

InstrumentationTest

public class InstrumentationTest
extends Object implements IAbiReceiver, IConfigurationReceiver, IDeviceTest, IMetricCollectorReceiver, IRemoteTest, ITestCollector

java.lang.Object
↳	com.android.tradefed.testtype.InstrumentationTest

Bilinen doğrudan alt sınıflar

AndroidJUnitTest, CodeCoverageTest

AndroidJUnitTest	android.support.test.runner.AndroidJUnitRunner kullanılarak belirli bir cihazda enstrümantasyon testi paketi çalıştıran bir test.
CodeCoverageTest	Belirli bir cihazda enstrümantasyon testi paketi çalıştıran ve kod kapsamı raporu oluşturan bir test.

Belirli bir cihazda enstrümantasyon testi paketi çalıştıran bir testtir.

Özet

Sabitler
`String`	`RUN_TESTS_AS_USER_KEY`
`String`	`RUN_TESTS_ON_SDK_SANDBOX`

Alanlar
`protected boolean`	`mDebug`
`protected boolean`	`mInstrumentInPcc`
`protected boolean`	`mInstrumentSdkInSandbox`
`protected boolean`	`mInstrumentSdkSandbox`

Herkese açık oluşturucular
`InstrumentationTest()`

Herkese açık yöntemler
`void`	`addDeviceListeners(Set<String> extraListeners)` Çalıştırıcıya daha fazla özel dinleyici eklenmesine olanak tanır.
`void`	`addInstrumentationArg(String key, String value)` Araç testleri çalıştırılırken sağlanacak bir bağımsız değişken ekleyin.
`IAbi`	`getAbi()`
`IConfiguration`	`getConfiguration()` Bu test için `IConfiguration` alır.
`String`	`getCoverageTarget()` `setCoverageTarget(String)` aracılığıyla daha önce belirlenen kapsama alanı hedefini elde edin.
`boolean`	`getDebug()` Enstrümantasyon hata ayıklama ayarını alın.
`ITestDevice`	`getDevice()` Test edilecek cihazı alın.
`String`	`getForceAbi()`
`long`	`getMaxTimeout()` Enstrümantasyon için ayarlanan maksimum zaman aşımını döndürür.
`String`	`getPackageName()` Android manifest paketinin çalışmasını sağlayın.
`String`	`getRunName()` Dinleyiciye sağlanacak özel test çalıştırma adını alın.
`String`	`getRunnerName()` Kullanılacak Android enstrümantasyon çalıştırıcısını alır.
`boolean`	`isCollectTestsOnly()`
`boolean`	`isOrchestrator()` `ERROR(InstrumentationTest.mOrchestrator/#mOrchestrator InstrumentationTest.mOrchestrator)` değerini döndürür.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Testleri çalıştırır ve sonuçları dinleyiciye bildirir.
`void`	`setAbi(IAbi abi)`
`void`	`setClassName(String testClassName)` İsteğe bağlı olarak, çalıştırılacak test sınıfı adını ayarlayın.
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Test toplama modunu etkinleştirir veya devre dışı bırakır.
`void`	`setCollectsTestsShellTimeout(int timeout)` Bu yöntem kullanımdan kaldırılmıştır. Bu yöntem işlemsizdir
`void`	`setConfiguration(IConfiguration config)` Kullanımdaki `IConfiguration` örneğini ekler.
`void`	`setCoverageTarget(String coverageTarget)` Bu testin kapsam hedefini belirleyin.
`void`	`setDebug(boolean debug)` Enstrümantasyon hata ayıklama ayarını belirleyin.
`void`	`setDevice(ITestDevice device)` Test edilen cihazı yerleştirin.
`void`	`setEnforceFormat(boolean enforce)` Enstrümentasyonun AJUR çıkış biçimini zorunlu kılıyorsak True olarak ayarlayın.
`void`	`setForceAbi(String abi)` force-abi seçeneğini ayarlar.
`void`	`setInstallFile(File installFile)` Testleri içeren isteğe bağlı yükleme dosyasını ayarlayın.
`void`	`setIsolatedStorage(boolean isolatedStorage)` Yalıtılmış depolamanın kullanılıp kullanılmayacağını ayarlayın.
`void`	`setMethodName(String testMethodName)` İsteğe bağlı olarak, çalıştırılacak test yöntemini ayarlayın.
`void`	`setMetricCollectors(List<IMetricCollector> collectors)` Test çalıştırması için tanımlanan `IMetricCollector` listesini ayarlar.
`void`	`setOrchestrator(boolean useOrchestrator)` --orchestrator seçeneğini ayarlar.
`void`	`setPackageName(String packageName)` Çalıştırılacak Android manifest paketini ayarlayın.
`void`	`setReRunUsingTestFile(boolean reRunUsingTestFile)` --rerun-from-file seçeneğini ayarlar.
`void`	`setRerunMode(boolean rerun)` İsteğe bağlı olarak, yeniden yayınlama modunu ayarlayın.
`void`	`setRetryAttemptNumber(int attemptNumber)` Test için yeniden deneme sayısı ayarlar. Cihaz tarafındaki çalıştırıcıya "retry_attempt" araç oluşturma bağımsız değişkeni olarak göndererek yeniden deneme girişiminin sayısını ayarlar.
`void`	`setRunName(String runName)` Dinleyiciye sağlanacak özel test çalıştırması adını ayarlayın
`void`	`setRunnerName(String runnerName)` İsteğe bağlı olarak, kullanılacak Android enstrümantasyon çalıştırıcısını ayarlayın.
`void`	`setShellTimeout(long timeout)` İsteğe bağlı olarak, cihazdan kabuk çıkışı beklenen maksimum süreyi (milisaniye cinsinden) ayarlayın.
`void`	`setTestFilePathOnDevice(String testFilePathOnDevice)` İsteğe bağlı olarak, cihazda bulunan ve çalıştırılacak satırla ayrılmış test sınıfları ve yöntemlerin listesini (biçim: com.foo.Class#method) içermesi gereken bir dosyanın yolunu ayarlayın.
`void`	`setTestPackageName(String testPackageName)` Test paketi filtresini ayarlar.
`void`	`setTestSize(String size)` İsteğe bağlı olarak, çalıştırılacak test boyutunu ayarlayın.
`void`	`setTestTimeout(long timeout)` İsteğe bağlı olarak, her bir test çalıştırması için maksimum süreyi (milisaniye cinsinden) ayarlayın.
`void`	`setTestsToRun(Collection<TestDescription> tests)` Bu InstrumentationTest tarafından yürütülmesi gereken test koleksiyonunu ayarlayın.
`void`	`setWindowAnimation(boolean windowAnimation)`

Korunan yöntemler
`static Set<TestDescription>`	`excludeNonExecuted(TestRunResult results)` Yeniden çalıştırılması gerekenleri izlemek için "NOT_EXECUTED" ve "Skipped" değerlerini filtreleyin.
`String`	`getClassName()` Çalıştırılacak sınıfın adını alın.
`ListInstrumentationParser`	`getListInstrumentationParser()` "pm list instrumentation" sorgularını ayrıştırmak için kullanılan `ListInstrumentationParser` değerini alın.
`String`	`getMethodName()` Çalıştırılacak test yöntemini alın.
`String`	`getTestPackageName()` Çalıştırılacak test java paketini alın.
`String`	`queryRunnerName()` Kullanılacak bir test çalıştırıcı için cihaza sorgu gönderin.
`void`	`setRunnerArgs(IRemoteAndroidTestRunner runner)`

Sabitler

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

Sabit Değer: "RUN_TESTS_AS_USER"

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

Sabit Değer: "RUN_TESTS_ON_SDK_SANDBOX"

Alanlar

mDebug

protected boolean mDebug

mInstrumentInPcc

protected boolean mInstrumentInPcc

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Herkese açık oluşturucular

InstrumentationTest

public InstrumentationTest ()

Herkese açık yöntemler

addDeviceListeners

public void addDeviceListeners (Set<String> extraListeners)

Çalıştırıcıya daha fazla özel dinleyici eklenmesine olanak tanır.

Parametreler
`extraListeners`	`Set`

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

Araç testleri çalıştırılırken sağlanacak bir bağımsız değişken ekleyin.

Parametreler
`key`	`String`: bağımsız değişken adı
`value`	`String`: bağımsız değişken değeri

getAbi

public IAbi getAbi ()

İadeler
`IAbi`

getConfiguration

public IConfiguration getConfiguration ()

Bu test için IConfiguration alır.

İadeler
`IConfiguration`

getCoverageTarget

public String getCoverageTarget ()

setCoverageTarget(String) aracılığıyla daha önce belirlenen kapsama alanı hedefini elde edin.

İadeler
`String`

getDebug

public boolean getDebug ()

Enstrümantasyon hata ayıklama ayarını alın.

İadeler
`boolean`	Boole hata ayıklama ayarı.

getDevice

public ITestDevice getDevice ()

Test edilecek cihazı alın.

İadeler
`ITestDevice`	`ITestDevice`

getForceAbi

public String getForceAbi ()

İadeler
`String`

getMaxTimeout

public long getMaxTimeout ()

Enstrümantasyon için ayarlanan maksimum zaman aşımını döndürür.

İadeler
`long`

getPackageName

public String getPackageName ()

Android manifest paketinin çalışmasını sağlayın.

İadeler
`String`

getRunName

public String getRunName ()

Dinleyiciye sağlanacak özel test çalıştırma adını alın.

İadeler
`String`

getRunnerName

public String getRunnerName ()

Kullanılacak Android enstrümantasyon çalıştırıcısını alır.

İadeler
`String`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

İadeler
`boolean`	Bu testin yalnızca test toplama modunda olup olmadığı.

isOrchestrator

public boolean isOrchestrator ()

ERROR(InstrumentationTest.mOrchestrator/#mOrchestrator InstrumentationTest.mOrchestrator) değerini döndürür.

İadeler
`boolean`

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Testleri çalıştırır ve sonuçları dinleyiciye bildirir.

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`

setAbi

public void setAbi (IAbi abi)

Parametreler
`abi`	`IAbi`

setClassName

public void setClassName (String testClassName)

İsteğe bağlı olarak, çalıştırılacak test sınıfı adını ayarlayın.

Parametreler
`testClassName`	`String`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Test toplama modunu etkinleştirir veya devre dışı bırakır.

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Bu yöntem kullanımdan kaldırılmıştır.
Bu yöntem işlemsizdir.

Testler toplanırken "kabuk çıkışı yanıtı için maksimum süre"ye izin verilecek maksimum süreyi milisaniye cinsinden ayarlayın.

Parametreler
`timeout`	`int`

setConfiguration

public void setConfiguration (IConfiguration config)

Kullanımdaki IConfiguration örneğini ekler.

Parametreler
`config`	`IConfiguration`

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Bu testin kapsam hedefini belirleyin.

Şu anda kullanılmamaktadır. Bu yöntem yalnızca coverageTarget'ın daha sonra getCoverageTarget() aracılığıyla alınabilmesi için mevcuttur.

Parametreler
`coverageTarget`	`String`

setDebug

public void setDebug (boolean debug)

Enstrümantasyon hata ayıklama ayarını belirleyin.

Parametreler
`debug`	`boolean`: Enstrümantasyon hata ayıklama ayarını belirlemek için kullanılan boole değeri.

setDevice

public void setDevice (ITestDevice device)

Test edilen cihazı yerleştirin.

Parametreler
`device`	`ITestDevice`: kullanılacak `ITestDevice`

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Enstrümentasyonun AJUR çıkış biçimini zorunlu kılıyorsak True olarak ayarlayın.

Parametreler
`enforce`	`boolean`

setForceAbi

public void setForceAbi (String abi)

force-abi seçeneğini ayarlar.

setInstallFile

public void setInstallFile (File installFile)

Testleri içeren isteğe bağlı yükleme dosyasını ayarlayın.

Parametreler
`installFile`	`File`: yüklenebilir `File`

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Yalıtılmış depolamanın kullanılıp kullanılmayacağını ayarlayın.

Parametreler
`isolatedStorage`	`boolean`

setMethodName

public void setMethodName (String testMethodName)

İsteğe bağlı olarak, çalıştırılacak test yöntemini ayarlayın.

Parametreler
`testMethodName`	`String`

setMetricCollectors

public void setMetricCollectors (List<IMetricCollector> collectors)

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

Parametreler
`collectors`	`List`

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

--orchestrator seçeneğini ayarlar.

Parametreler
`useOrchestrator`	`boolean`

setPackageName

public void setPackageName (String packageName)

Çalıştırılacak Android manifest paketini ayarlayın.

Parametreler
`packageName`	`String`

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

--rerun-from-file seçeneğini ayarlar.

Parametreler
`reRunUsingTestFile`	`boolean`

setRerunMode

public void setRerunMode (boolean rerun)

İsteğe bağlı olarak, yeniden yayınlama modunu ayarlayın.

Parametreler
`rerun`	`boolean`

setRetryAttemptNumber

public void setRetryAttemptNumber (int attemptNumber)

Test için yeniden deneme sayısı ayarlar. Varsayılan olarak hiçbir işlem yapılmaz.

Cihaz tarafındaki çalıştırıcıya "retry_attempt" araç oluşturma bağımsız değişkeni olarak göndererek yeniden deneme girişiminin sayısını ayarlar.

Parametreler
`attemptNumber`	`int`

setRunName

public void setRunName (String runName)

Dinleyiciye sağlanacak özel test çalıştırması adını ayarlayın

Parametreler
`runName`	`String`

setRunnerName

public void setRunnerName (String runnerName)

İsteğe bağlı olarak, kullanılacak Android enstrümantasyon çalıştırıcısını ayarlayın.

Parametreler
`runnerName`	`String`

setShellTimeout

public void setShellTimeout (long timeout)

İsteğe bağlı olarak, cihazdan kabuk çıkışı beklenen maksimum süreyi (milisaniye cinsinden) ayarlayın.

Parametreler
`timeout`	`long`

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

İsteğe bağlı olarak, cihazda bulunan ve çalıştırılacak satırla ayrılmış test sınıfları ve yöntemlerin (biçim: com.foo.Class#method) listesini içermesi gereken bir dosyanın yolunu ayarlayın. Ayarlanırsa, kalan her test için ayrı adb komutları yürütmek yerine, bu test dosyası kullanılarak InstrumentationFileTest aracılığıyla testler otomatik olarak yeniden çalıştırılmaya çalışılır.

Parametreler
`testFilePathOnDevice`	`String`

setTestPackageName

public void setTestPackageName (String testPackageName)

Test paketi filtresini ayarlar.

Boş değilse yalnızca belirtilen Java paketindeki testler yürütülür.

setClassName(String) için boş olmayan bir değer sağlanmışsa yoksayılır.

Parametreler
`testPackageName`	`String`

setTestSize

public void setTestSize (String size)

İsteğe bağlı olarak, çalıştırılacak test boyutunu ayarlayın.

Parametreler
`size`	`String`

setTestTimeout

public void setTestTimeout (long timeout)

İsteğe bağlı olarak, her bir test çalıştırması için maksimum süreyi (milisaniye cinsinden) ayarlayın.

Parametreler
`timeout`	`long`

setTestsToRun

public void setTestsToRun (Collection<TestDescription> tests)

Bu InstrumentationTest tarafından yürütülmesi gereken test koleksiyonunu ayarlayın.

Parametreler
`tests`	`Collection`: Çalıştırılacak testler

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Parametreler
`windowAnimation`	`boolean`

Korunan yöntemler

excludeNonExecuted

protected static Set<TestDescription> excludeNonExecuted (TestRunResult results)

Yeniden çalıştırılması gerekenleri izlemek için "NOT_EXECUTED" ve "Skipped" değerlerini filtreleyin.

Parametreler
`results`	`TestRunResult`

İadeler
`Set<TestDescription>`

getClassName

protected String getClassName ()

Çalıştırılacak sınıfın adını alın.

İadeler
`String`

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

"pm list instrumentation" sorgularını ayrıştırmak için kullanılan ListInstrumentationParser değerini alın.

İadeler
`ListInstrumentationParser`

getMethodName

protected String getMethodName ()

Çalıştırılacak test yöntemini alın.

İadeler
`String`

getTestPackageName

protected String getTestPackageName ()

Çalıştırılacak test java paketini alın.

İadeler
`String`

queryRunnerName

protected String queryRunnerName ()

Kullanılacak bir test çalıştırıcı için cihaza sorgu gönderin.

İadeler
`String`	Paketle eşleşen ilk test çalıştırıcısının adı veya eşleşen bulunmazsa null.

Verdiği hatalar
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parametreler
`runner`	`IRemoteAndroidTestRunner`