Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Urządzenie bazoweMetric Collector

public class BaseDeviceMetricCollector
extends Object implements IMetricCollector

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


Podstawowa implementacja IMetricCollector , która umożliwia uruchamianie i zatrzymywanie zbierania onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) oraz ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) .

Streszczenie

Pola

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Konstruktorzy publiczni

BaseDeviceMetricCollector ()

Metody publiczne

final getBuildInfos ()

Zwraca listę informacji o kompilacji dostępnych w wywołaniu.

final getDevices ()

Zwraca listę urządzeń dostępnych w wywołaniu.

File getFileFromTestArtifacts (String fileName)

Pobierz plik z artefaktów testowych lub artefaktów modułów i umieść go w pamięci podręcznej w mapie dla kolejnych wywołań.

final ITestInvocationListener getInvocationListener ()

Zwraca oryginalny ITestInvocationListener , w którym przekazujemy wyniki.

final getRealDevices ()

Zwraca wszystkie urządzenia inne niż skrótowe z listy getDevices() .

String getRunName ()

Zwraca nazwę przebiegu testowego mRunName , który wyzwala kolektor.

ITestInvocationListener init ( IInvocationContext context, ITestInvocationListener listener)

Inicjalizacja kolektora z bieżącym kontekstem i miejscem przekazania wyników.

final void invocationEnded (long elapsedTime)

Informuje, że wywołanie zostało zakończone pomyślnie lub z powodu błędu.

final void invocationFailed ( FailureDescription failure)

Zgłasza niekompletne wywołanie z powodu jakiegoś błędu.

final void invocationFailed (Throwable cause)

Zgłasza niekompletne wywołanie z powodu jakiegoś błędu.

final void invocationStarted ( IInvocationContext context)

Odbiorniki wywołania do przekazywania

final boolean isDisabled ()

Zwraca True, jeśli cały obiekt jest wyłączony (pomiń zarówno konfigurację, jak i usuwanie).

final void logAssociation (String dataName, LogFile logFile)

Nie używaj implementacji wewnętrznego kolektora metrycznego.

void onTestAssumptionFailure ( DeviceMetricData testData, TestDescription test)

Wywołanie zwrotne w przypadku niepowodzenia przypadku testowego z niepowodzeniem założenia.

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

Oddzwanianie po zakończeniu przypadku testowego.

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

Oddzwanianie po zakończeniu przypadku testowego.

void onTestFail ( DeviceMetricData testData, TestDescription test)

Wywołanie zwrotne w przypadku niepowodzenia przypadku testowego.

void onTestModuleEnded ()

Umożliwia przechwytywanie zdarzenia zakończenia modułu.

void onTestModuleStarted ()

Umożliwia przechwytywanie zdarzenia uruchomionego przez moduł.

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

Oddzwanianie po zakończeniu przebiegu testowego.

void onTestRunFailed ( DeviceMetricData testData, FailureDescription failure)

Wywołanie zwrotne dla zdarzeń testRunFailed

void onTestRunStart ( DeviceMetricData runData)

Wywołanie zwrotne po uruchomieniu uruchomienia testowego.

void onTestStart ( DeviceMetricData testData)

Wywołanie zwrotne po uruchomieniu przypadku testowego.

final void setDisable (boolean isDisabled)

Ustawia, czy obiekt powinien być wyłączony.

final void setLogSaver ( ILogSaver logSaver)

Nie używaj implementacji wewnętrznego kolektora metrycznego.

final void testAssumptionFailure ( TestDescription test, String trace)

Wywoływane, gdy atomowy test oznaczy, że przyjmuje warunek, który jest fałszywy

final void testAssumptionFailure ( TestDescription test, FailureDescription failure)

Wywoływane, gdy atomowy test oznaczy, że przyjmuje warunek, który jest fałszywy

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

Alternatywa dla ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) gdzie możemy bezpośrednio określić czas zakończenia.

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

Raportuje zakończenie wykonywania pojedynczego przypadku testowego.

