Depurar seu suplemento com o log de tempo de execução

Você pode usar o log de tempo de execução para depurar o manifesto do seu suplemento, assim como diversos erros de instalação. Esse recurso pode ajudá-lo a identificar e corrigir problemas com seu manifesto que não são detectados pela validação de esquema XSD, como uma incompatibilidade entre as identificações dos recursos. O registo de runtime é particularmente útil para depurar suplementos que implementam comandos de suplementos e funções personalizadas do Excel.

Use o log de tempo de execução na linha de comandos

Habilitar o log de tempo de execução na linha de comando é a maneira mais rápida de usar essa ferramenta de log.

• Para habilitar o log de tempo de execução:

  npx office-addin-dev-settings runtime-log --enable
  

• Para habilitar o log de tempo de execução apenas para um arquivo específico, use o mesmo comando com um nome de arquivo:

  npx office-addin-dev-settings runtime-log --enable [filename.txt]
  

• Para desabilitar o log de tempo de execução:

  npx office-addin-dev-settings runtime-log --disable
  

• Para exibir se o log de tempo de execução está ativado:

  npx office-addin-dev-settings runtime-log
  

• Para exibir ajuda na linha de comandos para o log de tempo de execução:

  npx office-addin-dev-settings runtime-log --help
  

Log de tempo de execução no Mac

1. Abra o Terminal e defina uma preferência de log de tempo de execução usando o comando defaults:

   defaults write <bundle id> CEFRuntimeLoggingFile -string <file_name>
   

   <bundle id> identifica quais hosts devem ser habilitados no log de tempo de execução. <file_name> é o nome do arquivo de texto no qual o log será gravado.

   Defina <bundle id> para um dos seguintes valores para ativar o registo de runtime para a aplicação correspondente.

   • com.microsoft.Word
   • com.microsoft.Excel
   • com.microsoft.Powerpoint
   • com.microsoft.Outlook

O exemplo seguinte ativa o registo de runtime para Word e, em seguida, abre o ficheiro de registo.

defaults write com.microsoft.Word CEFRuntimeLoggingFile -string "runtime_logs.txt"
open ~/library/Containers/com.microsoft.Word/Data/runtime_logs.txt

Para desativar o log de tempo de execução, use o comando defaults delete:

defaults delete <bundle id> CEFRuntimeLoggingFile

O exemplo seguinte desativará o registo de runtime para Word.

defaults delete com.microsoft.Word CEFRuntimeLoggingFile

Use o log do tempo de execução para solucionar problemas em seu manifesto

Para usar o log do tempo de execução para solucionar problemas ao carregar um suplemento:

1. Realize o sideload do seu suplemento para teste.

   Observação

   Recomendamos realizar o sideload apenas do suplemento que você está testando para minimizar a quantidade de mensagens no arquivo de log.

2. Se nada acontecer e você não vir seu suplemento (e ele não estiver aparecendo na caixa de diálogo de suplementos), abra o arquivo de log.

3. Procure pela ID de seu suplemento no arquivo de log, definida no seu manifesto. No arquivo de log, essa ID está marcada como SolutionId.

Problemas conhecidos com o log de tempo de execução

Talvez você veja mensagens no arquivo de log que são confusas ou que estão classificadas incorretamente. Por exemplo:

• A mensagem Medium Current host not in add-in's host list seguida por Unexpected Parsed manifest targeting different host é incorretamente classificada como um erro.

• Se você vir a mensagem Unexpected Add-in is missing required manifest fields DisplayName e ela não contiver uma SolutionId, o erro provavelmente não está relacionado ao suplemento que você está depurando.

• Qualquer mensagem Monitorable indica erros esperados do ponto de vista do sistema. Às vezes, indica um problema com o seu manifesto, como um elemento que foi soletrado incorretamente e que foi ignorado, mas que não fez com que o manifesto falhasse.

Confira também

• Manifesto de Suplementos do Office
• Validar o manifesto de suplemento do Office
• Limpar o cache do Office
• Realizar sideload de suplementos do Office para teste
• Depurar suplementos com ferramentas de programador no Microsoft Edge
• Runtimes nos Suplementos do Office