Exécuter des tests multiappareils avec le vérificateur CTS

Cette page contient des instructions pour utiliser les tests multiappareils CTS Verifier (CTS-V) pour Android 16 et versions ultérieures.

Configurer des tests multiappareils côté hôte

Cette section explique comment configurer des tests multiappareils.

  1. Assurez-vous que votre ordinateur de bureau dispose de la configuration système requise pour CTS.
  2. Suivez les étapes 2 et 5 de la section Installer le logiciel pour ordinateur pour vous assurer qu'adb, AAPT2 et Python sont correctement installés sur votre ordinateur.

  3. Préparez deux appareils testés (DUT) correspondants, chacun avec CTS-V configuré.

    • Pour en savoir plus sur la configuration d'un DUT, consultez Configurer le DUT.
    • Pour obtenir des instructions sur la configuration de CTS-V, consultez la section Configuration.

  4. Si vous testez un module autre que le NFC, suivez la procédure Configurer des tests standards à deux appareils.

  5. Si vous testez le module CDM, suivez la procédure Configurer les tests CDM en plus de la configuration standard à deux appareils.

Configurer des tests standards à deux appareils

Pour la configuration par défaut à deux appareils:

  1. Placez deux DUT Android correspondants à environ 20 cm l'un de l'autre.

  2. Pour garantir un environnement propre, placez les deux appareils dans une boîte de protection.

  3. (Facultatif) Configurez un sniffeur OTA pour le débogage du Wi-Fi.

Configurer des tests NFC

Les tests NFC utilisent un DUT et une puce NFC PN532.

Pour configurer des tests NFC:

  1. Achetez une puce NFC PN532. Nous vous recommandons le PN532 tout-en-un.

  2. Sur l'appareil de test, accédez à l'application Paramètres.

  3. Activez le NFC.

  4. Positionnez le chip NFC:

    • Pour les téléphones, positionnez le lecteur NFC de l'appareil testé comme indiqué sur la figure 1:

      Positionnement de la puce NFC

      Figure 1 : Positionnement de la puce NFC.

    • Pour les autres types d'appareils, placez la puce à côté de l'antenne NFC de l'appareil.

  5. Connectez la puce NFC PN532 à votre station de travail de test à l'aide d'un câble USB.

Configurer des tests de CDM

Le cas de test test_permissions_sync() présente un comportement différent en fonction du type de build des appareils sur lesquels le test est exécuté. Il est essentiel que les builds à la fois débogables (userdebug ou eng) et non débogables (user) soient testés par les OEM et que les tests soient réussis pour les deux.

Exemption

La clause CDD pour l'implémentation de l'API de synchronisation des autorisations ne l'oblige qu'à pouvoir transférer des données entre les appareils via un canal sécurisé. Étant donné que l'implémentation du canal sécurisé n'est pas une exigence de conformité CDD, ce test peut être ignoré sur les builds non débogables (utilisateurs), mais uniquement si vous ne souhaitez pas prendre en charge la fonctionnalité de synchronisation des autorisations CDM.

Les tests doivent réussir sur les builds débogables sans exception.

Prérequis pour les tests sur les builds non débogables

Si vous n'êtes pas exempté par les clauses d'exemption précédentes, vérifiez que les conditions préalables suivantes sont remplies.

Le canal sécurisé utilise AVF (AttestationVerificationFramework) pour vérifier la fiabilité du matériel. Les attestations générées par les deux parties contiennent plusieurs informations sur elles-mêmes pour s'assurer qu'aucune modification non autorisée n'a été apportée à leur système. L'AVF vérifie les états suivants pendant le processus de validation:

  • L'appareil dispose d'un accès à Internet
  • L'appareil utilise le démarrage validé et le build doit être signé avec une clé de publication, et non une clé de développement.
  • Le bootloader de l'appareil est verrouillé. Pour obtenir des instructions détaillées, consultez la section Verrouiller le bootloader.
  • Les niveaux de correctifs de l'OS, du démarrage clé et des principaux fournisseurs sont inférieurs à 12 mois. N'utilisez pas de build datant de plus d'un an

  • L'attestation d'appareil est étayée par l'un des certificats racine approuvés par le fournisseur. Spécifiez vos certificats racine approuvés dans la superposition de ressources vendor_required_attestation_certificates.xml.

