Depurar suplementos do Office em um Mac

Uma vez que os suplementos são desenvolvidos com HTML e JavaScript, foram concebidos para funcionar em várias plataformas, mas podem existir diferenças subtis na forma como os diferentes browsers compõem o HTML. Este artigo descreve como depurar suplementos em execução num Mac.

Importante

A depuração de suplementos com o Office no Mac só é possível se o Office estiver instalado no Mac a partir de Office.com e não da Apple App Store.

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, tem de ter o Mac OS High Sierra AND Mac Versão 16.9.1 (Compilação 18012504) ou posterior. Se não tiver uma compilação do Office no Mac, poderá qualificar-se para uma subscrição de programador do Microsoft 365 E5 através do Programa para Programadores do Microsoft 365; para obter detalhes, veja as FAQ. Em alternativa, pode inscrever-se numa avaliação gratuita de um 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

  As compilações da Mac App Store do Office não suportam o OfficeWebAddinDeveloperExtras sinalizador.

Em seguida, abra o aplicativo do Office e realize o sideload do seu suplemento. Selecione sem soltar (ou clique com o botão direito do rato) o suplemento e deverá ver uma 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 estiver a depurar um suplemento baseado em eventos ou relatórios de spam no Outlook no Mac, siga os passos em Depurar o suplemento do Outlook baseado em eventos ou relatórios de spam após configurar a OfficeWebAddinDeveloperExtras propriedade.

• 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 resolver a intermitência, experimente a seguinte solução.

  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 são frequentemente colocados 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.

Utilizar o menu de personalidade para limpar a 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 é suportado nos suplementos do Outlook, pode experimentar a opção para limpar a cache manualmente se estiver a utilizar o Outlook.

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

  Observação

  Tem de executar a Versão 10.13.6 ou posterior do macOS para ver o menu de personalidade.

  

Limpar a cache manualmente

Também pode limpar a cache manualmente ao eliminar os conteúdos das ~/Library/Containers/com.Microsoft.OsfWebHost/Data/ pastas e ~/Library/Containers/com.microsoft.{host}/Data/Documents/wef . Substitua pela {host} aplicação do Office, como Excel. Procure estas pastas através do terminal.

Eliminar o conteúdo da pasta remove um suplemento sideloaded do menu de suplementos numa aplicação ~/Library/Containers/com.microsoft.{host}/Data/Documents/wef .

Observação

Se a ~/Library/Containers/com.Microsoft.OsfWebHost/Data/ pasta não existir, verifique as seguintes pastas através do terminal e, se for encontrada, elimine 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/

Dica

Para procurar estas pastas através do Finder, tem de definir o Finder para mostrar ficheiros ocultos. O Finder apresenta as pastas no diretório Contentores por nome de produto, como o Microsoft Excel em vez de com.microsoft.Excel.