Visão geral da depuração de Suplementos do Office

A depuração de Suplementos do Office é essencialmente a mesma que a depuração qualquer aplicativo Web. No entanto, um único conjunto de ferramentas não funcionará para todos os desenvolvedores de suplementos. Isso ocorre porque os suplementos podem ser desenvolvidos em diferentes sistemas operacionais e executados em várias plataformas. Este artigo ajuda você a encontrar as diretrizes de depuração detalhadas para seu ambiente de desenvolvimento.

Do lado do servidor ou do lado do cliente?

Depurar o código do lado do servidor de um suplemento do Office é o mesmo que depurar o lado do servidor de qualquer aplicativo Web. Veja as instruções de depuração do seu IDE ou de outras ferramentas. A seguir estão alguns exemplos de algumas das ferramentas mais populares.

• Depurar aplicativos ASP.NET ou ASP.NET Core no Visual Studio
• Depuração Expressa
• Guia de depuração do Node.js
• Depuração do Node.js no VS Code
• Depuração do Webpack

O restante deste artigo está preocupado apenas com a depuração do JavaScript do lado do cliente (que pode ser transpilado do TypeScript).

Casos especiais

Existem alguns casos especiais em que o processo de depuração difere do normal para uma determinada combinação de plataforma, aplicativo do Office e ambiente de desenvolvimento. Se você estiver depurando qualquer um desses casos especiais, use os links nesta seção para encontrar a orientação adequada. Caso contrário, vá para Orientação geral.

• Depurando a função Office.initialize ou Office.onReady:Depure as funções initialize e onReady.
• Depuração de uma função personalizada do Excel em um ambiente de execução não compartilhado: Depuração de funções personalizadas em um ambiente de execução não compartilhado.
• Depurando um comando de função em um ambiente de execução não compartilhado:
  • Suplementos do Outlook em um computador de desenvolvimento Windows: Comandos de função de depuração em suplementos do Outlook
  • Outros suplementos de aplicativos do Office ou Outlook em um computador de desenvolvimento Mac: Depure um comando de função com um tempo de execução não compartilhado.
• Depurar um suplemento baseado em eventos ou relatórios de spam: depurar suplementos baseados em eventos e relatórios de spam.
• Depurar um suplemento no novo cliente de ambiente de trabalho do Outlook no Windows: consulte a secção "Depurar o seu suplemento" de Desenvolver suplementos do Outlook para o novo Outlook no Windows.
• Depurar um suplemento baseado no Blazor: depure o suplemento da mesma forma que depuraria uma aplicação Web do Blazor. Veja Depurar ASP.NET Core Blazor WebAssembly.

Diretrizes gerais

Para encontrar as diretrizes para depurar o código do lado do cliente, a primeira variável é o sistema operacional do seu computador de desenvolvimento.

• Windows
• Mac
• Linux ou outra variante Unix

Depurar no Windows

A seguir, as diretrizes gerais para a depuração no Windows. A depuração no Windows depende do seu IDE.

• Visual Studio: depurar usando as ferramentas F12 do navegador. Consulte Depurar Suplementos do Office no Visual Studio.
• Qualquer outro IDE (ou não quer depurar dentro do IDE): depure com as ferramentas de depuração webview2. Veja Depurar suplementos com ferramentas de programador no Microsoft Edge

Depurar no Mac

Utilize o Inspetor Web do Safari. As instruções estão em Depurar Suplementos do Office em um Mac.

Depurar no Linux

Não há uma versão de área de trabalho do Office para Linux, então será necessário fazer o sideload do suplemento para o Office na Web para testá-lo e depurá-lo. As diretrizes de depuração estão em Depurar suplementos no Office na Web.

Depurar suplementos em preparo ou produção

Para depurar um suplemento que já está em preparo ou produção, anexe um depurador da interface do usuário do suplemento. Para obter instruções, Anexe um depurador no painel de tarefas.

Versões do office.js para depuração

Existem versões de depuração das bibliotecas JavaScript do Office. Estas versões são mais legíveis por humanos e são mais fáceis de percorrer com um depurador. Utilize-as quando as APIs JavaScript do Office não estiverem a funcionar conforme esperado. Evite utilizá-los quando publicar e implementar o suplemento.

As versões de depuração encontram-se nas seguintes localizações da CDN.

• Biblioteca de API javaScript do Office: https://appsforoffice.microsoft.com/lib/1/hosted/office.debug.js
• Biblioteca da API JavaScript do Office (pré-visualização): https://appsforoffice.microsoft.com/lib/beta/hosted/office.debug.js

Confira também

• Runtimes nos Suplementos do Office