Depurar as funções initialize e onReady

O paradoxo de depurar as funções Office.initialize e Office.onReady é que um depurador só pode anexar a um processo que está em execução, mas essas funções são executadas imediatamente quando o processo de tempo de execução do suplemento é iniciado, antes que um depurador possa anexar. Na maioria das situações, reiniciar o suplemento depois que um depurador é anexado não ajuda porque reiniciar o suplemento fecha o processo de tempo de execução original e o depurador anexado e inicia um novo processo que não tem nenhum depurador anexado.

Felizmente, há duas maneiras de depurar essas funções, descritas nas seções a seguir.

Depurar usando o Office na Web

Para depurar com o Office na Web, use as etapas a seguir.

1. Faça o sideload e execute o suplemento no Office na Web. Isso geralmente é feito abrindo o painel de tarefas de um suplemento ou executando um comando de função. O suplemento é executado no processo geral do navegador, não em um processo separado, como seria no Office para área de trabalho.
2. Abra as ferramentas de desenvolvedor do navegador. Isso geralmente é feito pressionando F12. O depurador nas ferramentas é anexado ao processo do navegador.
3. Aplique pontos de interrupção conforme necessário ao código na Office.initialize função ou Office.onReady .
4. Reinicie o painel de tarefas do suplemento ou o comando de função, assim como você fez na etapa 1. Essa ação não fecha o processo do navegador ou o depurador. A Office.initialize função OR é executada Office.onReady novamente e o processamento é interrompido em seus pontos de interrupção.

Depurar usando o Office no Windows

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

1. Feche o aplicativo do Office no qual você planeja 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 o aplicativo do Office.
4. Execute o suplemento.
5. As ferramentas de desenvolvedor do Microsoft Edge devem abrir automaticamente. Use a ferramenta da mesma forma que faria ao depurar um painel de tarefas, conforme especificado em Depurar um suplemento do painel de tarefas usando as ferramentas de desenvolvedor do Microsoft Edge.

Confira também

• Runtimes em Suplementos do Office