Argumenty instrumentacji mikroporównawczej

Skonfiguruj zachowanie testów porównawczych, określając różne argumenty w narzędziu uruchamiającym instrumentację. Można je zastosować w konfiguracji Gradle lub dodać bezpośrednio podczas uruchamiania narzędzi z poziomu wiersza poleceń.

Aby skonfigurować argumenty instrumentacji podczas wykonywania testów porównawczych w Android Studio, wykonaj te czynności:

  1. Edytuj konfigurację uruchomienia, klikając Edytuj i wybierając konfigurację, którą chcesz edytować.
    Rysunek 1. Edytuj konfigurację uruchamiania.
  2. Aby edytować argumenty instrumentacji, kliknij obok pola Argumenty instrumentacji.
    Rysunek 2. Edytuj argument instrumentacji.
  3. Kliknij i dodaj wymagany argument instrumentacji.
    Rysunek 3. Dodaj argument instrumentacji.

dodatkowy test wyjściowy

Konfiguruje miejsce zapisywania na urządzeniu raportów porównawczych JSON i wyników profilowania.

  • Typ argumentu: ciąg znaków ścieżki pliku
  • Wartość domyślna: sprawdź zewnętrzny katalog pakietu APK

androidx.benchmark.dryRunMode.enable

Umożliwia przeprowadzanie testów porównawczych w pojedynczej pętli w celu sprawdzania, czy działają one prawidłowo. Możesz jej używać podczas zwykłych testów w ramach weryfikacji.

  • Typ argumentu: wartość logiczna
  • Wartość domyślna: false

androidx.benchmark.iterations

Zastępuje liczbę iteracji celu zależnej od czasu, aby zapewnić stałą ilość pracy. Zwykle przydaje się to tylko przy włączonym profilowaniu, które pozwala zachować spójną ilość pracy w logu czasu przy porównywaniu różnych implementacji lub uruchomień. W innych przypadkach może to obniżyć dokładność lub stabilność pomiarów.

  • Typ argumentu: liczba całkowita
  • Wartość domyślna: nie określono

androidx.benchmark.junit4.SideEffectRunListener

Wyniki testów porównawczych mogą być niespójne, jeśli w trakcie testu nie są wykonywane niepowiązane prace w tle.

Aby wyłączyć działanie w tle podczas analizy porównawczej, ustaw typ argumentu listenerinstrumentation na androidx.benchmark.junit4.SideEffectRunListener.

  • Typ argumentu: ciąg znaków
  • Dostępne opcje:
    • androidx.benchmark.junit4.SideEffectRunListener
  • Wartość domyślna: nie określono

androidx.benchmark.output.enable

Umożliwia zapisanie wynikowego pliku JSON w pamięci zewnętrznej.

  • Typ argumentu: wartość logiczna
  • Wartość domyślna: true

androidx.benchmark.profiling.mode

Umożliwia przechwytywanie plików śledzenia podczas przeprowadzania testów porównawczych. Dostępne opcje znajdziesz w sekcji Profilowanie mikroporównania.

  • Typ argumentu: ciąg znaków
  • Dostępne opcje:
    • MethodTracing
    • StackSampling
    • None
  • Wartość domyślna: None

androidx.benchmark.suppressErrors

Akceptuje rozdzielaną przecinkami listę błędów, które zmieniają się w ostrzeżenia.

  • Typ argumentu: lista ciągów tekstowych.
  • Dostępne opcje:
    • DEBUGGABLE
    • LOW-BATTERY
    • EMULATOR
    • CODE-COVERAGE
    • UNLOCKED
    • SIMPLEPERF
    • ACTIVITY-MISSING
  • Wartość domyślna: pusta lista

androidx.benchmark.startupMode.enable (wycofany)

Ponownie konfiguruje zapętlenie, aby umożliwić obsługę kodu analizy porównawczej podczas uruchamiania. W przypadku 10 pomiarów testy porównawcze są wykonywane bez zapętlania rozgrzewek. Aby zminimalizować obciążenie w mikroporównaniach, uśrednianie w pętli jest wyłączone.

  • Typ argumentu: wartość logiczna
  • Wartość domyślna: false
Wstecz
Profilowanie testu porównawczego
Dalej
Mikroporównanie i Hilt