UiAutomatorRunner

public class UiAutomatorRunner
extends Object implements IRemoteAndroidTestRunner

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

Menjalankan pengujian UI Automator di perangkat dan melaporkan hasilnya. Pengujian UI Automator adalah runner pengujian khusus untuk menjalankan pengujian otomatisasi UI yang menggunakan framework UI Automator. Runner pengujian di perangkat meniru format output pengujian instrumentasi sehingga kode parsing yang ada di ddmlib dan TF dapat digunakan kembali. Pada dasarnya, ini adalah wrapper di sekitar perintah ini: adb shell uiautomator runtest (file jar) -e class (class pengujian) ...

Ringkasan

Konstruktor publik

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

Membuat UiAutomatorRunner untuk menjalankan pengujian otomatisasi UI

Metode publik

void addBooleanArg(String name, boolean value)

Menambahkan argumen boolean untuk disertakan dalam perintah instrumentasi.

void addInstrumentationArg(String name, String value)

Menambahkan argumen untuk disertakan dalam perintah instrumentasi.

void cancel()

Meminta pembatalan proses pengujian ini.

IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

Menampilkan jenis cakupan pengujian yang dihasilkan oleh runner.

String getPackageName()

Menampilkan nama paket class Java terakhir yang ditambahkan

String getRunnerName()

Menampilkan nama class UiAutomatorTestRunner default

void removeInstrumentationArg(String name)

Menghapus argumen yang sebelumnya ditambahkan.

void run(ITestRunListener... listeners)

Jalankan pengujian ini.

void run( listeners)

Jalankan pengujian ini.

void setAdditionalTestOutputLocation(String additionalTestDataPath)

Menetapkan lokasi output pengujian tambahan yang akan disalin ke host sebelum aplikasi pengujian di-uninstal.

void setClassName(String className)

Menetapkan untuk menjalankan hanya pengujian di class ini. Harus dipanggil sebelum 'run'.

void setClassNames(String[] classNames)

Menetapkan untuk hanya menjalankan pengujian di class yang disediakan. Harus dipanggil sebelum 'run'.

void setCoverage(boolean coverage)

Menetapkan mode cakupan kode ini untuk pengujian ini.

void setCoverageReportLocation(String arg0)

Menetapkan lokasi laporan cakupan yang dihasilkan.

void setDebug(boolean debug)

Menetapkan mode debug untuk pengujian ini.

void setIgnoreSighup(boolean value)

Menetapkan opsi di uiautomator untuk mengabaikan SIGHUP.

void setLogOnly(boolean logOnly)

Menetapkan eksekusi pengujian ini ke mode hanya mencatat - melewati eksekusi pengujian.

void setMaxTimeToOutputResponse(long timeout, TimeUnit unit)

Menetapkan waktu maksimum yang diizinkan antara output perintah shell yang menjalankan pengujian di perangkat.

void setMaxTimeout(long maxTimeout, TimeUnit unit)

Menetapkan waktu maksimum yang diizinkan untuk penyelesaian instrumentasi.

void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)

Metode ini tidak digunakan lagi. Sebagai gantinya, gunakan setMaxTimeToOutputResponse(long, TimeUnit).

void setMethodName(String className, String testName)

Menetapkan untuk menjalankan hanya metode pengujian yang ditentukan. Harus dipanggil sebelum 'run'.

void setRunName(String runName)

Menetapkan nama proses kustom yang akan dilaporkan ke ITestRunListener pada run()

Jika tidak ditentukan, akan menggunakan nama paket

void setTestCollection(boolean b)

Menetapkan pengujian ini ke mode pengumpulan pengujian.

void setTestPackageName(String packageName)

Menetapkan untuk menjalankan semua pengujian dalam paket yang ditentukan Harus dipanggil sebelum 'run'.

void setTestSize(IRemoteAndroidTestRunner.TestSize size)

Menetapkan untuk hanya menjalankan pengujian dengan ukuran tertentu.

Metode yang dilindungi

