Une fois que vous avez publié un module complémentaire, les utilisateurs peuvent l'installer via l'application hôte ou le Google Workspace Marketplace. Avant de publier le module complémentaire, testez-le dans les applications hôtes qu'il étend.
Cette page explique comment installer un module complémentaire en cours de développement (un module complémentaire non publié ou pour les développeurs) à des fins de test ou pour un usage personnel. Vous pouvez également déboguer le module complémentaire à l'aide du débogueur et des points d'arrêt Apps Script.
Prérequis
- Vous devez disposer d'un accès Éditeur au projet de script.
- Pour permettre à d'autres utilisateurs de tester le module complémentaire, accordez-leur un accès Éditeur au projet. Consultez Collaborer avec d'autres développeurs.
- Les utilisateurs test doivent appartenir au même domaine que le propriétaire du script.
Installer un module complémentaire non publié
Installez les modules complémentaires non publiés à partir de la boîte de dialogue Déploiements.
Pour installer un module complémentaire non publié à des fins de test, procédez comme suit :
- Ouvrez le projet de script dans l'éditeur Apps Script.
- Sélectionnez Déployer > Tester les déploiements.
- Sélectionnez Installer.
- En bas de l'écran, sélectionnez OK.
Pour permettre à d'autres utilisateurs de tester le module complémentaire, partagez le projet avec leur compte (l'accès en modification est requis). Demandez ensuite aux utilisateurs de suivre la même procédure.
Une fois le module complémentaire installé, il est immédiatement disponible dans les applications hôtes qu'il étend. Vous devrez peut-être actualiser l'onglet de l'application hôte avant que le module complémentaire ne s'affiche. Autorisez le module complémentaire avant de l'utiliser. Si votre projet est déjà autorisé, utilisez ScriptApp.invalidateAuth pour invalider les autorisations existantes. Cela vous permet de tester la fonctionnalité OAuth précis.
Désinstaller un module complémentaire non publié
Pour désinstaller un module complémentaire non publié :
- Ouvrez le projet de script dans l'éditeur Apps Script.
- Sélectionnez Déployer > Tester les déploiements.
- Sélectionnez Désinstaller.
- En bas de l'écran, sélectionnez OK.
Ces étapes suppriment le déploiement et le module complémentaire n'apparaît plus. Vous pouvez réinstaller le déploiement à tout moment.
Bonnes pratiques pour les tests
Lorsque vous testez le module complémentaire, suivez les bonnes pratiques. Effectuez également les opérations suivantes :
Testez les flux de navigation des cartes dans toutes les applications hôtes que le module complémentaire étend. Vérifiez le comportement de l'application 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 tierce, vérifiez que le service est accessible. Assurez-vous que le module complémentaire gère correctement l'autorisation et la connexion.
Gérez les conditions d'erreur de manière optimale. Utilisez des cartes d'erreur si nécessaire.
Surveillez les performances du module complémentaire. Si le module complémentaire ralentit après une modification du code, vous devrez peut-être retravailler cette fonctionnalité.