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.

Dica

Este artigo está preocupado com a depuração no sentido estrito de definir pontos de interrupção e percorrer o código. Para obter as diretrizes sobre testes e solução de problemas, comece com Testar Suplementos do Office e Solução de problemas de erros de desenvolvimento com Suplementos do Office.

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.

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.

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.

Observação

Embora você deva testar seu suplemento em todas as plataformas às quais deseja oferecer suporte, você raramente precisará depurar em um ambiente diferente do seu computador de desenvolvimento. Por esse motivo, este artigo utiliza “seu computador de desenvolvimento” e “seu ambiente de desenvolvimento” para se referir ao ambiente no qual você está depurando. Se um problema no código ocorrer apenas em uma plataforma diferente daquela em seu computador de desenvolvimento e você precisar definir pontos de interrupção ou percorrer o código para resolvê-lo, o ambiente no qual você está depurando não é literalmente seu ambiente de desenvolvimento.

Depurar no Windows

A depuração no Windows depende do seu IDE.

Depurar no Mac

Use o Inspetor da 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. Confira Depurar suplementos no Office na Web.

Observação

Não recomendamos que você desenvolva Suplementos do Office em um computador Linux, exceto no caso incomum em que você pode ter certeza de que todos os usuários do suplemento acessarão o suplemento por meio do Office na Web a partir de um computador Linux.

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

Há versões de depuração das bibliotecas JavaScript do Office. Essas versões são mais legíveis e fáceis de percorrer com um depurador. Evite usá-los ao publicar e implantar seu suplemento.

As versões de depuração são encontradas nos seguintes locais da CDN.

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

Confira também

  • Last updated on