L'outil Android Compatibility Test Suite Verifier (CTS Verifier) complète Compatibility Test Suite (CTS). Si CTS vérifie les API et les fonctions automatisé, CTS Verifier fournit des tests pour les API et les fonctions qui ne peuvent pas être testé sur un appareil fixe sans saisie ni positionnement manuel (audio, par exemple) l'écran tactile, l'accéléromètre et l'appareil photo.
Conditions requises
Avant d'exécuter CTS Verifier, assurez-vous de disposer de l'équipement suivant:
- Appareil Android qui a vérifié la compatibilité avec les API Android en réussissant pour réussir la CTS. Il s'agit de l'appareil testé.
- Ordinateur Linux avec port compatible USB 2.0 Toutes les connexions à l'appareil testé via ce port.
- Deuxième appareil Android avec un Bluetooth compatible connu, le Wi-Fi direct, le Wi-Fi Aware, UWB (si l'appareil testé est compatible avec la UWB) et l'émulation de carte hôte NFC (HCE) la mise en œuvre.
- Un routeur Wi-Fi configuré avec un point d'accès et un mot de passe Le routeur devrait pouvoir se déconnecter d'Internet, mais n'est pas alimenté désactivée.
Préparez également le trépied, le support de l'appareil et les mesures les distances requises pour les tests de mesure de distance (proximité) avec la technologie UWB ; Wi-Fi NAN et Bluetooth RSSI. Pour en savoir plus, consultez Étalonnage de présence.
Exigences UICC pour les tests NFC
L'outil de vérification CTS propose les scénarios de test NFC suivants:
- Champ désactivé (utilise les données de transaction de 0 x 54)
- Désélectionner (utilise les données de transaction de 0 x 52)
- Commande HCI (0025000000) (utilise les données de transaction de 0x02)
Les tests d'événements de transaction nécessitent deux appareils, dont un doit avoir SecureElement avec les règles d'accès suivantes:
- Hachage de l'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, l'événement de transaction doit transmettre le code l'activité au premier plan.
Configuration
Définissez le mode de navigation système de l'appareil de test sur le mode à trois boutons en tant que ce qui suit:
- Ouvrez les paramètres.
- Accédez à Système > Geste > Navigation système :
- Sélectionnez un mode de navigation basé sur des boutons, le mode à trois boutons de préférence, si disponibles.
Pour configurer l'environnement de test de l'outil de vérification CTS:
Sur l'ordinateur Linux:
Exécutez la commande suivante avant d'installer le vérificateur CTS pour autoriser l'accès aux interfaces non SDK.
adb shell settings put global hidden_api_policy 1
Installez Android Studio.
Téléchargez le APK de l'outil de vérification CTS pour la version d'Android à tester.
Connectez l'appareil testé à l'ordinateur Linux.
Depuis un terminal de l'ordinateur Linux, installez
CtsVerifier.apksur l'appareil testé.adb install -r -g CtsVerifier.apk
Pour Android 10 ou version ultérieure, 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
Pour Android 11 ou version ultérieure, exécutez la commande suivante : pour autoriser l'enregistrement de rapports dans un répertoire auto-défini sous le fichier répertoire de premier niveau externe de l'appareil.
adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
Pour Android 13 ou version ultérieure, exécutez la commande suivante : pour autoriser l'accès à l'API de test pour le vérificateur CTS.
adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
Pour Android 14 ou version ultérieure, exécutez la commande suivante : pour autoriser l'application à allumer l'écran.
adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
Vérifiez que la date et l'heure système de l'appareil testé sont correctes.
Exécuter le vérificateur CTS
Lancez l'application CTS Verifier en appuyant sur l'icône CTS Verifier.
Figure 1 : Icône de l'outil de vérification CTS
L'application affiche plusieurs ensembles de test disponibles pour une vérification manuelle.
Figure 2. Menu des tests du vérificateur CTS
Chaque test contient un ensemble d'éléments communs en bas de l'écran.
Figure 3. Écran de test avec les éléments de test courants mis en évidence
- Réussite (✓) Indiquez si l'appareil testé répond aux exigences du test selon les informations instructions.
- Infos (?). Appuyez pour afficher les instructions de test. S'affiche également automatiquement la première fois qu'un test est ouvert.
- Échec (!). Appuyez si l'appareil testé ne répond pas aux exigences de test décrites dans les informations instructions.
Certains tests, tels que le mode accessoire USB et le test de calibrage de l'appareil photo, nécessitent de configuration du test supplémentaire, ainsi que des instructions détaillées dans les sections suivantes.
Tester le mode accessoire USB pour la version 8.0 ou ultérieure
Figure 4. Procédure de test des accessoires USB pour 8.0 et au-dessus
Figure 5. Test du mode accessoire USB pour les appareils 8.0 et au-dessus
Tester le mode accessoire USB pour les versions 7.x et antérieures
Le test d'accessoire USB nécessite un ordinateur Linux pour exécuter l'ordinateur de bureau USB. (hôte).
- Connectez l'appareil testé à l'ordinateur Linux.
Sur l'ordinateur, exécutez le programme
cts-usb-accessoryà partir de CTS. Package Verifier:./cts-usb-accessory
Attendez qu'un message pop-up s'affiche sur l'appareil, puis sélectionnez OK.
Figure 6. Test d'accessoire USB
Accédez au test d'accessoire USB dans l'application CTS Verifier sur l'appareil testé.
Sur l'ordinateur, examinez le résultat de la console. Exemple de résultat :
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
Utiliser la procédure d'étalonnage du champ de vision pour déterminer rapidement l'appareil avec une précision moyenne.
Configurez l'environnement de test:
- Imprimer le Cible calibration-pattern.pdf sur du papier A3 ou 11 x 17 pouces.
- Installez le modèle imprimé sur un support rigide.
Orientez l'appareil photo et la cible imprimée comme illustré ci-dessous graphique.
Figure 7. Cible de l'appareil photo imprimée
Définissez la largeur cible:
- Mesurez la distance (en centimètres) entre les lignes continues sur le format cible pour tenir compte des imprécisions d'impression (environ 38 cm).
- Lancez l'application de calibrage.
- Appuyez sur le bouton de configuration, puis sélectionnez Distance du repère.
- Mesurez et saisissez la distance par rapport au motif de la cible (environ 100 cm).
- Appuyez sur le bouton Retour pour revenir à l'aperçu du calibrage.
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. Aperçu affiche l'image avec une ligne verticale superposée ; cette ligne doit pour l'aligner sur la ligne centrale du modèle de cible. La grille transparente peut avec les autres lignes verticales pour garantir que l'axe optique orthogonale à la cible.
Exécutez le test d'étalonnage:
- 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 entre en mode d'étalonnage affiche la photo avec deux lignes verticales superposées sur l'image.
- Déterminez la précision:
<ph type="x-smartling-placeholder">
- </ph>
- Si les lignes s'alignent sur les lignes verticales du modèle de cible en l'espace de quelques centimètres, le champ de vision la résolution sélectionnée est exacte.
- Si les lignes ne sont pas alignées, le champ de vision du rapport sera inexact. Pour corriger ce problème, ajustez le curseur en bas de l'écran jusqu'à la superposition s'aligne sur le modèle cible le plus près possible. Lorsque la superposition et l'image du format cible sont alignées, la macro le champ de vision affiché est une approximation proche du . Le champ de vision indiqué doit se trouver à +/-2 degré de la valeur d'étalonnage.
- Appuyez sur le bouton Retour et répétez le test de calibrage pour toutes les images. compatibles avec l'appareil testé.
Exécuter le vérificateur CTS pour d'autres modes
À 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 avec plusieurs modes d'écran.
En haut de la liste principale de CTS Verifier, un bouton permettant d'activer s'affiche aux utilisateurs de basculer entre le mode d'affichage déplié et le mode d'affichage plié. CTS Verifier affichera les tests nécessaires pour le mode d'affichage sélectionné. Pour exécuter l'instruction dans CTS Verifier, il est recommandé de basculer le bouton sur l'écran approprié et exécuter la liste de tests affichée.
Les résultats des tests pliés sont enregistrés dans le même rapport tests. Pour identifier chaque résultat de test dont provient l'ensemble de test, une est ajouté à chaque nom de test en 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 à un ordinateur. Les noms des rapports sont automatiquement horodatés en fonction de l'appareil testé. l'heure système.
Pour enregistrer les résultats du test, appuyez sur l'icône d'enregistrement (disque) en haut de la liste. de catégories de test.
Attendez que le message contenant le chemin d'accès au rapport enregistré s'affiche (par exemple,
/sdcard/verifierReports/ctsVerifierReport-date-time.zip), puis et enregistrer le chemin d'accès.Connectez l'appareil testé à l'ordinateur Linux.
Téléchargez les rapports depuis l'installation du SDK Android sur l'ordinateur Linux. depuis l'appareil connecté à l'aide de
adb shell content readouadb pull CTSVerifierReportPath.Pour Android 7.x ou version ultérieure, téléchargez tous les rapports à l'aide de la commande suivante:
adb pull /sdcard/verifierReports
Pour Android 6.0 ou version antérieure, téléchargez tous les rapports à l'aide de la commande suivante:
adb pull /mnt/sdcard/ctsVerifierReports/
Pour Android 10 et versions ultérieures, la mise en œuvre Automobile et les appareils fonctionnant utilisateur secondaire, télécharger 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 afficher 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 nom de fichier. 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
Pour effacer les résultats de réussite/échec, sélectionnez les résultats dans l'application CTS Verifier. sélectionnez Menu > Effacer.