Processus de débogage en arrière-plan

Le processus de débogage implique les .vscode/launch.json fichiers et .vscode/tasks.json pour configurer les débogueurs dans Microsoft Visual Studio Code. Visual Studio Code lance le débogueur Node et le débogueur de navigateur, et Microsoft Edge ou Google Chrome lance un nouveau navigateur instance.

Le flux de travail du processus de débogage est le suivant :

1. launch.json le fichier configure le débogueur dans Visual Studio Code.

2. Visual Studio Code exécute le preLaunchTask composé, Démarrer l’application Teams localement dans le .vscode/tasks.json fichier.

3. Visual Studio Code lance ensuite les débogueurs spécifiés dans les configurations composées, telles que Attach to Bot, Attacher au Backend, Attach to Frontend, et Lancer Bot.

4. Le débogueur de navigateur, Microsoft Edge ou Google Chrome, lance une nouvelle instance de navigateur et ouvre une page web pour charger le client Microsoft Teams.

Valider les prérequis

Microsoft Teams Toolkit vérifie les prérequis suivants pendant le processus de débogage :

• Teams Toolkit vérifie si Node.js est installé. Si Node.js n’est pas installé, le débogage se termine.

• Teams Toolkit vérifie si Node.js version correspond aux versions définies dans le package.json fichier. Si la version ne correspond pas, le Kit de ressources Teams affiche un message d’avertissement dans le canal de sortie.

• Teams Toolkit vous invite à vous connecter au compte Microsoft 365 si vous ne vous êtes pas connecté avec vos informations d’identification valides.

• Le chargement d’applications personnalisées pour votre locataire développeur est activé pour empêcher l’arrêt du débogage local.

• Si Ngrok n’est pas installé ou si la version ne correspond pas à la configuration requise, teams Toolkit installe le package ngrok@4.2.2 npm Ngrok dans ~/.fx/bin/ngrok. La version binaire Ngrok 2.3 s’applique à l’extension de bot et de message et est gérée par le package npm Ngrok dans /.fx/bin/ngrok/node modules/ngrok/bin.

  Remarque

  Les modèles de projet Teams Toolkit utilisent le package npm ngrok@4.3.3, qui contient la version 2.3.40. Pour plus d’informations sur l’obtention d’une licence valide, consultez ngrok.

• Si Azure Functions Core Tools version 4 n’est pas installée ou si la version ne correspond pas à la configuration requise, teams Toolkit installe Azure Functions package azure-functions-core-tools@3 npm Core Tools pour Windows et macOS dans ~/.fx/bin/func. Le package npm Azure Functions Core Tools dans ~/.fx/bin/func/node_modules/azure-functions-core-tools/bin gère Azure Functions binaire Core Tools. Pour Linux, le débogage local se termine.

• Si le Kit de développement logiciel (SDK) .NET Core n’est pas installé ou si la version ne correspond pas à la configuration requise, teams Toolkit installe le KIT de développement logiciel (SDK) .NET Core pour Windows et macOS dans ~/.fx/bin/dotnet. La version du SDK .NET Core s’applique à Azure Functions. Pour Linux, le débogage local se termine.

  Le tableau suivant répertorie les versions .NET Core :

  Plateforme	Logiciels
  Windows, macOs (x64) et Linux	3.1 (recommandé), 5.0, 6.0
  macOs (arm64)	6.0

• Si le certificat de développement pour localhost n’est pas installé pour l’onglet dans Windows ou macOS, le Kit de ressources Teams vous invite à l’installer.

• Si Azure Functions extensions de liaison n’est pas installée, le Kit de ressources Teams installe Azure Functions extensions de liaison dans api/extensions.csproj.

• Si les packages npm ne sont pas installés, le Kit de ressources Teams installe tous les packages npm applicables à l’application d’onglet, à l’application de bot, à l’extension de message et Azure Functions.

• Teams Toolkit démarre Ngrok pour créer un tunnel HTTP pour le bot et l’extension de message.

• Si les ports tab, bot, extension de message et Azure Functions ne sont pas disponibles, le débogage local se termine.

  Le tableau suivant répertorie les ports disponibles pour les composants :

  Composant	Port
  Tab	53000
  Bot ou extension de message	3978
  Inspecteur de nœud pour l’extension de bot ou de messagerie	9239
  Azure Functions	7071
  Inspecteur de nœud pour les fonctions Azure	9229

Lorsque vous sélectionnez Démarrer le débogage (F5), le canal de sortie du Kit de ressources Teams affiche la progression et le résultat après avoir vérifié les prérequis.

Pour plus d’informations, consultez Tâche de validation des prérequis.

Démarrer le tunnel local

Pour l’extension de bot et de message, Teams Toolkit démarre un service de tunnel local pour rendre le point de terminaison de messagerie du bot public. Pour plus d’informations, consultez Démarrer la tâche de tunnel local.

Créer les ressources de débogage

Teams Toolkit exécute le cycle de vie provision défini dans teamsapp.local.yml pour créer les ressources associées à l’application Teams requises pour le débogage. Pour plus d’informations, consultez Provisionner la tâche et les actions disponibles.

Générer un projet

Teams Toolkit exécute le cycle de vie deploy défini dans teamsapp.local.yml pour générer le projet. Pour plus d’informations, consultez Déployer la tâche et les actions disponibles.

Suivre une visite guidée du code source

Vous pouvez afficher les dossiers et fichiers du projet sous Explorer dans Visual Studio Code après le débogage. Le tableau suivant répertorie les fichiers liés au débogage :

Pour plus d’informations sur la structure des dossiers du projet, consultez Projet teams Toolkit.

Voir aussi

• Vue d’ensemble du Kit de ressources Teams
• Déboguer votre application Teams à l'aide de Teams Toolkit
• Utiliser Teams Shared Computer Toolkit pour mettre en service des ressources cloud
• Déployer à partir du cloud
• Afficher un aperçu et personnaliser le manifeste d’application