Google se compromete a promover la equidad racial para las comunidades negras. Ver cómo.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Configurar CTS

Para ejecutar CTS, primero prepare su entorno físico, su máquina de escritorio y el dispositivo Android que está utilizando para las pruebas.

Entorno físico

Balizas Bluetooth LE

Si el dispositivo bajo prueba (DUT) es compatible con Bluetooth LE, coloque al menos tres balizas Bluetooth LE a menos de 5 metros del DUT para la prueba de escaneo de Bluetooth LE. Esas balizas no necesitan configurarse ni emitir nada específico, y pueden ser de cualquier tipo, incluidos iBeacon, Eddystone o incluso dispositivos que simulan balizas BLE.

Cámaras

Cuando ejecute la cámara CTS, use condiciones de iluminación normales con una tabla de patrones de prueba (como un patrón de tablero de ajedrez). Coloque la tabla de patrones de prueba de acuerdo con la distancia mínima de enfoque del DUT para asegurarse de que no esté demasiado cerca de la lente.

Apunte los sensores de la cámara a una escena con suficiente iluminación para permitir que los sensores bajo prueba alcancen y permanezcan en los cuadros objetivo configurados por segundo (FPS) como se especifica en CONTROL_AE_TARGET_FPS_RANGE . Esto se aplica a todos los sensores de cámara informados por getCameraIdList medida que la prueba itera sobre los dispositivos enumerados y mide el rendimiento individualmente.

Si el DUT admite cámaras externas, como cámaras web USB, conecte una cámara externa cuando ejecute CTS. De lo contrario, las pruebas CTS fallan.

GPS / GNSS

Si el DUT admite la función del sistema de posicionamiento global / sistema de navegación global por satélite (GPS / GNSS), proporcione una señal GPS / GNSS al DUT a un nivel de señal adecuado para la recepción y el cálculo de la ubicación del GPS. La parte del GPS debe cumplir con ICD-GPS-200C. De lo contrario, la señal GPS / GNSS puede ser de cualquier tipo, incluido un simulador de satélite o un repetidor GPS / GNSS de señales exteriores, o puede colocar el DUT lo suficientemente cerca de una ventana para que pueda recibir directamente suficiente señal GPS / GNSS.

Wi-Fi e IPv6

Las pruebas de CTS requieren una red Wi-Fi que admita IPv6, tenga una conexión a Internet y pueda tratar el DUT como un cliente aislado. Un cliente aislado se refiere a una configuración en la que el DUT no tiene visibilidad para los mensajes de difusión / multinetwork en esa subred. Esto ocurre con una configuración de AP de Wi-Fi o ejecutando el DUT en una subred aislada sin otros dispositivos conectados.

Si no tiene acceso a una red IPv6 nativa, una red de operadores IPv6 o una VPN para pasar algunas pruebas dependiendo de IPv6, puede usar un punto de acceso Wi-Fi y un túnel IPv6. Vea la lista de Wikipedia de corredores de túnel IPv6

Wi-Fi RTT

Android incluye la API RTT de Wi-Fi para una capacidad de tiempo de ida y vuelta (RTT) de Wi-Fi . Esto permite que los dispositivos midan su distancia a los puntos de acceso con una precisión de 1 a 2 metros, lo que aumenta significativamente la precisión de la ubicación en interiores. Dos dispositivos recomendados que admiten Wi-Fi RTT son Google Wifi y el punto de acceso fitlet2 de Compulab (configurado con un ancho de banda de 40 MHz a 5 GHz).

Los puntos de acceso deben estar encendidos, pero no requieren una conexión de red. Los puntos de acceso no necesitan estar al lado del dispositivo de prueba, pero se recomienda que se encuentren a menos de 40 pies del DUT. Un punto de acceso suele ser suficiente.

Configuración de la máquina de escritorio

ADB y AAPT

Antes de ejecutar el CTS, asegúrese de haber instalado las versiones recientes de Android Debug Bridge (adb) y Android Asset Packaging Tool (AAPT) y haya agregado la ubicación de esas herramientas a la ruta del sistema de su máquina.

Para instalar ADB, descargue el paquete de Android SDK Tools para su sistema operativo, ábralo y siga las instrucciones en el archivo README incluido. Para obtener información sobre la resolución de problemas, consulte Instalación de las herramientas del SDK autónomo .

Asegúrese de que adb y aapt estén en la ruta de su sistema. El siguiente comando supone que ha abierto el archivo de paquete en su directorio de inicio:

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

Kit de desarrollo de Java

Instale la versión adecuada del Kit de desarrollo de Java (JDK). Para Android 7.0 o superior:

Para más detalles, consulte los requisitos de JDK .

Archivos CTS

Descargue y abra los paquetes CTS de las descargas de la suite de pruebas de compatibilidad que coincidan con la versión de Android de sus dispositivos y todas las interfaces binarias (ABI) de aplicaciones que sus dispositivos admiten.

