Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Halaman ini diterjemahkan oleh Cloud Translation API.

BasePostProcessor

public abstract class BasePostProcessor
extends Object implements IPostProcessor

java.lang.Object
↳	com.android.tradefed.postprocessor.BasePostProcessor

Subclass langsung yang dikenal

AggregatePostProcessor, AveragePostProcessor, BluetoothConnectionSuccessRatePostProcessor, MetricFilePostProcessor, PerfettoGenericPostProcessor, StatsdGenericPostProcessor

AggregatePostProcessor	Agregator metrik yang memberikan nilai minimum, maksimum, rata-rata, varians, simpangan baku, total, jumlah, dan persentil opsional untuk metrik numerik yang dikumpulkan selama pengujian beberapa iterasi berjalan, memperlakukannya sebagai bilangan ganda.
AveragePostProcessor	Implementasi post-processor yang menghitung rata-rata daftar metrik.
BluetoothConnectionSuccessRatePostProcessor	Implementasi postprocessor yang menghitung tingkat keberhasilan untuk profil Bluetooth Gunakan "metric-key-match" untuk menentukan metrik yang berisi status koneksi Bluetooth dalam array numerik Contoh [0, 1, 2, 3, 0, 1, 2, 3].
MetricFilePostProcessor	Digunakan untuk mengupload file log metrik yang dikumpulkan selama pengujian dan tingkat operasi.
PerfettoGenericPostProcessor	Post-processor yang memproses file proto metrik teks/biner menjadi key-value pair dengan memperluas pesan dan kolom proto secara rekursif dengan nilai string hingga kolom dengan nilai numerik ditemukan.
StatsdGenericPostProcessor	Post-processor yang memproses laporan statsd proto biner menjadi key-value pair dengan memperluas laporan sebagai struktur hierarki.

Subclass tidak langsung yang umum

StatsdBeforeAfterGaugeMetricPostProcessor, StatsdEventMetricPostProcessor

StatsdBeforeAfterGaugeMetricPostProcessor	Post-processor yang memproses metrik pengukur yang dikumpulkan dalam pendekatan "sebelum/setelah", yaitu.
StatsdEventMetricPostProcessor	Post-processor yang memproses metrik peristiwa dalam laporan statsd menjadi pasangan nilai kunci, menggunakan formater yang ditentukan pada pemroses.

IPostProcessor dasar yang harus diperluas oleh setiap implementasi. Pastikan metode pemrosesan pasca dipanggil sebelum pelapor hasil akhir.

Ringkasan

Konstruktor publik
`BasePostProcessor()`

Metode publik
`final ITestInvocationListener`	`init(ITestInvocationListener listener)` Langkah inisialisasi post-processor.
`final void`	`invocationEnded(long elapsedTime)` Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena beberapa kondisi error.
`final void`	`invocationFailed(FailureDescription failure)` Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.
`final void`	`invocationFailed(Throwable cause)` Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.
`void`	`invocationSkipped(SkipReason reason)` Melaporkan pemanggilan sebagai dilewati
`final void`	`invocationStarted(IInvocationContext context)` Pemroses Pemanggilan untuk penerusan
`final boolean`	`isDisabled()` Menampilkan True jika seluruh objek dinonaktifkan (lewati penyiapan dan penghapusan).
`final void`	`logAssociation(String dataName, LogFile logFile)` Dalam beberapa kasus, log harus dikaitkan secara kuat dengan kasus pengujian, tetapi peluang untuk melakukannya pada callback `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` langsung tidak memungkinkan. Memperbarui pengaitan log-to-test.
	`processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)` Terapkan metode ini untuk menggabungkan metrik dan log di semua pengujian.
`abstract`	`processRunMetricsAndLogs( rawMetrics, runLogs)` Terapkan metode ini untuk menghasilkan kumpulan metrik baru dari metrik dan log yang ada.
	`processTestMetricsAndLogs(TestDescription testDescription, testMetrics, testLogs)` Terapkan metode ini untuk memproses metrik dan log pasca-pengujian dari setiap pengujian.
