Déboguer votre application Teams à l’aide de Visual Studio

Teams Toolkit automatise les services de démarrage des applications, lance le débogage et charge l’application Teams. Après le débogage, vous pouvez afficher un aperçu de l’application Teams dans le client web Teams. Vous pouvez également personnaliser les paramètres de débogage pour utiliser vos points de terminaison de bot ou des variables d’environnement pour charger votre application configurée. Visual Studio vous permet de déboguer des onglets, des bots et des extensions de message.

Configuration requise

  Installer Pour l’utilisation...
  Visual Studio 2022 Vous pouvez installer l’édition Entreprise de Visual Studio et installer la charge de travail ASP.NET et les outils de développement Microsoft Teams. Utiliser la dernière version
  Toolkit Teams Extension Visual Studio qui crée une structure de projet pour votre application. Utilisez la dernière version.
  Microsoft Teams Microsoft Teams pour collaborer avec toutes les personnes avec lesquelles vous travaillez via des applications pour la conversation, les réunions et les appels dans un seul endroit.
  Préparer votre client Microsoft Office 365 Accès au compte Teams avec les autorisations appropriées pour installer une application.
  Compte de développeur Microsoft 365 Accès au compte Teams avec les autorisations appropriées pour installer une application.
  Outils Azure et Microsoft Azure CLI Outils Azure pour accéder aux données stockées ou déployer un back-end cloud pour votre application Teams dans Azure.

Principales fonctionnalités de Teams Shared Computer Toolkit

Teams Toolkit automatise le processus de débogage local pour les fonctionnalités clés suivantes :

  • Préparer les dépendances d’application Teams : Teams Toolkit prépare les dépendances de débogage locales et inscrit votre application Teams dans votre compte de locataire. Pour les applications Bot et Extension de message, Teams Toolkit inscrit et configure le bot.

  • Démarrer le débogage : vous pouvez effectuer le débogage avec une seule opération. Appuyez sur F5 pour démarrer le débogage. Teams Toolkit génère du code, démarre les services et lance l’application dans votre navigateur.

  • Basculer les points d’arrêt : vous pouvez activer les points d’arrêt dans le code source des onglets, bots, extensions de message et Azure Functions. Les points d’arrêt s’exécutent lorsque vous interagissez avec l’application Teams dans votre navigateur web.

    L’image suivante montre les points d’arrêt bascule :

    Capture d’écran montrant les points d’arrêt de débogage locaux.

  • Rechargement à chaud : sélectionnez Rechargement à chaud pour appliquer vos modifications dans votre application Teams lorsque vous souhaitez mettre à jour et enregistrer le code source pendant le débogage.

    Capture d’écran montrant l’icône sélectionner un rechargement à chaud.

    Pour activer la Rechargement à chaud automatique, sélectionnez Rechargement à chaud dans la liste déroulante Enregistrement de fichier.

    Capture d’écran montrant la sélection d’un rechargement à chaud lors de l’enregistrement du fichier.

    Conseil

    Pour en savoir plus sur la fonction Rechargement à chaud, consultez Expérience de Rechargement à chaud .NET.

  • Arrêter le débogage : sélectionnez Arrêter le débogage (Maj+F5) une fois le débogage local terminé.

    Capture d’écran montrant l’icône Sélectionner arrêter le débogage.

Ajouter des variables d’environnement

Vous pouvez ajouter au environmentVariableslaunchSettings.json fichier.

Capture d’écran montrant l’ajout de variables d’environnement personnalisées.

Lancer l’application Teams en tant qu’application web

Vous pouvez lancer l’application Teams en tant qu’application web au lieu d’exécuter l’application dans le client Teams. Pour lancer votre application Teams en tant qu’application web, procédez comme suit :

  1. Dans Explorateur de solutions, sous Projet, sélectionnez Propriétés>launchSettings.json.

  2. Supprimez la launchUrl propriété .

    Capture d’écran montrant les équipes de lancement en tant qu’application web en supprimant launchurl.

  3. Cliquez avec le bouton droit sur Solution (dans ce scénario, le nom du projet est MyTeamsApp1), puis sélectionnez Propriétés.

    Capture d’écran montrant la solution de clic droit et sélectionner des propriétés.

    Une boîte de dialogue pages de propriétés de solution s’affiche.

  4. Sélectionnez Propriétés> de configurationConfiguration dans la boîte de dialogue.

  5. Décochez la case Déployer .

  6. Sélectionnez OK.

    Capture d’écran montrant la case à cocher Déployer dans les propriétés de configuration.

Next

Voir aussi

Teams Toolkit vous permet de déboguer et d’afficher un aperçu de votre application Microsoft Teams. Le débogage est le processus de vérification, de détection et de correction des problèmes ou bogues pour garantir que le programme s’exécute correctement dans Teams.