final void testFailed ( TestDescription test, FailureDescription failure)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

final void testFailed ( TestDescription test, String trace)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

final void testIgnored ( TestDescription test)

Wywoływana, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa ma adnotację org.junit.Ignore.

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

Udostępnia skojarzone dane dziennika lub debugowania z wywołania testowego.

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

Nie używaj implementacji wewnętrznego kolektora metrycznego.

final void testModuleEnded ()

Zgłasza koniec uruchomienia modułu.

final void testModuleStarted ( IInvocationContext moduleContext)

Raportuje początek działania modułu.

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

Raportuje koniec uruchomienia testowego.

final void testRunFailed ( FailureDescription failure)

Testowanie raportów nie powiodło się z powodu błędu opisanego przez FailureDescription .

final void testRunFailed (String errorMessage)

Testowanie raportów nie powiodło się z powodu błędu krytycznego.

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

Raportuje początek uruchomienia testowego.

final void testRunStarted (String runName, int testCount)

Testowe wywołania zwrotne

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

Raportuje początek uruchomienia testowego.

final void testRunStopped (long elapsedTime)

Raporty, że uruchomienie testowe zostało zatrzymane przed zakończeniem z powodu żądania użytkownika.

final void testStarted ( TestDescription test, long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription) , gdzie określamy również, kiedy test został uruchomiony, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) dla dokładnego pomiaru .

final void testStarted ( TestDescription test)

Przypadki testowe wywołania zwrotne

Pola

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

Konstruktorzy publiczni

Urządzenie bazoweMetric Collector

public BaseDeviceMetricCollector ()

Metody publiczne

getBuildInfos

public final  getBuildInfos ()

Zwraca listę informacji o kompilacji dostępnych w wywołaniu.

Zwroty

pobierzUrządzenia

public final  getDevices ()

Zwraca listę urządzeń dostępnych w wywołaniu.

Zwroty

getFileFromTestArtefakty

public File getFileFromTestArtifacts (String fileName)

Pobierz plik z artefaktów testowych lub artefaktów modułów i umieść go w pamięci podręcznej w mapie dla kolejnych wywołań.

Parametry
fileName String : nazwa pliku do wyszukania w artefaktach.

Zwroty
File Plik z artefaktu testowego lub artefaktu modułu. Zwraca wartość null, jeśli nie znaleziono pliku.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

Zwraca oryginalny ITestInvocationListener , w którym przekazujemy wyniki.

Zwroty
ITestInvocationListener

getRealDevices

public final  getRealDevices ()

Zwraca wszystkie urządzenia inne niż skrótowe z listy getDevices() .

Zwroty

getRunName

public String getRunName ()

Zwraca nazwę przebiegu testowego mRunName , który wyzwala kolektor.

Zwroty
String mRunName, nazwa bieżącego uruchomienia testowego.

w tym

public ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inicjalizacja kolektora z bieżącym kontekstem i miejscem przekazania wyników. Zostanie wywołane tylko raz na instancję, a kolektor powinien zaktualizować swój kontekst wewnętrzny i odbiornik. Init nigdy nie zostanie wywołany podczas uruchomienia testowego, zawsze wcześniej.

Nie zastępuj, chyba że wiesz, co robisz.

Parametry
context IInvocationContext : IInvocationContext dla wywołania w toku.

listener ITestInvocationListener : ITestInvocationListener gdzie umieścić wyniki.

Zwroty
ITestInvocationListener nowy słuchacz owija oryginalny.

Rzuty
DeviceNotAvailableException

inwokacjaZakończona

public final void invocationEnded (long elapsedTime)

Informuje, że wywołanie zostało zakończone pomyślnie lub z powodu błędu.

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
elapsedTime long : czas trwania wywołania w ms

wywołanie nie powiodło się

public final void invocationFailed (FailureDescription failure)

Zgłasza niekompletne wywołanie z powodu jakiegoś błędu.

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
failure FailureDescription : FailureDescription opisujący przyczynę niepowodzenia

