Testar e depurar Suplementos do Office em um servidor não local

Quando você tiver concluído o desenvolvimento e o teste em um host local e quiser preparar e testar o suplemento de um servidor não local ou conta de nuvem, poderá usar a ferramenta office-addin-debugging para qualquer projeto de suplemento baseado em Node.js. (A ferramenta não tem suporte em projetos criados com o Visual Studio.)

Observação

Se você estiver trabalhando em um computador Windows, poderá ter outra opção para testes não locais. Consulte Fazer sideload de suplementos do Office para teste de um compartilhamento de rede.

Projetos criados com o Microsoft 365 Agents Toolkit ou o Office Yeoman Generator (Yo Office)

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

Importante

A ferramenta de depuração de suplementos do office registra o suplemento no Registro do Windows ou em uma pasta especial em um Mac. Para um suplemento do Outlook, ele também registra o suplemento no Exchange. Para evitar bugs sutis durante o desenvolvimento, sempre termine uma sessão de teste executando npm run stop para garantir que esses registros sejam removidos e que o processo do servidor seja totalmente interrompido. Fechar manualmente o servidor, a janela da linha de comando (ou TERMINAL), o Visual Studio Code ou o aplicativo do Office não remove esses registros.

Outros projetos

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

npx office-addin-debugging start manifest.json

Esse comando faz sideload do suplemento para testes e depuração. A ferramenta também funciona com um manifesto somente de suplemento.

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

Importante

A ferramenta de depuração de suplementos do office registra o suplemento no Registro do Windows ou em uma pasta especial em um Mac. Para um suplemento do Outlook, ele também registra o suplemento no Exchange. Para evitar bugs sutis durante o desenvolvimento, sempre termine uma sessão de teste executando npx office-addin-debugging stop para garantir que esses registros sejam removidos e que o processo do servidor seja totalmente interrompido. Fechar manualmente o servidor, a janela da linha de comando (ou TERMINAL), o Visual Studio Code ou o aplicativo do Office não remove esses registros. Se você usou a --prod opção com o start comando, use a mesma opção com o stop comando.

  • Last updated on