Teams Toolkit automatise les services de démarrage d’application, lance le débogage et charge l’application Teams. Après le débogage, vous pouvez afficher un aperçu de l’application Teams dans le client web Teams. Vous pouvez également personnaliser les paramètres de débogage pour utiliser vos points de terminaison de bot ou des variables d’environnement pour charger votre application configurée. Visual Studio vous permet de déboguer l’onglet, le bot et l’extension de message. Pendant le processus de débogage, Teams Toolkit prend en charge les fonctionnalités de débogage suivantes :

  • Préparer les dépendances d’application Teams
  • Démarrer le débogage
  • Basculez les points d’arrêt.
  • Recharge à chaud
  • Arrêter le débogage

Configuration requise

  Installer Pour l’utilisation...
  Obligatoire  
  Visual Studio 2022 version 17.3 Vous pouvez installer l’édition Entreprise de Visual Studio et installer la charge de travail « ASP.NET » et les outils de développement Microsoft Teams.
  Toolkit Teams Extension Visual Studio qui crée une structure de projet pour votre application. Utilisez la dernière version.
  Microsoft Teams Microsoft Teams pour collaborer avec toutes les personnes avec lesquelles vous travaillez via les applications pour les conversations, les réunions, les appels, le tout au même endroit.
  Préparer votre client Microsoft Office 365 Accès au compte Teams avec les autorisations appropriées pour installer une application.
  Compte de développeur Microsoft 365 Accès au compte Teams avec les autorisations appropriées pour installer une application.
  Outils Azure et Microsoft Azure CLI Outils Azure permettant d’accéder aux données stockées ou de déployer un back-end basé sur le cloud pour votre application Teams dans Azure.
  Facultatif  
  Ngrok Ngrok est utilisé pour transférer des messages externes d’Azure Bot Framework à votre ordinateur local.

Principales fonctionnalités de Teams Shared Computer Toolkit

Vous pouvez voir les fonctionnalités clés suivantes du Kit de ressources Teams, qui automatisent le processus de débogage local de votre application Teams :

Préparer les dépendances d’application Teams

Teams Toolkit prépare les dépendances de débogage locales et inscrit votre application Teams dans le locataire de votre compte. Pour les applications Bot et Extension de message, Teams Toolkit inscrit et configure le bot.

Démarrer le débogage

Vous pouvez effectuer le débogage avec une seule opération, appuyez sur F5 pour démarrer le débogage. Teams Toolkit génère du code, démarre les services et lance l’application dans votre navigateur.

Basculez les points d’arrêt.

Vous pouvez activer/désactiver les points d’arrêt dans les codes sources des onglets, des bots, des extensions de message et des Azure Functions. Les points d’arrêt s’exécutent lorsque vous interagissez avec l’application Teams dans votre navigateur web. L’image suivante montre les points d’arrêt bascule :

Basculement des points d’arrêt de débogage locaux

Recharge à chaud

Sélectionnez Rechargement à chaud pour appliquer vos modifications dans votre application Teams lorsque vous souhaitez mettre à jour et enregistrer les codes sources simultanément pendant le débogage.

Sélectionner l’icône de rechargement à chaud

Sélectionnez l’option Rechargement à chaud enregistrer le fichier dans la liste déroulante pour activer le rechargement automatique à chaud.

Sélectionner le rechargement à chaud lors de l’enregistrement de fichier

Conseil

Pour en savoir plus sur Rechargement à chaud fonction de Visual Studio pendant le débogage, vous pouvez visiter https://aka.ms/teamsfx-vs-hotreload.

Arrêter le débogage

Sélectionnez Arrêter le débogage (Maj+F5) une fois le débogage local terminé.

Sélectionner l’icône Arrêter le débogage

Personnaliser les paramètres de débogage

Vous pouvez personnaliser le paramètre de débogage pour votre application Teams afin d’utiliser les points de terminaison de votre bot et d’ajouter des variables d’environnement :

Utiliser le point de terminaison de votre bot

Vous pouvez définir siteEndpoint la configuration dans le .fx/configs/config.local.json fichier sur votre point de terminaison.

"bot": {
    "siteEndpoint": "https://baidu.com"
}

Ajouter des variables d’environnement

Vous pouvez ajouter environmentVariables au launchSettings.json fichier.

Ajouter des variables d’environnement personnalisées

Lancer l’application Teams en tant qu’application web

Vous pouvez lancer l’application Teams en tant qu’application web au lieu de l’exécuter dans le client Teams.

  1. Sélectionnez Propriétés>launchSettings.json dans Explorateur de solutions panneau sous votre projet.

  2. Supprimez le launchUrl du fichier.

    Lancer des équipes en tant qu’application web en supprimant launchurl

  3. Cliquez avec le bouton droit sur Solution , puis sélectionnez Propriétés.

    Cliquez avec le bouton droit sur la solution et sélectionnez propriétés

  4. Sélectionnez Propriétés> de configurationConfiguration dans la boîte de dialogue.

  5. Décochez la case Déployer .

  6. Sélectionnez OK.

    Décochez déployer dans les propriétés de configuration.

Next

Voir aussi