Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IMetricCollector

java.lang.Objek
com.android.tradefed.device.metric.BaseDeviceMetricCollector


Implementasi dasar IMetricCollector yang memungkinkan untuk memulai dan menghentikan pengumpulan di onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) dan ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) .

Ringkasan

Bidang

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Konstruktor publik

BaseDeviceMetricCollector ()

Metode publik

final getBuildInfos ()

Mengembalikan daftar informasi build yang tersedia dalam pemanggilan.

final getDevices ()

Mengembalikan daftar perangkat yang tersedia dalam doa.

File getFileFromTestArtifacts (String fileName)

Ambil file dari artefak pengujian atau artefak modul dan simpan dalam cache di peta untuk panggilan berikutnya.

final ITestInvocationListener getInvocationListener ()

Mengembalikan ITestInvocationListener asli tempat kami meneruskan hasilnya.

String getModuleName ()
final getRealDevices ()

Mengembalikan semua perangkat non-rintisan dari daftar getDevices() .

String getRunName ()

Mengembalikan nama uji coba mRunName yang memicu kolektor.

ITestInvocationListener init ( IInvocationContext context, ITestInvocationListener listener)

Inisialisasi kolektor dengan konteks saat ini dan ke mana harus meneruskan hasil.

final void invocationEnded (long elapsedTime)

Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil atau karena beberapa kondisi kesalahan.

final void invocationFailed ( FailureDescription failure)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.

final void invocationFailed (Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.

final void invocationStarted ( IInvocationContext context)

Pendengar Doa untuk penerusan

final boolean isDisabled ()

Mengembalikan True jika seluruh objek dinonaktifkan (lewati penyiapan dan pembongkaran).

final void logAssociation (String dataName, LogFile logFile)

Jangan gunakan implementasi pengumpul metrik di dalam.

void onTestAssumptionFailure ( DeviceMetricData testData, TestDescription test)

Panggilan balik saat kasus uji gagal dengan kegagalan asumsi.

void onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)

Panggilan balik saat kasus uji berakhir.

void onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)

Panggilan balik saat kasus uji berakhir.

void onTestFail ( DeviceMetricData testData, TestDescription test)

Callback saat test case gagal.

void onTestModuleEnded ()

Memungkinkan menangkap acara modul berakhir.

void onTestModuleStarted ()

Mengizinkan menangkap acara modul yang dimulai.

void onTestRunEnd ( DeviceMetricData runData, currentRunMetrics) onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)

Panggilan balik saat uji coba berakhir.

void onTestRunFailed ( DeviceMetricData testData, FailureDescription failure)

Panggilan balik untuk acara testRunFailed

void onTestRunStart ( DeviceMetricData runData)

Panggilan balik saat uji coba dimulai.

void onTestStart ( DeviceMetricData testData)

Callback saat test case dimulai.

final void setDisable (boolean isDisabled)

Menetapkan apakah objek harus dinonaktifkan.

final void setLogSaver ( ILogSaver logSaver)

Jangan gunakan implementasi pengumpul metrik di dalam.

final void testAssumptionFailure ( TestDescription test, String trace)

Dipanggil saat tes atom menandai bahwa kondisi tersebut dianggap salah

final void testAssumptionFailure ( TestDescription test, FailureDescription failure)

Dipanggil saat tes atom menandai bahwa kondisi tersebut dianggap salah

final void testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics)

Alternatif untuk ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) tempat kita dapat menentukan waktu berakhir secara langsung.

final void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

Melaporkan akhir eksekusi dari kasus uji individu.

final void testFailed ( TestDescription test, FailureDescription failure)

Melaporkan kegagalan kasus uji individual.

final void testFailed ( TestDescription test, String trace)

Melaporkan kegagalan kasus uji individual.

final void testIgnored ( TestDescription test)

Dipanggil saat pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan org.junit.Ignore.

final void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)

Menyediakan data log atau debug terkait dari pemanggilan pengujian.

final void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

Jangan gunakan implementasi pengumpul metrik di dalam.

final void testModuleEnded ()

Melaporkan akhir dari sebuah modul yang dijalankan.

final void testModuleStarted ( IInvocationContext moduleContext)

Melaporkan awal dari modul yang sedang berjalan.

final void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

Melaporkan akhir uji coba.

final void testRunFailed ( FailureDescription failure)

Uji coba laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription .

final void testRunFailed (String errorMessage)

Uji coba laporan gagal diselesaikan karena kesalahan fatal.

