IRemoteAndroidTestRunner

public interface IRemoteAndroidTestRunner

com.android.ddmlib.testrunner.IRemoteAndroidTestRunner

Android test komutunu uzaktan çalıştırmak ve sonucu bir dinleyiciye bildirmek için kullanılan arayüz.

Özet

Herkese açık yöntemler

abstract void addBooleanArg(String name, boolean value)

Enstrümantasyon komutuna dahil edilecek bir boolean bağımsız değişkeni ekler.

abstract void addInstrumentationArg(String name, String value)

Enstrümantasyon komutuna dahil edilecek bir bağımsız değişken ekler.

abstract void cancel()

Bu test çalıştırmasının iptal edilmesini ister.

abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

Çalıştırıcı tarafından oluşturulan test kapsamının türünü döndürür.

abstract String getPackageName()

Uygulama paket adını döndürür.

abstract String getRunnerName()

runnerName değerini döndürür.

abstract void removeInstrumentationArg(String name)

Daha önce eklenmiş bir bağımsız değişkeni kaldırır.

abstract void run(ITestRunListener... listeners)

Bu test çalıştırmasını yürütün.

abstract void run( listeners)

Bu test çalıştırmasını yürütün.

abstract void setAdditionalTestOutputLocation(String additionalTestDataPath)

Test uygulaması kaldırılmadan önce ana makineye kopyalanacak ek test çıktısının konumunu ayarlar.

abstract void setClassName(String className)

Yalnızca bu sınıftaki testleri çalıştıracak ayarlar "run"dan önce çağrılmalıdır.

abstract void setClassNames(String[] classNames)

Yalnızca sağlanan sınıflardaki testleri çalıştırmak için ayarlanır. "run"dan önce çağrılmalıdır.

abstract void setCoverage(boolean coverage)

Bu test çalıştırmasının kod kapsamı modunu ayarlar.

abstract void setCoverageReportLocation(String reportPath)

Oluşturulan kapsam raporlarının konumunu ayarlar.

abstract void setDebug(boolean debug)

Bu test çalıştırmasının hata ayıklama modunu ayarlar.

abstract void setLogOnly(boolean logOnly)

Bu test çalıştırmasını yalnızca günlük moduna ayarlar. Test yürütme atlanır.

abstract void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

Cihazlarda testleri çalıştıran kabuk komutunun çıkışı arasında izin verilen maksimum süreyi ayarlar.

abstract void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

Enstrümantasyonun tamamlanması için izin verilen maksimum süreyi belirler.

abstract void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)

Bu yöntem kullanımdan kaldırılmıştır. ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)) kullanın.

abstract void setMethodName(String className, String testName)

Yalnızca belirtilen test yönteminin çalıştırılmasını ayarlar. "run" yönteminden önce çağrılmalıdır.

abstract void setRunName(String runName)

ITestRunListener tarihinde run() için raporlanacak özel bir çalıştırma adı ayarlayın.

Belirtilmezse paket adı kullanılır.

abstract void setTestCollection(boolean collection)

Bu test çalıştırmasını test koleksiyonu moduna ayarlar.

abstract void setTestPackageName(String packageName)

Belirtilen paketteki tüm testleri çalıştırmak için ayarlanır. "run" işlevinden önce çağrılmalıdır.

abstract void setTestSize(IRemoteAndroidTestRunner.TestSize size)

Yalnızca belirli boyuttaki testlerin çalıştırılmasını sağlar.

Herkese açık yöntemler

addBooleanArg

public abstract void addBooleanArg (String name, 
                boolean value)

Enstrümantasyon komutuna dahil edilecek bir boolean bağımsız değişkeni ekler.

Parametreler
name String: enstrümantasyon paketi bağımsız değişkeninin adı
value boolean: bağımsız değişkenin değeri

addInstrumentationArg

public abstract void addInstrumentationArg (String name, 
                String value)

Enstrümantasyon komutuna dahil edilecek bir bağımsız değişken ekler.

"run" komutundan önce çağrılmalıdır. Belirli bir ada sahip bir bağımsız değişken zaten sağlanmışsa değeri geçersiz kılınır.

Parametreler
name String: enstrümantasyon paketi bağımsız değişkeninin adı
value String: bağımsız değişkenin değeri

iptal

public abstract void cancel ()

Bu test çalıştırmasının iptal edilmesini ister.

getCoverageOutputType

public abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

Çalıştırıcı tarafından oluşturulan test kapsamının türünü döndürür. CoverageOutput bakın.

İlerlemeler
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public abstract String getPackageName ()

Uygulama paket adını döndürür.

İlerlemeler
String

getRunnerName

public abstract String getRunnerName ()

runnerName değerini döndürür.

İlerlemeler
String

removeInstrumentationArg

public abstract void removeInstrumentationArg (String name)

Daha önce eklenmiş bir bağımsız değişkeni kaldırır.

Parametreler
name String: Kaldırılacak enstrümantasyon paketi bağımsız değişkeninin adı

çalıştır

public abstract void run (ITestRunListener... listeners)

Bu test çalıştırmasını yürütün.

