Testar e depurar Suplementos do Office num servidor não local

  • Artigo

Quando concluir o desenvolvimento e teste num localhost e quiser testar o suplemento a partir de um servidor não local ou conta na nuvem, pode utilizar a ferramenta office-addin-debugging para qualquer projeto de suplemento baseado em Node.js. (A ferramenta não é suportada em projetos criados com o Visual Studio.)

Observação

Se estiver a trabalhar num computador Windows, poderá ter outra opção para testes não locais. Consulte Sideload Office Add-ins for testing from a network share (Sideload Suplementos do Office para testes a partir de uma partilha de rede).

Projetos criados com o Teams Toolkit ou o Gerador Yeoman do Office (Yo Office)

Se o seu projeto tiver sido criado com o Teams Toolkit ou o Office Yeoman Generator (Yo Office), a ferramenta office-addin-debugging já está instalada e o seu ficheiro package.json tem start scripts e que stop invocam a ferramenta. Para utilizá-lo para testes não locais, atualize a parte do domínio dos URLs no seu manifesto para apontar para o servidor de teste (ou CDN, conforme necessário). Em seguida, execute npm run start na linha de comandos (ou terminal do Visual Studio Code) para fazer sideload do suplemento para teste e depuração.

Importante

A ferramenta office-addin-debugging regista o suplemento no registo do Windows ou uma pasta especial num Mac. Para um suplemento do Outlook, também regista o suplemento no Exchange. Para evitar erros subtis ao desenvolver, termine sempre uma sessão de teste ao executar npm run stop para garantir que estes registos são removidos e que o processo do servidor está totalmente parado. Fechar manualmente o servidor, a janela da linha de comandos (ou TERMINAL), o Visual Studio Code ou a aplicação do Office não remove estes registos.

Outros projetos

Se o seu projeto não tiver sido criado com o Teams Toolkit ou o Yo Office, execute a ferramenta com o npx na raiz do projeto. Invoque-o com o respetivo start comando seguido do caminho relativo para o manifesto. Apresentamos um exemplo a seguir.

npx office-addin-debugging start manifest.json

Este comando sideloads the add-in for testing and debugging. A ferramenta também funciona com um manifesto apenas de suplemento.

Existem muitas opções para o start comando. Para obter detalhes, consulte README para a ferramenta em office-addin-debugging.

Importante

A ferramenta office-addin-debugging regista o suplemento no registo do Windows ou uma pasta especial num Mac. Para um suplemento do Outlook, também regista o suplemento no Exchange. Para evitar erros subtis ao desenvolver, termine sempre uma sessão de teste ao executar npx office-addin-debugging stop para garantir que estes registos são removidos e que o processo do servidor está totalmente parado. Fechar manualmente o servidor, a janela da linha de comandos (ou TERMINAL), o Visual Studio Code ou a aplicação do Office não remove estes registos. Se utilizou a opção --prod com o start comando , utilize a mesma opção com o stop comando .