Partilhar via


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.

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.

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.

Depurar no Windows

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

Para obter informações sobre o runtime que está a ser utilizado, consulte Browsers e controlos webview utilizados pelos Suplementos e Runtimes do Office nos Suplementos do Office.

Dica

Nas versões recentes do Office, uma forma de identificar o controlo webview que o Office está a utilizar é através do menu de personalidade em qualquer suplemento onde esteja disponível. (O menu de personalidade não é suportado no Outlook.) Abra o menu e selecione Informações de Segurança. Na caixa de diálogo Informações de Segurança no Windows, o Runtime reporta o Microsoft Edge, o Microsoft Edge Legado ou o Internet Explorer. O runtime não está incluído na caixa de diálogo em versões mais antigas do Office.

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.

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.

Confira também