Dieser Artikel beschreibt das Debuggen Ihres Bots mithilfe einer IDE wie Visual Studio oder Visual Studio Code und dem Bot Framework-Emulator. Verwenden Sie diese Methoden, um einen Bot lokal zu debuggen. In diesem Artikel wird ein Echo-Bot verwendet, z. B. der im Schnellstart zum 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 andere Methoden zum Debuggen Ihres Bots mit Bot Framework Emulator suchen, lesen Sie den Artikel Debuggen mit dem Emulator.
Hinweis
Die JavaScript-, C#- und Python-SDKs für Bot Framework werden weiterhin unterstützt, das Java-SDK wird jedoch eingestellt und der langfristige Support endet im November 2023.
Bestehende Bots, die mit dem Java SDK erstellt wurden, werden weiterhin funktionieren.
Festlegen von C#-Breakpoints 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. Zum Festlegen von Breakpoints in Visual Studio Code führen Sie die folgenden Schritte aus:
Starten Sie Visual Studio Code und öffnen Sie den Ordner mit Ihrem Botprojekt.
Legen Sie Haltepunkte nach Bedarf fest. In Visual Studio können Sie Breakpoints festlegen, indem Sie mit dem Mauszeiger auf die Spalte links neben den Zeilennummern zeigen. 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 beginnen starten. Die Ausführung Ihres Bots wird aus dem Terminal in Visual Studio Code im Debugmodus gestartet.
Senden Sie Ihrem Bot über den Emulator eine Nachricht (senden Sie beispielsweise die Nachricht „Hi“). Die Ausführung wird an der Zeile unterbrochen, an der Sie den Haltepunkt platziert haben.
Festlegen von C#-Breakpoints in Visual Studio
In Visual Studio (VS) können Sie Breakpoints festlegen und den Bot im Debugmodus ausführen, um den Code schrittweise zu durchlaufen. Zum Festlegen von Breakpoints in Visual Studio führen Sie die folgenden Schritte aus:
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 Build und dann Build-Lösung 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. In Visual Studio können Sie Breakpoints festlegen, indem Sie mit dem Mauszeiger auf die Spalte links neben den Zeilennummern zeigen. 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 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 im Emulator Ihrem Bot eine Nachricht, z. B. "Hallo". Die Ausführung wird an der Zeile unterbrochen, an der Sie den Haltepunkt platziert haben.
Festlegen von JavaScript-Breakpoints 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. Zum Festlegen von Breakpoints in Visual Studio Code führen Sie die folgenden Schritte aus:
Starten Sie Visual Studio Code und öffnen Sie den Ordner mit Ihrem Botprojekt.
Wählen Sie im Menü Debuggen und dann Debuggen starten aus. Wenn Sie zum Auswählen eines Laufzeitmoduls für das Ausführen des Codes aufgefordert werden, wählen Sie Node.js aus. 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. In Visual Studio können Sie Breakpoints festlegen, indem Sie mit dem Mauszeiger auf die Spalte links neben den Zeilennummern zeigen. 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 über den Emulator eine Nachricht (senden Sie beispielsweise die Nachricht „Hi“). Die Ausführung wird an der Zeile unterbrochen, an der Sie den Haltepunkt platziert haben.
Festlegen eines Java-Breakpoints in Visual Studio Code
Sofern nicht bereits geschehen, installieren Sie das Java-Erweiterungspack in Visual Studio Code. Diese Erweiterung bietet umfassende Unterstützung für Java in Visual Studio Code, einschließlich Debugging.
Starten Sie Visual Studio Code und öffnen Sie den Ordner mit Ihrem Botprojekt.
Legen Sie Haltepunkte nach Bedarf fest. In Visual Studio können Sie Breakpoints festlegen, indem Sie mit dem Mauszeiger auf die Spalte links neben den Zeilennummern zeigen. 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 einen Breakpoint zu einem gewünschten Speicherort hinzu.
Wählen Sie im Menü Ausführen und dann Debuggen starten.
Wählen Sie Java, wenn Sie aufgefordert werden, 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 über den Emulator eine Nachricht (senden Sie beispielsweise die Nachricht „Hi“). Die Ausführung wird an der Zeile unterbrochen, an der Sie den Haltepunkt platziert haben.
Installieren Sie die Python-Erweiterung in Visual Studio Code, wenn Sie dies nicht bereits getan haben. Diese Erweiterung bietet umfassende Unterstützung für Python in Visual Studio Code, einschließlich Debugging.
Starten Sie Visual Studio Code und öffnen Sie den Ordner mit Ihrem Botprojekt.
Legen Sie Haltepunkte nach Bedarf fest. In Visual Studio können Sie Breakpoints festlegen, indem Sie mit dem Mauszeiger auf die Spalte links neben den Zeilennummern zeigen. 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 im Menü 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 über den Emulator eine Nachricht (senden Sie beispielsweise die Nachricht „Hi“). Die Ausführung wird an der Zeile unterbrochen, an der Sie den Haltepunkt platziert haben.
