Lorsque vous publiez un module complémentaire, les utilisateurs peuvent l'installer via l'application hôte ou le Google Workspace Marketplace. Avant de publier vos modules complémentaires, testez-les dans les applications hôtes qu'ils étendent.
Cette page explique comment installer un module complémentaire en cours de développement (appelé module complémentaire non publié ou pour les développeurs) à des fins de test ou pour un usage personnel. Vous pouvez également déboguer les modules complémentaires à l'aide du débogueur et des points d'arrêt de l'IDE Apps Script.
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 un accès en tant qu'éditeur au projet de script. Pour en savoir plus sur l'octroi d'accès, consultez Collaborer avec d'autres développeurs.
Installer un module complémentaire non publié
Vous pouvez installer des modules complémentaires non publiés à partir de la boîte de dialogue Déploiements d'Apps Script.
Pour installer un module complémentaire Google Workspace non publié à des fins de test, procédez comme suit :
- Ouvrez le projet de script dans l'éditeur Apps Script.
- Cliquez sur Déployer > Tester les déploiements.
- Cliquez sur Installer.
- 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 avec leur compte (l'accès en modification est requis). Demandez ensuite aux utilisateurs de suivre les étapes ci-dessus.
Une fois installé, le module complémentaire est immédiatement disponible dans les applications hôtes qu'il étend. Vous devrez peut-être actualiser l'onglet de l'application hôte pour que le module complémentaire s'affiche. Vous devez également autoriser le module complémentaire avant de l'utiliser. Si votre projet est déjà autorisé, utilisez ScriptApp.invalidateAuth pour invalider les autorisations existantes afin de pouvoir tester la fonctionnalité OAuth précis sur votre module complémentaire.
Désinstaller un module complémentaire non publié
Pour désinstaller un déploiement de module complémentaire non publié, procédez comme suit :
- Ouvrez le projet de script dans l'éditeur Apps Script.
- Cliquez sur Déployer > Tester les déploiements.
- Cliquez sur Désinstaller.
- En bas de l'écran, cliquez sur OK.
Ces étapes suppriment immédiatement le déploiement et le module complémentaire n'apparaît plus dans aucune application hôte. Vous pouvez réinstaller le déploiement à tout moment en répétant la procédure d'installation.
Bonnes pratiques de test
Lorsque vous testez votre module complémentaire Google Workspace, veillez à suivre les bonnes pratiques pour le développement de modules complémentaires. Assurez-vous également de procéder comme suit :
Testez minutieusement les flux de navigation des cartes dans toutes les applications hôtes que l'extension étend. Assurez-vous que le comportement du module complémentaire est correct lorsque l'utilisateur passe d'un contexte à un autre, et entre les cartes non contextuelles et contextuelles.
Utilisez des exemples de données de test pour évaluer le comportement de votre module complémentaire.
Si votre module complémentaire se connecte à une API ou à un autre service tiers, vérifiez que le service est accessible et se comporte comme prévu. Assurez-vous que votre module complémentaire gère correctement les informations d'autorisation et de connexion.
Assurez-vous que les conditions d'erreur sont gérées de manière optimale. Utilisez des cartes d'erreur si nécessaire.
Faites attention aux performances du module complémentaire. Si vous modifiez le code et que le module complémentaire commence à ralentir, vous devrez peut-être supprimer ou retravailler cette fonctionnalité.