Create projetos de suplemento do Office com o Teams Toolkit

Uma ferramenta primária para desenvolver aplicativos do Teams é o Teams Toolkit. Você pode criar suplementos do Office com o Teams Toolkit, com as seguintes restrições.

• Os suplementos criados com o Teams Toolkit usam o manifesto unificado para o Microsoft 365.

• Somente suplementos do Outlook podem ser criados neste momento. Estamos trabalhando duro para habilitar o suporte no Teams Toolkit para suplementos para outros aplicativos e plataformas do Office.

  Observação

  Os suplementos do Office que usam o manifesto unificado para o Microsoft 365 têm suporte direto no Office na Web, no novo Outlook no Windows (versão prévia)e no Office no Windows conectado a uma assinatura do Microsoft 365, versão 2304 (Build 16320.00000) ou posterior.

  Quando o pacote de aplicativo que contém o manifesto unificado é implantado no AppSource ou no Centro de Administração Microsoft 365, se o manifesto tiver uma propriedade "alternateIcons" válida, um manifesto XML será gerado a partir do manifesto unificado e armazenado. Esse manifesto XML permite que o suplemento seja instalado em plataformas que não dão suporte diretamente ao manifesto unificado, incluindo Office no Mac, Office no celular, versões de assinatura do Office no Windows anteriores a 2304 (Build 16320.00000) e versões perpétuas do Office no Windows.

Instale a versão mais recente do Teams Toolkit em Visual Studio Code conforme descrito no Install Teams Toolkit.

Create um projeto de suplemento do Outlook

1. Abra Visual Studio Code e selecione Ícone do Teams Toolkit na Barra de Atividades.

   

2. Selecione Create um novo aplicativo.

3. Na lista suspensa Novo Projeto , selecione Suplemento do Outlook.

   

4. Na lista suspensa Recursos do aplicativo Usando um suplemento do Outlook , selecione Taskpane.

   

5. Na caixa de diálogo pasta Workspace que é aberta, selecione a pasta em que você deseja criar o projeto.

6. Dê um nome ao projeto (sem espaços) quando solicitado. O Teams Toolkit criará o projeto com arquivos básicos e scaffolding. Em seguida, ele abrirá o projeto em uma segunda janela Visual Studio Code. Feche a janela de Visual Studio Code original.

7. Na Visual Studio Code TERMINAL navegue até a raiz do projeto e execute npm install.

8. Antes de fazer alterações no projeto, verifique se você pode carregar o suplemento do Outlook de Visual Studio Code. Use as seguintes etapas:

   1. Verifique se sua conta na locação do desenvolvedor do Microsoft 365 também é uma conta de email no Outlook da área de trabalho. Se não for, siga as diretrizes em Adicionar uma conta de email ao Outlook.
   2. Feche a área de trabalho do Outlook.
   3. Em Visual Studio Code, abra o Teams Toolkit.
   4. Na seção ACCOUNTS , verifique se você está conectado ao Microsoft 365.
   5. Selecione Exibir | Executar em Visual Studio Code. No menu suspenso EXECUTAR E DEPURAR, selecione a opção Outlook Desktop (Edge Chromium)e pressione F5. O projeto cria e uma janela do servidor de desenvolvimento do Nó é aberta. Esse processo pode levar alguns minutos. Eventualmente, a área de trabalho do Outlook será aberta.
   6. Abra a caixa de entradada identidade da sua conta do Microsoft 365 e abra qualquer mensagem. Uma guia Suplemento contoso com dois botões será exibida na faixa de opções Home (ou na faixa de opções Mensagem , se você tiver aberto a mensagem em sua própria janela).
   7. Clique no botão Mostrar Painel de Tarefas e um painel de tarefas é aberto. Clique no botão Executar uma ação e uma pequena notificação aparece perto da parte superior da mensagem.
   8. Para parar a depuração e desinstalar o suplemento, selecione Executar | Parar Depuração em Visual Studio Code.

Agora você pode alterar e desenvolver o projeto. Em locais em que as diretrizes nos branchs de documentação de suplementos do Office, dependendo do tipo de manifesto que está sendo usado, siga as diretrizes do manifesto unificado.