Utilisation du vérificateur CTS

L'Android Compatibility Test Suite Verifier (CTS Verifier) ​​complète la Compatibility Test Suite (CTS). Tandis que CTS vérifie les API et les fonctions qui peuvent être automatisées, CTS Verifier propose des tests pour les API et les fonctions qui ne peuvent pas être testées sur un appareil stationnaire sans saisie ou positionnement manuel, telles que la qualité audio, l'écran tactile, l'accéléromètre et la caméra.

Exigences

Avant d'exécuter CTS Verifier, assurez-vous que vous disposez de l'équipement suivant :

  • Appareil Android qui a vérifié la compatibilité de l'API Android en réussissant le CTS. Il s'agit de l'appareil testé (DUT).
  • Ordinateur Linux avec port compatible USB 2.0. Toutes les connexions au DUT passent par ce port.
  • Deuxième appareil Android avec une implémentation connue de Bluetooth, Wi-Fi direct, Wi-Fi Aware, UWB (si le DUT prend en charge UWB) et d'émulation de carte hôte NFC (HCE).
  • Un routeur Wi-Fi configuré avec un nom de point d'accès et un mot de passe. Le routeur doit pouvoir se déconnecter d'Internet, mais pas être éteint.

Assurez-vous également de préparer les trépieds, les supports d'appareil et les distances pré-mesurées requis pour les tests de mesure de distance (proximité) pour UWB, Wi-Fi NAN et Bluetooth RSSI. Pour plus de détails, voir Étalonnage de présence .

Exigences UICC pour les tests NFC

CTS Verifier propose les cas de test NFC suivants :

  • Field-off (utilise les données de transaction de 0x54)
  • Désélectionner (utilise les données de transaction de 0x52)
  • Commande HCI (0025000000) (utilise les données de transaction de 0x02)

Les tests d'événements de transaction nécessitent deux appareils, dont l'un doit disposer de SecureElement UICC avec les règles d'accès suivantes :

  • Hachage APK CtsVerifier : 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
  • Identifiant d'application autorisé (AID) pour l'accès aux événements NFC : 0xA000000476416E64726F696443545341

Du côté de l'émulateur, nous nous attendons à ce que l'événement de transaction place l'activité correspondante au premier plan.

Installation

Changez le mode de navigation du système de l'appareil de test en mode à trois boutons comme suit :

  1. Ouvrez Paramètres.
  2. Accédez à Système > Geste > Navigation système .
  3. Sélectionnez n’importe quel mode de navigation basé sur des boutons, le mode à trois boutons étant préféré, si disponible.

Pour configurer l'environnement de test CTS Verifier :

  1. Sur l'ordinateur Linux :

    • Exécutez la commande suivante avant d'installer CTS Verifier pour autoriser l'accès aux interfaces non SDK.

      adb shell settings put global hidden_api_policy 1
      
    • Installez Android Studio .

    • Téléchargez l’ APK CTS Verifier pour la version d’Android à tester.

  2. Connectez le DUT à l'ordinateur Linux.

  3. Depuis un terminal sur l'ordinateur Linux, installez CtsVerifier.apk sur le DUT.

    adb install -r -g CtsVerifier.apk
    
  4. Pour Android 10 et versions ultérieures, exécutez la commande suivante pour autoriser l'application à créer le rapport.

    adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
    
  5. Pour Android 11 et versions ultérieures, exécutez la commande suivante pour autoriser l'enregistrement des rapports dans un répertoire auto-défini sous le répertoire externe de niveau supérieur de l'appareil.

    adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
    
  6. Pour Android 13 et versions ultérieures, exécutez la commande suivante pour autoriser l’accès à l’API de test pour CTS Verifier.

    adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
    
  7. Pour Android 14 et versions ultérieures, exécutez la commande suivante pour autoriser l’application à allumer l’écran.

    adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
    
  8. Assurez-vous que la date et l'heure du système sont correctement réglées sur le DUT.

Exécuter le vérificateur CTS

Lancez l'application CTS Verifier en appuyant sur l'icône CTS Verifier sur le DUT.

Icône CTS Verifier dans le lanceur

Figure 1. Icône du vérificateur CTS

L'application affiche plusieurs ensembles de tests disponibles pour une vérification manuelle.

Menu de tests du vérificateur CTS

Figure 2. Menu des tests du vérificateur CTS

Chaque test contient un ensemble d'éléments communs en bas de l'écran.