`final void`	`setLogSaver(ILogSaver logSaver)` Tetapkan `ILogSaver` untuk mengizinkan implementor menyimpan file.
`void`	`setUp()` Ganti metode ini di post-processor turunan untuk melakukan inisialisasi sebelum pengujian dijalankan.
`final void`	`testAssumptionFailure(TestDescription test, String trace)` Dipanggil saat pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Dipanggil saat pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
`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.
`final void`	`testEnded(TestDescription test, testMetrics)` Melaporkan akhir eksekusi setiap kasus pengujian.
`final void`	`testFailed(TestDescription test, FailureDescription failure)` Melaporkan kegagalan kasus pengujian individual.
`final void`	`testFailed(TestDescription test, String trace)` Melaporkan kegagalan kasus pengujian individual.
`final void`	`testIgnored(TestDescription test)` Dipanggil saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore.
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Gunakan metode ini untuk mencatat file dari implementasi PostProcessor.
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Dipanggil saat log pengujian disimpan.
`final void`	`testModuleEnded()` Melaporkan akhir proses modul.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` Melaporkan awal modul yang berjalan.
`final void`	`testRunEnded(long elapsedTime, runMetrics)` Melaporkan akhir pengujian yang dijalankan.
`final void`	`testRunFailed(FailureDescription failure)` Operasi pengujian laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh `FailureDescription`.
`final void`	`testRunFailed(String errorMessage)` Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Melaporkan awal pengujian yang dijalankan.
`final void`	`testRunStarted(String runName, int testCount)` Menguji callback run
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Melaporkan awal pengujian yang dijalankan.
`final void`	`testRunStopped(long elapsedTime)` Pengujian laporan berhenti sebelum selesai karena permintaan pengguna.
`final void`	`testSkipped(TestDescription test, SkipReason reason)` Dipanggil saat pengujian dilewati dan tidak dieksekusi karena alasan yang biasanya tidak diharapkan.
`final void`	`testStarted(TestDescription test, long startTime)` Alternatif untuk `testStarted(com.android.tradefed.result.TestDescription)` tempat kita juga menentukan kapan pengujian dimulai, digabungkan dengan `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` untuk pengukuran yang akurat.
`final void`	`testStarted(TestDescription test)` Callback kasus pengujian

Metode yang dilindungi
`void`	`cleanUp()`
`MetricMeasurement.DataType`	`getMetricType()` Ganti metode ini untuk mengubah jenis metrik jika diperlukan.
`String`	`getRunName()`

Konstruktor publik

BasePostProcessor

public BasePostProcessor ()

Metode publik

init

public final ITestInvocationListener init (ITestInvocationListener listener)

Langkah inisialisasi post-processor. Dijamin akan dipanggil sebelum callback pengujian apa pun.

Parameter
`listener`	`ITestInvocationListener`

Hasil
`ITestInvocationListener`

invocationEnded

public final void invocationEnded (long elapsedTime)

Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena beberapa kondisi error.

Akan otomatis dipanggil oleh framework TradeFederation.

Parameter
`elapsedTime`	`long`: waktu yang berlalu dari pemanggilan dalam md

invocationFailed

public final void invocationFailed (FailureDescription failure)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.

Akan otomatis dipanggil oleh framework TradeFederation.

Parameter
`failure`	`FailureDescription`: `FailureDescription` yang menjelaskan penyebab kegagalan

invocationFailed

public final void invocationFailed (Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.

Akan otomatis dipanggil oleh framework TradeFederation.

Parameter
`cause`	`Throwable`: `Throwable` penyebab kegagalan

invocationSkipped

public void invocationSkipped (SkipReason reason)

Melaporkan pemanggilan sebagai dilewati

Parameter
`reason`	`SkipReason`

invocationStarted

public final void invocationStarted (IInvocationContext context)

Pemroses Pemanggilan untuk penerusan

Parameter
`context`	`IInvocationContext`: informasi tentang pemanggilan

isDisabled

public final boolean isDisabled ()

Menampilkan True jika seluruh objek dinonaktifkan (lewati penyiapan dan penghapusan). Salah jika tidak.

Hasil
`boolean`

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Dalam beberapa kasus, log harus dikaitkan secara kuat dengan kasus pengujian, tetapi peluang untuk melakukannya pada callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) langsung tidak memungkinkan. Dengan demikian, callback ini memungkinkan untuk memberikan pengaitan yang kuat secara eksplisit.

Memperbarui pengaitan log-to-test. Jika metode ini dipanggil selama pengujian, log akan menjadi milik pengujian; jika tidak, log akan menjadi log operasi.

Parameter
`dataName`	`String`: Nama data
`logFile`	`LogFile`: `LogFile` yang dicatat sebelumnya dan harus dikaitkan dengan kasus pengujian.

processAllTestMetricsAndLogs

