Depurar seu aplicativo do Microsoft Teams localmente usando o Microsoft Visual Studio

O Visual Studio permite depurar guias, bots e extensões de mensagens. Você pode depurar seu aplicativo localmente no Visual Studio usando o Microsoft 365 Agents Toolkit (anteriormente conhecido como Teams Toolkit) executando:

Configurar túnel de desenvolvimento (somente para bot e extensão de mensagem)

No menu suspenso de depuração:

  1. Selecione Túneis de Desenvolvimento.

  2. Se você já tiver um túnel de desenvolvimento existente, selecione o túnel existente na lista. Por exemplo, na imagem a seguir, PublicDevTunnel é um túnel de desenvolvimento existente.

  3. Se você ainda não criou um túnel, selecione Criar um túnel.... Uma nova janela é exibida.

    A captura de tela mostra o túnel de desenvolvimento para a opção de depuração.

  4. Insira o nome do túnel de desenvolvimento e, em Acesso , selecione Público na lista suspensa.

  5. Selecione OK.

Configure seu kit de ferramentas para agentes

Para depurar seu aplicativo depois de criar um projeto, execute as seguintes etapas:

  1. Clique com o botão direito do mouse em seu projeto.

  2. Selecione o kit de ferramentas de agentes do> Microsoft 365Selecione a conta do Microsoft 365.

    A captura de tela mostra as dependências locais do aplicativo Teams de depuração.

    Observação

    Nesse cenário, o nome do projeto é MyM365Agent2.

    Sua conta do Microsoft 365 precisa ter a permissão de upload do aplicativo personalizado antes de entrar. Verifique se o aplicativo do Teams pode ser carregado no locatário, caso contrário, o aplicativo do Teams pode não ser executado no Cliente do Teams.

  3. Entre em sua conta do Microsoft 365 e selecione Continuar.

    A captura de tela mostra o login na conta do Microsoft 365.

    Observação

    Saiba mais sobre a permissão de upload de aplicativo personalizado, consulte preparar seu locatário do Microsoft 365.

  4. Selecione Depurar>,Iniciar Depuração ou selecione F5.

    A captura de tela mostra iniciar depuração.

    O Visual Studio inicia o aplicativo Teams dentro do cliente Microsoft Teams em seu navegador. Para obter mais informações, consulte Visão geral do kit de ferramentas de agentes do Microsoft 365.

  5. Selecione Adicionar para instalar seu aplicativo no Teams.

    Captura de tela da caixa de diálogo de detalhes do aplicativo com a opção de adicionar o aplicativo no Teams.

  6. Selecione Abrir para abrir o aplicativo no escopo pessoal.

    Como alternativa, você pode pesquisar e selecionar o escopo necessário ou selecionar um canal ou chat na lista e percorrer a caixa de diálogo para selecionar Ir.

    Captura de tela da caixa de diálogo de seleção de escopo com a lista de escopos compartilhados.

    Você também pode usar a função hot reload do Visual Studio durante a depuração. Para obter mais informações, consulte Recarga dinâmica do .NET.

    Observação

    Ao depurar um aplicativo de bot de notificação, certifique-se de postar a solicitação HTTP para http://localhost:5130/api/notification acionar a notificação. Se você selecionou o gatilho HTTP ao criar o projeto, pode usar qualquer ferramenta de API, como cURL (Prompt de Comando do Windows), Postman ou qualquer outra ferramenta de API.

    Antes de tentar executar o aplicativo do Teams localmente, se você fizer alterações no arquivo /appPackage/manifest.jsonde manifesto do aplicativo (anteriormente chamado de manifesto do aplicativo do Teams), certifique-se de executar o comando Selecionar Conta do Microsoft 365 .

Próxima etapa

Depurar processo em segundo plano

Confira também

  • Last updated on