Plug-in Assistant Google pour Android Studio

Stay organized with collections Save and categorize content based on your preferences.

Le plug-in Assistant Google permet de tester les actions dans l'application dans Android Studio. Pendant le développement et les tests, ce plug-in vous permet de créer un aperçu des actions dans l'application dans l'Assistant (pour votre compte Google). 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.

Fonctionnement

Le plug-in Assistant Google inclut l'outil de test des actions dans l'application, une fonctionnalité qui analyse le fichier shortcuts.xml et crée un aperçu des actions dans votre application pour un seul compte Google. Cet aperçu permet à l'Assistant Google de reconnaître les actions dans votre application avant de déployer la version de production de votre application sur la Google Play Console.

Pour chaque intent intégré de votre fichier shortcuts.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 les actions dans votre application à l'aide de combinaisons de paramètres logiques afin de vérifier leur bon fonctionnement. Vous êtes libre de créer, de mettre à jour et de supprimer des aperçus dans l'outil de test, afin d'itérer et de tester les actions dans votre application au sein d'un environnement sécurisé.

Une fois l'aperçu créé, vous pouvez déclencher une action dans l'application directement depuis la fenêtre de l'outil de test. En ce qui concerne les intents intégrés déclenchables par l'utilisateur, il est possible d'utiliser app name directement dans l'Assistant sur votre appareil pour tester une action dans votre application. Par exemple, vous pouvez dire "Hey Google, commence mon entraînement avec l'appli 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'aperçus pour des paramètres régionaux spécifiques dans l'outil de test 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é, tels que les paramètres régionaux qui permettent la création d'aperçu dans l'outil de test. Par exemple, elle indique si l'outil de test est compatible avec la création d'aperçus pour une langue spécifique et si les actions dans l'application peuvent être déclenchées par les utilisateurs.

Télécharger le plug-in

Le plug-in Assistant Google est disponible pour Android Studio. Pour en savoir plus sur l'installation et l'utilisation d'Android Studio, consultez la page Android Studio.

Pour installer le plug-in Assistant Google sur Android Studio, procédez comme suit :

  1. Accédez à Fichier > Paramètres, ou à Android Studio > Préférences.
  2. Dans la section Plug-ins, accédez à Marketplace et recherchez Google Assistant plugin.
  3. 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

L'utilisation du plug-in Assistant Google implique un certain nombre d'étapes de configuration pour permettre le test d'une action. 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 4.0 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'application Google sur votre appareil de test Android et terminez la configuration initiale de l'Assistant.
  • Activez la synchronisation des données sur l'appareil de test.

Limites

Le plug-in Assistant Google présente les limites suivantes :

  • Les actions dans l'application qui intègrent l'inventaire Web et l'appel d'application au premier plan ne peuvent pas être testées directement dans l'outil de test ni par les commandes Android Debug Bridge (adb). Pour les tester, commencez par créer un aperçu à l'aide de l'outil de test. Interagissez ensuite avec l'Assistant Google sur votre appareil physique afin de déclencher ces actions.
  • L'inventaire intégré pour l'intent intégré actions.intent.OPEN_APP_FEATURE ne peut être testé que pendant six heures après la création ou la modification 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 supplémentaires

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 :

  1. Connectez-vous à la Play Console.
  2. Suivez les instructions de la section "Configurer les licences d'application" dans cette rubrique d'aide de la Play Console.

    Ajoutez un testeur de licence via la Google Play Console.
    Figure 1. Ajouter un testeur de licence
  3. Accordez des privilèges d'utilisateur Play Console en lecture seule au compte Gmail du testeur de licence.

    1. Sélectionnez Utilisateurs et autorisations > Inviter de nouveaux utilisateurs > Ajouter une application.
    2. Dans Accès aux applications, assurez-vous que la case 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 le plug-in Assistant Google pour créer un aperçu pour l'utilisateur test.

Utiliser le plug-in Assistant Google

Accédez à l'outil de test des actions dans l'application. Pour ce faire, sélectionnez Outils > Assistant Google > Outil de test des actions dans l'application. 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

Vous pouvez utiliser une version brouillon de l'application à des fins de test. Pour en savoir plus, consultez la page Préparer et déployer une version. Nous vous encourageons vivement à tester 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 :

  1. Ouvrez l'outil de test des actions dans l'application.
  2. Si vous le souhaitez, saisissez un nom d'application et des paramètres régionaux à tester. Le nom et les paramètres régionaux par défaut de l'application sont test app action et en.
  3. Cliquez sur Créer un aperçu. Une fois l'aperçu créé, la fenêtre de l'outil de test s'actualise et affiche des informations sur les intents intégrés qui se trouvent dans le fichier shortcuts.xml.

L'outil de test utilise le nom de l'application pour créer et simuler des requêtes dans l'Assistant pour les actions dans votre application. 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. Nous vous recommandons d'utiliser 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. Vous pouvez également utiliser des paramètres régionaux racines, tels que en, pour inclure en-GB et en-US.

Pour modifier le nom d'appel ou les paramètres régionaux sélectionnés pour un aperçu existant, cliquez sur le bouton 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 mettre à jour un aperçu existant en fonction du fichier shortcuts.xml, cliquez sur le bouton Mettre à jour 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 d'intents intégrés dans le plug-in. Pour chaque intent intégré présent dans le fichier shortcuts.xml, le plug-in génère 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 est compatible avec 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/SendMoney
  • http://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 :

  1. Connectez votre appareil de test.
  2. Dans la section Sélectionner un appareil cible, choisissez l'équipement sur lequel vous souhaitez déclencher une action dans votre application.
  3. Dans la section Tester l'action dans l'application, cliquez sur le bouton Exécuter l'action dans l'application.

Les actions dans l'application déclenchées dans l'outil de test utilisent la commande Android Debug Bridge (adb) affichée. Celle-ci inclut toutes les métadonnées requises par l'application 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 Aide > Afficher le journal dans l'explorateur (ou Aide > Afficher le journal dans le Finder sur macOS).

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 :

  1. Cliquez sur Logcat dans la barre des fenêtres d'outils d'Android Studio pour accéder à vos messages de journaux Logcat.
  2. Recherchez les journaux contenant ActivityTaskManager.

Aide et ressources supplémentaires

Le plug-in Assistant Google fournit des liens vers la documentation, un atelier de programmation et d'autres ressources pédagogiques pour se familiariser avec l'outil de test.

Pour ouvrir l'Assistant dans Android Studio, sélectionnez Outils > Assistant Google > Aide.

Assistant de l'outil de test des actions dans l'application Figure 2. Section d'aide du plug-in Assistant Google