wywołanie nie powiodło się

public final void invocationFailed (Throwable cause)

Zgłasza niekompletne wywołanie z powodu jakiegoś błędu.

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
cause Throwable : Throwable przyczyna niepowodzenia

wywołanieRozpoczęto

public final void invocationStarted (IInvocationContext context)

Odbiorniki wywołania do przekazywania

Parametry
context IInvocationContext : informacje o wywołaniu

jest niepełnosprawny

public final boolean isDisabled ()

Zwraca True, jeśli cały obiekt jest wyłączony (pomiń zarówno konfigurację, jak i usuwanie). W przeciwnym razie fałsz.

Zwroty
boolean

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Nie używaj implementacji wewnętrznego kolektora metrycznego. To jest czyste przekazywanie.

Parametry
dataName String : nazwa danych

logFile LogFile : LogFile , który został wcześniej zarejestrowany i powinien być powiązany z przypadkiem testowym.

w przypadku niepowodzenia przy założeniu testu

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Wywołanie zwrotne w przypadku niepowodzenia przypadku testowego z niepowodzeniem założenia.

Parametry
testData DeviceMetricData : DeviceMetricData przechowująca dane dla przypadku testowego.

test TestDescription : TestDescription przypadku testowego w toku.

Rzuty
DeviceNotAvailableException

onTestEnd

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

Oddzwanianie po zakończeniu przypadku testowego. To powinien być czas na sprzątanie.

Parametry
testData DeviceMetricData : DeviceMetricData przechowująca dane dla przypadku testowego. Będzie tym samym obiektem, co podczas onTestStart(com.android.tradefed.device.metric.DeviceMetricData) .

currentTestCaseMetrics : bieżąca mapa metryk przekazana do ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) .

test TestDescription : TestDescription przypadku testowego w toku.

Rzuty
DeviceNotAvailableException

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Oddzwanianie po zakończeniu przypadku testowego. To powinien być czas na sprzątanie.

Parametry
testData DeviceMetricData : DeviceMetricData przechowująca dane dla przypadku testowego. Będzie tym samym obiektem, co podczas onTestStart(com.android.tradefed.device.metric.DeviceMetricData) .

currentTestCaseMetrics : bieżąca mapa metryk przekazana do ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) .

Rzuty
DeviceNotAvailableException

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Wywołanie zwrotne w przypadku niepowodzenia przypadku testowego.

Parametry
testData DeviceMetricData : DeviceMetricData przechowująca dane dla przypadku testowego.

test TestDescription : TestDescription przypadku testowego w toku.

Rzuty
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

Umożliwia przechwytywanie zdarzenia zakończenia modułu.

Rzuty
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

Umożliwia przechwytywanie zdarzenia uruchomionego przez moduł.

Rzuty
DeviceNotAvailableException

naTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Oddzwanianie po zakończeniu przebiegu testowego. To powinien być czas na sprzątanie.

Parametry
runData DeviceMetricData : DeviceMetricData przechowująca dane dla przebiegu. Będzie tym samym obiektem, co podczas onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) .

