Testy z instrumentacją

Najpierw przeczytaj artykuł Testowanie aplikacji na stronie developer.android.com. Pamiętaj, że testy narzędzia do testowania są używane w testach platformy w trochę inny sposób.

Podsumowując, testowanie pomiarów zapewnia specjalne środowisko testowe uruchamiane za pomocą polecenia am instrument, w którym docelowy proces aplikacji jest ponownie uruchamiany i inicjowany z podstawowym kontekstem aplikacji, a wątek pomiarów jest uruchamiany w ramach maszyny wirtualnej procesu aplikacji. Twój kod testowy rozpoczyna wykonywanie na tym wątku pomiarowym i otrzymuje instancję Instrumentation, która zapewnia dostęp do kontekstu aplikacji i interfejsów API umożliwiających manipulowanie procesem aplikacji poddawanym testom.

Kluczowych pojęć

  • instrumentacja musi być zadeklarowana w pakiecie aplikacji za pomocą tagu <instrumentation> zagnieżdżonego pod tagiem <manifest> w pliku manifestu pakietu aplikacji.
  • plik manifestu pakietu aplikacji może teoretycznie zawierać wiele tagów <instrumentation>, ale nie jest to powszechna praktyka.
  • Każdy element <instrumentation> musi zawierać:
    • atrybut android:name: powinien on zawierać nazwę podklasy Instrumentation, która jest uwzględniona w aplikacji testowej, która jest zwykle używanym testem, np.:android.support.test.runner.AndroidJUnitRunner
    • Musisz zdefiniować atrybut android:targetPackage. Jego wartość powinna być ustawiona na testowany pakiet aplikacji.

Podsumowanie kroków

  1. Poniżej znajdziesz typowe miejsca docelowe testów hermetycznych w przypadku usług frameworka:

    frameworks/base/core/tests/coretests
frameworks/base/services/tests/servicestests

    Jeśli do komponentu dodajesz zupełnie nowy moduł pomiarowy, zapoznaj się z artykułem

  2. Jeśli dodajesz testy w jednym z tych miejsc, postępuj zgodnie z dotychczasową konwencją. Jeśli konfigurujesz nowy moduł testowy, wykonaj czynności opisane w sekcji AndroidManifest.xml i Android.mk w jednym z tych miejsc:

  3. Przykład: frameworks/base/core/tests/coretests/. Pamiętaj, że te wiersze instalują dodatkowe aplikacje:

    <option name="test-file-name" value="FrameworksCoreTests.apk" />
<option name="test-file-name" value="BstatsTestApp.apk" />

  4. Pamiętaj, aby oznaczyć test jako @SmallTest, @MediumTest lub @LargeTest

  5. Utwórz moduł testowy za pomocą polecenia m, np.:

    m FrameworksCoreTests

  6. Przeprowadzanie testów:

    m tradefed-all
tradefed.sh run template/local_min --template:map test=FrameworksCoreTests

  7. Jeśli nie używasz narzędzia Tradefed, zainstaluj i uruchom testy ręcznie:

    1. Zainstaluj wygenerowany plik APK:
    adb install -r ${OUT}/data/app/FrameworksCoreTests/FrameworksCoreTests.apk

    1. Przeprowadź testy z różnymi opcjami:

      1. wszystkie testy pliku APK.

        adb shell am instrument -w com.android.frameworks.coretests\
  /android.support.test.runner.AndroidJUnitRunner

      2. wszystkich testów w ramach konkretnego pakietu Javy,

        adb shell am instrument -w -e package android.animation \
  com.android.frameworks.coretests\
  /android.support.test.runner.AndroidJUnitRunner

      3. wszystkie testy w ramach konkretnej lekcji

        adb shell am instrument -w -e class \
  android.animation.AnimatorSetEventsTest \
  com.android.frameworks.coretests\
  /android.support.test.runner.AndroidJUnitRunner

      4. konkretnej metody testowania,

        adb shell am instrument -w -e class \
  android.animation.AnimatorSetEventsTest#testCancel \
  com.android.frameworks.coretests\
  /android.support.test.runner.AndroidJUnitRunner

Test może wyraźnie stwierdzić, czy test się udał, czy nie, korzystając z interfejsów API JUnit. Nieprzechwycone wyjątki również spowodują błąd funkcjonalny.

Aby emitować dane o skuteczności, kod testowy może wywołać funkcję Instrumentation#sendStatus, aby wysłać listę par klucz-wartość. Pamiętaj, że:

  1. dane mogą być liczbą całkowitą lub zmiennoprzecinkową
  2. wartości niearytmetyczne zostaną odrzucone;
  3. Plik APK testowy może zawierać testy funkcjonalne lub testy danych, ale mieszanie obu nie jest obecnie obsługiwane