Descargue y abra la última versión de los archivos multimedia CTS .

Detección de dispositivos

Siga el paso para configurar su sistema para detectar su dispositivo .

Configuración del dispositivo Android

Construcciones de usuario

Un dispositivo compatible se define como un dispositivo con una compilación firmada por usuario / clave de liberación. Su dispositivo debe ejecutar una imagen del sistema basada en la compilación de usuario compatible conocida (Android 4.0 o superior) de nombres clave, etiquetas y números de compilación .

Primera propiedad de compilación de nivel API

Ciertos requisitos de CTS dependen de la compilación con la que se envió originalmente un dispositivo. Por ejemplo, los dispositivos que originalmente se envían con compilaciones anteriores pueden quedar excluidos de los requisitos del sistema que se aplican a los dispositivos que se envían con compilaciones posteriores.

Para poner esta información a disposición de CTS, los fabricantes de dispositivos podrían haber definido la propiedad de tiempo de construcción ro.product.first_api_level . El valor de esta propiedad es el primer nivel de API con el que se lanzó comercialmente el dispositivo.

Los fabricantes de dispositivos pueden reutilizar la implementación subyacente común para lanzar un nuevo producto como una actualización de un producto existente en el mismo grupo de dispositivos. Los fabricantes de dispositivos pueden configurar opcionalmente el nivel API del producto existente en ro.product.first_api_level , de modo que los requisitos de actualización se apliquen para CTS y Treble / VTS.

Los fabricantes de dispositivos pueden agregar PRODUCT_PROPERTY_OVERRIDES en su archivo device.mk para establecer esta propiedad, como se muestra en el siguiente ejemplo:

#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

Primer nivel de API para Android 9 o superior

Para los dispositivos lanzados con Android 9 o superior, establezca la propiedad ro.product.first_api_level en un valor válido de Codenames, Tags y Build Numbers .

Primer nivel de API para Android 8.xo inferior

Para los dispositivos iniciados en Android 8.xo ro.product.first_api_level , desactive (elimine) la propiedad ro.product.first_api_level para la primera compilación del producto. Para todas las compilaciones posteriores, establezca ro.product.first_api_level en el valor de nivel de API correcto. Esto permite que la propiedad identifique correctamente un nuevo producto y conserva información sobre el primer nivel de API del producto. Si la bandera no está activada, Android asigna Build.VERSION.SDK_INT a ro.product.first_api_level .

CTS shim apps

Android 7.0 incluye las siguientes aplicaciones preconstruidas (creadas a partir de esta fuente ), que no contienen ningún código, excepto el manifiesto:

CTS utiliza estas aplicaciones para probar privilegios y permisos. Para pasar las pruebas, debe precargar las aplicaciones en los directorios apropiados en la imagen del sistema sin volver a firmarlas.

CTS cuña APEX

Android 10 o superior incluye un formato de paquete llamado APEX . Para escribir pruebas CTS para API de administración APEX (como actualizar a una nueva versión o informar APEX activos), debe preinstalar un paquete CtsShimApex en el dispositivo de destino.

Se requiere que CtsShimApex esté preinstalado en una partición /system .

Si la propiedad ro.apex.updatable se establece en true , se requiere CtsShimApex para todos los dispositivos que admiten la administración de paquetes APEX.

Si ro.apex.updatable propiedad ro.apex.updatable o no está configurada, no es necesario que CtsShimApex esté preinstalado en un dispositivo. La prueba de validación de shim APEX verifica la implementación de CtsShimApex .

Applet de muestra

Android 9 introdujo las API de Open Mobile. Para los dispositivos que informan más de un elemento seguro, CTS agrega casos de prueba para validar el comportamiento de las API de Open Mobile. Estos casos de prueba requieren la instalación por única vez de un applet de muestra en el elemento seguro integrado (eSE) del DUT o en la tarjeta SIM utilizada por el DUT. El applet de muestra eSE y el applet de muestra SIM se pueden encontrar en AOSP.

Consulte Prueba de CTS para elemento seguro para obtener información más detallada sobre casos de prueba de API móvil abierta y casos de prueba de control de acceso.

Requisitos de almacenamiento

Las pruebas de estrés de medios CTS requieren que los videoclips estén en almacenamiento externo ( /sdcard ). La mayoría de los clips son de Big Buck Bunny , propiedad de Blender Foundation bajo la licencia Creative Commons Attribution 3.0 .

El espacio requerido depende de la resolución máxima de reproducción de video admitida por el dispositivo. Consulte la sección 5 del documento Definición de compatibilidad de Android para ver la versión de la plataforma de las resoluciones requeridas).