currentRunMetrics : bieżąca mapa metryk przekazana do ERROR(/#testRunEnded(long,Map)) .

Rzuty
DeviceNotAvailableException

przy nieudanym uruchomieniu testu

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Wywołanie zwrotne dla zdarzeń testRunFailed

Rzuty
DeviceNotAvailableException

po uruchomieniuTestu

public void onTestRunStart (DeviceMetricData runData)

Wywołanie zwrotne po uruchomieniu uruchomienia testowego.

Parametry
runData DeviceMetricData : DeviceMetricData przechowująca dane dla przebiegu.

Rzuty
DeviceNotAvailableException

na początku testu

public void onTestStart (DeviceMetricData testData)

Wywołanie zwrotne po uruchomieniu przypadku testowego.

Parametry
testData DeviceMetricData : DeviceMetricData przechowująca dane dla przypadku testowego.

Rzuty
DeviceNotAvailableException

ustawWyłącz

public final void setDisable (boolean isDisabled)

Ustawia, czy obiekt powinien być wyłączony. Wyłączone oznacza, że ​​należy pominąć zarówno kroki konfiguracji, jak i rozkładania. Może służyć do domyślnego wyłączenia obiektu w domyślnym konstruktorze.

Parametry
isDisabled boolean : stan, w którym obiekt powinien się znajdować.

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Nie używaj implementacji wewnętrznego kolektora metrycznego. To jest czyste przekazywanie.

Parametry
logSaver ILogSaver : ILogSaver

testZałożenieNiepowodzenie

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływane, gdy atomowy test oznaczy, że przyjmuje warunek, który jest fałszywy

Parametry
test TestDescription : identyfikuje test

trace String : ślad stosu awarii

testZałożenieNiepowodzenie

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wywoływane, gdy atomowy test oznaczy, że przyjmuje warunek, który jest fałszywy

Parametry
test TestDescription : identyfikuje test

failure FailureDescription : FailureDescription opisująca niepowodzenie i jego kontekst.

testZakończony

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

Alternatywa dla ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) gdzie możemy bezpośrednio określić czas zakończenia. Połącz z testStarted(com.android.tradefed.result.TestDescription, long) aby uzyskać dokładny pomiar.

Parametry
test TestDescription : identyfikuje test

endTime long : czas zakończenia testu, mierzony za pomocą System.currentTimeMillis()

testMetrics : ERROR(/Map) emitowanych metryk

testZakończony

public final void testEnded (TestDescription test, 
                 testMetrics)

Raportuje zakończenie wykonywania pojedynczego przypadku testowego.

Jeśli testFailed(TestDescription, FailureDescription) nie został wywołany, ten test zakończył się pomyślnie. Zwraca również wszelkie metryki klucz/wartość, które mogły zostać wyemitowane podczas wykonywania przypadku testowego.

Parametry
test TestDescription : identyfikuje test

testMetrics : ERROR(/Map) emitowanych metryk

Test nieudany

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

Zostanie wywołana między testStarted i testEnded.

Parametry
test TestDescription : identyfikuje test

failure FailureDescription : FailureDescription opisująca niepowodzenie i jego kontekst.

Test nieudany

public final void testFailed (TestDescription test, 
                String trace)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

Zostanie wywołana między testStarted i testEnded.

Parametry
test TestDescription : identyfikuje test

trace String : ślad stosu awarii

testIgnorowane

public final void testIgnored (TestDescription test)

Wywoływana, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa ma adnotację org.junit.Ignore.

Parametry
test TestDescription : identyfikuje test

TestLog

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

Udostępnia skojarzone dane dziennika lub debugowania z wywołania testowego.

