Настройка CTS

Чтобы запустить CTS, сначала подготовьте физическую среду, настольный компьютер и устройство Android, которое вы используете для тестирования.

Физическая среда

Маяки Bluetooth LE

Если тестируемое устройство (DUT) поддерживает Bluetooth LE, поместите не менее трех маяков Bluetooth LE в пределах 5 метров от DUT для сканирующего тестирования Bluetooth LE. Эти маяки не нужно настраивать или излучать что-либо конкретное, и они могут быть любого типа, включая iBeacon, Eddystone или даже устройства, имитирующие маяки BLE.

Камеры

При запуске камеры CTS используйте нормальные условия освещения с тестовой таблицей (например, шахматной доской). Поместите таблицу с тестовым шаблоном в соответствии с минимальным фокусным расстоянием тестируемого устройства, чтобы убедиться, что оно не слишком близко к объективу.

Точка датчики камеры к сцене с достаточным освещением , чтобы датчики под испытанием , чтобы достичь и остаются на максимальных сконфигурировано целевых кадров в секунду (FPS) , как указано в CONTROL_AE_TARGET_FPS_RANGE . Это относится ко всем датчикам камер , представленных getCameraIdList в качестве тестового перебирает перечисленные устройства и показатели работы в индивидуальном порядке .

Если DUT поддерживает внешние камеры, такие как веб-камеры USB, подключите внешнюю камеру при работе CTS. В противном случае тесты CTS не пройдут.

GPS / GNSS

Если тестируемое устройство поддерживает функцию глобальной системы позиционирования / глобальной навигационной спутниковой системы (GPS / GNSS), подайте на тестируемое устройство сигнал GPS / GNSS с подходящим уровнем сигнала для приема и расчета местоположения по GPS. Часть GPS должна соответствовать ICD-GPS-200C. В противном случае сигнал GPS / GNSS может быть любым, включая имитатор спутников или ретранслятор сигналов GPS / GNSS наружных сигналов, или вы можете разместить DUT достаточно близко к окну, чтобы оно могло напрямую принимать достаточное количество сигнала GPS / GNSS.

Wi-Fi и IPv6

Для тестов CTS требуется сеть Wi-Fi, которая поддерживает IPv6, имеет подключение к Интернету и может рассматривать DUT как изолированный клиент. Изолированный клиент относится к конфигурации, в которой DUT не видит широковещательные / многосетевые сообщения в этой подсети. Это происходит при настройке точки доступа Wi-Fi или при запуске DUT в изолированной подсети без подключения других устройств.

Если у вас нет доступа к собственной сети IPv6, сети оператора IPv6 или VPN для прохождения некоторых тестов в зависимости от IPv6, вы можете использовать точку доступа Wi-Fi и туннель IPv6. См Википедии список IPv6 туннеля брокеров .

Wi-Fi RTT

Android включает в себя API Wi-Fi RTT для Wi-Fi времени туда и обратно (RTT) возможности. Это позволяет устройствам измерять расстояние до точек доступа с точностью от 1 до 2 метров, что значительно повышает точность определения местоположения в помещении. Два рекомендуемые устройства с поддержкой Wi-Fi RTT являются Google Wi - Fi и fitlet2 точка доступа CompuLab в (набор с пропускной способностью 40 МГц на частоте 5 ГГц).

Точки доступа должны быть включены, но не требуют подключения к сети. Точки доступа не обязательно должны находиться рядом с тестирующим устройством, но рекомендуется находиться в пределах 40 футов от DUT. Обычно достаточно одной точки доступа.

Настройка настольного компьютера

АБР и ААПТ

Перед запуском CTS, убедитесь , что вы установили последние версии как Android Debug Bridge (ADB) и Android Asset Packaging Tool (AAPT) и добавили расположение этих инструментов для системного пути вашей машины.

Для того, чтобы установить ADB, скачать Tools Android SDK пакет для вашей операционной системы, откройте его и следуйте инструкциям в прилагаемом файле README. Сведения об устранении неполадок см Установка автономных SDK Tools .

Убедитесь в том, что adb и aapt находятся в вашем системном пути. Следующая команда предполагает, что вы открыли архив пакета в своем домашнем каталоге:

экспорт PATH = $ PATH: $ HOME / android-sdk-linux / build-tools / version

Комплект для разработки Java

Установите подходящую версию Java Development Kit (JDK). Для Android 7.0 или выше:

Для получения дополнительной информации см требований JDK .

CTS файлы

Скачать и открыть пакеты CTS от совместимости Test Suite Загрузки соответствующей Android версии устройств и все прикладные бинарных интерфейсы (АБИС) , что устройства поддерживают.