final void testRunStarted (String runName, int testCount, int attemptNumber)

Melaporkan awal uji coba.

final void testRunStarted (String runName, int testCount)

Uji coba callback

final void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)

Melaporkan awal uji coba.

final void testRunStopped (long elapsedTime)

Uji coba laporan berhenti sebelum selesai karena permintaan pengguna.

final void testStarted ( TestDescription test, long startTime)

Alternatif untuk testStarted(com.android.tradefed.result.TestDescription) tempat kami juga menentukan kapan pengujian dimulai, dikombinasikan dengan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) untuk pengukuran yang akurat .

final void testStarted ( TestDescription test)

Test case callback

Bidang

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Konstruktor publik

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

Metode publik

getBuildInfos

public final  getBuildInfos ()

Mengembalikan daftar informasi build yang tersedia dalam pemanggilan.

Pengembalian

getDevices

public final  getDevices ()

Mengembalikan daftar perangkat yang tersedia dalam doa.

Pengembalian

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

Ambil file dari artefak pengujian atau artefak modul dan simpan dalam cache di peta untuk panggilan berikutnya.

Parameter
fileName String : nama file yang akan dicari di artefak.

Pengembalian
File File dari artefak pengujian atau artefak modul. Mengembalikan null jika file tidak ditemukan.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

Mengembalikan ITestInvocationListener asli tempat kami meneruskan hasilnya.

Pengembalian
ITestInvocationListener

getModuleName

public String getModuleName ()

Pengembalian
String

getRealDevices

public final  getRealDevices ()

Mengembalikan semua perangkat non-rintisan dari daftar getDevices() .

Pengembalian

getRunName

public String getRunName ()

Mengembalikan nama uji coba mRunName yang memicu kolektor.

Pengembalian
String mRunName, nama uji coba saat ini.

init

public ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inisialisasi kolektor dengan konteks saat ini dan ke mana harus meneruskan hasil. Hanya akan dipanggil sekali per instans, dan kolektor diharapkan memperbarui konteks internal dan pendengarnya. Init tidak akan pernah dipanggil selama uji coba sebelumnya.

Jangan mengesampingkan kecuali Anda tahu apa yang Anda lakukan.

Parameter
context IInvocationContext : IInvocationContext untuk pemanggilan yang sedang berlangsung.

listener ITestInvocationListener : ITestInvocationListener tempat meletakkan hasil.

Pengembalian
ITestInvocationListener pendengar baru membungkus yang asli.

Melempar
DeviceNotAvailableException

doaBerakhir

public final void invocationEnded (long elapsedTime)

Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil atau karena beberapa kondisi kesalahan.

Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation.

Parameter
elapsedTime long : waktu berlalu dari doa dalam ms

doa Gagal

public final void invocationFailed (FailureDescription failure)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.

Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation.

Parameter
failure FailureDescription : FailureDescription menjelaskan penyebab kegagalan

doa Gagal

public final void invocationFailed (Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.

Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation.

Parameter
cause Throwable : Penyebab kegagalan yang Throwable

invocationStarted

public final void invocationStarted (IInvocationContext context)

Pendengar Doa untuk penerusan

Parameter
context IInvocationContext : informasi tentang doa

Dinonaktifkan

public final boolean isDisabled ()

Mengembalikan True jika seluruh objek dinonaktifkan (lewati penyiapan dan pembongkaran). Salah sebaliknya.

Pengembalian
boolean

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Jangan gunakan implementasi pengumpul metrik di dalam. Ini murni penerusan.

Parameter
dataName String : Nama data

logFile LogFile : LogFile yang telah dicatat sebelumnya dan harus dikaitkan dengan kasus uji.

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Panggilan balik saat kasus uji gagal dengan kegagalan asumsi.

Parameter
testData DeviceMetricData : DeviceMetricData menyimpan data untuk kasus uji.

test TestDescription : TestDescription dari test case yang sedang berlangsung.

Melempar
DeviceNotAvailableException

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

Panggilan balik saat kasus uji berakhir. Ini harus menjadi waktu untuk membersihkan.

Parameter
testData DeviceMetricData : DeviceMetricData menyimpan data untuk kasus uji. Akan menjadi objek yang sama seperti selama onTestStart(com.android.tradefed.device.metric.DeviceMetricData) .

currentTestCaseMetrics : peta metrik saat ini diteruskan ke ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) .

test TestDescription : TestDescription dari test case yang sedang berlangsung.

