Vue d’ensemble du débogage Office des modules

Article
12/21/2023

Le débogage Office les applications est essentiellement identique au débogage de n’importe quelle application web. Toutefois, un seul ensemble d’outils ne fonctionne pas pour tous les développeurs de modules. Cela est dû au fait que les compléments peuvent être développés sur différents systèmes d’exploitation et s’exécuter sur plusieurs plateformes. Cet article vous aide à trouver les instructions de débogage détaillées pour votre environnement de développement.

Conseil

Cet article traite du débogage dans le sens étroit de la définition de points d’arrêt et du code pas à pas. Pour obtenir des conseils sur les tests et la résolution des problèmes, commencez par tester les Office et résoudre les erreurs de développement avec Office les autres.

Remarque

Bien que vous devrez tester votre complément sur toutes les plateformes que vous souhaitez prendre en charge, vous n’aurez que très rarement besoin de déboguer sur un environnement différent de votre ordinateur de développement. Pour cette raison, cet article utilise « votre ordinateur de développement » et « votre environnement de développement » pour faire référence à l’environnement sur lequel vous déboguer. Si un problème dans le code se produit uniquement sur une plateforme autre que celle de votre ordinateur de développement et que vous devez définir des points d’arrêt ou un code pas à pas pour le résoudre, l’environnement sur lequel vous déboguer n’est pas littéralement votre environnement de développement.

Côté serveur ou côté client ?

Le débogage du code côté serveur d’un Office est identique au débogage côté serveur d’une application web. Consultez les instructions de débogage pour votre IDE ou d’autres outils. Voici quelques exemples pour certains des outils les plus populaires.

Le reste de cet article ne concerne que le débogage du JavaScript côté client (qui peut être transposé de TypeScript).

Cas particuliers

Dans certains cas particuliers, le processus de débogage diffère de la normale pour une combinaison donnée de plateforme, d’application Office et d’environnement de développement. Si vous déboguez l’un de ces cas spéciaux, utilisez les liens de cette section pour trouver les conseils appropriés. Sinon, continuez à Instructions générales.

Débogage la fonction Office.initialize ou Office.onReady : Déboguer les fonctions initialize et onReady.
Debugging d’une fonction personnalisée Excel dans un runtime non-partagé : Débogage de fonctions personnalisées dans un runtime non-partagé.
Débogage d'unecommande de fonctiondans un runtime non-partagée :
- Compléments Outlook sur un ordinateur de développement Windows : commandes de fonction de débogage dans les compléments Outlook
- Autres compléments d’application Office ou Outlook sur un ordinateur de développement Mac : Déboguez une commande de fonction avec un runtime non partagé.
Débogage d’un complément Outlook basé sur des événements ou de création de rapports de courrier indésirable : déboguer les compléments basés sur les événements et les rapports de courrier indésirable.
Débogage d’un complément dans le nouveau client de bureau Outlook sur Windows (préversion) : consultez la section « Déboguer votre complément » de Développer des compléments Outlook pour le nouveau outlook sur Windows (préversion) .
Débogage d’un complément blazor : déboguez le complément de la même façon que vous déboguez une application web Blazor. Consultez Déboguer ASP.NET Core Blazor WebAssembly.

Directives générales

Pour trouver des conseils pour le débogage du code côté client, la première variable est le système d’exploitation de votre ordinateur de développement.

Windows
Mac
Linux ou une autre variante Unix

Débogage sur Windows

L’exemple suivant fournit des instructions générales sur le débogage sur Windows. Le débogage sur Windows dépend de votre IDE.

Visual Studio : Déboguer à l’aide des outils F12 du navigateur. Afficher Debug Office Add-ins in Visual Studio
Tout autre IDE (ou vous ne souhaitez pas déboguer à l’intérieur de votre IDE) : utilisez les outils de développement associés au contrôle webview que les compléments utilisent sur votre ordinateur de développement. Consultez l’une des rubriques suivantes :
- Pour la vue web Trident : Déboguer des compléments à l’aide des outils de développement pour Internet Explorer
- Pour la vue web EdgeHTML : Déboguer des compléments à l’aide des outils de développement pour Edge Hérité
- Pour la vue web WebView2 : Déboguer des compléments à l’aide d’outils de développement dans Microsoft Edge (basé sur Chromium)

Pour plus d’informations sur le runtime utilisé, voir Navigateurs et contrôles d’affichage web utilisés par les compléments Office et les runtimes dans les compléments Office.

Conseil

Dans les versions récentes d’Office, l’une des façons d’identifier le contrôle webview utilisé par Office consiste à utiliser le menu personnalité de n’importe quel complément où il est disponible. (Le menu personnalité n’est pas pris en charge dans Outlook.) Ouvrez le menu et sélectionnez Informations de sécurité. Dans la boîte de dialogue Informations de sécurité sur Windows, le runtime signale Microsoft Edge, Microsoft Edge hérité ou Internet Explorer. Le runtime n’est pas inclus dans la boîte de dialogue dans les versions antérieures d’Office.

Débogage sur Mac

Utilisez l’inspecteur web Safari. Les instructions sont dans Déboguer des Office sur un Mac.

Débogage sur Linux

Il n’existe aucune version de bureau de Office pour Linux. Vous devrez donc recharger une version test du Office sur le Web pour le tester et le déboguer. Les conseils de débogage se trouve dans les compléments de débogage Office sur le Web.

Remarque

Nous vous déconseillons de développer des compléments Office sur un ordinateur Linux, sauf dans le cas inhabituel où vous pouvez vous assurer que tous les utilisateurs du module accéderont au module par le biais de Office sur le Web à partir d’un ordinateur Linux.

Déboguer des compléments en préproduction ou en production

Pour déboguer un complément déjà en préproduction ou en production, attachez un débogueur à partir de l’interface utilisateur du complément. Pour obtenir des instructions, consultez Attacher un débogueur à partir du volet Office.

Voir aussi

Temps d'exécution dans les compléments Office

Partager via