Tenga en cuenta que las capacidades de reproducción de video del DUT se verifican a través de las API android.media.CamcorderProfile para versiones anteriores de Android y las API android.media.MediaCodecInfo.CodecCapabilities de Android 5.0.

Estos son los requisitos de almacenamiento por resolución máxima de reproducción de video:

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

Pantalla y almacenamiento

  • Cualquier dispositivo que no tenga una pantalla incrustada debe estar conectado a una pantalla.
  • Si el dispositivo tiene una ranura para tarjeta de memoria, conecte una tarjeta SD vacía. Use una tarjeta SD que admita el bus de ultra alta velocidad (UHS) con capacidad SDHC o SDXC o una con al menos una clase de velocidad 10 o superior para garantizar que pueda pasar el CTS.
  • Si el dispositivo tiene ranuras para tarjetas SIM, conecte una tarjeta SIM activada en cada ranura. Si el dispositivo admite SMS, cada tarjeta SIM debe tener su propio campo de número completado.

Desarrollador UICC

Para ejecutar las pruebas de API del operador de CTS, el dispositivo debe tener una tarjeta SIM con reglas de privilegios de operador. Consulte Preparación de la UICC .

Configuración del dispositivo Android

  1. Los datos de fábrica restablecen el dispositivo: Configuración> Copia de seguridad y restablecimiento> Restablecimiento de datos de fábrica .
  2. Configure el idioma de su dispositivo en inglés ( Estados Unidos ): Configuración> Idioma y entrada> Idioma .
  3. Active la configuración de ubicación si hay una función de GPS o Wi-Fi / red celular en el dispositivo: Configuración> Ubicación> Activado .
  4. Conéctese a una red Wi-Fi que admita IPv6, puede tratar el DUT como un cliente aislado (consulte el entorno físico más arriba) y tenga una conexión a Internet: Configuración> Wi-Fi .
  5. Asegúrese de que no haya un patrón de bloqueo o contraseña configurados en el dispositivo: Configuración> Seguridad> Bloqueo de pantalla> Ninguno .
  6. Habilite la depuración de USB en su dispositivo: Configuración> Opciones de desarrollador> Depuración de USB .
  7. Establezca la hora en formato de 12 horas: Configuración> Fecha y hora> Usar formato de 24 horas> Desactivado .
  8. Configure el dispositivo para permanecer despierto: Configuración> Opciones de desarrollador> Mantenerse despierto> Activado .
  9. Solo en Android 5.xy 4.4.x , configure el dispositivo para permitir ubicaciones falsas: Configuración> Opciones de desarrollador> Permitir ubicaciones falsas> Activado .
  10. En Android 4.2 o superior , desactive la verificación de aplicaciones USB: Configuración> Opciones de desarrollador> Verificar aplicaciones a través de USB> Desactivado .
  11. Inicie el navegador y descarte cualquier pantalla de inicio / configuración.
  12. Conecte la máquina de escritorio que se usará para probar el dispositivo con un cable USB.

Instalación de archivos

Instalar y configurar aplicaciones de ayuda en el dispositivo.

  1. Configure su dispositivo de acuerdo con su versión CTS:
    • CTS versiones 2.1 R2 a 4.2 R4: configure su dispositivo (o emulador) para ejecutar las pruebas de accesibilidad con:
      abd install -r android-cts/repository/testcases/CtsDelegatingAccessibilityService.apk

      En el dispositivo, habilite la delegación: Configuración> Accesibilidad> Accesibilidad> Delegar el servicio de accesibilidad .
    • CTS versiones 6.xo inferior: en dispositivos que declaran android.software.device_admin , configure su dispositivo para ejecutar la prueba de administración del dispositivo usando:
      adb install -r android-cts/repository/testcases/CtsDeviceAdmin.apk

      En Configuración> Seguridad> Seleccionar administradores de dispositivos , habilite los dos administradores de dispositivos android.deviceadmin.cts.CtsDeviceAdminReceiver* . Asegúrese de que android.deviceadmin.cts.CtsDeviceAdminDeactivatedReceiver y cualquier otro administrador de dispositivos precargados permanezcan deshabilitados.
  2. Copie los archivos multimedia CTS en el dispositivo de la siguiente manera:
    1. Navegue ( cd ) a la ruta donde se descargan y descomprimen los archivos multimedia.
    2. Cambiar los permisos del archivo:
      chmod u+x copy_media.sh
    3. Copie los archivos necesarios:
      • Para copiar clips hasta una resolución de 720x480, ejecute:
        ./copy_media.sh 720x480
      • Si no está seguro de la resolución máxima, copie todos los archivos:
        ./copy_media.sh all
      • Si hay varios dispositivos en adb, agregue la opción de serie ( -s ) de un dispositivo específico hasta el final. Por ejemplo, para copiar hasta 720x480 en el dispositivo con el número de serie 1234567, ejecute:
        ./copy_media.sh 720x480 -s 1234567