Vérificateur de qualité vidéo en streaming

Figure 3. Écran de test avec les éléments de test courants mis en évidence

  • Réussir ( ✓). Appuyez si le DUT répond aux exigences de test selon les instructions d'information.
  • Info (?). Appuyez pour afficher les instructions de test. Apparaît également automatiquement à la première ouverture d'un test.
  • Échouer (!). Appuyez si le DUT ne répond pas aux exigences du test selon les instructions d'information.

Certains tests, tels que le mode accessoire USB et le test d'étalonnage de la caméra, nécessitent une configuration de test et des instructions supplémentaires, comme détaillé dans les sections suivantes.

Testez le mode accessoire USB pour 8.0 et versions ultérieures

Test des accessoires USB CTS Verifier

Figure 4. Procédure de test des accessoires USB pour 8.0 et versions ultérieures

Test des accessoires USB CTS Verifier

Figure 5. Test du mode accessoire USB pour 8.0 et versions ultérieures

Testez le mode accessoire USB pour 7.x et versions antérieures

Le test des accessoires USB nécessite un ordinateur Linux pour exécuter le programme de la machine de bureau USB (hôte).

  1. Connectez le DUT à l'ordinateur Linux.
  2. Sur l'ordinateur, exécutez le programme cts-usb-accessory du package CTS Verifier :

    ./cts-usb-accessory
  3. Attendez qu'un message contextuel apparaisse sur le DUT, puis sélectionnez OK .
    Test des accessoires USB CTS Verifier

    Figure 6. Test des accessoires USB

  4. Accédez au test des accessoires USB dans l’application CTS Verifier sur le DUT.

  5. Sur l'ordinateur, examinez la sortie de la console. Exemple de sortie :

    CTS USB Accessory Tester
    Found possible Android device (413c:2106) - attempting to switch to accessory
    mode...
    Failed to read protocol versionfigure3
    Found Android device in accessory mode (18d1:2d01)...
    [RECV] Message from Android device #0
    [SENT] Message from Android accessory #0
    [RECV] Message from Android device #1
    [SENT] Message from Android accessory #1
    [RECV] Message from Android device #2
    [SENT] Message from Android accessory #2
    [RECV] Message from Android device #3
    [SENT] Message from Android accessory #3
    [RECV] Message from Android device #4
    [SENT] Message from Android accessory #4
    [RECV] Message from Android device #5
    [SENT] Message from Android accessory #5
    [RECV] Message from Android device #6
    [SENT] Message from Android accessory #6
    [RECV] Message from Android device #7
    [SENT] Message from Android accessory #7
    [RECV] Message from Android device #8
    [SENT] Message from Android accessory #8
    [RECV] Message from Android device #9
    [SENT] Message from Android accessory #9
    [RECV] Message from Android device #10
    [SENT] Message from Android accessory #10
    

Calibrer le champ de vision de la caméra

Utilisez la procédure d’étalonnage du champ de vision pour déterminer rapidement le champ de vision de l’appareil avec une précision modérée.

  1. Configurez l'environnement de test :

    1. Imprimez le fichier cible calibrage-pattern.pdf sur du papier de format 11" x 17" ou A3.
    2. Montez le motif imprimé sur un support rigide.
    3. Orientez la caméra et la cible imprimée comme indiqué dans le schéma suivant.
      Cible imprimée par la caméra

      Figure 7. Cible imprimée par la caméra

  2. Définissez la largeur cible :

    1. Mesurez la distance (en centimètres) entre les lignes pleines sur le motif cible pour tenir compte des imprécisions d'impression (~ 38 cm).
    2. Démarrez l'application d'étalonnage.
    3. Appuyez sur le bouton de configuration et sélectionnez Distance du marqueur .
    4. Mesurez et entrez la distance jusqu'au motif cible (~ 100 cm).
    5. Appuyez sur le bouton Retour pour revenir à l'aperçu de l'étalonnage.
  3. Vérifiez que l'appareil et la cible sont placés comme indiqué sur la figure et que les distances correctes ont été saisies dans la boîte de dialogue de configuration. L'aperçu affiche l'image avec une ligne verticale superposée ; cette ligne doit s'aligner avec la ligne centrale du motif cible. La grille transparente peut être utilisée avec les autres lignes verticales pour garantir que l'axe optique est orthogonal à la cible.

  4. Exécutez le test d'étalonnage :

    1. Sélectionnez une résolution d'image (à l'aide du sélecteur en bas à gauche), puis appuyez sur l'écran pour prendre une photo. Le test passe en mode calibrage et affiche la photo avec deux lignes verticales superposées sur l'image.
    2. Déterminer la précision :
      • Si les lignes s'alignent avec les lignes verticales du motif cible à quelques centimètres près, le champ de vision indiqué pour la résolution sélectionnée est précis.
      • Si les lignes ne s'alignent pas, le champ de vision signalé est inexact. Pour corriger cela, ajustez le curseur en bas de l’écran jusqu’à ce que la superposition s’aligne le plus possible avec le motif cible. Lorsque la superposition et l'image du motif cible sont alignées, le champ de vision affiché est une proche approximation de la valeur correcte. Le champ de vision signalé doit se situer à +/-2 degrés de la valeur d'étalonnage.
    3. Appuyez sur le bouton Retour et répétez le test d'étalonnage pour toutes les résolutions d'image prises en charge par le DUT.

