Criar aplicativos com o Microsoft Teams Toolkit e o Visual StudioBuild apps with the Microsoft Teams Toolkit and Visual Studio

O Microsoft Teams Toolkit permite que você crie aplicativos personalizados do teams diretamente no IDE (ambiente de desenvolvimento integrado) do Visual Studio.The Microsoft Teams Toolkit enables you to create custom Teams apps directly within the Visual Studio integrated development environment (IDE). O Microsoft Teams Toolkit orienta você durante o processo e oferece tudo o que você precisa para criar, depurar e iniciar o aplicativo Teams.The Microsoft Teams toolkit guides you through the process and provides everything you need to build, debug, and launch your Teams app.

Pré-requisitosPrerequisites

  1. Habilitar visualização do desenvolvedorEnable developer preview

  2. Certifique-se de que o ** ASP.neT e o módulo de desenvolvimento da Web** foram adicionados à sua instância do Visual Studio.Make sure that the ASP.NET and web development module has been added to your Visual Studio instance. Você pode verificar seguindo as etapas descritas em Modificar o Visual Studio adicionando ou removendo cargas de trabalho e documentação de componente.You can check by following the steps in the Modify Visual Studio by adding or removing workloads and component documentation.

módulo asp.net do Visual Studio

  1. Se quiser testar seu aplicativo implantando-o a partir do Visual Studio, você precisará ter o IIS (serviços de informações da Internet) instalado em seu ambiente de desenvolvimento.If you would like test your app by deploy it from Visual Studio, you'll need to have IIS (Internet Information Services) installed in your development environment. O Visual Studio não inclui o IIS e ele não está incluído na configuração padrão do Windows 10, Windows 8 ou Windows 7; no entanto, você pode baixar a versão mais recente no centro de download da Microsoft.Visual Studio does not include IIS and it isn't included in the default Windows 10, Windows 8, or Windows 7 configuration; however, you can download the latest version from the Microsoft download center.

Exibição da página de download do IIS

Instalar o kit de ferramentas do teamsInstall the Teams Toolkit

O Microsoft Teams Toolkit para Visual Studio está disponível para download no Visual Studio Marketplace ou diretamente a partir do menu Extensions no Visual Studio.The Microsoft Teams Toolkit for Visual Studio is available for download from the Visual Studio Marketplace or directly from the Extensions menu within Visual Studio.

Usando o kit de ferramentasUsing the toolkit

Configurar um novo projeto do teamsSet up a new Teams project

  1. Selecione criar um novo projeto.Select Create a new project.
  2. Escolha aplicativo Microsoft Teams e selecione Avançar.Choose Microsoft Teams App and select Next.
  3. Você chegará à tela configurar seu novo projeto , onde você pode escolher o nome do projeto, o locale o nome da solução.You will arrive at the Configure your new project screen where you can choose the Project name, Location, and Solution name.
  4. Marque a caixa rotulada Colocar solução e projeto no mesmo diretório.Check the box labeled Place solution and project in the same directory.
  5. Uma janela pop-up com o rótulo Adicionar recursos permitirá que você escolha um ou mais recursos para a configuração do projeto.A pop-up window labeled Add Capabilities will allow you to choose one or more capabilities for your project setup.
  6. Selecione o botão Avançar para concluir o processo de configuração.Select the Next button to complete the configuration process.
  7. Uma janela pop-up com o rótulo Adicionar recursos permitirá que você escolha as propriedades para cada recurso selecionado.A pop-up window labeled Add Capabilities will allow you to choose the properties for each selected capability.
  8. Selecione concluir e você irá parar na página inicial do Microsoft Teams Toolkit .Select Finish and you will land on the Microsoft Teams Toolkit landing page.

Configurar seu aplicativoConfigure your app

Em seu núcleo, o aplicativo Teams engloba três componentes:At its core, the Teams app embraces three components:

  1. O cliente Microsoft Teams (Web, desktop ou celular) onde os usuários interagem com seu aplicativo.The Microsoft Teams client (web, desktop or mobile) where users interact with your app.
  2. Um servidor que responde às solicitações de conteúdo que será exibido no Microsoft Teams, por exemplo, o conteúdo da guia HTML ou um cartão adaptável de bot.A server that responds to requests for content that will be displayed in Teams, e.g., HTML tab content or a bot adaptive card .
  3. Um pacote de aplicativos do teams que consiste em três arquivos:A Teams app package consisting of three files:
  • O manifest.jsemThe manifest.json
  • Um ícone de cor para seu aplicativo exibir no catálogo de aplicativos públicos ou de organizaçãoA color icon for your app to display in the public or organization app catalog
  • Um ícone de estrutura de tópicos para exibição na barra de atividades do Microsoft Teams.An outline icon for display on the Teams activity bar.

Quando um aplicativo é instalado, o cliente do teams analisa o arquivo de manifesto para determinar as informações necessárias, como o nome do seu aplicativo e a URL onde os serviços estão localizados.When an app is installed, the Teams client parses the manifest file to determine needed information like the name of your app and the URL where the services are located.

