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

Сначала прочитайте статью «Протестируйте свое приложение» на сайте 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. Запустите тесты:

   • Самое простое решение — использовать Atest следующим образом:

     atest FrameworksCoreTests
     

   • Или для более сложных тестов используйте тестовый жгут Торговой федерации :

   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
   

   Совет: вы используете adb shell pm list instrumentation , чтобы найти инструменты внутри только что установленного 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-файл может быть либо функциональным, либо метрическим тестом, однако сочетание обоих в настоящее время не поддерживается.