Exécutez CTS Verifier pour les modes alternatifs

À partir des versions CTS 10 R6 et CTS 11 R2, CTS Verifier prend en charge les tests requis pour les appareils dotés de modes alternatifs ou pour les appareils dotés de plusieurs modes d'écran.

En haut de la liste principale de CTS Verifier, un bouton s'affiche pour permettre aux utilisateurs de basculer entre le mode d'affichage déplié et plié. CTS Verifier affichera les tests nécessaires pour le mode d'affichage sélectionné. Pour exécuter les modes alternatifs dans CTS Verifier, il faut basculer le bouton sur le mode d'affichage approprié et exécuter la liste des tests affichés.

Interrupteur à bascule CTS-V

Les résultats des tests pliés seront enregistrés dans le même rapport que les tests dépliés. Pour identifier chaque résultat de test à partir duquel provient l'ensemble de tests, un suffixe est ajouté à chaque nom de test sous le mode plié.

<Test result="fail" name="com.android.cts.verifier.deskclock.DeskClockTestsActivity[folded]">
  <RunHistory subtest="CREATE_ALARM[folded]">
    <Run start="1594176663973" end="1594176665841" isAutomated="false" />
  </RunHistory>
</Test>

Exporter les résultats

Une fois tous les tests terminés, vous pouvez enregistrer les résultats sous forme de rapport et les télécharger sur un ordinateur. Les noms des rapports sont automatiquement horodatés en fonction de l’heure du système DUT.

  1. Pour enregistrer vos résultats de test, appuyez sur l'icône Enregistrer (disque) en haut de la liste des catégories de tests.

  2. Attendez un message contextuel affichant le chemin du fichier vers le rapport enregistré (par exemple, /sdcard/verifierReports/ctsVerifierReport-date-time.zip ), puis enregistrez le chemin.

  3. Connectez le DUT à l'ordinateur Linux.

  4. À partir de l'installation du SDK Android sur l'ordinateur Linux, téléchargez les rapports à partir de l'appareil connecté à l'aide adb shell content read ou adb pull CTSVerifierReportPath .

    • Pour Android 7.x et versions ultérieures, téléchargez tous les rapports à l'aide de la commande suivante :

      adb pull /sdcard/verifierReports
      
    • Pour Android 6.0 et versions antérieures, téléchargez tous les rapports à l'aide de la commande suivante :

      adb pull /mnt/sdcard/ctsVerifierReports/
      
    • Pour Android 10 et versions ultérieures, implémentant Automotive et les appareils exécutés en tant qu'utilisateur secondaire , téléchargez le dernier rapport à l'aide de la commande suivante :

      adb shell content read --user CURRENT_USER --uri
      
      content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip
      

      Pour répertorier tous les rapports disponibles sur l'appareil connecté :

      adb shell content query --user CURRENT_USER --uri
      
      content://com.android.cts.verifier.testresultsprovider/reports
      

      Pour télécharger un rapport à partir de la liste, vous pouvez spécifier l'ID de ligne ou le nom de fichier. Par exemple:

      adb shell content read --user CURRENT_USER --uri
      
      content://com.android.cts.verifier.testresultsprovider/reports/0 > report.zip
      
      adb shell content read --user CURRENT_USER --uri
      
      content://com.android.cts.verifier.testresultsprovider/reports/ctsVerifierReport-date-time.zip >
      report.zip
      
  5. Pour effacer les résultats de réussite/d'échec, sélectionnez les résultats dans l'application CTS Verifier et sélectionnez Menu > Effacer .