Загрузите и откройте последнюю версию медиа - файлов CTS .

Обнаружение устройства

Следуйте шаг , чтобы настроить вашу систему для обнаружения устройства .

Настройка устройства Android

Пользовательские сборки

Совместимое устройство определяется как устройство со сборкой, подписанной пользователем / ключом выпуска. Устройство должно быть запущена система изображения на основе известной как совместимый пользовательский билд (Android 4.0 или выше) с кодовыми, теги и номер сборки .

Свойство сборки первого уровня API

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

Для того, чтобы сделать эту информацию доступной для CTS, производители устройств могли бы определить Нарастание времени свойства ro.product.first_api_level . Значение этого свойства - первый уровень API, с которым устройство было коммерчески запущено.

Производители устройств могут повторно использовать общую базовую реализацию для запуска нового продукта в качестве обновления существующего продукта в той же группе устройств. Производители устройств могут дополнительно установить уровень API существующего продукта к ro.product.first_api_level , так что требования обновления применяются для CTS и высоких частот / СДС.

Производители устройств могут добавлять PRODUCT_PROPERTY_OVERRIDES в их device.mk файл , чтобы установить это свойство, как показано в следующем примере:

#ro.product.first_api_level indicates the first api level that the device has
been commercially launched on.
PRODUCT_PROPERTY_OVERRIDES +=\
ro.product.first_api_level=21

Первый уровень API для Android 9 или выше

Для устройств , запускаемых с Android 9 или выше, установите ro.product.first_api_level свойство действительного значение от Кодового, тегов и номера сборки .

Первый уровень API для Android 8.x или ниже

Для устройств , запущенных на Android 8.x или ниже, убрать (убрать) ro.product.first_api_level свойства для первой сборки продукта. Для всех последующих сборок, набор ro.product.first_api_level к правильному значению уровня API. Это позволяет свойству правильно идентифицировать новый продукт и сохранять информацию о первом уровне API продукта. Если флаг не установлен, Android присваивает Build.VERSION.SDK_INT к ro.product.first_api_level .

Пакеты прокладок CTS

Android 10 и выше включает в себя формат пакета под названием APEX . Чтобы запустить тесты CTS для интерфейсов управления APEX (например, обновление до новой версии или отчетности активного конька) , вы должны предустанавливать на CtsShimApex пакет на целевом устройстве.

CtsShimApex требуется быть предустановлена на /system раздела.

Если ro.apex.updatable свойство имеет значение true , CtsShimApex требуется для всех устройств, поддерживающих управление пакетами APEX.

Если ro.apex.updatable свойство отсутствует или не установлен, CtsShimApex не требуется быть предустановлена на управление пакетами. Если ro.apex.updatable свойство отсутствует или не установлен, CtsShimApex не требуется , чтобы быть предварительно установлена на устройстве. Апекс Shim тест проверки проверяет выполнение CtsShimApex .

Начиная с Android 11, CtsShimApex содержит два прекомпилированных приложения (построенное из этого источника ), которые не содержат какой - либо код для манифеста , за исключением. CTS использует эти приложения для проверки прав и разрешений.

Если устройство не поддерживает управление пакетами APEX (то есть, ro.apex.updatable свойство отсутствует или не установлен), или если устройство работает под управлением версии 10 или ниже, два приложения должны установки двоичных предустановлен в система отдельно:

Чтобы пройти тесты, предварительно загрузите приложения в соответствующие каталоги в образе системы без повторной подписи приложений.

Пример апплета

Android 9 представил открытые мобильные API. Для устройств, которые сообщают о нескольких защищенных элементах, CTS добавляет тестовые примеры для проверки поведения Open Mobile API. Эти тестовые сценарии требуют однократной установки образца апплета во встроенный Secure Element (eSE) DUT или на SIM-карту, используемую DUT. Ese образец апплет , и апплет образца SIM - можно найти в AOSP.

См CTS тест для безопасного элемента для получения более подробной информации о Open Mobile тестового API и тестовом контроле доступа.

Требования к хранилищу

СМИ CTS стресс тесты требуют видеоклипов , чтобы быть на внешнем накопителе ( /sdcard ). Большинство клипов из Big Buck Bunny , который защищен авторским правом Фонда Blender под 3.0 лицензии Creative Commons Attribution .

Требуемое пространство зависит от максимального разрешения воспроизведения видео, поддерживаемого устройством. Смотрите раздел 5 в Определении документа Android Compatibility для версии платформы необходимых разрешений).

