Compartilhar via

Sideload Suplementos do Office que utilizam o manifesto unificado para o Microsoft 365

  • Artigo

O processo de sideload de um suplemento que utiliza o manifesto Unificado para o Microsoft 365 varia consoante a ferramenta que pretende utilizar e sobre a forma como o projeto de suplemento foi criado.

Observação

Um suplemento que utilize o manifesto unificado pode ser colocado em sideload no Office no Windows, Versão 2304 (Compilação 16320.20000) ou posterior. Atualmente, não pode ser sideloaded na Web, Mac ou iPad.

Suplementos de sideload criados com o gerador Yeoman para Suplementos do Office (Yo Office)

Utilize o processo descrito em Sideload com uma linha de comandos do sistema, shell bash ou terminal.

Sideload com o Teams Toolkit

  1. Primeiro, certifique-se de que a aplicação de ambiente de trabalho do Office na qual pretende colocar o sideload está fechada.

  2. No Visual Studio Code, abra o Teams Toolkit.

  3. Apenas necessário para o Outlook: na secção CONTAS , verifique se tem sessão iniciada no Microsoft 365.

  4. Selecione Ver | Executar no Visual Studio Code. No menu pendente EXECUTAR E DEPURAR , selecione uma destas opções conforme adequado para o seu suplemento.

    • Ambiente de Trabalho do Excel (Chromium Edge)
    • Ambiente de Trabalho do Outlook (edge Chromium)
    • PowerPoint Desktop (edge Chromium)
    • ambiente de trabalho do Word (Chromium do Edge)

  5. Pressione F5. O projeto é compilação e é aberta uma janela Dev-Server do Nó. Este processo pode demorar alguns minutos e, em seguida, é aberta a versão de ambiente de trabalho da aplicação do Office que selecionou. Agora pode trabalhar com o seu suplemento. Para um suplemento do Outlook, certifique-se de que está a trabalhar na Caixa de Entrada da sua identidade de conta do Microsoft 365.

  6. Para parar a depuração e desinstalar o suplemento, selecione Executar | Parar Depuração no Visual Studio Code. Fechar a janela do servidor não para de forma fiável o servidor e fechar a aplicação do Office não faz com que o Office não se preocupe com o suplemento.

Sideload com uma linha de comandos do sistema, shell bash ou terminal

  1. Primeiro, certifique-se de que a aplicação de ambiente de trabalho do Office na qual pretende colocar o sideload está fechada.
  2. Abra uma linha de comandos do sistema, a shell do bash ou a Visual Studio Code TERMINAL e navegue para a raiz do projeto.
  3. O comando para fazer sideload do suplemento depende de quando o projeto foi criado. Se a secção "scripts" do ficheiro de package.json do projeto tiver um script "start:desktop", execute npm run start:desktop; caso contrário, execute npm run start. O projeto é compilação e é aberta uma janela Dev-Server do Nó. Este processo pode demorar alguns minutos e, em seguida, é aberta a aplicação anfitriã do Office (Excel, Outlook, PowerPoint ou Word).
  4. Agora pode trabalhar com o seu suplemento.
  5. Quando terminar de trabalhar com o suplemento, certifique-se de que executa o comando npm run stop. Fechar a janela do servidor não para de forma fiável o servidor e fechar a aplicação do Office não faz com que o Office não se preocupe com o suplemento.

Sideload de outros projetos NodeJS e npm

Existem duas ferramentas que pode utilizar para sideload.

Sideload com a ferramenta Office-Addin-Debugging

  1. Para colocar o suplemento em sideload, execute o seguinte comando. Este comando coloca o manifesto unificado e os dois ficheiros de imagem de ícone referenciados na propriedade "ícones" do manifesto num ficheiro zip e faz o sideload para a aplicação do Office. Também inicia um servidor numa janela do NodeJS separada para alojar os ficheiros de suplemento no localhost. Para obter mais detalhes sobre este comando, consulte Office-Addin-Debugging.

    npx office-addin-debugging start <relative-path-to-unified-manifest> desktop

  2. Quando utiliza office-addin-debugging para iniciar um suplemento, pare sempre a sessão com o seguinte comando. Fechar a janela do servidor não para de forma fiável o servidor e fechar a aplicação do Office não faz com que o Office não se preocupe com o suplemento.

    npx office-addin-debugging stop <relative-path-to-unified-manifest>

Sideload com a CLI do Teams Toolkit (interface de linha de comandos)

  1. Crie manualmente um pacote zip com os seguintes passos.

    1. Abra o manifesto unificado e desloque-se para a propriedade "ícones". Tenha em atenção o caminho relativo dos dois ficheiros de imagem.
    2. Utilize qualquer utilitário zip para criar um ficheiro zip que contenha o manifesto unificado e os dois ficheiros de imagem. Os ficheiros de imagem têm de ter o mesmo caminho relativo no ficheiro zip que têm no projeto. Por exemplo, se o caminho relativo for "assets/icon-64.png" e "assets/icon-128.png", tem de incluir a pasta "assets" com os dois ficheiros no pacote zip.
    3. Se a pasta contiver outros ficheiros, como ficheiros de imagem utilizados no friso do Office, remova-os do pacote zip. Deve ter apenas os dois ficheiros de imagem especificados na propriedade "ícones" (para além do manifesto na raiz do pacote zip).

  2. Na raiz do projeto, abra uma linha de comandos ou shell de bash e execute os seguintes comandos.

    npm install -g @microsoft/teamsapp-cli

teamsapp install --file-path <relative-path-to-zip-file>

  3. Quando utiliza a CLI do Teams Toolkit para iniciar um suplemento, pare sempre a sessão com o seguinte comando. Fechar a janela do servidor não para de forma fiável o servidor e fechar a aplicação do Office não faz com que o Office não se preocupe com o suplemento. Substitua o "{GUID do suplemento}" pelo GUID na propriedade "id" do manifesto unificado.

    teamsapp uninstall -manifest-id {GUID of the add-in}