Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.
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á 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 5 metros del dispositivo bajo prueba 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, incluidas 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 máximos 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 ya 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 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 satelital o un repetidor GPS / GNSS de señales exteriores, o puede colocar el dispositivo bajo prueba 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. Consulte la lista de Wikipedia de agentes de túneles IPv6 .

RTT Wi-Fi

Android incluye la API de Wi-Fi RTT 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.

Consulte Wi-Fi RTT (IEEE 802.11mc) y ubicación de Wi-Fi: rango con RTT para obtener una lista de dispositivos recomendados que admiten Wi-Fi RTT.

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 haber instalado las versiones recientes de Android Debug Bridge (adb) y la Herramienta de empaquetado de activos de Android (AAPT) y agregue la ubicación de esas herramientas a la ruta del sistema de su máquina.

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

Asegúrese de que adb y aapt estén en la ruta de su 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 para Ubuntu

Instale la versión adecuada de Java Development Kit (JDK) .

  • Para Android 11, instale OpenJDK11.
  • Para Android 9 y Android 10, instale OpenJDK9.
  • Para Android 7.0, 7.1, 8.0 y 8.1, instale OpenJDK8.

Para obtener más información, consulte los requisitos de JDK .

Archivos CTS

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

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

Detección de dispositivos

Siga el paso para configurar su sistema para que detecte su dispositivo .

Limite de memoria

Es posible que desee aumentar la memoria máxima disponible durante la ejecución de la prueba en el script cts-tradfed . Consulte el ejemplo CL para obtener más información.

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. Su dispositivo debe ejecutar una imagen del sistema basada en la compilación del usuario compatible (Android 4.0 o superior) a partir de Codenames, Tags y Build Numbers .

Propiedad de construcción del primer nivel de API

Ciertos requisitos de CTS dependen de la versión con la que se envió originalmente el 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 que esta información esté disponible para CTS, los fabricantes de dispositivos podrían haber definido la propiedad de tiempo de 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 establecer opcionalmente el nivel de API del producto existente en ro.product.first_api_level , de modo que se apliquen los requisitos de actualización 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 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 versiones anteriores

Para dispositivos lanzados en Android 8.xo ro.product.first_api_level , ro.product.first_api_level (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 la información sobre el primer nivel de API del producto. Si la Build.VERSION.SDK_INT está configurada, 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 pruebas CTS para las API de administración de APEX (como actualizar a una nueva versión o informar APEX activos), debe preinstalar un paquete CtsShimApex en una partición /system .

La prueba de validación de shim APEX verifica la implementación de CtsShimApex .

requisitos de ro.apex.updatable

  • 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 el dispositivo.

Preinstalaciones y precargas de CtsShim

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

Si el dispositivo no admite la administración de paquetes APEX (es decir, ro.apex.updatable propiedad ro.apex.updatable o no está configurada), o si el dispositivo ejecuta la versión 10 o inferior, las dos aplicaciones precompiladas deben estar preinstaladas en el sistema por separado.

Versión del dispositivo Preinstalar (si APEX es compatible) Precarga
BRAZO x86 BRAZO x86
Android 11 android11-arm-release
en /system/apex/com.android.apex.cts.shim.apex
android11-x86-release
en /system/apex/com.android.apex.cts.shim.apex
android11-arm-CtsShim.apk
en /system/app/CtsShimPrebuilt.apk

android11-arm-CtsShimPriv.apk
en /system/priv-app/CtsShimPrivPrebuilt.apk

android11-x86-CtsShim.apk
en /system/app/CtsShimPrebuilt.apk

android11-x86-CtsShimPriv.apk
en /system/priv-app/CtsShimPrivPrebuilt.apk

Android 10 android10-release
en /system/apex/com.android.apex.cts.shim.apex
android10-arm-CtsShim.apk
en /system/app/CtsShimPrebuilt.apk

android10-arm-CtsShimPriv.apk
en /system/priv-app/CtsShimPrivPrebuilt.apk

android10-x86-CtsShim.apk
en /system/app/CtsShimPrebuilt.apk

android10-x86-CtsShimPriv.apk
en /system/priv-app/CtsShimPrivPrebuilt.apk

Android 9, O y O-MR1 N / A N / A arm-CtsShim.apk
en /system/app/CtsShimPrebuilt.apk

arm-CtsShimPriv.apk
en /system/priv-app/CtsShimPrivPrebuilt.apk

x86-CtsShim.apk
en /system/app/CtsShimPrebuilt.apk

x86-CtsShimPriv.apk
en /system/priv-app/CtsShimPrivPrebuilt.apk

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 subprograma de muestra eSE y el subprograma de muestra SIM se pueden encontrar en AOSP.

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

Requisitos de almacenamiento

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

El espacio requerido depende de la resolución máxima de reproducción de video que admita el dispositivo. Consulte la sección 5 del documento Definición de compatibilidad de Android para conocer la versión de plataforma de las resoluciones necesarias).

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 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.

Desarrollador UICC

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

Configuración del dispositivo Android

  1. Restablecer los datos de fábrica del dispositivo: Configuración> Copia de seguridad y restablecer> Restablecer 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 red GPS o Wi-Fi / celular en el dispositivo: Configuración> Ubicación> Activado .
  4. Conéctese a una red Wi-Fi que admita IPv6, pueda tratar el DUT como un cliente aislado (consulte Entorno físico más arriba) y tenga una conexión a Internet: Configuración> Wi-Fi .
  5. Asegúrese de que no haya ningún 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. Configura la hora en formato de 12 horas: Configuración> Fecha y hora> Usar formato de 24 horas> Desactivado .
  8. Configure el dispositivo para que permanezca despierto: Configuración> Opciones de desarrollador> Permanecer despierto> Activado .
  9. Solo en Android 5.xy 4.4.x , configure el dispositivo para permitir ubicaciones simuladas: Configuración> Opciones de desarrollador> Permitir ubicaciones simuladas> Activado .
  10. En Android 4.2 o superior , desactiva la verificación de la aplicación USB: Configuración> Opciones de desarrollador> Verificar aplicaciones a través de USB> Desactivado .
  11. Inicie el navegador y cierre cualquier pantalla de inicio / configuración.
  12. 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 4.2 R4: Configure su dispositivo (o emulador) para ejecutar las pruebas de accesibilidad con:
      adb install -r android-cts/repository/testcases/CtsDelegatingAccessibilityService.apk

      En el dispositivo, habilite la delegación: Configuración> Accesibilidad> Accesibilidad> Delegar servicio de accesibilidad .
    • CTS versiones 6.xo anteriores: 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. Cambie 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 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