Вот требования к хранилищу при максимальном разрешении воспроизведения видео:

  • 480x360: 98 МБ
  • 720 x 480: 193 МБ
  • 1280x720: 606 МБ
  • 1920x1080: 1863 МБ

Экран и хранилище

  • Любое устройство, не имеющее встроенного экрана, необходимо подключить к экрану.
  • Если в устройстве есть слот для карты памяти, вставьте пустую SD-карту. Используйте SD-карту, которая поддерживает сверхвысокоскоростную шину (UHS) с емкостью SDHC или SDXC, или карту с классом скорости не менее 10 или выше, чтобы гарантировать, что она может пройти CTS.

  • Если в устройстве есть слоты для SIM-карт, вставьте активированную SIM-карту в каждый из них. Если устройство поддерживает SMS, каждая SIM-карта должна иметь собственное поле номера. Для устройств под управлением Android 12 или более поздних версий все SIM-карты должны поддерживать сохранение номеров сокращенного набора (ADN). GSM и USIM карты с телекоммуникационном специальным файлом (DF Telecom) удовлетворяют это требование.

Разработчик UICC

Для запуска CTS испытаний несущей API, устройство должно использовать SIM - карту с привилегиями носителя CTS отвечает требованиям , указанным в Подготовка UICC .

Конфигурация устройства Android

  1. Данные фабрики сброса устройства: Настройки> Резервное копирование и сброс> Сброс настроек.

  2. Установите язык вашего устройства на английский язык (США): Настройки> Язык и ввод> Язык.

  3. Включите настройки местоположения , если есть GPS или Wi-Fi / функция сотовой сети на устройстве: Настройки> Местоположение> Вкл.

  4. Подключение к сети Wi-Fi , который поддерживает IPv6, может относиться к ИУ как изолированному клиенту (см Физической среды выше), и имеет подключение к Интернету: Настройки> Wi-Fi.

  5. Убедитесь , что ни один шаблон блокировки или пароль не установлен на устройстве: Настройки> Безопасность> Блокировка экрана> Нет.

  6. Включение отладки USB на устройстве: Настройки> Параметры разработчика> отладки USB.

  7. Установите время в 12-часовом формате: Настройки> Дата и время> Использовать 24-часовой формат> Выкл.

  8. Установите устройство бодрствовать: Настройки> Параметры разработчика> бодрствовать> Вкл.

  9. В Android 5.x и 4.4.x только установите устройство , чтобы макет места: Настройки> Параметры разработчика> Эмуляция расположения> На .10. В Android 4.2 или выше, выключите USB приложение проверки: Настройки> Параметры разработчика> Проверка приложений через USB> Off .11. Запустите браузер и закройте любой экран запуска / настройки.

  10. Подключите настольный компьютер, который будет использоваться для тестирования устройства, с помощью кабеля USB.

Установка файла

Установите и настройте вспомогательные приложения на устройстве.

  1. Настройте свое устройство в соответствии с вашей версией CTS:

    • CTS версия 2.1 R2 через 4.2 R4: Настройка устройства (или эмулятор) для выполнения тестов доступности с: abd install -r android-cts/repository/testcases/CtsDelegatingAccessibilityService.apk

      На устройстве включения делегирования: Настройки> Специальные возможности> Специальные возможности> Делегирование Доступность Сервис.

    • Версии CTS 6.x или понизить: На устройствах , которые заявляют android.software.device_admin , настроить устройство для запуска теста администрирования устройства с помощью: adb install -r android-cts/repository/testcases/CtsDeviceAdmin.apk`

      В меню Настройки> Безопасность> Выбор администраторов устройства, включите два android.deviceadmin.cts.CtsDeviceAdminReceiver* администраторов устройства. Убедитесь в том, что android.deviceadmin.cts.CtsDeviceAdminDeactivatedReceiver и любые другие администраторы предустановленных устройств остаются инвалидами.

  2. Скопируйте медиафайлы CTS на устройство следующим образом:

    1. Navigate ( cd ) на пути , где медиа - файлы будут загружены и распакованы.
    2. Изменение прав доступа к файлам: chmod u+x copy_media.sh

    3. Скопируйте необходимые файлы:

      • Чтобы скопировать клипы с разрешением до 720x480, запустите:

        ./copy_media.sh 720x480
        
      • Если вы не уверены в максимальном разрешении, скопируйте все файлы:

        ./copy_media.sh all
        
      • При наличии нескольких устройств под ADB, добавьте серийный вариант ( -s ) конкретного устройства до конца. Например, чтобы скопировать до 720x480 на устройство с серийным номером 1234567, запустите:

        ./copy_media.sh 720x480 -s 1234567