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şken 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, Collection<ITestRunListener> 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 paketinin 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(Collection<ITestRunListener> 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ıracak şekilde ayarlar. "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 işlemi 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"dan önce çağrılmalıdır.
void	setRunName(String runName) ITestRunListener tarihinde run(ITestRunListener) 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ıracak ayarları yapar. "run" işleminden ö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: Çalıştırılacak enstrümantasyon 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: Çalıştırılacak enstrümantasyon 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şken 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. Belirtilen 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, 
                Collection<ITestRunListener> 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	Collection: Sonuçların bildirileceği dinleyiciler.

İadeler
IInstrumentationResultParser	InstrumentationResultParser örneği.

getAmInstrumentCommand

public String getAmInstrumentCommand ()

İadeler
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 hükümlerini inceleyin.

İadeler
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public String getPackageName ()

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

İadeler
String

getRunOptions

public String getRunOptions ()

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

İadeler
String

getRunnerName

public String getRunnerName ()

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

İadeler
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ı

run

public void run (ITestRunListener... listeners)

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

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

Parametreler
listeners	ITestRunListener: Test sonuçlarını dinler

Verdiği hatalar
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

run

public void run (Collection<ITestRunListener> listeners)

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

Parametreler
listeners	Collection: Test sonuçları için dinleyici toplama

Verdiği hatalar
AdbCommandRejectedException
IOException
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 nitelikli sınıf adı (ör. x.y.z)

setClassNames

public void setClassNames (String[] classNames)

Yalnızca sağlanan sınıflardaki testleri çalıştıracak şekilde ayarlar. "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şkeni 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 işlemine 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 işlemi 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ğerlerinin birimleri. değerleri.

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ğerlerinin birimleri. değerleri.

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"dan önce çağrılmalıdır.

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

setRunName

public void setRunName (String runName)

ITestRunListener tarihinde run(ITestRunListener) 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ıracak ayarları yapar. "run" işleminden ö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.

İadeler
String

getRunnerPath

protected String getRunnerPath ()

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

İadeler
String