IRemoteAndroidTestRunner

public interface IRemoteAndroidTestRunner

com.android.ddmlib.testrunner.IRemoteAndroidTestRunner

Antarmuka untuk menjalankan perintah pengujian Android dari jarak jauh dan melaporkan hasil ke pemroses.

Ringkasan

Metode publik

abstract void addBooleanArg(String name, boolean value)

Menambahkan argumen boolean untuk disertakan dalam perintah instrumentasi.

abstract void addInstrumentationArg(String name, String value)

Menambahkan argumen untuk disertakan dalam perintah instrumentasi.

abstract void cancel()

Meminta pembatalan proses pengujian ini.

abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

Menampilkan jenis cakupan pengujian yang dihasilkan oleh runner.

abstract String getPackageName()

Menampilkan nama paket aplikasi.

abstract String getRunnerName()

Menampilkan runnerName.

abstract void removeInstrumentationArg(String name)

Menghapus argumen yang sebelumnya ditambahkan.

abstract void run(ITestRunListener... listeners)

Jalankan pengujian ini.

abstract void run( listeners)

Jalankan pengujian ini.

abstract void setAdditionalTestOutputLocation(String additionalTestDataPath)

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

abstract void setClassName(String className)

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

abstract void setClassNames(String[] classNames)

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

abstract void setCoverage(boolean coverage)

Menetapkan mode cakupan kode ini untuk pengujian ini.

abstract void setCoverageReportLocation(String reportPath)

Menetapkan lokasi laporan cakupan yang dihasilkan.

abstract void setDebug(boolean debug)

Menetapkan mode debug untuk pengujian ini.

abstract void setLogOnly(boolean logOnly)

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

abstract void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

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

abstract void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

Menetapkan waktu maksimum yang diizinkan untuk penyelesaian instrumentasi.

abstract void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)

Metode ini tidak digunakan lagi. Gunakan ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)).

abstract void setMethodName(String className, String testName)

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

abstract void setRunName(String runName)

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

Jika tidak ditentukan, akan menggunakan nama paket

abstract void setTestCollection(boolean collection)

Menetapkan pengujian ini ke mode pengumpulan pengujian.

abstract void setTestPackageName(String packageName)

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

abstract void setTestSize(IRemoteAndroidTestRunner.TestSize size)

Menetapkan untuk hanya menjalankan pengujian dengan ukuran tertentu.

Metode publik

addBooleanArg

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

Meminta pembatalan proses pengujian ini.

getCoverageOutputType

public abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

Hasil
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public abstract String getPackageName ()

Menampilkan nama paket aplikasi.

Hasil
String

getRunnerName

public abstract String getRunnerName ()

Menampilkan runnerName.

Hasil
String

removeInstrumentationArg

public abstract void removeInstrumentationArg (String name)

Menghapus argumen yang sebelumnya ditambahkan.

Parameter
name String: nama argumen paket instrumentasi yang akan dihapus

lari

public abstract void run (ITestRunListener... listeners)

Jalankan pengujian ini.

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

Parameter
listeners ITestRunListener: memantau hasil pengujian
Menampilkan
TimeoutException jika terjadi waktu tunggu habis pada koneksi.
AdbCommandRejectedException jika adb menolak perintah
ShellCommandUnresponsiveException jika perangkat tidak menghasilkan hasil pengujian apa pun selama periode yang lebih lama dari waktu maksimum untuk menghasilkan output.
jika koneksi ke perangkat terputus.

lari

public abstract void run ( listeners)

Jalankan pengujian ini.

Parameter
listeners : kumpulan pemroses untuk hasil pengujian
Menampilkan
TimeoutException jika terjadi waktu tunggu habis pada koneksi.
AdbCommandRejectedException jika adb menolak perintah
ShellCommandUnresponsiveException jika perangkat tidak menghasilkan hasil pengujian apa pun selama periode yang lebih lama dari waktu maksimum untuk menghasilkan output.
jika koneksi ke perangkat terputus.

setAdditionalTestOutputLocation

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

Menetapkan mode cakupan kode ini untuk pengujian ini.

Parameter
coverage boolean

setCoverageReportLocation

public abstract void setCoverageReportLocation (String reportPath)

Menetapkan lokasi laporan cakupan yang dihasilkan.

Parameter
reportPath String

setDebug

public abstract 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 abstract void setLogOnly (boolean logOnly)

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

Parameter
logOnly boolean

setMaxTimeToOutputResponse

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

Metode ini tidak digunakan lagi.
Gunakan ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)).

Parameter
maxTimeToOutputResponse int

setMethodName

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

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

Jika tidak ditentukan, akan menggunakan nama paket

setTestCollection

public abstract void setTestCollection (boolean collection)

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

setTestPackageName

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