public  processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                 allTestLogs)

Terapkan metode ini untuk menggabungkan metrik dan log di semua pengujian. Metrik yang dihasilkan dari metode ini akan dilaporkan sebagai metrik run. Hanya metrik yang baru dibuat yang harus ditampilkan, dan dengan nama kunci unik (tidak ada tabrakan dengan kunci yang ada).

Parameter
`allTestMetrics`	`ListMultimap`: HashMultimap yang menyimpan metrik dari setiap pengujian yang dikelompokkan menurut nama metrik.
`allTestLogs`	: Peta yang menyimpan peta file log setiap pengujian yang diberi kunci berdasarkan nama datanya, menggunakan `TestDescription` setiap pengujian sebagai kunci.

Hasil
	Kumpulan metrik yang baru dibuat dari semua metrik pengujian.

processRunMetricsAndLogs

public abstract  processRunMetricsAndLogs ( rawMetrics, 
                 runLogs)

Terapkan metode ini untuk menghasilkan kumpulan metrik baru dari metrik dan log yang ada. Hanya metrik yang baru dibuat yang akan ditampilkan, dan dengan nama kunci unik (tidak diizinkan terjadi tabrakan dengan kunci yang ada).

Parameter
`rawMetrics`	: Kumpulan metrik mentah yang tersedia untuk dijalankan.
`runLogs`	: Kumpulan file log untuk pengujian yang dijalankan.

Hasil
	Kumpulan metrik yang baru dibuat dari metrik run.

processTestMetricsAndLogs

public  processTestMetricsAndLogs (TestDescription testDescription, 
                 testMetrics, 
                 testLogs)

Terapkan metode ini untuk memproses metrik dan log pasca-pengujian dari setiap pengujian. Hanya metrik yang baru dihasilkan yang akan ditampilkan, dan dengan nama kunci unik (tidak ada tabrakan dengan kunci yang ada).

Parameter
`testDescription`	`TestDescription`: Objek TestDescription yang menjelaskan pengujian.
`testMetrics`	: Kumpulan metrik dari pengujian.
`testLogs`	: Kumpulan file yang dicatat ke dalam log selama pengujian.

Hasil
	Kumpulan metrik yang baru dibuat dari metrik pengujian.

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Tetapkan ILogSaver untuk mengizinkan implementor menyimpan file.

Parameter
`logSaver`	`ILogSaver`: `ILogSaver`

setUp

public void setUp ()

Ganti metode ini di post-processor turunan untuk melakukan inisialisasi sebelum pengujian dijalankan.

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Dipanggil saat pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`trace`	`String`: stack trace kegagalan

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Dipanggil saat pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`failure`	`FailureDescription`: `FailureDescription` yang 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. Gabungkan dengan testStarted(com.android.tradefed.result.TestDescription, long) untuk pengukuran yang akurat.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`endTime`	`long`: waktu pengujian berakhir, diukur melalui `System.currentTimeMillis()`
`testMetrics`	: `ERROR(/Map)` dari metrik yang dikeluarkan

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

Melaporkan akhir eksekusi setiap kasus pengujian.

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

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`testMetrics`	: `ERROR(/Map)` dari metrik yang dikeluarkan

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Melaporkan kegagalan kasus pengujian individual.

Akan dipanggil antara testStarted dan testEnded.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`failure`	`FailureDescription`: `FailureDescription` yang menjelaskan kegagalan dan konteksnya.

testFailed

public final void testFailed (TestDescription test, 
                String trace)

Melaporkan kegagalan kasus pengujian individual.

Akan dipanggil antara testStarted dan testEnded.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`trace`	`String`: stack trace kegagalan

testIgnored

public final void testIgnored (TestDescription test)

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

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian

testLog

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

Gunakan metode ini untuk mencatat file dari implementasi PostProcessor.

Parameter
`dataName`	`String`: nama deskriptif `String` data. misalnya, "device_logcat". Perhatikan bahwa dataName mungkin tidak unik per pemanggilan. Artinya, pengimplementasi harus dapat menangani beberapa panggilan dengan dataName yang sama
`dataType`	`LogDataType`: `LogDataType` data
`dataStream`	`InputStreamSource`: `InputStreamSource` data. Implementator harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup InputStream yang dihasilkan setelah selesai. Pemanggil 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)

Dipanggil saat log pengujian disimpan.

Harus digunakan sebagai pengganti ITestInvocationListener.testLog(String, LogDataType, InputStreamSource).

