Déboguer votre application Teams localement à l’aide de 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 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 encore 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.

1. Configurer votre Teams Shared Computer Toolkit

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 Teams Toolkit>Préparer les dépendances de l’application Teams.

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

    Remarque

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

    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 Teams.

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

    Capture d’écran montrant l’ajout d’une application.

    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 Préparer les dépendances d’application Teams .

Étape suivante

Voir aussi

Teams Toolkit vous permet de déboguer et d’afficher un aperçu local de votre application Microsoft Teams. Pendant le processus de débogage, teams Toolkit démarre automatiquement les services d’application, lance les débogueurs et charge l’application Teams. Vous pouvez afficher un aperçu local de votre application Teams dans le client web Teams après le débogage.

Visual Studio vous permet de déboguer l’onglet, le bot et l’extension de message. Vous pouvez déboguer votre application localement dans Visual Studio à l’aide de Teams Toolkit en effectuant les opérations suivantes :

Configurer ngrok (uniquement pour l’application Bot et Extension de message)

Utilisez l’invite de commandes pour exécuter cette commande :

ngrok http 5130

1. Configurer votre Teams Shared Computer Toolkit

Effectuez les étapes suivantes à l’aide du Kit de ressources Teams pour déboguer votre application après avoir créé un projet :

  1. Cliquez avec le bouton droit sur votre projet.

  2. Sélectionnez Teams Toolkit>Préparer les dépendances de l’application Teams.

    Dépendances d’application Teams pour le débogage local

    Remarque

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

    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 risque de ne pas s’exécuter dans le client Teams.

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

    Se connecter 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 sélectionnez directement F5.

    Démarrer le débogage

    Visual Studio lance l’application Teams dans le client Microsoft Teams dans votre navigateur.

    Remarque

    Pour en savoir plus, consultez Vue d’ensemble du kit de ressources Teams.

  5. Une fois Microsoft Teams chargé, sélectionnez Ajouter pour installer votre application dans Teams.

    Sélectionner Ajouter pour charger l’application

    Conseil

    Vous pouvez également utiliser la fonction de rechargement à chaud de Visual Studio pendant le débogage. Pour en savoir plus, consultez https://aka.ms/teamsfx-vs-hotreload.

    Remarque

    Veillez à publier une requête http://localhost:5130/api/notification HTTP dans pour déclencher une notification, lorsque vous déboguez l’application Notification Bot. Si vous avez sélectionné le 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.

    Conseil

    Si vous apportez des modifications au fichier manifeste d’application (précédemment appelé manifeste d’application Teams) (/templates/appPackage/manifest.template.json), veillez à exécuter la commande Préparer les dépendances d’application Teams. Avant d’essayer de réexécuter l’application Teams localement.

Étape suivante

Voir aussi