Należy wywołać przed ERROR(/ITestInvocationListener#invocationFailed(Throwable)) lub ERROR(/ITestInvocationListener#invocationEnded(long))

Struktura TradeFederation automatycznie wywoła tę metodę, dostarczając dziennik hosta i, jeśli ma to zastosowanie, dziennik urządzenia.

Parametry
dataName String : opisowa nazwa danych typu String . np. „device_logcat”. Uwaga dataName może nie być unikatowa na wywołanie. tj. realizatorzy muszą być w stanie obsłużyć wiele wywołań z tą samą nazwą data

dataType LogDataType : LogDataType danych

dataStream InputStreamSource : InputStreamSource danych. Realizatorzy powinni wywołać metodę createInputStream, aby rozpocząć odczytywanie danych i zapewnić zamknięcie wynikowego InputStream po zakończeniu. Wywołujący powinien upewnić się, że źródło danych pozostaje obecne i dostępne do momentu zakończenia metody testLog.

testLogZapisano

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

Nie używaj implementacji wewnętrznego kolektora metrycznego. To jest czyste przekazywanie.

Parametry
dataName String : opisowa nazwa danych typu String . np. „device_logcat”. Uwaga dataName może nie być unikatowa na wywołanie. tj. realizatorzy muszą być w stanie obsłużyć wiele wywołań z tą samą nazwą data

dataType LogDataType : LogDataType danych

dataStream InputStreamSource : InputStreamSource danych. Realizatorzy powinni wywołać metodę createInputStream, aby rozpocząć odczytywanie danych i zapewnić zamknięcie wynikowego InputStream po zakończeniu.

logFile LogFile : LogFile zawierający metadane zapisanego pliku.

testModułZakończony

public final void testModuleEnded ()

Zgłasza koniec uruchomienia modułu.

testModułUruchomiony

public final void testModuleStarted (IInvocationContext moduleContext)

Raportuje początek działania modułu. To wywołanie zwrotne jest powiązane z testModuleEnded() i jest opcjonalne w sekwencji. Jest używany tylko podczas biegu, który używa modułów: biegaczy opartych na pakiecie.

Parametry
moduleContext IInvocationContext : IInvocationContext modułu.

TestUruchomionyZakończony

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Raportuje koniec uruchomienia testowego. FIXME: Nie możemy mieć dwóch interfejsów Map<> o różnych typach, więc musimy tutaj użyć HashMap.

Parametry
elapsedTime long : urządzenie zgłosiło czas, który upłynął, w milisekundach

runMetrics : pary klucz-wartość zgłoszone na koniec testu z Metric .

TestUruchomie się nie powiódł

public final void testRunFailed (FailureDescription failure)

Testowanie raportów nie powiodło się z powodu błędu opisanego przez FailureDescription .

Parametry
failure FailureDescription : FailureDescription opisująca niepowodzenie i jego kontekst.

TestUruchomie się nie powiódł

public final void testRunFailed (String errorMessage)

Testowanie raportów nie powiodło się z powodu błędu krytycznego.

Parametry
errorMessage String : String opisujący przyczynę niepowodzenia uruchomienia.

testUruchomiony

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

Raportuje początek uruchomienia testowego.

Parametry
runName String : nazwa uruchomienia testowego

testCount int : całkowita liczba testów w przebiegu testowym

attemptNumber int : numer porządkowy, identyfikujący różne próby tego samego runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. Np. Test jest powtarzany 3 razy na poziomie granularnym, powinien mieć łącznie 4 przebiegi pod tą samą nazwą runName, a numer próby wynosi od 0 do 3.

testUruchomiony

public final void testRunStarted (String runName, 
                int testCount)

Testowe wywołania zwrotne

Parametry
runName String : nazwa uruchomienia testowego

testCount int : całkowita liczba testów w przebiegu testowym

testUruchomiony

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

Raportuje początek uruchomienia testowego.

Parametry
runName String : nazwa uruchomienia testowego

testCount int : całkowita liczba testów w przebiegu testowym

attemptNumber int : numer porządkowy, identyfikujący różne próby tego samego runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. Np. Test jest powtarzany 3 razy na poziomie granularnym, powinien mieć łącznie 4 przebiegi pod tą samą nazwą runName, a numer próby wynosi od 0 do 3.

startTime long : czas rozpoczęcia biegu, mierzony za pomocą System.currentTimeMillis()

testRunStopped

public final void testRunStopped (long elapsedTime)

Raporty, że uruchomienie testowe zostało zatrzymane przed zakończeniem z powodu żądania użytkownika.

TODO: obecnie nieużywane, rozważ usunięcie

Parametry
elapsedTime long : urządzenie zgłosiło czas, który upłynął, w milisekundach

testRozpoczęto

public final void testStarted (TestDescription test, 
                long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription) , gdzie określamy również, kiedy test został uruchomiony, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) dla dokładnego pomiaru .

Parametry
test TestDescription : identyfikuje test

startTime long : czas rozpoczęcia testu, mierzony za pomocą System.currentTimeMillis()

testRozpoczęto

public final void testStarted (TestDescription test)

Przypadki testowe wywołania zwrotne

Parametry
test TestDescription : identyfikuje test