Google is committed to advancing racial equity for Black communities. See how.
Эта страница была переведа с помощью 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 поскольку тест проходит по перечисленным устройствам и измеряет производительность индивидуально.

Если тестируемое устройство поддерживает внешние камеры, например веб-камеры 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 включает Wi-Fi RTT API для возможности двустороннего приема Wi-Fi (RTT) . Это позволяет устройствам измерять расстояние до точек доступа с точностью от 1 до 2 метров, что значительно повышает точность определения местоположения в помещении.

См. Разделы Wi-Fi RTT (IEEE 802.11mc) и Местоположение Wi-Fi: в диапазоне от RTT для получения списка рекомендуемых устройств, поддерживающих Wi-Fi RTT.

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

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

АБР и AAPT

Перед запуском 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 для Ubuntu

Установите подходящую версию Java Development Kit (JDK) .

  • Для Android 11 установите OpenJDK11.
  • Для Android 9 и Android 10 установите OpenJDK9.
  • Для Android 7.0, 7.1, 8.0 и 8.1 установите OpenJDK8.

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

CTS файлы

Загрузите и откройте пакеты CTS из раздела Загрузки пакета тестирования совместимости, соответствующие версии 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 допустимое значение из Codenames, Tags и Build Numbers .

Первый уровень 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 для API управления APEX (например, обновление до новой версии или создание отчетов об активных APEX), необходимо предварительно CtsShimApex пакет CtsShimApex на целевом устройстве.

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

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

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

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

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

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

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

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

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

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

Для стресс-тестов CTS media требуется, чтобы видеоклипы находились на внешнем накопителе ( /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 МБ
  • 720 x 480: 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 : настройте свое устройство (или эмулятор) для запуска тестов доступности с помощью:
      adb 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