Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

Configuración de CTS

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

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 exploración 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, utilice 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.

El punto los sensores de la cámara a una escena con una iluminación suficiente para permitir que los sensores bajo prueba para alcanzar y permanecer en el máximo configurado marcos de destino por segundo (fps) como se especifica en CONTROL_AE_TARGET_FPS_RANGE . Esto se aplica a todos los sensores de la cámara reportados por getCameraIdList como las iteraciones de las pruebas sobre los dispositivos y medidas que figuran el rendimiento individual.

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 de 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 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 CTS requieren una red Wi-Fi que admita IPv6, tenga una conexión a Internet y pueda tratar al DUT como un cliente aislado. Un cliente aislado se refiere a una configuración en la que el dispositivo bajo prueba no tiene visibilidad de los mensajes de difusión / redes múltiples en esa subred. Esto ocurre con una configuración de AP Wi-Fi o ejecutando el DUT en una subred aislada sin que otros dispositivos estén conectados.

Si no tiene acceso a una red IPv6 nativa, una red de operador IPv6 o una VPN para pasar algunas pruebas según IPv6, puede usar un punto de acceso Wi-Fi y un túnel IPv6. Ver la Wikipedia lista de proveedores de túneles IPv6 .

RTT Wi-Fi

Android incluye la API de Wi-Fi RTT para un tiempo de ida y vuelta Wi-Fi (RTT) de capacidad. 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 de soporte Wi-Fi RTT son Google Wifi y punto de acceso fitlet2 de Compulab (conjunto de ancho de banda de 40 MHz a 5 GHz).

Los puntos de acceso deben estar encendidos, pero no requieren una conexión de red. No es necesario que los puntos de acceso estén al lado del dispositivo de prueba, pero se recomienda que estén a 40 pies del dispositivo bajo prueba. Normalmente, un punto de acceso es suficiente.

Configuración de la máquina de escritorio

ADB y AAPT

Antes de ejecutar el CTS, asegúrese de que ha instalado las versiones recientes de ambas Android Debug Bridge (ADB) y Android activos Packaging Tool (AAPT) y se añade la ubicación de dichas herramientas a la ruta del sistema de la máquina.

Para instalar el BAD, la descarga Herramientas Android SDK paquete para su sistema operativo, abrirlo, y siga las instrucciones del archivo README incluido. Para solucionar los problemas de información, consulte Instalación de los autónomos de herramientas SDK .

Asegúrese de que adb y aapt se encuentran en la ruta del sistema. El siguiente comando asume que ha abierto el archivo del 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 de Java Development Kit (JDK). Para Android 7.0 o superior:

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

Archivos CTS

Descargar y abrir los paquetes de CTS Compatibility Test Suite Descargas combina con el modelo de sus dispositivos Android y todas las interfaces binarias de la aplicación (Abis) que sus dispositivos de apoyo.

Descargar y abrir la versión más reciente 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 el usuario / clave de liberación. El dispositivo debe estar ejecutando una imagen del sistema basado en la conocida para que sea compatible usuario acumulación (Android 4.0 o superior) de Nombres de versión, las etiquetas y números de compilación .

Propiedad de construcción del primer nivel de API

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

Para poner esta información a disposición de CTS, los fabricantes de dispositivos podrían haber definido la propiedad en tiempo de compilació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 para ro.product.first_api_level , de modo que se aplican requisitos de actualización para CTS y agudos / VTS.

Los fabricantes de dispositivos pueden añadir PRODUCT_PROPERTY_OVERRIDES en su device.mk archivo 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, ajuste el ro.product.first_api_level propiedad a un valor válido de Nombres de versión, las etiquetas y números de compilación .

Primer nivel de API para Android 8.xo versiones anteriores

Para los dispositivos lanzados en 8.x Android o inferior, unset (quitar) el ro.product.first_api_level propiedad por primera acumulación del producto. Para todas las posteriores construcciones, juego ro.product.first_api_level al valor correcto nivel de la API. Esto permite que la propiedad identifique correctamente un nuevo producto y conserva la información sobre el primer nivel de API del producto. Si la bandera no está definida, Android asigna Build.VERSION.SDK_INT a ro.product.first_api_level .

Paquetes de suplementos CTS

Android 10 o superior incluye un formato de paquete llamado APEX . Para ejecutar las pruebas de CTS para las API de gestión de APEX (como la actualización a una nueva versión o informar vértices activos) debe preinstalar un CtsShimApex paquete en el dispositivo de destino.

CtsShimApex se requiere para ser preinstalado en un /system partición.

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

Si el ro.apex.updatable propiedad se encuentra o no está definida, CtsShimApex no está obligado a ser preinstalado en una gestión de paquetes. Si el ro.apex.updatable propiedad se encuentra o no está definida, CtsShimApex no está obligado a estar preinstalado en un dispositivo. El APEX cuña prueba de validación verifica la implementación de CtsShimApex .

A partir de Android 11, CtsShimApex contiene dos aplicaciones creados previamente (construidos a partir de esta fuente ), que no contienen ningún código, excepto para el manifiesto. CTS usa estas aplicaciones para probar privilegios y permisos.

Si el dispositivo no es compatible con la gestión de paquetes APEX (es decir, la ro.apex.updatable propiedad se encuentra o no se ha establecido), o si el dispositivo se está ejecutando la versión 10 o inferior, las dos aplicaciones predefinidos deben estar preinstalados en el sistema por separado:

