RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

java.lang.Object
   ↳ com.android.ddmlib.testrunner.RemoteAndroidTestRunner

Android test komutunu uzaktan çalıştırır ve sonuçları bildirir.

Özet

Herkese açık oluşturucular

RemoteAndroidTestRunner(String packageName, IShellEnabledDevice remoteDevice)

Alternatif oluşturucu.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice)

Alternatif oluşturucu.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice, RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

Uzak Android test çalıştırıcısı oluşturur.

Herkese açık yöntemler

void addBooleanArg(String name, boolean value)

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

void addInstrumentationArg(String name, String value)

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

void cancel()

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

IInstrumentationResultParser createParser(String runName, listeners)

Enstrümantasyon çıktısını ayrıştırmak için kullanılacak InstrumentationResultParser oluşturun.

String getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

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

String getPackageName()

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

String getRunOptions()

am instrument komutu için seçenekleri döndürür.

String getRunnerName()

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

void removeInstrumentationArg(String name)

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

void run(ITestRunListener... listeners)

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

void run( listeners)

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

void setAdditionalTestOutputLocation(String additionalTestDataPath)

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

void setClassName(String className)

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

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.

void setCoverage(boolean coverage)

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

void setCoverageReportLocation(String reportPath)

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

void setDebug(boolean debug)

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

void setLogOnly(boolean logOnly)

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

void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

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

void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

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

void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
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.

void setRunName(String runName)

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

Belirtilmezse paket adı kullanılır.

void setRunOptions(String options)

am instrument komutu için seçenekleri ayarlar.

void setTestCollection(boolean collect)

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

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.

void setTestSize(IRemoteAndroidTestRunner.TestSize size)

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

Korunan yöntemler

String getArgsCommand()

Belirtilen enstrümantasyon bağımsız değişkenleri için tam enstrümantasyon komut satırı söz dizimini döndürür.

String getRunnerPath()

Tam enstrümantasyon bileşen yolunu döndürür.

Herkese açık oluşturucular

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

Alternatif oluşturucu. Varsayılan enstrümantasyon çalıştırıcısını kullanır.

Parametreler
packageName String: Çalıştırılacak testleri içeren Android uygulama paketi
remoteDevice IShellEnabledDevice: Testlerin yürütüleceği Android cihaz

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice)

Alternatif oluşturucu. Varsayılan statusReporterMode kullanılır.

Parametreler
packageName String: Çalıştırılacak testleri içeren Android uygulama paketi
runnerName String: Yürütülecek araç testi çalıştırıcısı. Boşsa varsayılan çalıştırıcı kullanılır.
remoteDevice IShellEnabledDevice: Testlerin yürütüleceği Android cihaz

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice, 
                RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

Uzak Android test çalıştırıcısı oluşturur.

Parametreler
packageName String: Çalıştırılacak testleri içeren Android uygulama paketi
runnerName String: Yürütülecek araç testi çalıştırıcısı. Boşsa varsayılan çalıştırıcı kullanılır.
remoteDevice IShellEnabledDevice: Testlerin yürütüleceği Android cihaz
statusReporterMode RemoteAndroidTestRunner.StatusReporterMode: Bir enstrüman komutu için kullanılacak durum raporlayıcı modu

Herkese açık yöntemler

addBooleanArg

public 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 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 void cancel ()

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

createParser

public IInstrumentationResultParser createParser (String runName, 
                 listeners)

Enstrümantasyon çıktısını ayrıştırmak için kullanılacak InstrumentationResultParser oluşturun.

Parametreler
runName String: Kullanılacak çalıştırmanın adı.
listeners : Sonuçların bildirileceği dinleyiciler.
İlerlemeler
IInstrumentationResultParser InstrumentationResultParser örneği.

getAmInstrumentCommand

public String getAmInstrumentCommand ()

İlerlemeler
String

getCoverageOutputType

public 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 String getPackageName ()

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

İlerlemeler
String

getRunOptions

public String getRunOptions ()

am instrument komutu için seçenekleri döndürür.

İlerlemeler
String

getRunnerName

public String getRunnerName ()

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

İlerlemeler
String

removeInstrumentationArg

public 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 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
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

çalıştır

public 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
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation

public 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 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 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 void setCoverage (boolean coverage)

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

Parametreler
coverage boolean

setCoverageReportLocation

public void setCoverageReportLocation (String reportPath)

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

Parametreler
reportPath String

setDebug

public 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 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 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 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 void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Parametreler
maxTimeToOutputResponse int

setMethodName

public 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 void setRunName (String runName)

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

Belirtilmezse paket adı kullanılır.

setRunOptions

public void setRunOptions (String options)

am instrument komutu için seçenekleri ayarlar. Seçeneklerin tam listesi için com/android/commands/am/Am.java adresine bakın.

Parametreler
options String

setTestCollection

public void setTestCollection (boolean collect)

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
collect boolean

setTestPackageName

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

Korunan yöntemler

getArgsCommand

protected String getArgsCommand ()

Belirtilen enstrümantasyon bağımsız değişkenleri için tam enstrümantasyon komut satırı söz dizimini döndürür. Bağımsız değişken belirtilmemişse boş dize döndürür.

İlerlemeler
String

getRunnerPath

protected String getRunnerPath ()

Tam enstrümantasyon bileşen yolunu döndürür.

İlerlemeler
String