String getRunCommand()
String getRunnerPath()

Konstruktor publik

UiAutomatorRunner

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

Membuat UiAutomatorRunner untuk menjalankan pengujian otomatisasi UI

Parameter
remoteDevice IDevice: perangkat jarak jauh untuk berinteraksi dengan: jalankan pengujian, kumpulkan hasil, dll.
jarPaths String: jalur ke file jar tempat kasus pengujian UI Automator berada; jalur harus absolut atau relatif ke /data/local/tmp/ di perangkat
runnerPath String: runner uiautomator alternatif yang akan digunakan, dapat berupa null dan default akan digunakan dalam kasus ini

Metode publik

addBooleanArg

public void addBooleanArg (String name, 
                boolean value)

Menambahkan argumen boolean untuk disertakan dalam perintah instrumentasi.

Parameter
name String: nama argumen paket instrumentasi
value boolean: nilai argumen

addInstrumentationArg

public void addInstrumentationArg (String name, 
                String value)

Menambahkan argumen untuk disertakan dalam perintah instrumentasi.

Harus dipanggil sebelum 'run'. Jika argumen dengan nama yang diberikan telah disediakan, nilainya akan diganti.

Parameter
name String: nama argumen paket instrumentasi
value String: nilai argumen

batal

public void cancel ()

Meminta pembatalan proses pengujian ini.

getCoverageOutputType

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

Menampilkan jenis cakupan pengujian yang dihasilkan oleh runner. Lihat CoverageOutput.

Hasil
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public String getPackageName ()

Menampilkan nama paket class Java terakhir yang ditambahkan

Hasil
String

getRunnerName

public String getRunnerName ()

Menampilkan nama class UiAutomatorTestRunner default

Hasil
String

removeInstrumentationArg

public void removeInstrumentationArg (String name)

Menghapus argumen yang sebelumnya ditambahkan.

Parameter
name String: nama argumen paket instrumentasi yang akan dihapus

lari

public void run (ITestRunListener... listeners)

Jalankan pengujian ini.

