Depurar as funções initialize e onReady

Observação

Este artigo pressupõe que está familiarizado com Inicializar o seu Suplemento do Office.

O paradoxo da depuração das funções Office.initialize e Office.onReady é que um depurador só pode anexar a um processo em execução, mas estas funções são executadas imediatamente à medida que o processo de runtime do suplemento é iniciado, antes de um depurador poder ser anexado. Na maioria das situações, reiniciar o suplemento depois de um depurador ser anexado não ajuda porque reiniciar o suplemento fecha o processo de runtime original e o depurador anexado e inicia um novo processo que não tem nenhum depurador anexado.

Felizmente, existem duas formas de depurar estas funções descritas nas secções seguintes.

Depurar com Office na Web

Para depurar com Office na Web, utilize os seguintes passos.

1. Faça sideload e execute o suplemento no Office na Web. Normalmente, isto é feito ao abrir o painel de tarefas de um suplemento ou ao executar um comando de função. O suplemento é executado no processo geral do browser, não é um processo separado como faria no Office para ambiente de trabalho.
2. Abra as ferramentas de programador do browser. Normalmente, isto é feito ao premir F12. O depurador nas ferramentas anexa ao processo do browser.
3. Aplique pontos de interrupção conforme necessário ao código na Office.initialize função or Office.onReady .
4. Reinicie o painel de tarefas do suplemento ou o comando de função tal como fez no passo 1. Esta ação não fecha o processo do browser nem o depurador. A Office.initialize função ou Office.onReady é executada novamente e o processamento para nos pontos de interrupção.

Dica

Para obter informações mais detalhadas, veja Depurar suplementos no Office na Web.

Depurar com o Office no Windows

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.

Observação

Poderá ver outras instâncias da ferramenta de programação do Microsoft Edge a abrir automaticamente, uma vez que esta variável de ambiente afetará todas as instâncias do WebView2 no seu sistema.

Confira também

• Runtimes nos Suplementos do Office