Observação

Caso ainda não tenha feito isso, você precisará entrar no seu Microsoft 365 ou conta para continuar com o processo de desenvolvimento.If you haven't done so already, you will need to sign in to your Microsoft 365 or account to continue with the development process.

Se você não tem uma conta da Microsoft 365, você pode se inscrever para uma assinatura do microsoft 365 Developer Program .If you don't have a Microsoft 365 account, you can sign up for a Microsoft 365 Developer Program subscription. É grátis por 90 dias e será renovado continuamente, desde que você o esteja usando para a atividade de desenvolvimento.It's free for 90 days and will continually renew as long as you're using it for development activity. Se você tiver uma assinatura do Visual Studio Enterprise ou Professional , ambos os programas incluirão uma assinaturagratuita de desenvolvedor do Microsoft 365, ativa pela vida da sua assinatura do Visual Studio.If you have a Visual Studio Enterprise or Professional subscription, both programs include a free Microsoft 365 developer subscription, active for the life of your Visual Studio subscription. Confira Configurar uma assinatura de desenvolvedor do Microsoft 365.See Set up a Microsoft 365 developer subscription.

Etapas de configuraçãoConfiguration steps

  1. Para configurar seu aplicativo, na página inicial do Microsoft Teams Toolkit , selecione Editar pacote de aplicativos .To configure your app, on the Microsoft Teams Toolkit landing page, select Edit app package .
  2. No menu suspenso meus ambientes , selecione desenvolvimento.From the My Environments drop-down menu, select development.
  3. Você vai parar na página de detalhes do aplicativo , onde você pode editar os campos de Propriedade do seu aplicativo.You will land on the App details page where you can edit your app's property fields.
  4. A edição dos campos na página de detalhes do aplicativo atualiza o conteúdo do manifest.jsem um arquivo que será fornecido como parte do pacote de aplicativos.Editing the fields in the App details page updates the contents of the manifest.json file that will ultimately ship as part of the app package. Saiba MaisLearn more

Empacotar seu aplicativoPackage your app

A modificação da página de detalhes do aplicativo ou a atualização do manifestoou arquivos . env na pasta do seu aplicativo . publish gerará automaticamente seu arquivo de Development.zip .Modifying the app details page or updating the manifest, or .env files in your app's .publish folder will automatically generate your Development.zip file. O arquivo Development.zip inclui três arquivos necessários: o manifest.js e os dois arquivos de ícone.The Development.zip file includes three required files — the manifest.json and two icon files.

Instalar e executar o aplicativo localmenteInstall and run your app locally

  1. No menu suspenso configurações de solução , selecione implantar.From the Solution Configurations dropdown menu, select Deploy.

Menu configurações de solução

  1. Selecione o botão ISS Express + Teams .Select the ISS Express + Teams button.

  2. O Microsoft Teams será iniciado e a caixa de diálogo de instalação do aplicativo deverá aparecer no cliente do teams.Teams will launch and the app installation dialogue should appear in the Teams client.

Validar seu aplicativoValidate your app

A página validar permite verificar o pacote do aplicativo antes de enviar o aplicativo para o AppSource.The Validate page allows you to check your app package before submitting your app to AppSource. Basta carregar o pacote de manifesto e a ferramenta de validação verificará seu aplicativo em todos os casos de teste relacionados ao manifesto.Simply upload the manifest package and the validation tool will check your app against all manifest related test cases. Para cada teste com falha, a descrição fornece um link de documentação para ajudá-lo a corrigir o erro.For each failed tests, the description provides a documentation link to help you fix the error. Para os testes difíceis de automatizar, a lista de verificação preliminar detalha 7 dos casos de teste com falha mais comuns, bem como vincular a uma lista de verificação de envio completa.For the tests that are hard to automate, the Preliminary checklist details 7 of the most common failed test cases as well as link to a complete submission checklist.

Publicar seu aplicativo no TeamsPublish your app to Teams

✔ Na home page do seu projeto, você pode carregar seu aplicativo para uma equipe, enviar seu aplicativo para o repositório de aplicativos personalizado da empresa para usuários em sua organização ou enviar seu aplicativo para a origem do aplicativo para todos os usuários do teams.✔ On your project home page, you can upload your app to a team, submit your app to your company custom app store for users in your organization, or submit your app to App Source for all Teams users.

✔ Seu administrador de ti revisará esses envios.✔ Your IT admin will review these submissions.

✔ Você pode retornar à página publicar para verificar seu status de envio e saber se seu aplicativo foi aprovado ou rejeitado pelo seu administrador de ti. Este também é o local em que você vai enviar atualizações para seu aplicativo ou cancelar qualquer envio ativo no momento.✔ You can return to the Publish page to check on your submission status and learn if your app was approved or rejected by your IT admin. This is also where you'll come to submit updates to your app or cancel any currently active submissions.