Depurar suplementos do Office em um Mac

Como os suplementos são desenvolvidos usando HTML e JavaScript, eles são projetados para funcionar entre plataformas, mas pode haver diferenças sutis na forma como diferentes navegadores renderizam o HTML. Este artigo descreve como depurar suplementos em execução em um Mac.

Importante

A depuração de suplementos com o Office no Mac só será possível se o Office estiver instalado no Mac de Office.com, não na loja de aplicativos da Apple.

Depuração com Safari Web Inspetor em um Mac

Se você tiver um suplemento que mostre a interface do usuário em um painel de tarefas ou em um suplemento de conteúdo, o Safari Web Inspector poderá ser usado para depurar um Suplemento do Office.

Para poder depurar suplementos do Office no Mac, você deve ter Mac OS High Sierra e Mac Office Versão 16.9.1 (Build 18012504) ou posterior. Se você não tiver um build do Office no Mac, poderá se qualificar para uma assinatura de desenvolvedor Microsoft 365 E5 por meio do Programa de Desenvolvedor do Microsoft 365; para obter detalhes, confira as perguntas frequentes. Como alternativa, você pode se inscrever para uma avaliação gratuita de 1 mês ou comprar um plano do Microsoft 365.

Para iniciar, abra um terminal e defina a propriedade OfficeWebAddinDeveloperExtras do aplicativo relevante do Office da seguinte maneira:

• defaults write com.microsoft.Word OfficeWebAddinDeveloperExtras -bool true

• defaults write com.microsoft.Excel OfficeWebAddinDeveloperExtras -bool true

• defaults write com.microsoft.Powerpoint OfficeWebAddinDeveloperExtras -bool true

• defaults write com.microsoft.Outlook OfficeWebAddinDeveloperExtras -bool true

  Importante

  Os builds do Mac App Store do Office não dão suporte ao OfficeWebAddinDeveloperExtras sinalizador.

Em seguida, abra o aplicativo do Office e realize o sideload do seu suplemento. Clique com o botão direito do mouse no suplemento e você verá a opção Inspecionar Elemento no menu de contexto. Marque essa opção e ela exibirá o inspetor, onde você poderá definir os pontos de interrupção e depurar o suplemento.

Observação

Se você estiver tentando usar o inspetor e a caixa de diálogo piscar, atualize o Office para a versão mais recente. Se isso não resolve a cintilação, experimente a solução alternativa a seguir.

1. Reduza o tamanho da caixa de diálogo.
2. Escolha Inspecionar Elemento, que será aberto em uma nova janela.
3. Redimensione a caixa de diálogo para seu tamanho original.
4. Use o inspetor, conforme necessário.

Limpar cache do aplicativo do Office em um Mac

Os suplementos geralmente são armazenados em cache no Office no Mac por motivos de desempenho. Normalmente, o cache será limpo quando o suplemento for recarregado. Se houver mais de um suplemento no mesmo documento, é provável que o processo de limpeza automática do cache ao recarregar não seja confiável.

Usar o menu de personalidade para limpar o cache

Você pode limpar o cache usando o menu personalidade de qualquer suplemento do painel de tarefas. No entanto, como o menu de personalidade não tem suporte nos suplementos do Outlook, você pode tentar a opção de limpar o cache manualmente se estiver usando o Outlook.

• Escolha o menu personalidade. Em seguida, escolha Limpar Cache da Web.

  Observação

  Você deve executar o macOS Versão 10.13.6 ou posterior para ver o menu de personalidade.

  

Limpar o cache manualmente

Você também pode limpar o cache manualmente ao excluir o conteúdo na pasta ~/Library/Containers/com.Microsoft.OsfWebHost/Data/. Procure essa pasta por meio do terminal.

Observação

Se essa pasta não existir, marcar para as pastas a seguir por meio do terminal e, se encontrada, exclua o conteúdo da pasta.

• ~/Library/Containers/com.microsoft.{host}/Data/Library/Caches/ onde {host} é o aplicativo do Office (por exemplo, Excel)
• ~/Library/Containers/com.microsoft.{host}/Data/Library/Application Support/Microsoft/Office/16.0/Wef/ onde {host} é o aplicativo do Office (por exemplo, Excel)
• ~/Library/Containers/com.microsoft.Office365ServiceV2/Data/Caches/com.microsoft.Office365ServiceV2/
• ~/Library/Containers/com.microsoft.Office365ServiceV2/Data/Library/Caches/com.microsoft.Office365ServiceV2/

Para procurar essas pastas por meio do Finder, você deve definir o Finder para mostrar arquivos ocultos. O Localizador exibe as pastas dentro do diretório Contêineres pelo nome do produto, como o Microsoft Excel em vez de com.microsoft.Excel.