27 Mart 2025'ten itibaren AOSP'yi derlemek ve AOSP'ye katkıda bulunmak için aosp-main yerine android-latest-release kullanmanızı öneririz. Daha fazla bilgi için AOSP'de yapılan değişiklikler başlıklı makaleyi inceleyin.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

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 sınıfını kullanarak belirli bir cihazda araç testi paketi çalıştıran bir test.
CodeCoverageTest	Belirli bir cihazda bir araç testi paketi çalıştıran ve kod kapsamı raporunu oluşturan bir test.

Belirli bir cihazda bir araç testi paketi çalıştıran test.

Özet

Fields'ın oynadığı filmler
`public static final String`	`RUN_TESTS_AS_USER_KEY`
`public static final String`	`RUN_TESTS_ON_SDK_SANDBOX`
`protected boolean`	`mDebug`
`protected boolean`	`mInstrumentSdkInSandbox`
`protected boolean`	`mInstrumentSdkSandbox`

Herkese açık kurucular
`InstrumentationTest()`

Herkese açık yöntemler
`void`	`addDeviceListeners( extraListeners)` Runner'a daha fazla özel dinleyici eklemenize olanak tanır
`void`	`addInstrumentationArg(String key, String value)` Araç testlerini çalıştırırken kullanılacak bir bağımsız değişken ekleyin.
`IAbi`	`getAbi()`
`IConfiguration`	`getConfiguration()` Bu testin `IConfiguration` değerini alır.
`String`	`getCoverageTarget()` Daha önce `setCoverageTarget(String)` aracılığıyla ayarlanan coverageTarget değerini alın.
`boolean`	`getDebug()` Enstrümantasyon hata ayıklama ayarını alın.
`ITestDevice`	`getDevice()` Test cihazını alın.
`String`	`getForceAbi()`
`long`	`getMaxTimeout()` Enstrümasyon için ayarlanan maksimum zaman aşımını döndürür.
`String`	`getPackageName()` Android manifest paketini çalıştırı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`	`isOrchestrator()` `ERROR(InstrumentationTest.mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest.mOrchestrator)` değerini döndürür
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Testleri çalıştırır ve sonucu 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`'ü enjekte eder.
`void`	`setCoverageTarget(String coverageTarget)` Bu testin kapsam hedefini ayarlayın.
`void`	`setDebug(boolean debug)` Enstrümantasyon hata ayıklama ayarını belirleyin.
`void`	`setDevice(ITestDevice device)` Test edilen cihazı enjekte edin.
`void`	`setEnforceFormat(boolean enforce)` Ölçüm için AJUR çıkış biçimini zorunlu kılarsak 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ı dosyayı yükleme ayarını yapın.
`void`	`setIsolatedStorage(boolean isolatedStorage)` Yalıtılmış depolama alanının kullanılıp kullanılmayacağını ayarlayın.
`void`	`setMethodName(String testMethodName)` İsteğe bağlı olarak, test yönteminin çalıştırılmasını ayarlayın.
`void`	`setMetricCollectors( collectors)` Test çalışması için tanımlanan `IMetricCollector` öğelerinin listesini ayarlar.
`void`	`setOrchestrator(boolean useOrchestrator)` --orchestrator seçeneğini ayarlar
`void`	`setPackageName(String packageName)` Android manifest paketini çalıştırılacak şekilde ayarlayın.
`void`	`setReRunUsingTestFile(boolean reRunUsingTestFile)` --rerun-from-file seçeneğini ayarlar.
`void`	`setRerunMode(boolean rerun)` İsteğe bağlı olarak yeniden çalıştırma modunu ayarlayın.
`void`	`setRunName(String runName)` Dinleyiciye sağlanacak özel test çalıştırma adını ayarlama
`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ının ve yöntemlerinin (biçim: com.foo.Class#method) listesini 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( tests)` Bu InstrumentationTest tarafından yürütülmesi gereken test koleksiyonunu ayarlayın.
`void`	`setWindowAnimation(boolean windowAnimation)`

Korunan yöntemler
`static`	`excludeNonExecuted(TestRunResult results)` Yeniden çalıştırılması gerekenleri izlemek için "NOT_EXECUTED" ve Atlandı değerlerini filtreleyin.
`String`	`getClassName()` Çalıştırılacak sınıf 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ılacağı test Java paketini alın.
`String`	`queryRunnerName()` Cihazdan, kullanılacak bir test çalıştırıcı için sorgu alın.
`void`	`setRunnerArgs(IRemoteAndroidTestRunner runner)`

Fields'ın oynadığı filmler

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

mDebug

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Herkese açık kurucular

InstrumentationTest

public InstrumentationTest ()

Herkese açık yöntemler

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Runner'a daha fazla özel dinleyici eklemenize olanak tanır

Parametreler
`extraListeners`

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

Araç testlerini çalıştırırken kullanılacak 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 ()

İlerlemeler
`IAbi`

getConfiguration

