Debuggen Ihrer Teams-App mit Visual Studio

  • Artikel

Teams Toolkit automatisiert App-Startdienste, initiiert das Debuggen und lädt die Teams-App quer. Nach dem Debuggen können Sie eine Vorschau der Teams-App im Teams-Webclient anzeigen. Sie können auch Debugeinstellungen anpassen, 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 Sie können die Enterprise Edition von Visual Studio und die ASP.NET Workload und Microsoft Teams-Entwicklungstools installieren. Verwenden der neuesten Version
  Teams 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 für den Zugriff auf gespeicherte Daten oder das Bereitstellen eines cloudbasierten Back-Ends für Ihre Teams-App in Azure.

Wichtige Features des Teams-Toolkits

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

  • Vorbereiten von Teams-App-Abhängigkeiten: Teams Toolkit bereitet lokale Debugabhängigkeiten vor und registriert Ihre Teams-App in Ihrem Mandantenkonto. Für Bot- und Nachrichtenerweiterungs-Apps registriert und konfiguriert das Teams Toolkit den Bot.

  • Debuggen starten: Sie können das Debuggen mit einem einzelnen Vorgang ausführen, drücken Sie F5 , um das Debuggen zu starten. Teams Toolkit erstellt Code, startet Dienste und startet die App in Ihrem Browser.

  • Haltepunkte umschalten: Sie können Haltepunkte im Quellcode von Registerkarten, Bots, Nachrichtenerweiterungen und Azure Functions umschalten. 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 Ihre Ä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

Sie können der environmentVariableslaunchSettings.json Datei hinzufügen.

Screenshot: Hinzufügen von benutzerdefinierten Umgebungsvariablen

Starten der Teams-App als Web-App

Sie können die Teams-App als Web-App starten, 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.

  2. Entfernen Sie die launchUrl -Eigenschaft.

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

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

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

    Es wird ein Dialogfeld eigenschaftenseiten der Lösung angezeigt.

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

  5. Deaktivieren Sie das Kontrollkästchen Bereitstellen .

  6. Wählen Sie OK aus.

    Screenshot: Deaktivieren der Bereitstellung in Den Konfigurationseigenschaften

Weiter

Lokales Debuggen Ihrer App

Siehe auch

Das Teams-Toolkit unterstützt Sie beim Debuggen und Anzeigen einer Vorschau Ihrer Microsoft Teams-App. Debuggen ist der Prozess der Überprüfung, Erkennung und Behebung von Problemen oder Fehlern, um sicherzustellen, dass das Programm in Teams erfolgreich ausgeführt wird.

Das Teams-Toolkit automatisiert App-Startdienste, initiiert das Debuggen und lädt die Teams-App quer. Nach dem Debuggen können Sie eine Vorschau der Teams-App im Teams-Webclient anzeigen. Sie können auch Debugeinstellungen anpassen, um Ihre Botendpunkte oder Umgebungsvariablen zum Laden Ihrer konfigurierten App zu verwenden. Visual Studio ermöglicht ihnen das Debuggen von Registerkarten, Bots und Nachrichtenerweiterungen. Während des Debugprozesses unterstützt das Teams-Toolkit die folgenden Debugfeatures:

  • Vorbereiten von Teams-App-Abhängigkeiten
  • Debugging starten
  • Umschalthaltepunkte
  • Hot Reload
  • Debuggen beenden

Voraussetzungen

  Installieren Zum Benutzen...
  Required  
  Visual Studio 2022, Version 17.3 Sie können die Enterprise Edition von Visual Studio und die Workload "ASP.NET" und Microsoft Teams-Entwicklungstools installieren.
  Teams 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, mit denen Sie zusammenarbeiten, über Apps für Chats, Besprechungen und Anrufe – alles 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 für den Zugriff auf gespeicherte Daten oder die Bereitstellung eines cloudbasierten Back-Ends für Ihre Teams-App in Azure.
  Optional  
  Ngrok Ngrok wird verwendet, um externe Nachrichten von Azure Bot Framework an Ihren lokalen Computer weiterzuleiten.

Wichtige Features des Teams-Toolkits

Sie können die folgenden wichtigsten Features des Teams-Toolkits sehen, das den lokalen Debugprozess Ihrer Teams-App automatisiert:

Vorbereiten von Teams-App-Abhängigkeiten

Teams Toolkit bereitet lokale Debugabhängigkeiten vor und registriert Ihre Teams-App im Mandanten in Ihrem Konto. Für Bot- und Nachrichtenerweiterungs-Apps registriert und konfiguriert das Teams Toolkit den Bot.

Debugging starten

Sie können das Debuggen mit einem einzelnen Vorgang ausführen, drücken Sie F5 , um das Debuggen zu starten. Teams Toolkit erstellt Code, startet Dienste und startet die App in Ihrem Browser.

Umschalthaltepunkte

Sie können Haltepunkte in den Quellcodes von Registerkarten, Bots, Nachrichtenerweiterungen und Azure Functions umschalten. Die Haltepunkte werden ausgeführt, wenn Sie mit der Teams-App in Ihrem Webbrowser interagieren. Die folgende Abbildung zeigt die Umschalthaltepunkte:

Breakpoints für lokales Debuggen

Hot Reload

Wählen Sie Hot Reload aus, um Ihre Änderungen in Ihrer Teams-App anzuwenden, wenn Sie die Quellcodes während des Debuggens gleichzeitig aktualisieren und speichern möchten.

Symbol

Wählen Sie in der Dropdownliste die Option Hot Reload dateispeichern aus, um automatisches Hot Reload zu aktivieren.

Auswählen von Hot Reload beim Speichern der Datei

Tipp

Weitere Informationen zu Hot Reload Funktion von Visual Studio während des Debuggens finden Sie unter https://aka.ms/teamsfx-vs-hotreload.

Debuggen beenden

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

Symbol

Anpassen von Debugeinstellungen

Sie können die Debugeinstellung für Ihre Teams-App anpassen, um Ihre Botendpunkte zu verwenden und Umgebungsvariablen hinzuzufügen:

Verwenden Ihres Bot-Endpunkts

Sie können die Konfiguration in der .fx/configs/config.local.json Datei auf Ihren Endpunkt festlegensiteEndpoint.

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

Umgebungsvariablen hinzufügen

Sie können der launchSettings.json Datei hinzufügenenvironmentVariables.

Hinzufügen benutzerdefinierter Umgebungsvariablen

Starten der Teams-App als Web-App

Sie können die Teams-App als Web-App starten, anstatt im Teams-Client auszuführen.

  1. Wählen Sie eigenschaften>launchSettings.json in Projektmappen-Explorer Bereich unter Ihrem Projekt aus.

  2. Entfernen Sie aus launchUrl der Datei.

    Starten von Teams als Web-App durch Entfernen von launchurl

  3. Klicken Sie mit der rechten Maustaste auf Projektmappe , und wählen Sie Eigenschaften aus.

    Klicken Sie mit der rechten Maustaste auf die Lösung, und wählen Sie Eigenschaften aus.

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

  5. Deaktivieren Sie das Kontrollkästchen Bereitstellen .

  6. Wählen Sie OK aus.

    Deaktivieren der Bereitstellung in Konfigurationseigenschaften

Weiter

Lokales Debuggen Ihrer App

Siehe auch