Tester et déboguer des modules complémentaires Google Workspace Apps Script

Lorsque vous publiez un module complémentaire, les utilisateurs peuvent l'installer via l'application hôte ou Google Workspace Marketplace. Avant de publier, testez modules complémentaires que vous développez au sein des applications hôtes qu'elles s'étendent.

Cette page explique comment installer un module complémentaire en cours de développement (appelé non publié ou développeur) complémentaire) à des fins de test ou pour un usage personnel. Vous pouvez également déboguer des modules complémentaires à l'aide de la Apps Script Débogueur et points d'arrêt de l'IDE.

Prérequis

  • Vous devez disposer d'un accès éditeur au projet de script du module complémentaire.
  • Pour permettre à d'autres membres de votre organisation de tester le module complémentaire, accordez-leur le rôle d'éditeur l'accès au projet de script. Pour en savoir plus sur les autorisations d'accès, consultez la page Collaborer avec d'autres développeurs

Installer un module complémentaire non publié

Vous pouvez installer des modules complémentaires non publiés à partir des déploiements d'Apps Script .

Suivez ces étapes pour installer un fichier non publié Module complémentaire Google Workspace pour les tests:

  1. Ouvrez le projet de script dans l'éditeur Apps Script.
  2. Cliquez sur Déployer > Tester les déploiements
  3. Cliquez sur Installer.
  4. En bas de l'écran, cliquez sur OK.

Vous pouvez autoriser d'autres utilisateurs à tester le module complémentaire en partageant le projet Apps Script à son compte (un accès en modification est requis). Invitez ensuite les utilisateurs à suivez les étapes ci-dessus.

Une fois installé, le module complémentaire est immédiatement disponible dans les applications hôtes qu'il s'étend. Vous devrez peut-être actualiser l'onglet de l'application hôte avant d'installer le module complémentaire s'affiche. Vous devez également autoriser le module complémentaire avant de l'utiliser.

Désinstaller un module complémentaire non publié

Pour désinstaller un déploiement de module complémentaire non publié, procédez comme suit:

  1. Ouvrez le projet de script dans l'éditeur Apps Script.
  2. Cliquez sur Déployer > Tester les déploiements
  3. Cliquez sur Désinstaller.
  4. En bas de l'écran, cliquez sur OK.

Cette procédure supprime immédiatement le déploiement et le module complémentaire n'apparaît plus dans n'importe quelle application hôte. Vous pouvez réinstaller le déploiement à tout moment en en répétant la procédure d'installation.

Bonnes pratiques de test

Lorsque vous testez votre module complémentaire Google Workspace, à suivre les Bonnes pratiques pour le développement de modules complémentaires. En outre, assurez-vous d'effectuer les opérations suivantes:

  1. Testez en détail les flux de navigation par carte dans toutes les applications hôtes du module complémentaire. Assurez-vous que le comportement du module complémentaire est correct lors des déplacements de l'utilisateur du contexte au contexte, et entre les fiches non contextuelles et non contextuelles.

  2. Utiliser des exemples de données de test pour évaluer le comportement de votre module complémentaire.

  3. Si votre module complémentaire se connecte à une API tierce ou à un autre service, vérifiez afin que le service soit accessible et fonctionne comme prévu. Assurez-vous que votre module complémentaire gère les informations d'autorisation et de connexion ; correctement.

  4. Assurez-vous que toutes les conditions d'erreur sont traitées correctement. Utiliser des fiches d'erreur si nécessaire.

  5. Faites attention aux performances du module complémentaire. Si vous modifiez et que le module complémentaire commence à ralentir, vous devrez peut-être supprimer ou retravailler cette fonctionnalité.