L'outil de test des actions dans les applications est un plug-in Android Studio destiné aux développeurs. Il vous permet de créer un aperçu des actions dans les applications dans l'Assistant pour votre compte Google pendant les phases de développement et de test. Vous pouvez ainsi observer la façon dont une action dans votre application gère différents paramètres avant d'en demander le déploiement.
Résultat
L'outil de test des actions dans les applications analyse votre fichier actions.xml et crée un aperçu de vos actions associées au même compte Google. Cet aperçu permet à l'Assistant Google de reconnaître les actions dans votre application avant de déployer sa version de production sur la Google Play Console.
Pour chaque intent intégré de votre fichier actions.xml, le plug-in affiche un objet JSON-LD correspondant et fournit des valeurs de paramètres par défaut. Vous pouvez ensuite modifier ces valeurs pour tester vos actions dans les applications à l'aide de combinaisons de paramètres significatives et ainsi vérifier leur bon fonctionnement. Vous pouvez créer, mettre à jour et supprimer des aperçus dans l'outil de test, ce qui vous permet d'itérer et de tester les actions dans votre application dans un environnement sécurisé.
Une fois que vous avez généré un aperçu, vous pouvez déclencher une action dans votre application sur votre appareil de test directement depuis la fenêtre de l'outil de test. En ce qui concerne les intents intégrés déclenchables par l'utilisateur, vous pouvez également utiliser le nom d'appel directement dans l'Assistant sur votre appareil pour tester votre action dans votre application. Par exemple, vous pouvez dire "Hey Google, commence mon entraînement avec l'application XXX" pour lancer une action dans l'application qui utilise l'intent intégré actions.intent.START_EXERCISE.
Compatibilité avec les paramètres régionaux
La création d'un aperçu pour des paramètres régionaux spécifiques dans l'outil de test des actions dans les applications varie en fonction de l'intent intégré. La documentation de référence des intents intégrés présente les fonctionnalités disponibles pour chaque intent intégré (par exemple, les paramètres régionaux compatibles avec la création d'aperçu dans l'outil de test). Elle indique également si des actions dans les applications utilisant cet intent intégré sont déclenchables par les utilisateurs.
Obtenir l'outil
L'outil de test des actions dans les applications est disponible sous la forme d'un plug-in pour Android Studio. Pour en savoir plus sur l'installation et l'utilisation d'Android Studio, consultez la page Android Studio.
Pour installer l'outil de test des actions dans les applications dans Android Studio, procédez comme suit :
- Accédez à File > Settings (Fichier > Paramètres) ou à Android Studio > Preferences (Android Studio > Préférences) sous macOS.
- Dans la section Plugins (Plug-ins), accédez à Marketplace et recherchez
App Actions Test Tool. - Installez l'outil, puis redémarrez Android Studio.
Vous pouvez également télécharger le plug-in directement à partir du dépôt public Jetbrains.
Configuration requise
Plusieurs étapes de configuration sont nécessaires avant de pouvoir tester de manière adéquate les actions dans les applications. Vous devez en particulier utiliser le même compte utilisateur dans Android Studio, sur votre appareil de test et dans la console Google Play.
Suivez ces étapes afin de préparer votre environnement de développement :
- Connectez-vous à Android Studio (version 3.4 ou ultérieure).
- Avec le même compte, connectez-vous à l'application Google sur votre appareil de test Android.
- Avec le même compte, accédez à la Play Console pour tester le package d'application importé.
- Ouvrez l'appli Google sur votre appareil de test Android et terminez la configuration initiale de l'Assistant.
- Activez la synchronisation des données sur votre appareil de test.
Limites
L'outil de test des actions dans les applications présente les limites suivantes :
- Les aperçus d'actions dans les applications ne sont accessibles que sur les appareils physiques. Les tentatives de déclenchement d'un aperçu d'action dans l'application sur un appareil virtuel peuvent entraîner l'apparition du message suivant : "Sorry, I couldn't find that" (Désolé, cet élément est introuvable).
- Les actions dans l'application qui intègrent l'inventaire Web ne peuvent pas être testées directement dans l'outil de test ni par les commandes de débogage Android (
adb). Pour les tester, commencez par créer un aperçu à l'aide de l'outil de test. Déclenchez ensuite ces actions dans les applications en interagissant avec l'Assistant Google sur votre appareil physique. - L'inventaire intégré pour l'intent intégré
actions.intent.OPEN_APP_FEATUREne peut être testé que pendant six heures après la création ou la mise à jour d'un aperçu. Mettez à jour l'aperçu de l'outil de test ou créez-en un autre pour réinitialiser la période de six heures.
Ajouter des testeurs
Vous pouvez inviter des utilisateurs supplémentaires à votre projet afin qu'ils puissent tester l'intégration des actions dans votre application. Cela peut être utile lorsque vous souhaitez partager le projet avec d'autres membres de votre équipe de développement, ou encore avec les testeurs du contrôle qualité en amont d'un lancement en production.
Les testeurs doivent être ajoutés en tant que testeurs de licence sur le Google Play Store et doivent disposer d'un accès en lecture seule à la Google Play Console.
Pour ajouter d'autres testeurs, procédez comme suit :
- Connectez-vous à la Play Console.
Suivez les instructions de la section "Configurer les licences d'application" dans cette rubrique d'aide de la Play Console.
Figure 1 : Ajouter un testeur de licence Définissez les droits d'utilisateur de la Play Console en lecture seule au compte Gmail du testeur de licence.
- Sélectionnez User & permissions > Invite new users > Add app (Utilisateurs et autorisations > Inviter de nouveaux utilisateurs > Ajouter une application).
- Dans App Access (Accès aux applications), assurez-vous que la case Admin (all permissions) (Administrateur (toutes les autorisations)) est décochée.
Vous devrez vous connecter séparément à Android Studio à l'aide du compte Gmail de chaque testeur que vous souhaitez autoriser. Une fois connecté, utilisez l'outil de test des actions dans les applications pour créer un aperçu destiné à l'utilisateur testeur.
Utiliser l'outil
Accédez à l'outil de test des actions dans les applications en choisissant Tools > App Actions > App Actions Test Tool (Outils > Actions dans les applications > Outil de test des actions dans les applications) ou en sélectionnant App Actions Test Tool (Outil de test des actions dans les applications) dans le menu contextuel qui s'ouvre d'un clic droit. Lorsque vous ouvrez l'outil, la vue change selon que l'aperçu de l'outil de test est actif ou non.
Créer, mettre à jour et supprimer des aperçus
Utilisez une version brouillon de l'application pour les tests. Pour en savoir plus, consultez Préparer et déployer une version. Testez votre application en mode brouillon avant de l'envoyer pour examen.
L'outil de test crée des aperçus en fonction du nom de votre compte Google et de votre package d'application (ID d'application). Vous pouvez ainsi tester plusieurs applications avec le même compte Google. Tant que votre ID est différent pour chaque ressource applicative à tester, vous pouvez continuer à utiliser le même compte Google afin de créer et de tester l'aperçu. Plusieurs comptes Google ayant accès au même package d'application peuvent utiliser l'outil de test afin de créer des aperçus distincts pour cette application.
Pour créer un aperçu, procédez comme suit dans Android Studio :
- Ouvrez l'outil de test des actions dans les applications.
- Saisissez éventuellement un nom d'appel et des paramètres régionaux à tester. Les noms et paramètres régionaux par défaut sont
test app actioneten-US. - Cliquez sur Create Preview (Créer un aperçu). Une fois votre aperçu créé, la fenêtre de l'outil de test s'actualise et affiche des informations sur les intents intégrés contenus dans votre fichier
actions.xml.
Le nom d'appel est utilisé par l'outil de test pour créer et simuler des requêtes Assistant pour vos actions dans les applications. Les actions dans l'application déployées utilisent le nom Play Store de votre application pour les appels. Toutefois, vous pouvez utiliser n'importe quel libellé dans l'outil de test. Utilisez le nom de votre application comme nom d'appel dans l'outil de test.
Les paramètres régionaux que vous renseignez doivent correspondre à la langue de l'Assistant Google sur l'appareil de test. Vous ne pouvez créer un aperçu que dans une seule langue à la fois. Par exemple, si la langue de l'Assistant est l'anglais (États-Unis), vous pouvez saisir en-US, mais pas en-**, en-GB ni en-US, en-GB.
Pour modifier le nom d'appel ou les paramètres régionaux sélectionnés pour un aperçu existant, cliquez sur le bouton Delete Preview (Supprimer l'aperçu) dans l'outil de test. Saisissez ensuite le nom et les paramètres régionaux de l'appel avant de créer un aperçu.
Pour modifier un aperçu existant en fonction de votre fichier actions.xml, cliquez sur le bouton Update Preview (Modifier l'aperçu) dans l'outil de test. Vous trouverez des informations sur votre aperçu actuel dans la section Tester l'action dans l'application de la fenêtre de l'outil de test.
Configurer un intent intégré
Une fois que vous avez créé un aperçu pour votre application, vous pouvez tester différentes valeurs de paramètres pour les intents intégrés dans le plug-in. Pour chaque intent intégré présent dans votre fichier actions.xml, le plug-in rend un objet JSON-LD correspondant et fournit des valeurs de paramètres par défaut. Vous pouvez modifier ces valeurs pour tester vos actions dans l'application à l'aide de combinaisons de paramètres logiques et vérifier ainsi leur bon fonctionnement.
Les paramètres et leurs valeurs suivent généralement la structure de schema.org ou de schema.googleapis.com pour les propriétés et les descriptions. Pour plus d'informations sur les paramètres d'intent intégré, accédez aux descriptions de type de schéma propres aux paramètres et à leurs éléments de niveau supérieur, tels qu'ils sont catégorisés.
Par exemple, l'intent intégré actions.intent.CREATE_MONEY_TRANSFER prend en charge le paramètre d'intent moneyTransfer.transferMode. La page schema.googleapis.com pour MoneyTransfer présente transferMode en tant que propriété. La propriété transferMode représente un mode de transfert et attend des valeurs (comme SendMoney) énumérées du type FinancialTransferMode. Dans l'outil de test, vous pouvez fournir l'une de ces énumérations en tant que valeur de transferMode :
http://schema.googleapis.com/SendMoneyhttp://schema.googleapis.com/ReceiveMoney
Déclencher des actions dans l'application
Après avoir créé un aperçu et configuré un intent intégré, vous pouvez déclencher une action dans l'application sur votre appareil de test directement depuis la fenêtre de l'outil de test.
Pour ce faire, procédez comme suit :
- Connectez votre appareil de test.
- Dans la section Select Target Device (Sélectionner un appareil cible), choisissez l'équipement sur lequel vous souhaitez déclencher votre action dans l'application.
- Dans la section Test App Action (Tester l'action dans l'application), cliquez sur le bouton Run (Exécuter).
Les actions dans l'application déclenchées dans l'outil de test utilisent la commande Android Debug Bridge (adb) affichée. La commande shell adb générée inclut toutes les métadonnées requises par l'appli Google pour exécuter un intent intégré.
Cette approche imite le comportement qu'adopte une action dans votre application une fois que l'Assistant a extrait les informations clés d'une requête.
Journalisation Android Studio
Les journaux spécifiques à l'outil de test sont disponibles dans les fichiers journaux Android Studio, et non dans la sortie Logcat. Les journaux Android Studio sont générés par des processus exécutés directement sur votre poste de travail. Vous pouvez les utiliser pour résoudre les problèmes liés aux opérations de l'outil de test, tels que la création, la modification ou la suppression d'un aperçu.
Pour accéder aux fichiers journaux Android Studio, sélectionnez Help > Show log in explorer (Aide > Afficher le journal dans l'explorateur) ou, sous macOS, Help > Show log in finder (Aide > Afficher le journal dans le Finder).
Les journaux associés aux actions dans l'application sont disponibles dans Logcat. Logcat récupère les journaux des appareils virtuels ou physiques connectés à Android Studio.
Pour obtenir les journaux des actions dans l'application pour votre appareil, procédez comme suit :
- Cliquez sur Logcat dans la barre des fenêtres d'outils d'Android Studio pour accéder à vos messages de journaux Logcat.
- Recherchez les journaux contenant
ActivityTaskManager.
Aide et ressources supplémentaires
L'assistant de test des actions dans les applications fournit des liens vers la documentation, des ateliers de programmation et d'autres ressources pédagogiques pour se familiariser avec l'outil de test.
Vous pouvez ouvrir l'assistant dans Android Studio en sélectionnant Tools > App Actions > Help (Outils > Actions dans les applications > Aide).
