UiAutomatorRunner

public class UiAutomatorRunner
extends Object implements IRemoteAndroidTestRunner

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

Cihazda UI Automator testini çalıştırır ve sonuçları bildirir. UI Automator testi, UI Automator çerçevesini kullanan kullanıcı arayüzü otomasyonu testlerini çalıştırmak için özel bir test çalıştırıcıdır. Cihazdaki test çalıştırıcı, ddmlib ve TF'deki mevcut ayrıştırma kodunun yeniden kullanılabilmesi için enstrümantasyon test çıkış biçimini taklit eder. Bu komut, temelde şu komutun sarmalayıcısıdır: adb shell uiautomator runtest (jar dosyaları) -e class (test sınıfları) ...

Özet

Herkese açık oluşturucular

UiAutomatorRunner(IDevice remoteDevice, String[] jarPaths, String runnerPath)

Kullanıcı arayüzü otomasyonu testlerini çalıştırmak için bir UiAutomatorRunner oluşturun

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.

IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

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

String getPackageName()

Eklenen son Java sınıfının paket adını döndürür.

String getRunnerName()

Varsayılan UiAutomatorTestRunner sınıf adını 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 arg0)

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 setIgnoreSighup(boolean value)

uiautomator'da SIGHUP'ı yoksayma seçeneğini 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 timeout, TimeUnit unit)

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

void setMaxTimeout(long maxTimeout, TimeUnit unit)

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

void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)

Bu yöntem kullanımdan kaldırılmıştır. Bunun yerine setMaxTimeToOutputResponse(long, TimeUnit) kullanın.

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 setTestCollection(boolean b)

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 getRunCommand()
String getRunnerPath()

Herkese açık oluşturucular

UiAutomatorRunner

public UiAutomatorRunner (IDevice remoteDevice, 
                String[] jarPaths, 
                String runnerPath)

Kullanıcı arayüzü otomasyonu testlerini çalıştırmak için bir UiAutomatorRunner oluşturun

Parametreler
remoteDevice IDevice: Etkileşimde bulunulacak uzak cihaz: Test çalıştırma, sonuç toplama vb.
jarPaths String: UI Automator test senaryolarının bulunduğu jar dosyalarının yolları; yollar mutlak olmalı veya cihazdaki /data/local/tmp/ dizinine göreli olmalıdır.
runnerPath String: Kullanılacak alternatif uiautomator çalıştırıcısı. null olabilir ve bu durumda varsayılan değer kullanılır.

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.

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 ()

Eklenen son Java sınıfının paket adını döndürür.

İlerlemeler
String

getRunnerName

public String getRunnerName ()

Varsayılan UiAutomatorTestRunner sınıf adını 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 arg0)

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

Parametreler
arg0 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

setIgnoreSighup

public void setIgnoreSighup (boolean value)

uiautomator'da SIGHUP'ı yoksayma seçeneğini ayarlar.

Parametreler
value boolean: Doğru olarak ayarlanırsa sinyali yoksay

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 timeout, 
                TimeUnit unit)

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
timeout 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.
unit TimeUnit: Sıfır olmayan maxTimeToOutputResponse ve maxTimeout değerleri için birimler.

setMaxTimeout

public void setMaxTimeout (long maxTimeout, 
                TimeUnit unit)

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.
unit TimeUnit: Sıfır olmayan maxTimeToOutputResponse ve maxTimeout değerleri için birimler.

setMaxtimeToOutputResponse

public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Bu yöntem kullanımdan kaldırılmıştır.
Bunun yerine setMaxTimeToOutputResponse(long, TimeUnit) kullanın.

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.

setTestCollection

public void setTestCollection (boolean b)

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
b 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

getRunCommand

protected String getRunCommand ()

İlerlemeler
String

getRunnerPath

protected String getRunnerPath ()

İlerlemeler
String