À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

Cette page a été traduite par l'API Cloud Translation.

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

Cette page contient des instructions pour utiliser les tests multidispositifs 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 multidispositifs.

Assurez-vous que votre ordinateur de bureau répond aux exigences du système d'exploitation pour CTS.
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.
Préparez deux appareils testés (DUT) identiques, chacun avec CTS-V configuré.
- Pour savoir comment configurer un appareil en test, consultez Configurer l'appareil en test.
- Pour savoir comment configurer CTS-V, consultez Configuration.
Si vous testez un module autre que NFC, suivez Configurer des tests standards à deux appareils.
- Pour les tests NFC, suivez Configurer les tests NFC.
Si vous testez le module CDM, suivez 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 :

Placez deux appareils Android identiques à environ 20 cm l'un de l'autre.
Pour garantir un environnement propre, placez les deux appareils dans une boîte de protection.

Remarque : Si vous rencontrez des problèmes avec ces tests et que vous avez besoin d'aide, assurez-vous que les tests ont été exécutés avec les deux appareils dans une enceinte blindée.
(Facultatif) Configurez un renifleur 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 :

Achetez une puce NFC PN532. Nous vous recommandons le PN532 tout-en-un.
Sur le DUT, accédez à l'application Paramètres.
Activez le NFC.
Positionnez la puce NFC :
- Pour les téléphones, positionnez le lecteur NFC du DUT comme indiqué sur la figure 1 :
  
  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.
Connectez la puce NFC PN532 à votre poste de travail de test à l'aide d'un câble USB.

Configurer des tests CDM

Le comportement du cas de test test_permissions_sync() varie en fonction du type de compilation des appareils sur lesquels le test est exécuté. Il est essentiel que les OEM testent les deux versions (débogables [userdebug ou eng] et non débogables [user]) et que les tests réussissent pour les deux.

Exemption

La clause CDD pour l'implémentation de l'API de synchronisation des autorisations exige uniquement qu'elle soit capable de transférer des données entre les appareils sur un canal sécurisé. Étant donné que l'implémentation du canal sécurisé n'est pas une exigence de conformité du CDD, ce test peut être ignoré sur les versions non débogables (utilisateur), mais uniquement si vous souhaitez désactiver la fonctionnalité de synchronisation des autorisations CDM.

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

Conditions préalables pour effectuer des tests sur des builds non débogables

Si vous n'êtes pas exempté par les clauses d'exemption précédentes, assurez-vous de remplir les conditions préalables suivantes.

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 lors du processus de validation :

L'appareil a accès à Internet
L'appareil utilise le démarrage sécurisé et la compilation doit être signée avec une clé de version, et non une clé de développement.
Le bootloader de l'appareil est verrouillé. Pour obtenir des instructions détaillées, consultez Verrouiller le bootloader.
Les niveaux de correctifs de l'OS, du boot et du fournisseur de clés datent de moins de 12 mois. N'utilisez pas une version datant de plus d'un an.
L'attestation de l'appareil est basée sur l'un des certificats racine approuvés par le fournisseur. Spécifiez vos certificats racine de confiance 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 multidétecteurs 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 manuel sur l'appareil. Une fois chaque test terminé, les résultats sont automatiquement importés sur l'appareil testé et affichés dans l'application CTS Verifier.

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

Exécuter des tests multi-appareils

Pour effectuer un test multidétecteur :

Sur votre poste 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
```
Dans l'application CTS Verifier sur l'appareil à tester, cliquez sur Host-side Tests (Tests côté hôte). La figure 2 montre les tests côté hôte dans l'application CTS Verifier :

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

Une liste de modules de test multiappareils côté hôte s'affiche.
Identifiez le nom du module de test que vous souhaitez exécuter. Par exemple, le module CompanionDeviceManager est listé sous CtsCompanionDeviceManagerMultiDeviceTestCases.

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, l'UI est automatiquement renseignée avec les résultats des cas de test une fois le module exécuté sur l'hôte.
Dans la console cts-v-host, exécutez la commande suivante :
```
run cts-v-host -m test_module_name
```
Exemple :
```
run cts-v-host -m CtsCompanionDeviceManagerMultiDeviceTestCases
```
Remarque : Si vous exécutez cts-v-host sans utiliser -m test_module_name, la commande tente d'exécuter tous les modules de test, en ignorant les écarts dans les exigences concernant l'appareil et le matériel. Exécutez plutôt la commande run cts-v-host-default-devices pour exécuter les tests avec la configuration standard en tant que sous-plan unique.
Remarque : Vous pouvez indiquer les DUT spécifiques à tester à l'aide de leur numéro de série : run cts-v-host -m test_module_name -s device1_serial -s device2_serial ...

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 montre des exemples de résultats pour les tests CtsCompanionDeviceManager :

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

Remarque : Les résultats côté hôte sont automatiquement ajoutés au rapport de test CTS-V global.

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

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

Corriger l'absence de réponse pour GetFirmwareVersion lors des tests NFC

Si le message verify_firmware_version RuntimeError: No response for GetFirmwareVersion s'affiche lorsque vous exécutez les tests multidispositifs, cela signifie que les tests ne peuvent pas accéder à la carte NFC PN532.

Pour résoudre ce problème, identifiez le chemin série utilisé par la carte NFC PN532 sur votre hôte, tel que 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

Corriger le message d'erreur "Échec de la transaction" 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 signifie probablement 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 ne sont pas équipés d'un PN532, le mauvais DUT peut avoir été sélectionné. Pour en savoir plus, consultez 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 du DUT dans votre commande de test côté hôte à l'aide de l'indicateur -s.
Déconnectez tous les appareils autres que le DUT de l'hôte.

Le cas 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 répondent aux conditions préalables.