Metode praktis untuk ERROR(/#run(Collection)).

Parameter
listeners ITestRunListener: memantau hasil pengujian
Menampilkan
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

lari

public void run ( listeners)

Jalankan pengujian ini.

Parameter
listeners : kumpulan pemroses untuk hasil pengujian
Menampilkan
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation

public void setAdditionalTestOutputLocation (String additionalTestDataPath)

Menetapkan lokasi output pengujian tambahan yang akan disalin ke host sebelum aplikasi pengujian di-uninstal. Misalnya, laporan tolok ukur yang dibuat.

Parameter
additionalTestDataPath String

setClassName

public void setClassName (String className)

Menetapkan untuk menjalankan hanya pengujian di class ini. Harus dipanggil sebelum 'run'.

Parameter
className String: nama class yang sepenuhnya memenuhi syarat (misalnya x.y.z)

setClassNames

public void setClassNames (String[] classNames)

Menetapkan untuk hanya menjalankan pengujian di class yang disediakan. Harus dipanggil sebelum 'run'.

Jika menyediakan lebih dari satu class, memerlukan InstrumentationTestRunner yang mendukung sintaks argumen beberapa class.

Parameter
classNames String: array nama class yang sepenuhnya memenuhi syarat (misalnya x.y.z)

setCoverage

public void setCoverage (boolean coverage)

Menetapkan mode cakupan kode ini untuk pengujian ini.

Parameter
coverage boolean

setCoverageReportLocation

public void setCoverageReportLocation (String arg0)

Menetapkan lokasi laporan cakupan yang dihasilkan.

Parameter
arg0 String

setDebug

public void setDebug (boolean debug)

Menetapkan mode debug untuk pengujian ini. Jika benar (true), peluncur pengujian Android akan menunggu debugger disematkan sebelum melanjutkan eksekusi pengujian.

Parameter
debug boolean

setIgnoreSighup

public void setIgnoreSighup (boolean value)

Menetapkan opsi di uiautomator untuk mengabaikan SIGHUP.

Parameter
value boolean: mengabaikan sinyal jika disetel ke benar (true)

setLogOnly

public void setLogOnly (boolean logOnly)

Menetapkan eksekusi pengujian ini ke mode hanya mencatat - melewati eksekusi pengujian.

Parameter
logOnly boolean

setMaxTimeToOutputResponse

public void setMaxTimeToOutputResponse (long timeout, 
                TimeUnit unit)

Menetapkan waktu maksimum yang diizinkan antara output perintah shell yang menjalankan pengujian di perangkat.

Hal ini memungkinkan setelan waktu tunggu jika pengujian dapat macet dan tidak pernah selesai. Ini berbeda dengan waktu tunggu normal pada koneksi.

Secara default, tidak ada waktu tunggu yang akan ditentukan.

Parameter
timeout long: jumlah waktu maksimum selama perintah diizinkan untuk tidak menghasilkan respons apa pun. Nilai 0 berarti metode akan menunggu selamanya (hingga receiver membatalkan eksekusi) untuk output perintah dan tidak pernah memunculkan pengecualian.
unit TimeUnit: Satuan untuk nilai maxTimeToOutputResponse dan maxTimeout selain nol.

setMaxTimeout

public void setMaxTimeout (long maxTimeout, 
                TimeUnit unit)

Menetapkan waktu maksimum yang diizinkan untuk penyelesaian instrumentasi.

Hal ini memungkinkan setelan waktu tunggu jika pengujian dapat macet dan tidak pernah selesai. Ini berbeda dengan waktu tunggu normal pada koneksi.

Secara default, tidak ada waktu tunggu yang akan ditentukan.

Parameter
maxTimeout long: jumlah waktu maksimum selama perintah diizinkan untuk tidak menghasilkan respons apa pun. Nilai 0 berarti metode akan menunggu selamanya (hingga receiver membatalkan eksekusi) untuk output perintah dan tidak pernah memunculkan pengecualian.
unit TimeUnit: Satuan untuk nilai maxTimeToOutputResponse dan maxTimeout selain nol.

setMaxtimeToOutputResponse

public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Metode ini tidak digunakan lagi.
gunakan setMaxTimeToOutputResponse(long, TimeUnit) sebagai gantinya.

Parameter
maxTimeToOutputResponse int

setMethodName

public void setMethodName (String className, 
                String testName)

Menetapkan untuk menjalankan hanya metode pengujian yang ditentukan. Harus dipanggil sebelum 'run'.

Parameter
className String: nama class yang sepenuhnya memenuhi syarat (misalnya x.y.z)
testName String: nama metode

setRunName

public void setRunName (String runName)

Menetapkan nama proses kustom yang akan dilaporkan ke ITestRunListener pada run()

Jika tidak ditentukan, akan menggunakan nama paket

setTestCollection

public void setTestCollection (boolean b)

Menetapkan pengujian ini ke mode pengumpulan pengujian. Jika benar, akan melewati eksekusi pengujian dan akan menetapkan semua argumen peluncur yang sesuai yang diperlukan untuk pengumpulan pengujian yang berhasil.

Parameter
b boolean

setTestPackageName

public void setTestPackageName (String packageName)

Menetapkan untuk menjalankan semua pengujian dalam paket yang ditentukan Harus dipanggil sebelum 'run'.

Parameter
packageName String: nama paket yang sepenuhnya memenuhi syarat (misalnya x.y.z)

setTestSize

public void setTestSize (IRemoteAndroidTestRunner.TestSize size)

Menetapkan untuk hanya menjalankan pengujian dengan ukuran tertentu. Harus dipanggil sebelum 'run'.

Parameter
size IRemoteAndroidTestRunner.TestSize: TestSize yang akan dijalankan.

Metode yang dilindungi

getRunCommand

protected String getRunCommand ()

Hasil
String

getRunnerPath

protected String getRunnerPath ()

Hasil
String