ICommandScheduler
public
interface
ICommandScheduler
com.android.tradefed.command.ICommandScheduler |
Penjadwal untuk menjalankan perintah TradeFederation.
Ringkasan
Class bertingkat | |
---|---|
interface |
ICommandScheduler.IScheduledInvocationListener
Pemroses untuk peristiwa pemanggilan saat pemanggilan selesai. |
Metode publik | |
---|---|
abstract
Pair<Boolean, Integer>
|
addCommand(String[] args)
Menambahkan perintah ke penjadwal. |
abstract
void
|
addCommandFile(String cmdFile,
Menambahkan semua perintah dari file tertentu ke penjadwal |
abstract
void
|
await()
Menunggu penjadwal mulai berjalan, termasuk menunggu penyerahan dari TF lama selesai jika berlaku. |
abstract
void
|
displayCommandQueue(PrintWriter printWriter)
Menghasilkan info debug mendetail tentang status antrean eksekusi perintah. |
abstract
void
|
displayCommandsInfo(PrintWriter printWriter, String regex)
Menampilkan daftar perintah saat ini. |
abstract
void
|
displayInvocationsInfo(PrintWriter printWriter)
Menampilkan daftar pemanggilan saat ini. |
abstract
void
|
dumpCommandsXml(PrintWriter printWriter, String regex)
Membuang file xml yang diperluas untuk perintah tersebut dengan semua
nilai |
abstract
long
|
execCommand(IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)
Mengalokasikan perangkat secara langsung dan menjalankan perintah tanpa menambahkannya ke antrean perintah
menggunakan |
abstract
long
|
execCommand(ICommandScheduler.IScheduledInvocationListener listener, String[] args)
Secara langsung mengalokasikan perangkat dan menjalankan perintah tanpa menambahkannya ke antrean perintah. |
abstract
long
|
execCommand(ICommandScheduler.IScheduledInvocationListener listener, ITestDevice device, String[] args)
Langsung jalankan perintah di perangkat yang telah dialokasikan. |
abstract
long
|
execCommand(ICommandScheduler.IScheduledInvocationListener listener,
Jalankan perintah secara langsung di perangkat yang telah dialokasikan. |
abstract
CommandFileWatcher
|
getCommandFileWatcher()
Mendapatkan CommandFileWatcher yang sesuai untuk penjadwal ini |
abstract
int
|
getExecutingCommandCount()
Menampilkan jumlah Perintah dalam status eksekusi. |
abstract
String
|
getInvocationInfo(int invocationId)
Menampilkan informasi tentangbu pemanggilan yang menentukan ID pemanggilan. |
abstract
CommandRunner.ExitCode
|
getLastInvocationExitCode()
Menampilkan kode error dari panggilan terakhir yang berjalan. |
abstract
Throwable
|
getLastInvocationThrowable()
Menampilkan |
abstract
int
|
getReadyCommandCount()
Menampilkan jumlah Perintah dalam status siap di antrean. |
abstract
boolean
|
isDeviceInInvocationThread(ITestDevice device)
Menampilkan true (benar) jika perangkat digunakan oleh thread pemanggilan aktif. |
abstract
void
|
join()
Menunggu penjadwal selesai. |
abstract
void
|
join(long millis)
Menunggu penjadwal selesai atau waktu tunggu habis setelah durasi yang ditentukan dalam milidetik. |
abstract
void
|
removeAllCommands()
Menghapus semua perintah dari penjadwal |
abstract
void
|
setClearcutClient(ClearcutClient client)
Menetapkan klien untuk melaporkan data memanfaatkan |
abstract
boolean
|
shouldShutdownOnCmdfileError()
Menampilkan true jika kita perlu menonaktifkan penjadwal saat terjadi error perintah |
default
void
|
shutdown()
Mencoba menonaktifkan penjadwal perintah dengan tuntas. |
abstract
void
|
shutdown(boolean notifyStop)
Mencoba menonaktifkan penjadwal perintah dengan tuntas. |
abstract
void
|
shutdownHard(boolean killAdb)
Mencoba menonaktifkan penjadwal perintah secara paksa. |
abstract
void
|
shutdownHard()
Mencoba menonaktifkan penjadwal perintah secara paksa. |
abstract
void
|
shutdownOnEmpty()
Mirip dengan |
abstract
void
|
start()
Mulai |
abstract
boolean
|
stopInvocation(int invocationId, String cause)
Hentikan pemanggilan yang sedang berjalan dengan menentukan ID-nya. |
default
boolean
|
stopInvocation(int invocationId)
Hentikan pemanggilan yang sedang berjalan dengan menentukan ID-nya. |
abstract
boolean
|
stopInvocation(ITestInvocation invocation)
Menghentikan pemanggilan yang sedang berjalan. |
default
void
|
stopScheduling()
Berhenti menjadwalkan dan menerima pengujian baru, tetapi tidak menghentikan Tradefed. |
Metode publik
addCommand
public abstract Pair<Boolean, Integer> addCommand (String[] args)
Menambahkan perintah ke penjadwal.
Perintah pada dasarnya adalah instance konfigurasi yang akan dijalankan dan argumen terkait.
Jika argumen "--help" ditentukan, teks bantuan untuk konfigurasi akan ditampilkan ke stdout. Jika tidak, konfigurasi akan ditambahkan ke antrean untuk dijalankan.
Parameter | |
---|---|
args |
String : argumen konfigurasi. |
Hasil | |
---|---|
Pair<Boolean, Integer> |
Sepasang nilai, nilai pertama adalah true Boolean jika perintah berhasil ditambahkan. Nilai kedua adalah ID pelacak perintah yang diketahui(nilai non-negatif) jika
perintah berhasil ditambahkan, tampilkan 0 saat perintah ditambahkan untuk semua perangkat, jika tidak,
-1. |
Menampilkan | |
---|---|
ConfigurationException |
jika perintah tidak dapat diuraikan |
addCommandFile
public abstract void addCommandFile (String cmdFile,extraArgs)
Menambahkan semua perintah dari file tertentu ke penjadwal
Parameter | |
---|---|
cmdFile |
String : jalur sistem file file perintah |
extraArgs |
: ERROR(/List) argumen String yang akan ditambahkan ke setiap perintah yang diuraikan
dari file. Dapat kosong, tetapi tidak boleh null. |
Menampilkan | |
---|---|
ConfigurationException |
jika file perintah tidak dapat diuraikan |
Lihat juga:
await
public abstract void await ()
Menunggu penjadwal mulai berjalan, termasuk menunggu penyerahan dari TF lama selesai jika berlaku.
displayCommandQueue
public abstract void displayCommandQueue (PrintWriter printWriter)
Menampilkan info debug mendetail tentang status antrean eksekusi perintah.
displayCommandsInfo
public abstract void displayCommandsInfo (PrintWriter printWriter, String regex)
Menampilkan daftar perintah saat ini.
Parameter | |
---|---|
printWriter |
PrintWriter : ERROR(/PrintWriter) yang akan menghasilkan output. |
regex |
String : ekspresi reguler yang harus dicocokkan dengan perintah agar dapat
dicetak. Jika null, semua perintah akan dicetak. |
displayInvocationsInfo
public abstract void displayInvocationsInfo (PrintWriter printWriter)
Menampilkan daftar pemanggilan saat ini.
Parameter | |
---|---|
printWriter |
PrintWriter : ERROR(/PrintWriter) yang menjadi target output. |
dumpCommandsXml
public abstract void dumpCommandsXml (PrintWriter printWriter, String regex)
Buang file xml yang diperluas untuk perintah dengan semua
nilai Option
yang ditentukan untuk semua perintah saat ini.
Parameter | |
---|---|
printWriter |
PrintWriter : ERROR(/PrintWriter) untuk menampilkan status. |
regex |
String : ekspresi reguler yang harus dicocokkan dengan perintah agar
file XML di-dump. Jika null, semua perintah akan di-dump. |
execCommand
public abstract long execCommand (IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)
Mengalokasikan perangkat secara langsung dan menjalankan perintah tanpa menambahkannya ke antrean perintah
menggunakan IInvocationContext
yang sudah ada.
Parameter | |
---|---|
context |
IInvocationContext : IInvocationContext yang ada. |
listener |
ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener yang akan diberi tahu |
args |
String : argumen perintah |
Hasil | |
---|---|
long |
Menampilkan | |
---|---|
ConfigurationException |
if perintah tidak valid |
NoDeviceException |
jika tidak ada perangkat untuk digunakan |
execCommand
public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener, String[] args)
Secara langsung mengalokasikan perangkat dan menjalankan perintah tanpa menambahkannya ke antrean perintah.
Parameter | |
---|---|
listener |
ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener yang akan diberi tahu |
args |
String : argumen perintah |
Hasil | |
---|---|
long |
ID panggilan perintah terjadwal. |
Menampilkan | |
---|---|
ConfigurationException |
if perintah tidak valid |
NoDeviceException |
jika tidak ada perangkat untuk digunakan |
{i>execCommand<i}
public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener, ITestDevice device, String[] args)
Langsung jalankan perintah di perangkat yang telah dialokasikan.
Parameter | |
---|---|
listener |
ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener yang akan diberi tahu |
device |
ITestDevice : ITestDevice yang akan digunakan |
args |
String : argumen perintah |
Hasil | |
---|---|
long |
ID panggilan perintah terjadwal. |
Menampilkan | |
---|---|
ConfigurationException |
jika perintah tidak valid |
execCommand
public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener,devices, String[] args)
Jalankan perintah secara langsung di perangkat yang sudah dialokasikan.
Parameter | |
---|---|
listener |
ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener yang akan diberi tahu |
devices |
: ERROR(/List yang akan digunakan |
args |
String : argumen perintah |
Hasil | |
---|---|
long |
ID panggilan perintah terjadwal. |
Menampilkan | |
---|---|
ConfigurationException |
jika perintah tidak valid |
getCommandFileWatcher
public abstract CommandFileWatcher getCommandFileWatcher ()
Mendapatkan CommandFileWatcher yang sesuai untuk penjadwal ini
Hasil | |
---|---|
CommandFileWatcher |
getExecutingCommandCount
public abstract int getExecutingCommandCount ()
Menampilkan jumlah Perintah dalam status eksekusi.
Hasil | |
---|---|
int |
getInvocationInfo
public abstract String getInvocationInfo (int invocationId)
Menampilkan informasi tentangbu pemanggilan yang menentukan ID pemanggilan.
Parameter | |
---|---|
invocationId |
int : ID pelacakan pemanggilan. |
Hasil | |
---|---|
String |
String yang berisi informasi tentang pemanggilan. |
getLastInvocationExitCode
public abstract CommandRunner.ExitCode getLastInvocationExitCode ()
Menampilkan kode error dari pemanggilan terakhir yang dijalankan. Menampilkan 0 (tidak ada error), jika belum ada pemanggilan yang dijalankan.
Hasil | |
---|---|
CommandRunner.ExitCode |
getLastInvocationThrowable
public abstract Throwable getLastInvocationThrowable ()
Menampilkan Throwable
dari pemanggilan terakhir yang dijalankan.
Menampilkan null, jika tidak ada throwable yang tersedia.
Hasil | |
---|---|
Throwable |
getReadyCommandCount
public abstract int getReadyCommandCount ()
Menampilkan jumlah Perintah dalam status siap di antrean.
Hasil | |
---|---|
int |
isDeviceInInvocationThread
public abstract boolean isDeviceInInvocationThread (ITestDevice device)
Menampilkan nilai benar jika perangkat digunakan oleh thread pemanggilan aktif.
Parameter | |
---|---|
device |
ITestDevice |
Hasil | |
---|---|
boolean |
gabung
public abstract void join (long millis)
Menunggu penjadwal selesai atau waktu tunggu habis setelah durasi yang ditentukan dalam milidetik.
Parameter | |
---|---|
millis |
long |
Lihat juga:
removeAllCommands
public abstract void removeAllCommands ()
Hapus semua perintah dari penjadwal
setClearcutClient
public abstract void setClearcutClient (ClearcutClient client)
Menetapkan klien untuk melaporkan data harness
Parameter | |
---|---|
client |
ClearcutClient |
shouldShutdownOnCmdfileError
public abstract boolean shouldShutdownOnCmdfileError ()
Menampilkan true jika kita perlu menonaktifkan penjadwal saat terjadi error perintah
Hasil | |
---|---|
boolean |
shutdown
public void shutdown ()
Mencoba mematikan penjadwal perintah dengan baik.
Menghapus perintah yang menunggu untuk diuji, dan meminta agar semua pemanggilan yang sedang berlangsung dihentikan dengan baik.
Setelah shutdown dipanggil, loop utama penjadwal akan menunggu semua pemanggilan yang sedang berlangsung selesai sebelum keluar sepenuhnya.
shutdown
public abstract void shutdown (boolean notifyStop)
Mencoba mematikan penjadwal perintah dengan baik.
Parameter | |
---|---|
notifyStop |
boolean : jika benar, akan memberi tahu pemanggilan penonaktifan TF. |
shutdownHard
public abstract void shutdownHard (boolean killAdb)
Mencoba menonaktifkan penjadwal perintah secara paksa.
Serupa dengan shutdown()
, tetapi juga akan secara opsional menghentikan koneksi adb, dalam
upaya untuk 'menginspirasi' pemanggilan yang sedang berlangsung agar selesai lebih cepat.
Parameter | |
---|---|
killAdb |
boolean |
shutdownHard
public abstract void shutdownHard ()
Mencoba menonaktifkan penjadwal perintah secara paksa. Sama seperti shutdownHard(true).
shutdownOnEmpty
public abstract void shutdownOnEmpty ()
Mirip dengan shutdown()
, tetapi akan menunggu semua perintah dieksekusi
sebelum keluar.
Perhatikan bahwa jika ada perintah dalam mode loop, penjadwal tidak akan pernah keluar.
start
public abstract void start ()
Mulai ICommandScheduler
.
Harus dipanggil sebelum memanggil metode lain.
Akan berjalan hingga shutdown()
dipanggil.
lihat Thread.start()
.
stopInvocation
public abstract boolean stopInvocation (int invocationId, String cause)
Hentikan pemanggilan yang sedang berjalan dengan menentukan ID-nya.
Parameter | |
---|---|
invocationId |
int : ID pelacakan pemanggilan. |
cause |
String : penyebab penghentian pemanggilan. |
Hasil | |
---|---|
boolean |
true jika pemanggilan dihentikan, false jika tidak |
Menampilkan | |
---|---|
UnsupportedOperationException |
jika penerapan tidak mendukungnya |
stopInvocation
public boolean stopInvocation (int invocationId)
Hentikan pemanggilan yang sedang berjalan dengan menentukan ID-nya.
Parameter | |
---|---|
invocationId |
int |
Hasil | |
---|---|
boolean |
true jika pemanggilan dihentikan, false jika tidak |
Menampilkan | |
---|---|
UnsupportedOperationException |
jika penerapan tidak mendukungnya |
stopInvocation
public abstract boolean stopInvocation (ITestInvocation invocation)
Menghentikan pemanggilan yang sedang berjalan.
Parameter | |
---|---|
invocation |
ITestInvocation |
Hasil | |
---|---|
boolean |
true jika pemanggilan dihentikan, false jika tidak |
Menampilkan | |
---|---|
UnsupportedOperationException |
jika implementasinya tidak mendukung |
stopScheduling
public void stopScheduling ()
Berhenti menjadwalkan dan menerima pengujian baru, tetapi tidak menghentikan Tradefed. Hal ini dimaksudkan untuk mengaktifkan penonaktifan dua langkah, yaitu pertama-tama kita menghabiskan semua pengujian yang sedang berjalan, lalu menghentikan proses Tradefed.