In diesem Artikel wird beschrieben, wie Sie Ihren Bot mithilfe einer IDE wie Visual Studio oder Visual Studio Code debuggen und die Bot Framework Emulator. Verwenden Sie diese Methoden, um einen Bot lokal zu debuggen. In diesem Artikel wird ein Echobot verwendet, z. B. der im Schnellstart Erstellen eines Bots erstellte Bot.
Hinweis
In diesem Artikel wird Bot Framework Emulator zum Senden und Empfangen von Nachrichten vom Bot während des Debuggens verwendet. Wenn Sie nach anderen Möglichkeiten suchen, Ihren Bot mithilfe des Bot Framework Emulator zu debuggen, lesen Sie den Artikel Debuggen mit dem Bot Framework Emulator.
Hinweis
Die Bot Framework-Python- und Java-SDKs werden eingestellt und der endgültige langfristige Support endet im November 2023.
Es werden nur kritische Sicherheits- und Fehlerbehebungen innerhalb dieses Repositorys durchgeführt.
Vorhandene Bots, die mit diesen SDKs erstellt wurden, funktionieren weiterhin.
Festlegen von C#-Haltepunkten in Visual Studio Code
In Visual Studio Code können Sie Breakpoints festlegen und den Bot im Debugmodus ausführen, um den Code schrittweise zu durchlaufen. Gehen Sie wie folgt vor, um Haltepunkte in Visual Studio Code festzulegen:
Starten Sie Visual Studio Code, und öffnen Sie Ihren Botprojektordner.
Legen Sie Haltepunkte nach Bedarf fest. Um einen Haltepunkt festzulegen, zeigen Sie mit der Maus auf die Spalte links neben den Zeilennummern. Ein kleiner roter Punkt wird angezeigt. Wenn Sie den Punkt auswählen, wird der Breakpoint festgelegt. Wenn Sie den Punkt erneut auswählen, wird der Breakpoint entfernt.
Wählen Sie in der Menüleiste Ausführen und dann Debuggen starten aus. Die Ausführung Ihres Bots wird aus dem Terminal in Visual Studio Code im Debugmodus gestartet.
Senden Sie ihrem Bot im Emulator eine Nachricht (z. B. senden Sie die Nachricht "Hallo"). Die Ausführung wird an der Zeile unterbrochen, an der Sie den Haltepunkt platziert haben.
Festlegen von C#-Haltepunkten in Visual Studio
In Visual Studio können Sie Haltepunkte festlegen und den Bot im Debugmodus ausführen, um Den Code schrittweise zu durchlaufen. Gehen Sie wie folgt vor, um Haltepunkte in Visual Studio festzulegen:
Navigieren Sie zu Ihrem Botordner, und öffnen Sie die SLN-Datei. Damit wird die Projektmappe in Visual Studio geöffnet.
Wählen Sie in der Menüleiste Erstellen und dann Projektmappe erstellen aus.
Wählen Sie im Projektmappen-Explorer die Datei vom Typ .cs aus und legen Sie bei Bedarf Breakpoints fest. In dieser Datei ist die Hauptlogik des Bots definiert. Um einen Haltepunkt festzulegen, zeigen Sie mit der Maus auf die Spalte links neben den Zeilennummern. Ein kleiner Punkt wird angezeigt. Wenn Sie den Punkt auswählen, wird der Breakpoint festgelegt. Wenn Sie den Punkt erneut auswählen, wird der Breakpoint entfernt.
Wählen Sie im Menü Debuggen und dann Debuggen starten aus. Zu diesem Zeitpunkt wird der Bot lokal ausgeführt.
Starten Sie den Bot Framework-Emulator, und stellen Sie eine Verbindung mit Ihrem Bot her, wie es im Abschnitt oben beschrieben ist.
Senden Sie ihrem Bot im Emulator eine Nachricht, z. B. "Hallo". Die Ausführung wird an der Zeile unterbrochen, an der Sie den Haltepunkt platziert haben.
Festlegen von JavaScript-Haltepunkten in Visual Studio Code
In Visual Studio Code können Sie Breakpoints festlegen und den Bot im Debugmodus ausführen, um den Code schrittweise zu durchlaufen. Gehen Sie wie folgt vor, um Haltepunkte in Visual Studio Code festzulegen:
Starten Sie Visual Studio Code, und öffnen Sie Ihren Botprojektordner.
Wählen Sie in der Menüleiste Debuggen und dann Debuggen starten aus. Wenn Sie aufgefordert werden, eine Runtime-Engine zum Ausführen ihres Codes auszuwählen, wählen Sie Node.jsaus. Zu diesem Zeitpunkt wird der Bot lokal ausgeführt.
Wählen Sie die Datei vom Typ .js aus und legen Sie bei Bedarf Breakpoints fest. Um einen Haltepunkt festzulegen, zeigen Sie mit der Maus auf die Spalte links neben den Zeilennummern. Ein kleiner roter Punkt wird angezeigt. Wenn Sie den Punkt auswählen, wird der Breakpoint festgelegt. Wenn Sie den Punkt erneut auswählen, wird der Breakpoint entfernt.
Starten Sie Bot Framework Emulator, und stellen Sie eine Verbindung mit Ihrem Bot her, wie es im Artikel Debuggen mit dem Emulator beschrieben ist.
Senden Sie ihrem Bot im Emulator eine Nachricht (z. B. senden Sie die Nachricht "Hallo"). Die Ausführung wird an der Zeile unterbrochen, an der Sie den Haltepunkt platziert haben.
Festlegen von Java-Haltepunkten in Visual Studio Code
Installieren Sie das Java-Erweiterungspaket in Visual Studio Code, falls Sie dies noch nicht getan haben. Diese Erweiterung bietet umfassende Unterstützung für Java in Visual Studio Code, einschließlich Debuggen.
Starten Sie Visual Studio Code, und öffnen Sie Ihren Botprojektordner.
Legen Sie Haltepunkte nach Bedarf fest. Um einen Haltepunkt festzulegen, zeigen Sie mit der Maus auf die Spalte links neben den Zeilennummern. Ein kleiner roter Punkt wird angezeigt. Wenn Sie den Punkt auswählen, wird der Breakpoint festgelegt. Wenn Sie den Punkt erneut auswählen, wird der Breakpoint entfernt.
Wählen Sie die EchoBot.java Datei aus, und fügen Sie einem gewünschten Speicherort einen Haltepunkt hinzu.
Wählen Sie in der Menüleiste Ausführen und dann Debuggen starten aus.
Wählen Sie Java aus, wenn Sie zum Debuggen der aktuell ausgewählten Datei aufgefordert werden.
Starten Sie Bot Framework Emulator, und stellen Sie eine Verbindung mit Ihrem Bot her, wie es im Artikel Debuggen mit dem Emulator beschrieben ist.
Senden Sie ihrem Bot im Emulator eine Nachricht (z. B. senden Sie die Nachricht "Hallo"). Die Ausführung wird an der Zeile unterbrochen, an der Sie den Haltepunkt platziert haben.
Installieren Sie die Python-Erweiterung in Visual Studio Code, falls Sie dies noch nicht getan haben. Diese Erweiterung bietet umfassende Unterstützung für Python in Visual Studio Code, einschließlich Debuggen.
Starten Sie Visual Studio Code, und öffnen Sie Ihren Botprojektordner.
Legen Sie Haltepunkte nach Bedarf fest. Um einen Haltepunkt festzulegen, zeigen Sie mit der Maus auf die Spalte links neben den Zeilennummern. Ein kleiner roter Punkt wird angezeigt. Wenn Sie den Punkt auswählen, wird der Breakpoint festgelegt. Wenn Sie den Punkt erneut auswählen, wird der Breakpoint entfernt.
Wählen Sie die Datei app.py aus.
Wählen Sie in der Menüleiste Debuggen und dann Debuggen starten aus.
Wählen Sie Python-Datei aus, um die aktuell ausgewählte Datei zu debuggen.
Starten Sie Bot Framework Emulator, und stellen Sie eine Verbindung mit Ihrem Bot her, wie es im Artikel Debuggen mit dem Emulator beschrieben ist.
Senden Sie ihrem Bot im Emulator eine Nachricht (z. B. senden Sie die Nachricht "Hallo"). Die Ausführung wird an der Zeile unterbrochen, an der Sie den Haltepunkt platziert haben.
