Partager via

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

Visual Studio vous permet de déboguer des onglets, des bots et des extensions de message. Vous pouvez déboguer votre application localement dans Visual Studio à l’aide de Microsoft 365 Agents Toolkit (anciennement appelé Teams Toolkit) en effectuant les opérations suivantes :

Configurer le tunnel de développement (uniquement pour l’extension de bot et de message)

Dans le menu déroulant débogage :

  1. Sélectionnez Dev Tunnels.

  2. Si vous avez déjà un tunnel de développement existant, sélectionnez le tunnel existant dans la liste. Par exemple, dans l’image suivante , PublicDevTunnel est un tunnel de développement existant.

  3. Si vous n’avez pas créé de tunnel, sélectionnez Créer un tunnel... Une nouvelle fenêtre s’affiche.

    Capture d’écran montrant l’option de tunnel de développement pour le débogage.

  4. Entrez le nom du tunnel de développement et sous Accès , sélectionnez Public dans la liste déroulante.

  5. Sélectionnez OK.

Configurer votre kit de ressources Agents

Pour déboguer votre application après avoir créé un projet, procédez comme suit :

  1. Cliquez avec le bouton droit sur votre projet.

  2. Sélectionnez Microsoft 365 Agents Toolkit>Sélectionnez compte Microsoft 365.

    Capture d’écran montrant les dépendances d’application teams de débogage locales.

    Remarque

    Dans ce scénario, le nom du projet est MyM365Agent2.

    Votre compte Microsoft 365 doit disposer de l’autorisation de chargement d’application personnalisée avant de vous connecter. Vérifiez que votre application Teams peut être chargée sur le locataire, sinon votre application Teams peut échouer à s’exécuter dans le client Teams.

  3. Connectez-vous à votre compte Microsoft 365 , puis sélectionnez Continuer.

    Capture d’écran montrant la connexion au compte Microsoft 365.

    Remarque

    Pour en savoir plus sur l’autorisation de chargement d’application personnalisée, consultez Préparer votre locataire Microsoft 365.

  4. Sélectionnez Déboguer>Démarrer le débogage ou F5.

    Capture d’écran montrant le démarrage du débogage.

    Visual Studio lance l’application Teams dans le client Microsoft Teams dans votre navigateur. Pour plus d’informations, consultez Vue d’ensemble du kit de ressources Microsoft 365 Agents.

  5. Sélectionnez Ajouter pour installer votre application dans Teams.

    Capture d’écran de la boîte de dialogue détails de l’application avec l’option permettant d’ajouter l’application dans Teams.

  6. Sélectionnez Ouvrir pour ouvrir l’application dans l’étendue personnelle.

    Vous pouvez également rechercher et sélectionner l’étendue requise, ou sélectionner un canal ou une conversation dans la liste, puis parcourir la boîte de dialogue pour sélectionner Accéder.

    Capture d’écran de la boîte de dialogue de sélection d’étendue avec la liste des étendues partagées.

    Vous pouvez également utiliser la fonction de rechargement à chaud de Visual Studio pendant le débogage. Pour plus d’informations, consultez Rechargement à chaud .NET.

    Remarque

    Lorsque vous déboguez une application de bot de notification, veillez à http://localhost:5130/api/notification publier une requête HTTP sur afin de déclencher la notification. Si vous avez sélectionné déclencheur HTTP lors de la création du projet, vous pouvez utiliser n’importe quel outil d’API comme cURL (invite de commandes Windows), Postman ou tout autre outil API.

    Avant d’essayer d’exécuter l’application Teams localement, si vous apportez des modifications au fichier /appPackage/manifest.jsonmanifeste de l’application (précédemment appelé manifeste d’application Teams), veillez à exécuter la commande Sélectionner un compte Microsoft 365 .

Étape suivante

Processus de débogage en arrière-plan

Voir aussi

  • Last updated on