Depurar suplementos com ferramentas de programador no Microsoft Edge

Este artigo mostra como depurar o código do lado do cliente (JavaScript ou TypeScript) do seu suplemento fora do seu IDE atual.

Depurar um suplemento do painel de tarefas com as ferramentas de programador do Microsoft Edge

1. Faça sideload e execute o suplemento.

   Observação

   Para fazer sideload de um suplemento no Outlook, veja Sideload Outlook add-ins for testing (Sideload de suplementos do Outlook para testes).

2. Execute as ferramentas de programador do Microsoft Edge através de um destes métodos:

   • Certifique-se de que o painel de tarefas do suplemento tem o foco e prima Ctrl+Shift+I.
   • Clique com o botão direito do rato (ou selecione sem soltar) no painel de tarefas para abrir o menu de contexto e selecione Inspecionar ou abra o menu de personalidade e selecione Anexar Depurador. (O menu de personalidade não é suportado no Outlook.)

   Observação

   O novo cliente de ambiente de trabalho do Outlook no Windows não suporta o menu de contexto ou o atalho de teclado para aceder às ferramentas de programador do Microsoft Edge. Em vez disso, tem de executar olk.exe --devtools a partir de uma linha de comandos. Para obter mais informações, consulte a secção "Depurar o seu suplemento" de Desenvolver suplementos do Outlook para o novo Outlook no Windows.

3. Abra o separador Origens .

4. Abra o ficheiro que pretende depurar com os seguintes passos.

   1. Na extremidade direita da barra de menus superior da ferramenta, selecione o botão ... e, em seguida, selecione Procurar.
   2. Introduza uma linha de código do ficheiro que pretende depurar na caixa de pesquisa. Deve ser algo que não é provável que esteja em qualquer outro ficheiro.
   3. Selecione o botão atualizar.
   4. Nos resultados da pesquisa, selecione a linha para abrir o ficheiro de código no painel acima dos resultados da pesquisa.

   

5. Para definir um ponto de interrupção, selecione o número de linha da linha no ficheiro de código. Um ponto vermelho aparece junto à linha no ficheiro de código. Na janela do depurador à direita, o ponto de interrupção é registado no menu pendente Pontos de interrupção.

6. Execute funções no suplemento conforme necessário para disparar o ponto de interrupção.

Depurar uma caixa de diálogo num suplemento

Se o seu suplemento utilizar a API de Caixa de Diálogo do Office, a caixa de diálogo é executada num processo separado do painel de tarefas (se aplicável) e a ferramenta tem de ser iniciada a partir desse processo separado. Siga estas etapas.

1. Execute o suplemento.

2. Abra a caixa de diálogo e certifique-se de que tem o foco.

3. Abra as ferramentas de programador do Microsoft Edge através de um destes métodos:

   • Prima Ctrl+Shift+I ou F12.
   • Clique com o botão direito do rato (ou selecione sem soltar) na caixa de diálogo para abrir o menu de contexto e selecione Inspecionar.

4. Utilize a ferramenta tal como faria para o código num painel de tarefas. Veja Depurar um suplemento do painel de tarefas com ferramentas de programador do Microsoft Edge anteriormente neste artigo.

Abrir automaticamente as ferramentas de programador do Microsoft Edge para depurar a inicialização

Para depurar a sequência de inicialização do suplemento, configure o seu ambiente para que as ferramentas de programador do Microsoft WebView2 sejam abertas automaticamente quando o suplemento for iniciado.

1. Feche a aplicação do Office onde planeia depurar o suplemento.
2. Defina a variável de WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS ambiente para incluir o valor --auto-open-devtools-for-tabs.
3. Abra a aplicação do Office.
4. Execute o suplemento.
5. As ferramentas de programador do Microsoft Edge devem abrir automaticamente. Utilize a ferramenta tal como faria ao depurar um painel de tarefas, conforme especificado em Depurar um suplemento do painel de tarefas com as ferramentas de programador do Microsoft Edge.