Melempar
DeviceNotAvailableException

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Panggilan balik saat kasus uji berakhir. Ini harus menjadi waktu untuk membersihkan.

Parameter
testData DeviceMetricData : DeviceMetricData menyimpan data untuk kasus uji. Akan menjadi objek yang sama seperti selama onTestStart(com.android.tradefed.device.metric.DeviceMetricData) .

currentTestCaseMetrics : peta metrik saat ini diteruskan ke ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) .

Melempar
DeviceNotAvailableException

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Callback saat test case gagal.

Parameter
testData DeviceMetricData : DeviceMetricData menyimpan data untuk kasus uji.

test TestDescription : TestDescription dari test case yang sedang berlangsung.

Melempar
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

Memungkinkan menangkap acara modul berakhir.

Melempar
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

Mengizinkan menangkap acara modul yang dimulai.

Melempar
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Panggilan balik saat uji coba berakhir. Ini harus menjadi waktu untuk membersihkan.

Parameter
runData DeviceMetricData : DeviceMetricData menyimpan data untuk dijalankan. Akan menjadi objek yang sama seperti selama onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) .

currentRunMetrics : peta metrik saat ini diteruskan ke ERROR(/#testRunEnded(long,Map)) .

Melempar
DeviceNotAvailableException

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Panggilan balik untuk acara testRunFailed

Melempar
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Panggilan balik saat uji coba dimulai.

Parameter
runData DeviceMetricData : DeviceMetricData menyimpan data untuk dijalankan.

Melempar
DeviceNotAvailableException

onTestStart

public void onTestStart (DeviceMetricData testData)

Callback saat test case dimulai.

Parameter
testData DeviceMetricData : DeviceMetricData menyimpan data untuk kasus uji.

Melempar
DeviceNotAvailableException

setDisable

public final void setDisable (boolean isDisabled)

Menetapkan apakah objek harus dinonaktifkan. Dinonaktifkan berarti langkah penyiapan dan pembongkaran harus dilewati. Dapat digunakan untuk membuat objek dinonaktifkan secara default di konstruktor default.

Parameter
isDisabled boolean : status tempat objek harus diletakkan.

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Jangan gunakan implementasi pengumpul metrik di dalam. Ini murni penerusan.

Parameter
logSaver ILogSaver : ILogSaver

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Dipanggil saat tes atom menandai bahwa kondisi tersebut dianggap salah

Parameter
test TestDescription : mengidentifikasi tes

trace String : tumpukan jejak kegagalan

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Dipanggil saat tes atom menandai bahwa kondisi tersebut dianggap salah

Parameter
test TestDescription : mengidentifikasi tes

failure FailureDescription : FailureDescription menjelaskan kegagalan dan konteksnya.

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternatif untuk ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) tempat kita dapat menentukan waktu berakhir secara langsung. Kombinasikan dengan testStarted(com.android.tradefed.result.TestDescription, long) untuk pengukuran yang akurat.

Parameter
test TestDescription : mengidentifikasi tes

endTime long : waktu pengujian berakhir, diukur melalui System.currentTimeMillis()

testMetrics : ERROR(/Map) dari metrik yang dipancarkan

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

Melaporkan akhir eksekusi dari kasus uji individual.

Jika testFailed(TestDescription, FailureDescription) tidak dipanggil, tes ini lulus. Juga menampilkan metrik kunci/nilai apa pun yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.

Parameter
test TestDescription : mengidentifikasi tes

testMetrics : ERROR(/Map) dari metrik yang dipancarkan

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Melaporkan kegagalan kasus uji individual.

Akan dipanggil antara testStarted dan testEnded.

Parameter
test TestDescription : mengidentifikasi tes

failure FailureDescription : FailureDescription menjelaskan kegagalan dan konteksnya.

testFailed

public final void testFailed (TestDescription test, 
                String trace)

Melaporkan kegagalan kasus uji individu.

Akan dipanggil antara testStarted dan testEnded.

Parameter
test TestDescription : mengidentifikasi tes

trace String : tumpukan jejak kegagalan

testIgnored

public final void testIgnored (TestDescription test)

Dipanggil saat pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan org.junit.Ignore.

Parameter
test TestDescription : mengidentifikasi tes

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Menyediakan data log atau debug terkait dari pemanggilan pengujian.

