RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

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

Menjalankan perintah pengujian Android dari jarak jauh dan melaporkan hasilnya.

Ringkasan

Konstruktor publik

RemoteAndroidTestRunner(String packageName, IShellEnabledDevice remoteDevice)

Konstruktor alternatif.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice)

Konstruktor alternatif.

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

Membuat runner pengujian Android jarak jauh.

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.

IInstrumentationResultParser createParser(String runName, listeners)

Buat InstrumentationResultParser yang akan digunakan untuk mengurai output instrumentasi.

String getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

Menampilkan jenis cakupan pengujian yang dihasilkan oleh runner.

String getPackageName()

Menampilkan nama paket aplikasi.

String getRunOptions()

Menampilkan opsi untuk perintah instrumen am.

String getRunnerName()

Menampilkan runnerName.

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

Menetapkan lokasi laporan cakupan yang dihasilkan.

void setDebug(boolean debug)

Menetapkan mode debug untuk pengujian ini.

void setLogOnly(boolean logOnly)

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

void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

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

void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

Menetapkan waktu maksimum yang diizinkan untuk penyelesaian instrumentasi.

void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
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 setRunOptions(String options)

Menetapkan opsi untuk perintah instrumen am.

void setTestCollection(boolean collect)

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

Menampilkan sintaksis command line instrumentasi lengkap untuk argumen instrumentasi yang diberikan.

String getRunnerPath()

Menampilkan jalur komponen instrumentasi lengkap.

Konstruktor publik

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

Konstruktor alternatif. Menggunakan pelari instrumentasi default.

Parameter
packageName String: paket aplikasi Android yang berisi pengujian yang akan dijalankan
remoteDevice IShellEnabledDevice: perangkat Android untuk menjalankan pengujian

RemoteAndroidTestRunner

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

Konstruktor alternatif. Menggunakan default statusReporterMode.

Parameter
packageName String: paket aplikasi Android yang berisi pengujian yang akan dijalankan
runnerName String: runner pengujian instrumentasi yang akan dieksekusi. Jika null, akan menggunakan peluncur default
remoteDevice IShellEnabledDevice: perangkat Android untuk menjalankan pengujian

RemoteAndroidTestRunner

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

Membuat runner pengujian Android jarak jauh.

Parameter
packageName String: paket aplikasi Android yang berisi pengujian yang akan dijalankan
runnerName String: runner pengujian instrumentasi yang akan dieksekusi. Jika null, akan menggunakan peluncur default
remoteDevice IShellEnabledDevice: perangkat Android untuk menjalankan pengujian
statusReporterMode RemoteAndroidTestRunner.StatusReporterMode: mode pelapor status yang akan digunakan untuk perintah instrumen

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.

createParser

public IInstrumentationResultParser createParser (String runName, 
                 listeners)

Buat InstrumentationResultParser yang akan digunakan untuk mengurai output instrumentasi.

Parameter
runName String: Nama operasi yang akan digunakan.
listeners : Pemroses tempat melaporkan hasil.
Hasil
IInstrumentationResultParser Instance InstrumentationResultParser.

getAmInstrumentCommand

public String getAmInstrumentCommand ()

Hasil
String

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

Hasil
String

getRunOptions

public String getRunOptions ()

Menampilkan opsi untuk perintah am instrument.

Hasil
String

getRunnerName

public String getRunnerName ()

Menampilkan runnerName.

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

Menetapkan lokasi laporan cakupan yang dihasilkan.

Parameter
reportPath 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

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 maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

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
maxTimeToOutputResponse 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.
maxTimeUnits TimeUnit: Satuan untuk nilai maxTimeToOutputResponse dan maxTimeout selain nol.

setMaxTimeout

public void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

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.
maxTimeUnits TimeUnit: Satuan untuk nilai maxTimeToOutputResponse dan maxTimeout selain nol.

setMaxtimeToOutputResponse

public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

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

setRunOptions

public void setRunOptions (String options)

Menetapkan opsi untuk perintah am instrument. Lihat com/android/commands/am/Am.java untuk mengetahui daftar lengkap opsi.

Parameter
options String

setTestCollection

public void setTestCollection (boolean collect)

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

getArgsCommand

protected String getArgsCommand ()

Menampilkan sintaksis command line instrumentasi lengkap untuk argumen instrumentasi yang diberikan. Menampilkan string kosong jika tidak ada argumen yang ditentukan.

Hasil
String

getRunnerPath

protected String getRunnerPath ()

Menampilkan jalur komponen instrumentasi lengkap.

Hasil
String