Google стремится продвигать расовую справедливость для черных сообществ. Смотри как.
Эта страница была переведа с помощью Cloud Translation API.
Switch to English

Настройка 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 поскольку тест getCameraIdList перечисленные устройства и измеряет производительность индивидуально.

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

GPS / GNSS

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

Wi-Fi и IPv6

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

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

Wi-Fi RTT

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

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

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

АБР и ААРТ

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

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

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

export PATH=$PATH:$HOME/android-sdk-linux/build-tools/ version

Java Development Kit

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

Подробнее см. Требования JDK .

Файлы CTS

Загрузите и откройте пакеты CTS из комплекта Compatibility Test Suite. Загрузки, соответствующие версии Android вашего устройства и всем двоичным интерфейсам приложений (ABI), которые поддерживаются вашими устройствами.

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

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

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

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

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

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

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

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

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

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

Производители устройств могут добавить 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 допустимое значение из 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 7.0 включает в себя следующие готовые приложения (созданные из этого источника ), которые не содержат никакого кода, кроме манифеста:

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

CTS шим APEX

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

CtsShimApex необходимо предварительно установить в раздел /system .

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

Если свойство ro.apex.updatable отсутствует или не установлено, CtsShimApex не требуется предварительно устанавливать на устройстве. Валидационный тест APEX проверяет реализацию CtsShimApex .

Образец апплета

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

См. CTS Test for Secure Element для получения более подробной информации о тестовых случаях Open Mobile API и тестовых случаях контроля доступа.

Требования к хранению

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

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

Обратите внимание, что возможности воспроизведения видео DUT проверяются через API android.media.CamcorderProfile для более ранних версий Android и API android.media.MediaCodecInfo.CodecCapabilities из Android 5.0.

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

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

Экран и память

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

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

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

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

  1. Заводские настройки устройства: Настройки> Резервное копирование и сброс> Заводские настройки .
  2. Установите язык вашего устройства на английский ( США ): Настройки> Язык и ввод> Язык .
  3. Включите настройку местоположения, если на устройстве есть функция GPS или Wi-Fi / сотовая сеть: Настройки> Местоположение> Вкл .
  4. Подключитесь к сети Wi-Fi, которая поддерживает IPv6, может рассматривать DUT как изолированный клиент (см. Выше Физическая среда ) и имеет подключение к Интернету: « Настройки»> «Wi-Fi» .
  5. Убедитесь, что на устройстве не установлен шаблон блокировки или пароль: « Настройки»> «Безопасность»> «Блокировка экрана»> «Нет» .
  6. Включите отладку USB на вашем устройстве: Настройки> Параметры разработчика> Отладка USB .
  7. Установите время в 12-часовой формат: Настройки> Дата и время> Использовать 24-часовой формат> Выкл .
  8. Настройте устройство на бодрствование: Настройки> Параметры разработчика> Бодрствовать> Вкл .
  9. Только в Android 5.x и 4.4.x : установите на устройстве разрешенные макеты: Настройки> Параметры разработчика> Разрешить макеты> Вкл .
  10. В Android 4.2 или более поздней версии отключите проверку приложения USB: « Настройки»> «Параметры разработчика»> «Проверка приложений через USB»> «Выкл .».
  11. Запустите браузер и закройте любой экран запуска / настройки.
  12. Подключите настольный компьютер, который будет использоваться для тестирования устройства, с помощью 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. Перейдите ( 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