public IConfiguration getConfiguration ()

Bu testin IConfiguration değerini alır.

İlerlemeler
`IConfiguration`

getCoverageTarget

public String getCoverageTarget ()

Daha önce setCoverageTarget(String) aracılığıyla ayarlanan coverageTarget değerini alın.

İlerlemeler
`String`

getDebug

public boolean getDebug ()

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

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

getDevice

public ITestDevice getDevice ()

Test cihazını alın.

İlerlemeler
`ITestDevice`	`ITestDevice`

getForceAbi

public String getForceAbi ()

İlerlemeler
`String`

getMaxTimeout

public long getMaxTimeout ()

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

İlerlemeler
`long`

getPackageName

public String getPackageName ()

Android manifest paketini çalıştırın.

İlerlemeler
`String`

getRunName

public String getRunName ()

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

İlerlemeler
`String`

getRunnerName

public String getRunnerName ()

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

İlerlemeler
`String`

isOrchestrator

public boolean isOrchestrator ()

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

İlerlemeler
`boolean`

çalıştır

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Testleri çalıştırır ve sonucu dinleyiciye bildirir.

Parametreler
`testInfo`	`TestInformation`: Test çalıştırmak için yararlı bilgiler içeren `TestInformation` nesnesi.
`listener`	`ITestInvocationListener`: test sonuçlarının `ITestInvocationListener`'ü

Atışlar
`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

Testleri toplarken "kabuk çıkış yanıtı için maksimum süre"ye izin vermek üzere maksimum süreyi ms cinsinden ayarlayın.

Parametreler
`timeout`	`int`

setConfiguration

public void setConfiguration (IConfiguration config)

Kullanımdaki IConfiguration'ü enjekte eder.

Parametreler
`config`	`IConfiguration`

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Bu testin kapsam hedefini ayarlayın.

Şu anda kullanılmamaktadır. Bu yöntem yalnızca coverageTarget'ın daha sonra getCoverageTarget() üzerinden 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ı ayarlamak için kullanılacak boole değeri.

setDevice

public void setDevice (ITestDevice device)

Test edilen cihazı enjekte edin.

Parametreler
`device`	`ITestDevice`: Kullanılacak `ITestDevice`

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Ölçüm için AJUR çıkış biçimini zorunlu kılarsak 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ı dosyayı yükleme ayarını yapın.

Parametreler
`installFile`	`File`: yüklenebilir `ERROR(/File)`

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

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

Parametreler
`isolatedStorage`	`boolean`

setMethodName

public void setMethodName (String testMethodName)

İsteğe bağlı olarak, test yönteminin çalışacağını ayarlayın.

Parametreler
`testMethodName`	`String`

setMetricCollectors

public void setMetricCollectors ( collectors)

Test çalışması için tanımlanan IMetricCollector öğelerinin listesini ayarlar.

Parametreler
`collectors`

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

--orchestrator seçeneğini ayarlar

Parametreler
`useOrchestrator`	`boolean`

setPackageName

public void setPackageName (String packageName)

Android manifest paketini çalıştırılacak şekilde 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 çalıştırma modunu ayarlayın.

Parametreler
`rerun`	`boolean`

setRunName

public void setRunName (String runName)

Dinleyiciye sağlanacak özel test çalıştırma 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ının ve yöntemlerinin (biçim: com.foo.Class#method) listesini içermesi gereken bir dosyanın yolunu ayarlayın. Ayarlanırsa, yeniden çalıştırma aracılığıyla kalan her test için ayrı adb komutları yürütmek yerine InstrumentationFileTest aracılığıyla bu test dosyasını kullanarak testleri otomatik olarak yeniden çalıştırmayı dener.

Parametreler
`testFilePathOnDevice`	`String`

setTestPackageName

public void setTestPackageName (String testPackageName)

Test paketi filtresini ayarlar.

Değeri null değilse yalnızca belirtilen java paketindeki testler yürütülür.

setClassName(String) için boş olmayan bir değer sağlanırsa 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 ( tests)

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

Parametreler
`tests`	: çalıştırılacak testler

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Parametreler
`windowAnimation`	`boolean`

Korunan yöntemler

excludeNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

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

Parametreler
`results`	`TestRunResult`

İlerlemeler

getClassName

protected String getClassName ()

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

İlerlemeler
`String`

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

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

İlerlemeler
`ListInstrumentationParser`

getMethodName

protected String getMethodName ()

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

İlerlemeler
`String`

getTestPackageName

protected String getTestPackageName ()

Çalıştırmak için test Java paketini alın.

İlerlemeler
`String`

queryRunnerName

protected String queryRunnerName ()

Cihazdan, kullanılacak bir test çalıştırıcı için sorgu alın.

İlerlemeler
`String`	Paketle eşleşen ilk test çalıştırıcı adı veya hiçbiri bulunamazsa null.

Atışlar
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parametreler
`runner`	`IRemoteAndroidTestRunner`