ERROR(/#run(Collection)) için kolaylık yöntemi.

Parametreler
listeners ITestRunListener: Test sonuçlarını dinler
Dekoratif yastıklar
TimeoutException bağlantıda zaman aşımı olması durumunda
AdbCommandRejectedException adb komutu reddederse
ShellCommandUnresponsiveException Cihaz, maksimum çıkış süresinden daha uzun bir süre boyunca test sonucu vermediyse.
Cihazla bağlantı kesildiyse

çalıştır

public abstract void run ( listeners)

Bu test çalıştırmasını yürütün.

Parametreler
listeners : Test sonuçları için dinleyici toplama
Dekoratif yastıklar
TimeoutException bağlantıda zaman aşımı olması durumunda
AdbCommandRejectedException adb komutu reddederse
ShellCommandUnresponsiveException Cihaz, maksimum çıkış süresinden daha uzun bir süre boyunca test sonucu vermediyse.
Cihazla bağlantı kesildiyse

setAdditionalTestOutputLocation

public abstract void setAdditionalTestOutputLocation (String additionalTestDataPath)

Test uygulaması kaldırılmadan önce ana makineye kopyalanacak ek test çıktısının konumunu ayarlar. Örneğin, oluşturulan karşılaştırma raporları.

Parametreler
additionalTestDataPath String

setClassName

public abstract void setClassName (String className)

Yalnızca bu sınıftaki testleri çalıştıracak ayarlar "run"dan önce çağrılmalıdır.

Parametreler
className String: Tam sınıf adı (ör. x.y.z)

setClassNames

public abstract void setClassNames (String[] classNames)

Yalnızca sağlanan sınıflardaki testleri çalıştırmak için ayarlanır. "run"dan önce çağrılmalıdır.

Birden fazla sınıf sağlanıyorsa çoklu sınıf bağımsız değişken söz dizimini destekleyen bir InstrumentationTestRunner gerekir.

Parametreler
classNames String: Tam nitelikli sınıf adları dizisi (ör. x.y.z)

setCoverage

public abstract void setCoverage (boolean coverage)

Bu test çalıştırmasının kod kapsamı modunu ayarlar.

Parametreler
coverage boolean

setCoverageReportLocation

public abstract void setCoverageReportLocation (String reportPath)

Oluşturulan kapsam raporlarının konumunu ayarlar.

Parametreler
reportPath String

setDebug

public abstract void setDebug (boolean debug)

Bu test çalıştırmasının hata ayıklama modunu ayarlar. Doğruysa Android test çalıştırıcısı, test yürütmeye devam etmeden önce bir hata ayıklayıcının eklenmesini bekler.

Parametreler
debug boolean

setLogOnly

public abstract void setLogOnly (boolean logOnly)

Bu test çalıştırmasını yalnızca günlük moduna ayarlar. Test yürütme atlanır.

Parametreler
logOnly boolean

setMaxTimeToOutputResponse

public abstract void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Cihazlarda testleri çalıştıran kabuk komutunun çıkışı arasında izin verilen maksimum süreyi ayarlar.

Bu sayede, testlerin takılıp kalması ve hiçbir zaman tamamlanmaması durumunda zaman aşımı ayarlanabilir. Bu, bağlantıdaki normal zaman aşımından farklıdır.

Varsayılan olarak zaman aşımı belirtilmez.

Parametreler
maxTimeToOutputResponse long: Komutun herhangi bir yanıt vermemesine izin verilen maksimum süre. 0 değeri, yöntemin komut çıkışı için sonsuza kadar (receiver yürütmeyi iptal edene kadar) bekleyeceği ve hiçbir zaman hata vermeyeceği anlamına gelir.
maxTimeUnits TimeUnit: Sıfır olmayan maxTimeToOutputResponse ve maxTimeout değerleri için birimler.

setMaxTimeout

public abstract void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

Enstrümantasyonun tamamlanması için izin verilen maksimum süreyi belirler.

Bu sayede, testlerin takılıp kalması ve hiçbir zaman tamamlanmaması durumunda zaman aşımı ayarlanabilir. Bu, bağlantıdaki normal zaman aşımından farklıdır.

Varsayılan olarak zaman aşımı belirtilmez.

Parametreler
maxTimeout long: Komutun herhangi bir yanıt vermemesine izin verilen maksimum süre. 0 değeri, yöntemin komut çıkışı için sonsuza kadar (receiver yürütmeyi iptal edene kadar) bekleyeceği ve hiçbir zaman hata vermeyeceği anlamına gelir.
maxTimeUnits TimeUnit: Sıfır olmayan maxTimeToOutputResponse ve maxTimeout değerleri için birimler.

setMaxtimeToOutputResponse

public abstract void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Bu yöntem kullanımdan kaldırılmıştır.
ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)) özelliğini kullanın.

Parametreler
maxTimeToOutputResponse int

setMethodName

public abstract void setMethodName (String className, 
                String testName)

Yalnızca belirtilen test yönteminin çalıştırılmasını ayarlar. "run" yönteminden önce çağrılmalıdır.

Parametreler
className String: Tam sınıf adı (ör. x.y.z)
testName String: yöntem adı

setRunName

public abstract void setRunName (String runName)

ITestRunListener tarihinde run() için raporlanacak özel bir çalıştırma adı ayarlayın.

Belirtilmezse paket adı kullanılır.

setTestCollection

public abstract void setTestCollection (boolean collection)

Bu test çalıştırmasını test koleksiyonu moduna ayarlar. Doğruysa test yürütme atlanır ve başarılı bir test toplama işlemi için gereken tüm uygun çalıştırıcı bağımsız değişkenleri ayarlanır.

Parametreler
collection boolean

setTestPackageName

public abstract void setTestPackageName (String packageName)

Belirtilen paketteki tüm testleri çalıştırmak için ayarlanır. "run" işlevinden önce çağrılmalıdır.

Parametreler
packageName String: Tam nitelikli paket adı (ör. x.y.z)

setTestSize

public abstract void setTestSize (IRemoteAndroidTestRunner.TestSize size)

Yalnızca belirli boyuttaki testlerin çalıştırılmasını sağlar. "run" komutundan önce çağrılmalıdır.

Parametreler
size IRemoteAndroidTestRunner.TestSize: Çalıştırılacak TestSize.