Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article explique comment utiliser Visual Studio Code (VS Code) pour développer votre complément Office.
Conditions préalables
Outil de création de projet. Vous disposez des options suivantes.
- Le générateur Yeoman pour les compléments Office (également appelé « Yo Office »). Pour obtenir des instructions d’installation et d’utilisation, voir Créer des projets de complément Office à l’aide du générateur Yeoman. Avec cet outil, vous avez la possibilité de créer des compléments qui utilisent le manifeste de complément uniquement ou le manifeste unifié pour Microsoft 365. Pour plus d’informations sur les différences, commencez par le manifeste des compléments Office.
- Le Kit de ressources Microsoft 365 Agents pour Visual Studio Code. Pour obtenir des instructions d’installation, consultez Installer agents Toolkit. Pour obtenir des instructions d’utilisation, consultez Créer des projets de complément Office avec microsoft 365 Agents Toolkit. Avec cet outil, vous pouvez créer des compléments qui utilisent le manifeste unifié pour Microsoft 365.
Développer le complément à l’aide de VS Code
Pour utiliser le projet, ouvrez le dossier racine du projet avec VS Code.
Les deux outils créent un complément de base avec des fonctionnalités limitées. Vous pouvez personnaliser le complément en modifiant le manifeste, HTML, JavaScript ou TypeScript et des fichiers CSS dans VS Code. Pour obtenir une description générale de la structure de projet et des fichiers dans le projet de complément que le générateur Yeoman crée, consultez les instructions du générateur Yeoman dans le démarrage rapide de 5 minutes qui correspond au type de complément que vous avez créé.
Tester et déboguer le complément
Les méthodes de test, de débogage et de résolution des problèmes des compléments Office varient selon la plateforme et l’outil utilisé pour créer le projet. Pour plus d’informations, consultez Tester et déboguer des compléments Office et Créer des projets de complément Office avec microsoft 365 Agents Toolkit.
Publier le complément
Un complément Office comprend deux composants de base : un fichier manifeste et votre propre application web. Le manifeste définit différents paramètres, y compris la façon dont votre complément s’intègre avec les clients Office. Votre application web utilise les fichiers HTML, JavaScript et d’autres fichiers qui fournissent les fonctionnalités et l’interface utilisateur du complément.
Lorsque vous développez votre complément, vous pouvez l’exécuter sur votre serveur Web local (localhost), mais lorsque vous êtes prêt à le publier pour permettre à d’autres utilisateurs d’y accéder, vous devez déployer l’application Web sur un serveur Web ou un service d’hébergement Web (par exemple, Microsoft Azure), puis mettre à jour le manifeste pour spécifier l’URL de l’application déployée.
Lorsque votre complément fonctionne comme vous le souhaitez et que vous êtes prêt à le publier pour que d’autres utilisateurs y accèdent, effectuez les étapes suivantes.
À partir de la ligne de commande, dans le répertoire racine de votre projet de complément, exécutez la commande suivante pour préparer tous les fichiers pour le déploiement de production.
npm run buildUne fois la build terminée, le dossier dist dans le répertoire racine de votre projet de complément contient les fichiers que vous allez déployer dans les étapes suivantes.
Chargez le contenu du dossier dist sur le serveur Web qui héberge votre complément. Vous pouvez utiliser n’importe quel type de serveur Web ou de service d’hébergement Web pour héberger votre complément.
Dans VS Code, ouvrez le fichier manifeste du complément, situé dans le répertoire racine du projet. Remplacez toutes les occurrences de
https://localhost:3000par l’URL de l’application Web que vous avez déployée sur un serveur Web à l’étape précédente.Choisissez la méthode que vous souhaitez utiliser pour déployer votre complément Office et suivez les instructions pour publier le complément.