Инструментальные испытания

Сначала прочтите Тестируйте свое приложение на developer.android.com. Обратите внимание, что существуют некоторые различия в том, как инструментальные тесты используются при тестировании платформы.

Подводя итог, можно сказать, что инструментальный тест предоставляет специальную среду выполнения теста, которая запускается с помощью команды am instrument , где целевой процесс приложения перезапускается и инициализируется с базовым контекстом приложения, а поток инструментирования запускается внутри виртуальной машины процесса приложения. Ваш тестовый код начинает выполнение в этом потоке инструментирования и снабжен экземпляром Instrumentation , который обеспечивает доступ к контексту приложения и API для управления тестируемым процессом приложения.

Ключевые понятия

  • Инструментарий должен быть объявлен в пакете приложения с помощью тега <instrumentation> , вложенного в тег <manifest> манифеста пакета приложения.
  • Манифест пакета приложения технически может содержать несколько тегов <instrumentation> , хотя обычно он не используется таким образом.
  • каждый <instrumentation> должен содержать:
    • атрибут android:name : это должно быть имя подкласса Instrumentation , включенного в тестовое приложение, которое обычно является используемым исполнителем тестов, например: android.support.test.runner.AndroidJUnitRunner
    • должен быть определен атрибут android:targetPackage . Его значение должно быть установлено на пакет тестируемого приложения.

Краткое изложение шагов

  1. Ниже приведены распространенные направления для герметичных испытаний на соответствие фреймворкам:

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

    Если вы добавляете совершенно новый модуль измерительных приборов для своего компонента, см.

  2. Следуя существующим соглашениям, если вы добавляете тесты в одно из мест выше. Если вы настраиваете новый тестовый модуль, пожалуйста, следуйте настройке AndroidManifest.xml и Android.mk в одном из мест выше

  3. См. frameworks/base/core/tests/coretests/ для примера. Обратите внимание, что эти строки устанавливают дополнительные приложения:

    <option name="test-file-name" value="FrameworksCoreTests.apk" />
    <option name="test-file-name" value="BstatsTestApp.apk" />
    
  4. Не забудьте отметить свой тест как @SmallTest , @MediumTest или @LargeTest

  5. Создайте тестовый модуль с m, например:

    m FrameworksCoreTests
    
  6. Запустите тесты:

    m tradefed-all
    tradefed.sh run template/local_min --template:map test=FrameworksCoreTests
    
  7. Если Tradefed не используется, установите и запустите тесты вручную:

    1. Установите сгенерированный apk:
    adb install -r ${OUT}/data/app/FrameworksCoreTests/FrameworksCoreTests.apk
    
    1. Запустите тесты с различными вариантами:

      1. все тесты в apk

        adb shell am instrument -w com.android.frameworks.coretests\
          /android.support.test.runner.AndroidJUnitRunner
        
      2. все тесты в рамках определенного пакета Java

        adb shell am instrument -w -e package android.animation \
          com.android.frameworks.coretests\
          /android.support.test.runner.AndroidJUnitRunner
        
      3. все тесты в рамках определенного класса

        adb shell am instrument -w -e class \
          android.animation.AnimatorSetEventsTest \
          com.android.frameworks.coretests\
          /android.support.test.runner.AndroidJUnitRunner
        
      4. конкретный метод испытания

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

Ваш тест может сделать явное утверждение о прохождении или провале с помощью API JUnit ; кроме того, любые неперехваченные исключения также приведут к функциональному сбою.

Чтобы выдать метрики производительности, ваш тестовый код может вызвать Instrumentation#sendStatus для отправки списка пар ключ-значение. Важно отметить, что:

  1. Метрики могут быть целыми или с плавающей точкой.
  2. любые нечисловые значения будут отброшены
  3. Ваш тестовый APK может быть либо функциональным тестом, либо метрическим тестом, однако смешивание обоих в настоящее время не поддерживается.