Parameter
`dataName`	`String`: nama deskriptif `String` data. misalnya, "device_logcat". Perhatikan bahwa dataName mungkin tidak unik per pemanggilan. Artinya, pengimplementasi harus dapat menangani beberapa panggilan dengan dataName yang sama
`dataType`	`LogDataType`: `LogDataType` data
`dataStream`	`InputStreamSource`: `InputStreamSource` data. Implementator harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup InputStream yang dihasilkan setelah selesai.
`logFile`	`LogFile`: `LogFile` yang berisi metadata file yang disimpan.

testModuleEnded

public final void testModuleEnded ()

Melaporkan akhir proses modul.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Melaporkan awal modul yang berjalan. Callback ini dikaitkan dengan testModuleEnded() dan bersifat opsional dalam urutan. Ini hanya digunakan selama operasi yang menggunakan modul: runner berbasis suite.

Parameter
`moduleContext`	`IInvocationContext`: `IInvocationContext` modul.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Melaporkan akhir pengujian yang dijalankan.

Parameter
`elapsedTime`	`long`: waktu berlalu yang dilaporkan perangkat, dalam milidetik
`runMetrics`	: pasangan nilai kunci yang dilaporkan di akhir pengujian

testRunFailed

public final void testRunFailed (FailureDescription failure)

Operasi pengujian laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription.

Parameter
`failure`	`FailureDescription`: `FailureDescription` yang menjelaskan kegagalan dan konteksnya.

testRunFailed

public final void testRunFailed (String errorMessage)

Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.

Parameter
`errorMessage`	`String`: `String` yang menjelaskan alasan kegagalan operasi.

testRunStarted

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

Melaporkan awal pengujian yang dijalankan.

Parameter
`runName`	`String`: nama operasi pengujian
`testCount`	`int`: jumlah total pengujian dalam operasi pengujian
`attemptNumber`	`int`: nomor urutan, yang mengidentifikasi berbagai upaya runName yang sama yang berjalan beberapa kali. attemptNumber diberi indeks 0 dan harus bertambah setiap kali operasi baru terjadi. Misalnya, pengujian dicoba ulang secara terperinci 3 kali, pengujian tersebut harus memiliki total 4 operasi di bawah runName yang sama dan attemptNumber-nya adalah dari 0 hingga 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Menguji callback run

Parameter
`runName`	`String`: nama operasi pengujian
`testCount`	`int`: jumlah total pengujian dalam operasi pengujian

testRunStarted

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

Melaporkan awal pengujian yang dijalankan.

Parameter
`runName`	`String`: nama operasi pengujian
`testCount`	`int`: jumlah total pengujian dalam operasi pengujian
`attemptNumber`	`int`: nomor urutan, yang mengidentifikasi berbagai upaya runName yang sama yang berjalan beberapa kali. attemptNumber diberi indeks 0 dan harus bertambah setiap kali operasi baru terjadi. Misalnya, pengujian dicoba ulang secara terperinci 3 kali, pengujian tersebut harus memiliki total 4 operasi di bawah runName yang sama dan attemptNumber adalah dari 0 hingga 3.
`startTime`	`long`: waktu mulai operasi, diukur melalui `System.currentTimeMillis()`

testRunStopped

public final void testRunStopped (long elapsedTime)

Pengujian laporan berhenti sebelum selesai karena permintaan pengguna.

TODO: currently unused, consider removing

Parameter
`elapsedTime`	`long`: waktu berlalu yang dilaporkan perangkat, dalam milidetik

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

Dipanggil saat pengujian dilewati dan tidak dieksekusi karena alasan yang biasanya tidak diharapkan. Pengujian ini akan dicoba untuk dicoba lagi untuk mencoba mendapatkan eksekusi yang tepat.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`reason`	`SkipReason`: `SkipReason`

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

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

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`startTime`	`long`: waktu pengujian dimulai, diukur melalui `System.currentTimeMillis()`

testStarted

public final void testStarted (TestDescription test)

Callback kasus pengujian

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian

Metode yang dilindungi

cleanUp

protected void cleanUp ()

getMetricType

protected MetricMeasurement.DataType getMetricType ()

Ganti metode ini untuk mengubah jenis metrik jika diperlukan. Secara default, metrik disetel ke jenis yang diproses.

Hasil
`MetricMeasurement.DataType`

getRunName

protected String getRunName ()

Hasil
`String`