Harus dipanggil sebelum ERROR(/ITestInvocationListener#invocationFailed(Throwable)) atau ERROR(/ITestInvocationListener#invocationEnded(long))

Kerangka TradeFederation akan secara otomatis memanggil metode ini, memberikan log host dan jika berlaku, logcat perangkat.

Parameter
dataName String : nama deskriptif String dari data. misalnya "device_logcat". Catatan dataName mungkin tidak unik per pemanggilan. yaitu pelaksana harus dapat menangani banyak panggilan dengan dataName yang sama

dataType LogDataType : LogDataType dari data

dataStream InputStreamSource : InputStreamSource dari data. Pelaksana harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup InputStream yang dihasilkan setelah selesai. Penelepon harus memastikan sumber data tetap ada dan dapat diakses hingga metode testLog selesai.

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Jangan gunakan implementasi pengumpul metrik di dalam. Ini murni penerusan.

Parameter
dataName String : nama deskriptif String dari data. misalnya "device_logcat". Catatan dataName mungkin tidak unik per pemanggilan. yaitu pelaksana harus dapat menangani banyak panggilan dengan dataName yang sama

dataType LogDataType : LogDataType dari data

dataStream InputStreamSource : InputStreamSource dari data. Pelaksana harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup InputStream yang dihasilkan setelah selesai.

logFile LogFile : LogFile yang berisi meta data dari file yang disimpan.

testModuleEnded

public final void testModuleEnded ()

Melaporkan akhir dari sebuah modul yang dijalankan.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Melaporkan awal dari modul yang sedang berjalan. Callback ini dikaitkan dengan testModuleEnded() dan opsional dalam urutannya. Ini hanya digunakan selama menjalankan yang menggunakan modul: pelari berbasis suite.

Parameter
moduleContext IInvocationContext : IInvocationContext dari modul.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Melaporkan akhir uji coba. FIXME: Kami tidak dapat memiliki dua antarmuka Map<> dengan tipe yang berbeda, jadi kami harus menggunakan HashMap di sini.

Parameter
elapsedTime long : perangkat melaporkan waktu berlalu, dalam milidetik

runMetrics : key-value pair dilaporkan di akhir uji coba dengan Metric .

testRunFailed

public final void testRunFailed (FailureDescription failure)

Uji coba laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription .

Parameter
failure FailureDescription : FailureDescription menjelaskan kegagalan dan konteksnya.

testRunFailed

public final void testRunFailed (String errorMessage)

Uji coba laporan gagal diselesaikan karena kesalahan fatal.

Parameter
errorMessage String : String yang menjelaskan alasan kegagalan proses.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Melaporkan awal uji coba.

Parameter
runName String : nama uji coba

testCount int : jumlah total pengujian dalam uji coba

attemptNumber int : nomor urut, mengidentifikasi upaya berbeda dari runName yang sama yang berjalan berkali-kali. tryNumber adalah 0-diindeks dan harus bertambah setiap kali proses baru terjadi. misalnya, pengujian diulang ulang sebanyak 3 kali, harus memiliki total 4 proses di bawah runName yang sama dan nomor percobaan dari 0 hingga 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Uji coba callback

Parameter
runName String : nama uji coba

testCount int : jumlah total pengujian dalam uji coba

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Melaporkan awal uji coba.

Parameter
runName String : nama uji coba

testCount int : jumlah total pengujian dalam uji coba

attemptNumber int : nomor urut, mengidentifikasi upaya berbeda dari runName yang sama yang berjalan berkali-kali. tryNumber adalah 0-diindeks dan harus bertambah setiap kali proses baru terjadi. misalnya, pengujian diulang ulang sebanyak 3 kali, harus memiliki total 4 proses di bawah runName yang sama dan nomor percobaan dari 0 hingga 3.

startTime long : waktu proses dimulai, diukur melalui System.currentTimeMillis()

testRunStopped

public final void testRunStopped (long elapsedTime)

Uji coba laporan berhenti sebelum selesai karena permintaan pengguna.

TODO: saat ini tidak digunakan, pertimbangkan untuk menghapus

Parameter
elapsedTime long : perangkat melaporkan waktu berlalu, dalam milidetik

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

Alternatif untuk testStarted(com.android.tradefed.result.TestDescription) tempat kami juga menentukan kapan pengujian dimulai, dikombinasikan dengan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) untuk pengukuran yang akurat .

Parameter
test TestDescription : mengidentifikasi tes

startTime long : waktu pengujian dimulai, diukur melalui System.currentTimeMillis()

testStarted

public final void testStarted (TestDescription test)

Test case callback

Parameter
test TestDescription : mengidentifikasi tes