Para aprobar las pruebas, precargue las aplicaciones en los directorios correspondientes de la imagen del sistema sin volver a firmar las aplicaciones.

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 única de un subprograma de muestra en el elemento seguro integrado (eSE) del DUT o en la tarjeta SIM utilizada por el DUT. El applet de ejemplo ESE y el applet de ejemplo SIM se pueden encontrar en AOSP.

Ver Prueba de CTS para Secure Element para obtener información más detallada sobre los casos de prueba API Open Mobile y casos de prueba de control de acceso.

Requisitos de almacenamiento

Los medios de comunicación CTS subrayan pruebas requieren clips de vídeo para estar en almacenamiento externo ( /sdcard ). La mayoría de los clips son de Big Buck Bunny , que es propiedad de la Fundación Blender bajo la licencia Creative Commons Atribución 3.0 .

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

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

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

Pantalla y almacenamiento

  • Cualquier dispositivo que no tenga una pantalla incorporada debe estar conectado a una pantalla.
  • Si el dispositivo tiene una ranura para tarjetas de memoria, conecte una tarjeta SD vacía. Utilice una tarjeta SD que admita bus de velocidad ultra alta (UHS) con capacidad SDHC o SDXC o una con al menos clase de velocidad 10 o superior para asegurarse de que pueda pasar la 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 completo. Para dispositivos con Android 12 o superior, todas las tarjetas SIM deben ser compatibles con el almacenamiento de números de marcación abreviada (ADN). Tarjetas GSM y USIM con el archivo dedicado telecomunicaciones (Telecom DF) satisfacen este requisito.

Desarrollador UICC

Para ejecutar las pruebas API portadora CTS, el dispositivo tiene que usar una tarjeta SIM con privilegios de transporte CTS cumplimiento de los requisitos especificados en la preparación de la UICC .

Configuración del dispositivo Android

  1. Restablecer datos de fábrica del dispositivo: Configuración> Copia de seguridad y restablecimiento> Restablecer datos de fábrica.

  2. Establecer el idioma del dispositivo en Inglés (Estados Unidos): Ajustes> Idioma y entrada> Idioma.

  3. Active el ajuste de ubicación, si hay un GPS o función de red Wi-Fi / celular en el dispositivo: Configuración> Ubicación> Activada.

  4. Conectarse a una red Wi-Fi compatible con IPv6, se puede tratar el DUT como un cliente aislado (véase entorno físico más arriba), y tiene una conexión a Internet: Ajustes> Wi-Fi.

  5. Asegúrese de que hay un patrón o contraseña de bloqueo se fija en el dispositivo: Configuración> Seguridad> Bloqueo de pantalla> Ninguno.

  6. Habilitar la depuración USB en el dispositivo: Configuración> Opciones de desarrollador> Depuración USB.

  7. Ajustar la hora en formato de 12 horas: Ajustes> Fecha y hora> Formato de 24 horas> Off.

  8. Configurar el dispositivo para mantenerse despierto: Ajustes> Opciones de desarrollador> Stay Awake> Activar.

  9. En 5.x Android y 4.4.x solamente, configurar el dispositivo para permitir ubicaciones de prueba: Ajustes> Opciones de desarrollador> Permitir ubicaciones de prueba> En 0.10. En Android 4.2 o superior, apague la verificación de aplicaciones USB: Ajustes> Opciones de desarrollador> Verificar aplicaciones a través de USB> Off 0.11. Inicie el navegador y cierre cualquier pantalla de inicio / configuración.

  10. Conecte la máquina de escritorio que se utilizará para probar el dispositivo con un cable USB.

Instalación de archivos

Instale y configure aplicaciones de ayuda en el dispositivo.

  1. Configure su dispositivo de acuerdo con su versión CTS:

    • Versiones CTS 2.1 R2 a través de 4,2 R4: configurar el dispositivo (o un emulador) para ejecutar las pruebas de accesibilidad con: abd install -r android-cts/repository/testcases/CtsDelegatingAccessibilityService.apk

      En el dispositivo, habilitar la delegación: Ajustes> Accesibilidad> Accesibilidad> Accesibilidad Servicio delegar.

    • CTS versiones 6.x o inferior: En los dispositivos que declarar android.software.device_admin , configurar el dispositivo para ejecutar la prueba administración del dispositivo usando: adb install -r android-cts/repository/testcases/CtsDeviceAdmin.apk`

      En Configuración> Seguridad> Seleccionar administradores de dispositivos, permitirá a las dos android.deviceadmin.cts.CtsDeviceAdminReceiver* administradores del dispositivo. Asegurar que android.deviceadmin.cts.CtsDeviceAdminDeactivatedReceiver y cualesquiera otros administradores de dispositivos precargados permanecen desactivadas.

  2. Copie los archivos multimedia CTS en el dispositivo de la siguiente manera:

    1. Navegar ( cd ) a la ruta donde los archivos multimedia se descargan y descomprimen.
    2. Cambiar los permisos de 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 bajo ADB, añadir la opción de serie ( -s ) de un dispositivo específico para el fin. Por ejemplo, para copiar hasta 720x480 en el dispositivo con serie 1234567, ejecute:

        ./copy_media.sh 720x480 -s 1234567