Este artigo descreve como depurar seu bot usando um IDE, como Visual Studio ou Visual Studio Code, e o Bot Framework Emulator. Use esses métodos para depurar um bot localmente. Este artigo usa um bot de eco, como o criado no início rápido Criar um bot .
Nota
Neste artigo, usamos o Bot Framework Emulator para enviar e receber mensagens do bot durante a depuração. Se você estiver procurando outras maneiras de depurar seu bot usando o Bot Framework Emulator, leia o artigo Debug with the Bot Framework Emulator .
Nota
Os SDKs JavaScript, C# e Python do Bot Framework continuarão a ser suportados, no entanto, o Java SDK está sendo desativado com suporte final de longo prazo terminando em novembro de 2023.
Os bots existentes construídos com o Java SDK continuarão a funcionar.
Definir pontos de interrupção C# no Visual Studio Code
No Visual Studio Code, pode definir pontos de interrupção e executar o bot no modo de depuração para examinar o código. Para definir pontos de interrupção no Visual Studio Code, faça o seguinte:
Inicie o Visual Studio Code e abra a pasta do projeto do bot.
Defina pontos de interrupção conforme necessário. Para definir um ponto de interrupção, passe o mouse sobre a coluna à esquerda dos números de linha. Será apresentado um pequeno ponto vermelho. Se selecionar o ponto, será definido o ponto de interrupção. Se selecionar o ponto novamente, o ponto de interrupção será removido.
Na barra de menus, selecione Executar e, em seguida , Iniciar Depuração. Seu bot começará a ser executado no modo de depuração do Terminal no Visual Studio Code.
A partir do emulador, envie uma mensagem ao seu bot (por exemplo, envie a mensagem "Oi"). A execução vai parar na linha onde colocou o ponto de interrupção.
Definir pontos de interrupção C# no Visual Studio
No Visual Studio, você pode definir pontos de interrupção e executar o bot no modo de depuração para percorrer seu código. Para definir pontos de interrupção no Visual Studio, faça o seguinte:
Navegue para a pasta do bot e abra o ficheiro .sln. A solução irá abrir no Visual Studio.
Na barra de menus, selecione Build e selecione Build Solution.
No Explorador de Soluções, selecione o ficheiro .cs e defina os pontos de interrupção necessários. Este ficheiro define a lógica do bot principal. Para definir um ponto de interrupção, passe o mouse sobre a coluna à esquerda dos números de linha. Um pequeno ponto aparecerá. Se selecionar o ponto, será definido o ponto de interrupção. Se selecionar o ponto novamente, o ponto de interrupção será removido.
No menu, selecione Depurar e, em seguida, Iniciar Depuração. Neste momento, o bot está a ser executado localmente.
Inicie o Bot Framework Emulator e ligue-se ao bot, como descrito na secção acima.
No emulador, envie uma mensagem ao bot, como "Oi". A execução vai parar na linha onde colocou o ponto de interrupção.
Definir pontos de interrupção JavaScript no Visual Studio Code
No Visual Studio Code, pode definir pontos de interrupção e executar o bot no modo de depuração para examinar o código. Para definir pontos de interrupção no Visual Studio Code, faça o seguinte:
Inicie o Visual Studio Code e abra a pasta do projeto do bot.
Na barra de menus, selecione Depurar e, em seguida, selecione Iniciar Depuração. Se você for solicitado a selecionar um mecanismo de tempo de execução para executar seu código, selecione Node.js. Neste momento, o bot está a ser executado localmente.
Selecione o ficheiro .js e defina pontos de interrupção conforme necessário. Para definir um ponto de interrupção, passe o mouse sobre a coluna à esquerda dos números de linha. Será apresentado um pequeno ponto vermelho. Se selecionar o ponto, será definido o ponto de interrupção. Se selecionar o ponto novamente, o ponto de interrupção será removido.
A partir do emulador, envie uma mensagem ao seu bot (por exemplo, envie a mensagem "Oi"). A execução vai parar na linha onde colocou o ponto de interrupção.
Definir pontos de interrupção Java no Visual Studio Code
Instale o Java Extension Pack no Visual Studio Code, se ainda não tiver feito isso. Esta extensão fornece suporte avançado para Java no Visual Studio Code, incluindo depuração.
Inicie o Visual Studio Code e abra a pasta do projeto do bot.
Defina pontos de interrupção conforme necessário. Para definir um ponto de interrupção, passe o mouse sobre a coluna à esquerda dos números de linha. Será apresentado um pequeno ponto vermelho. Se selecionar o ponto, será definido o ponto de interrupção. Se selecionar o ponto novamente, o ponto de interrupção será removido.
Selecione o EchoBot.java arquivo e adicione um ponto de interrupção a um local desejado.
Na barra de menus, selecione Executar e, em seguida, selecione Iniciar Depuração.
Selecione Java se for solicitado a depurar o arquivo selecionado no momento.
A partir do emulador, envie uma mensagem ao seu bot (por exemplo, envie a mensagem "Oi"). A execução vai parar na linha onde colocou o ponto de interrupção.
Instale a extensão Python no Visual Studio Code, se ainda não tiver feito isso. Esta extensão fornece suporte avançado para Python no Visual Studio Code, incluindo depuração.
Inicie o Visual Studio Code e abra a pasta do projeto do bot.
Defina pontos de interrupção conforme necessário. Para definir um ponto de interrupção, passe o mouse sobre a coluna à esquerda dos números de linha. Será apresentado um pequeno ponto vermelho. Se selecionar o ponto, será definido o ponto de interrupção. Se selecionar o ponto novamente, o ponto de interrupção será removido.
Selecione o app.py arquivo.
Na barra de menus, selecione Depurar e, em seguida, selecione Iniciar Depuração.
Selecione Arquivo Python para depurar o arquivo selecionado no momento.
A partir do emulador, envie uma mensagem ao seu bot (por exemplo, envie a mensagem "Oi"). A execução vai parar na linha onde colocou o ponto de interrupção.