Exécuter des tests multiappareils côté hôte (AOSP 16 ou version ultérieure)

CTS Verifier 16 introduit la prise en charge des tests multiappareils côté hôte. Ces tests peuvent être exécutés à l'aide de scripts automatisés sur l'hôte, au lieu de l'opération de test manuelle sur l'appareil. Une fois chaque test terminé, les résultats sont automatiquement importés sur le DUT et affichés dans l'application CTS Verifier.

Cette section explique comment exécuter les tests multiappareils côté hôte.

Exécuter des tests multiappareils

Pour exécuter un test multiappareil:

  1. Sur votre station de travail de test, lancez la console cts-v-host à partir du répertoire dans lequel le package ZIP CTS-V a été décompressé:

    ./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefed

  2. Dans l'application CTS Verifier sur l'appareil de test, cliquez sur Tests côté hôte. La figure 2 montre les tests côté hôte dans l'application CTS Verifier:

    Tests multiappareils côté hôte dans l'application CTS Verifier

    Figure 2. Tests multiappareils côté hôte dans l'application CTS Verifier.

    Une liste des modules de test multi-appareils côté hôte s'affiche.

  3. Identifiez le nom du module de test que vous souhaitez exécuter. Par exemple, le module CompanionDeviceManager est listé sous le nom CtsCompanionDeviceManagerMultiDeviceTestCases.

  4. Dans la console cts-v-host, exécutez la commande suivante : Remarque: Si vous appuyez sur un module côté hôte dans l'application CTS Verifier, vous ne verrez pas de liste de cas de test individuels. Au lieu de cela, les résultats du cas de test sont automatiquement renseignés dans l'UI une fois le module exécuté sur l'hôte.

  5. Dans la console xTS, exécutez la commande suivante:

    run cts-v-host -m test_module_name

    Exemple :

    run cts-v-host -m CtsCompanionDeviceManagerMultiDeviceTestCases

    Une fois que la console xTS a terminé d'exécuter les tests, les résultats s'affichent dans l'application CTS Verifier. Les tests marqués en vert ont réussi. Les tests marqués en rouge ont échoué. La figure 3 présente des exemples de résultats pour les tests CtsCompanionDeviceManager:

    Résultats des tests multiappareils côté hôte dans l'application CTS Verifier

    Figure 3. Résultats des tests multiappareils côté hôte dans l'application CTS Verifier.

Résoudre les problèmes liés aux tests multi-appareils

Cette section fournit des conseils de dépannage pour les problèmes potentiels.

Correction de l'erreur "Aucune réponse pour GetFirmwareVersion" lors des tests NFC

Si vous recevez le message verify_firmware_version RuntimeError: No response for GetFirmwareVersion lorsque vous exécutez les tests multiappareils, les tests ne peuvent pas accéder à la carte NFC PN532.

Pour résoudre ce problème, identifiez le chemin de série utilisé par la carte NFC PN532 sur votre hôte, par exemple dev/ttyUSB1, puis spécifiez-le manuellement à l'aide de l'argument --module-arg dans la console:

run cts-v-host -m CtsNfcHceMultiDeviceTestCases --module-arg CtsNfcHceMultiDeviceTestCases:pn532_serial_path:/dev/ttyUSB1

Correction du message d'erreur "Transaction failed" (Transaction échouée) lors des tests NFC

Si le message Transaction failed, check device logs for more information. s'affiche pour tous les cas de test NFC, cela est probablement dû au fait que la puce NFC du DUT ne peut pas détecter le PN532.

Si plusieurs appareils sont connectés à l'hôte et que certains d'entre eux ne sont pas équipés d'un PN532, il est possible que le mauvais DUT ait été sélectionné. Pour en savoir plus, consultez la section Configurer des tests NFC.

Pour résoudre ce problème, effectuez l'une des opérations suivantes:

  • Définissez le numéro de série correct du DUT dans votre commande de test côté hôte à l'aide de l'indicateur -s.

  • Déconnectez tous les appareils autres que l'appareil sous test de l'hôte.

Le scénario de test CDM test_permissions_sync est ignoré

Si le test est exécuté sur des appareils non débogables, vérifiez si vous êtes exempté. Sinon, assurez-vous que les deux appareils remplissent les conditions préalables.