Enstrümantasyon Testi

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

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

Bilinen doğrudan alt sınıflar AndroidJUnitTest , CodeCoverageTest AndroidJUnitTest Android.support.test.runner.AndroidJUnitRunner'ı kullanarak belirli bir cihazda enstrümantasyon test paketini çalıştıran bir Test. Kod Kapsama Testi Belirli bir cihazda enstrümantasyon test paketini çalıştıran ve kod kapsamı raporunu oluşturan bir Test.

---

Belirli bir cihazda enstrümantasyon test paketini çalıştıran bir Test.

Özet

Alanlar
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

Kamu inşaatçıları
InstrumentationTest ()

Genel yöntemler
void	addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners) Koşucuya daha fazla özel dinleyici eklenmesine izin verir
void	addInstrumentationArg (String key, String value) Enstrümantasyon testlerini çalıştırırken sağlanacak bir bağımsız değişken ekleyin.
IAbi	getAbi ()
IConfiguration	getConfiguration () Bu test için IConfiguration alır.
String	getCoverageTarget () Daha önce setCoverageTarget(String) aracılığıyla ayarlanan kapsama Hedefini alın.
boolean	getDebug () Enstrümantasyon hata ayıklama ayarını alın.
ITestDevice	getDevice () Cihazı teste tabi tutun.
String	getForceAbi ()
long	getMaxTimeout () Enstrümantasyon için ayarlanan maksimum zaman aşımı değerini döndürür.
String	getPackageName () Çalıştırmak için Android manifest paketini edinin.
String	getRunName () Dinleyiciye sağlanacak özel test çalıştırması 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 test sınıfının adını çalışacak şekilde 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şlem gerektirmez
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ı ayarlayın.
void	setDevice ( ITestDevice device) Test edilen cihazı enjekte edin.
void	setEnforceFormat (boolean enforce) Enstrümantasyonun AJUR çıkış biçimini uygularsak True'yu 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üklenecek şekilde 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 test yöntemini çalışacak şekilde ayarlayın.
void	setMetricCollectors ( collectors) setMetricCollectors ( 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) Android bildirim paketini çalışacak ş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ı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 çıktısı beklenecek maksimum süreyi (milisaniye cinsinden) ayarlayın.
void	setTestFilePathOnDevice (String testFilePathOnDevice) İsteğe bağlı olarak, aygıtta bulunan ve çalıştırılacak satırla ayrılmış test sınıfları ve yöntemlerinin (format: com.foo.Class#method) listesini içermesi gereken 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) setTestsToRun ( tests) Bu InstrumentationTest tarafından yürütülmesi gereken testlerin koleksiyonunu ayarlayın.
void	setWindowAnimation (boolean windowAnimation)

Korumalı yöntemler
static	excludeNonExecuted ( TestRunResult results) Yeniden çalıştırılması gerekenleri izlemek amacıyla "YÜRÜTÜLMEMİŞ" ifadesini filtreleyin.
String	getClassName () Çalıştırılacak sınıf adını alın.
ListInstrumentationParser	getListInstrumentationParser () 'PM listesi enstrümantasyonu' sorgularını ayrıştırmak için kullanılan ListInstrumentationParser edinin.
String	getMethodName () Çalıştırılacak test yöntemini edinin.
String	getTestPackageName () Çalıştırmak için test Java paketini edinin.
String	queryRunnerName () Kullanılacak bir test çalıştırıcısı için cihazı sorgulayın.
void	setRunnerArgs (IRemoteAndroidTestRunner runner)

Alanlar

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

mHata ayıklama

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Kamu inşaatçıları

Enstrümantasyon Testi

public InstrumentationTest ()

Genel yöntemler

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Koşucuya daha fazla özel dinleyici eklenmesine izin verir

Parametreler
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

Enstrümantasyon testlerini çalıştırı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 ()

Daha önce setCoverageTarget(String) aracılığıyla ayarlanan kapsama Hedefini alın.

İadeler
String

getDebug

public boolean getDebug ()

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

İadeler
boolean	Boolean hata ayıklama ayarı.

cihaz al

public ITestDevice getDevice ()

Cihazı teste tabi tutun.

İadeler
ITestDevice	ITestDevice

getForceAbi

public String getForceAbi ()

İadeler
String

getMaxTimeout

public long getMaxTimeout ()

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

İadeler
long

getPackageName

public String getPackageName ()

Çalıştırmak için Android manifest paketini edinin.

İadeler
String

getRunName

public String getRunName ()

Dinleyiciye sağlanacak özel test çalıştırması 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

Orkestratör

public boolean isOrchestrator ()

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

İadeler
boolean

koşmak

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Testleri çalıştırır ve sonucu 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

Atar
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Parametreler
abi	IAbi

setSınıfAdı

public void setClassName (String testClassName)

İsteğe bağlı olarak test sınıfının adını çalışacak şekilde ayarlayın.

Parametreler
testClassName	String

setYalnızcaCollectTestler

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setCollectsTestlerShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

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

Testleri toplarken 'kabuk çıktı yanıtına kadar maksimum süre'ye izin vermek için maksimum süreyi ms cinsinden ayarlayın.

Parametreler
timeout	int

setYapılandırma

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ılmıyor. Bu yöntem henüz mevcut olduğundan, kapsamaTarget'ı daha sonra getCoverageTarget() aracılığıyla alınabilir.

Parametreler
coverageTarget	String

setDebug

public void setDebug (boolean debug)

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

Parametreler
debug	boolean : enstrümantasyon hata ayıklama ayarını ayarlamak için boolean değeri.

setCihaz

public void setDevice (ITestDevice device)

Test edilen cihazı enjekte edin.

Parametreler
device	ITestDevice : kullanılacak ITestDevice

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Enstrümantasyonun AJUR çıkış biçimini uygularsak True'yu 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üklenecek şekilde ayarlayın.

Parametreler
installFile	File : kurulabilir ERROR(/File)

setYalıtılmışDepolama

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 test yöntemini çalışacak şekilde ayarlayın.

Parametreler
testMethodName	String

setMetricCollectors

public void setMetricCollectors ( collectors)

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

Parametreler
collectors

setOrkestratör

public void setOrchestrator (boolean useOrchestrator)

--orchestrator seçeneğini ayarlar

Parametreler
useOrchestrator	boolean

setPaketAdı

public void setPackageName (String packageName)

Android bildirim paketini çalışacak şekilde ayarlayın.

Parametreler
packageName	String

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

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

Parametreler
reRunUsingTestFile	boolean

setYeniden ÇalıştırmaModu

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ı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 çıktısı beklenecek maksimum süreyi (milisaniye cinsinden) ayarlayın.

Parametreler
timeout	long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

İsteğe bağlı olarak, aygıtta bulunan ve çalıştırılacak satırla ayrılmış test sınıfları ve yöntemlerinin (format: com.foo.Class#method) listesini içermesi gereken dosyanın yolunu ayarlayın. Ayarlanırsa, yeniden çalıştırma yoluyla 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ı deneyecektir.

Parametreler
testFilePathOnDevice	String

setTestPackageName

public void setTestPackageName (String testPackageName)

Test paketi filtresini ayarlar.

Boş değilse, yalnızca verilen Java paketi içindeki testler yürütülecektir.

setClassName(String) öğesine boş olmayan bir değer sağlanmışsa göz ardı edilecektir

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 testlerin koleksiyonunu ayarlayın.

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

setPencereAnimasyonu

public void setWindowAnimation (boolean windowAnimation)

Parametreler
windowAnimation	boolean

Korumalı yöntemler

Yürütülmeyenleri hariç tut

protected static  excludeNonExecuted (TestRunResult results)

Yeniden çalıştırılması gerekenleri izlemek amacıyla "YÜRÜTÜLMEMİŞ" ifadesini filtreleyin.

Parametreler
results	TestRunResult

İadeler

getClassName

protected String getClassName ()

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

İadeler
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

'PM listesi enstrümantasyonu' sorgularını ayrıştırmak için kullanılan ListInstrumentationParser edinin.

İadeler
ListInstrumentationParser

getMethodName

protected String getMethodName ()

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

İadeler
String

getTestPackageName

protected String getTestPackageName ()

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

İadeler
String

sorguRunnerName

protected String queryRunnerName ()

Kullanılacak bir test çalıştırıcısı için cihazı sorgulayın.

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

Atar
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parametreler
runner	IRemoteAndroidTestRunner