Freigeben über


Debuggen Ihrer Microsoft Teams-App mit Microsoft Visual Studio

Microsoft 365 Agents Toolkit (früher als Teams Toolkit bezeichnet) automatisiert App-Startdienste, initiiert das Debuggen und lädt die Teams-App hoch. Nach dem Debuggen können Sie eine Vorschau der Teams-App im Teams-Webclient anzeigen. Passen Sie Debugeinstellungen an, um Ihre Botendpunkte oder Umgebungsvariablen zum Laden Ihrer konfigurierten App zu verwenden. Mit Visual Studio können Sie Registerkarten, Bots und Nachrichtenerweiterungen debuggen.

Voraussetzungen

  Installieren Zum Benutzen...
  Visual Studio 2022 Installieren Sie die Enterprise Edition von Visual Studio, und installieren Sie die ASP.NET Workload und Microsoft Teams-Entwicklungstools. Verwenden Sie die neueste Version.
  Microsoft 365 Agents Toolkit Eine Visual Studio-Erweiterung, die ein Projektgerüst für Ihre App erstellt. Verwenden Sie die neueste Version.
  Microsoft Teams Microsoft Teams für die Zusammenarbeit mit allen Personen, mit denen Sie arbeiten, über Apps für Chats, Besprechungen und Anrufe an einem Ort.
  Vorbereiten Ihres Microsoft 365-Mandanten Zugriff auf das Teams-Konto mit den entsprechenden Berechtigungen zum Installieren einer App.
  Microsoft 365-Entwicklerkonto Zugriff auf das Teams-Konto mit den entsprechenden Berechtigungen zum Installieren einer App.
  Azure Tools und Microsoft Azure CLI Azure Tools, um auf gespeicherte Daten zuzugreifen oder ein cloudbasiertes Back-End für Ihre Teams-App in Azure bereitzustellen.

Wichtige Features des Agents-Toolkits

Das Agents Toolkit automatisiert den lokalen Debugprozess für die folgenden wichtigen Features:

  • Wählen Sie Microsoft 365-Konto: Agents Toolkit bereitet lokale Debugabhängigkeiten vor und registriert Ihre Teams-App in Ihrem Mandantenkonto. Für Bot- und Nachrichtenerweiterungs-Apps registriert und konfiguriert das Agents Toolkit den Bot.

  • Debuggen starten: Führen Sie das Debuggen mit einem einzelnen Vorgang aus, indem Sie F5 drücken. Agents Toolkit erstellt Code, startet Dienste und startet die App in Ihrem Browser.

  • Breakpoints umschalten: Umschalten von Haltepunkten im Quellcode von Registerkarten, Bots, Nachrichtenerweiterungen und Azure Functions. Die Haltepunkte werden ausgeführt, wenn Sie mit der Teams-App in Ihrem Webbrowser interagieren.

    Die folgende Abbildung zeigt die Umschalthaltepunkte:

    Screenshot: Lokale Debug-Umschaltpunkte

  • Hot Reload: Wählen Sie Hot Reload aus, um Änderungen in Ihrer Teams-App anzuwenden, wenn Sie den Quellcode während des Debuggens aktualisieren und speichern möchten.

    Screenshot: Symbol

    Um die automatische Hot Reload zu aktivieren, wählen Sie in der Dropdownliste unter Datei speichern die Option Hot Reload aus.

    Screenshot: Auswählen von

    Tipp

    Weitere Informationen zur Hot Reload-Funktion finden Sie unter .NET Hot Reload.

  • Debuggen beenden: Wählen Sie Debuggen beenden (UMSCHALT+F5) aus, wenn das lokale Debuggen abgeschlossen ist.

    Screenshot: Symbol

Umgebungsvariablen hinzufügen

Fügen Sie der environmentVariables Datei hinzu launchSettings.json .

Screenshot: Hinzufügen von benutzerdefinierten Umgebungsvariablen

Starten der Teams-App als Web-App

Starten Sie die Teams-App als Web-App, anstatt die App im Teams-Client auszuführen. Führen Sie die folgenden Schritte aus, um Ihre Teams-App als Web-App zu starten:

  1. Wählen Sie Projektmappen-Explorer unter Projekt die Option Eigenschaften>launchSettings.json aus.

    Screenshot: Starten von Teams als Web-App durch Entfernen von launchurl

  2. Klicken Sie mit der rechten Maustaste auf Projektmappe (in diesem Szenario lautet der Projektname M365Agents), und wählen Sie Eigenschaften aus.

    Screenshot: Rechtsklick-Lösung und Auswählen von Eigenschaften

    Es wird ein Dialogfeld eigenschaftenseiten der Lösung angezeigt.

  3. Wählen Sie im Dialogfeld Konfigurationseigenschaften>Konfiguration aus.

  4. Deaktivieren Sie das Kontrollkästchen Bereitstellen .

  5. Wählen Sie OK aus.

    Screenshot: Deaktivieren der Bereitstellung in Den Konfigurationseigenschaften

Weiter

Siehe auch