Criar seu primeiro aplicativo usando C#
Inicie o desenvolvimento de aplicativos do Microsoft Teams criando seu primeiro aplicativo do Teams com uma guia, um bot ou uma funcionalidade de extensão de mensagem.
Neste tutorial, você aprenderá:
- Como configurar um novo projeto.
- Como criar aplicativos com recursos de guia usando c# e Microsoft Visual Studio 2022.
Este guia passo a passo ajuda você a criar uma guia com o Teams Toolkit. Você verá a seguinte saída depois de concluir este guia:
Pré-requisitos
Aqui está uma lista de ferramentas que você precisa instalar para criar e implantar um aplicativo do Teams.
| Instalar | Para usar... | |
|---|---|---|
| Microsoft Teams | Microsoft Teams para colaborar com todos com quem você trabalha por meio de aplicativos para chat, reuniões e chamar tudo em um só lugar. | |
|
Visual Studio 2022 |
Você pode instalar a versão corporativa no Visual Studio 2022 e instalar as cargas de trabalho ASP.NET e desenvolvimento da Web. Use a versão mais recente. | |
| Kit de ferramentas do Teams | Uma extensão do Visual Studio que cria um scaffolding de projeto para seu aplicativo. Use a versão mais recente. |
Instalar o Kit de Ferramentas do Teams
O Teams Toolkit ajuda a simplificar o processo de desenvolvimento com ferramentas para criar um scaffolding de projeto para seu aplicativo. Ele cria a estrutura de diretório necessária para todos os recursos selecionados com os arquivos necessários em vigor, prontos para criar o projeto.
Você pode baixar o instalador mais recente do Visual Studio. O Kit de Ferramentas do Teams está disponível como uma extensão no Visual Studio.
Depois de abrir o instalador do Visual Studio, na janela de cargas de trabalho pop-up.
Selecione ASP.NET e desenvolvimento web.
Em detalhes de> instalaçãoOpcional, selecione Ferramentas de desenvolvimento do Microsoft Teams.
Selecione Instalar.
Selecione Iniciar. A janela do aplicativo do Visual Studio 2022 é exibida.
Acesse Extensões>Gerenciar Extensões.
A janela Gerenciar Extensão é exibida:
No painel esquerdo, selecione Instalado. A extensão do Teams Toolkit é avaialble.
Configurar seu locatário de desenvolvimento do Teams
Um locatário é como um espaço ou um contêiner para sua organização no Teams, onde você conversa, compartilha arquivos e executa reuniões. Esse espaço também é onde você carrega e testa seu aplicativo personalizado. Vamos verificar se você está pronto para desenvolver com o locatário.
Verificar a opção de carregamento de aplicativo personalizado
Depois de criar o aplicativo, você deve carregar seu aplicativo no Teams sem distribuí-lo. Esse processo é conhecido como upload de aplicativo personalizado. Entre em sua conta do Microsoft 365 para exibir essa opção.
Observação
O upload personalizado do aplicativo é necessário para visualizar e testar aplicativos no ambiente local do Teams. Se ele não estiver habilitado, você não poderá visualizar e testar seu aplicativo no ambiente local do Teams.
Você já tem um locatário e acesso de administrador? Vamos marcar se você fizer isso!
Verifique se você pode carregar um aplicativo personalizado no Teams:
Abra o Microsoft Teams, selecione o ícone Aplicativos .
Selecione Gerenciar seus aplicativos.
Selecione Carregar um aplicativo.
Procure a opção Carregar um aplicativo personalizado . Se você vir a opção, o upload de aplicativo personalizado estará habilitado.
Observação
Se você não encontrar a opção de carregar um aplicativo personalizado, entre em contato com o administrador do Teams.
Create um locatário gratuito do desenvolvedor do Teams (opcional)
Se você não tiver uma conta do Teams, poderá obtê-la gratuitamente. Ingresse no programa de desenvolvedor do Microsoft 365!
Selecione Ingressar Agora e siga as instruções na tela.
Na tela de boas-vindas, selecione Configurar assinatura E5.
Configurar a conta de administrador. Depois de concluir, a seguinte tela será exibida:
Entre no Teams usando a conta de administrador que você configurou. Verifique se você tem a opção Carregar um aplicativo personalizado no Teams.
Obter uma conta gratuita do Azure
Se você deseja hospedar seu aplicativo ou acessar recursos no Azure, deverá ter uma assinatura do Azure. Create uma conta gratuita antes de começar.
Agora você tem todas as ferramentas para configurar sua conta. Em seguida, vamos configurar seu ambiente de desenvolvimento e começar a criar! Selecione o aplicativo que você deseja criar primeiro.
Create workspace do projeto para seu aplicativo de guia usando C#
Inicie o desenvolvimento de aplicativos do Microsoft Teams criando seu primeiro aplicativo. Este aplicativo usa o recurso de guia.
Se os pré-requisitos estiverem em vigor, vamos começar!
As etapas a seguir ajudam você a criar um workspace de projeto para seu aplicativo de guias no Visual Studio:
Abra o Visual Studio.
Selecione Novo Projeto.
Na caixa de pesquisa, insira Teams.
Selecione Microsoft Teams App>Next.
Insira os detalhes a seguir para configurar seu novo projeto.
- Insira o nome do projeto necessário no nome do projeto.
- Selecione o local necessário para salvar arquivos e pastas de projeto.
- Selecione Criar.
Selecione Tab>Create.
O aplicativo de guia Teams é criado em poucos segundos.
Faça um tour pelo código-fonte do aplicativo tab
O Teams Toolkit fornece todos os componentes para a criação de um aplicativo. Depois de criar o projeto, você pode exibir as pastas e arquivos do projeto em Gerenciador de Soluções.
Compilar e executar seu primeiro aplicativo de guia usando C#
Depois de configurar o workspace do projeto com o Teams Toolkit, crie seu aplicativo de guias.
Entre em sua conta do Microsoft 365
Use sua conta do Microsoft 365 para entrar no Teams. Se você estiver usando um locatário do programa de desenvolvedor do Microsoft 365, a conta de administrador que você configurou durante o registro é sua conta do Microsoft 365.
No Gerenciador de Soluções, em Solução MyTeamsApp, clique com o botão direito do mouse em MyTeamsApp.
Selecione Teams Toolkit>Prepare Teams App Dependencies.
Selecione Microsoft 365 Account>Continue.
Compilar e executar seu aplicativo localmente no Visual Studio
Para compilar e executar seu aplicativo localmente:
Selecione Depurar>Iniciar Depuração ou insira F5.
O Visual Studio inicia o processo de depuração e abre o cliente Web do Teams em um navegador. Se receber a solicitação, entre com sua conta do Microsoft 365.
Selecione Adicionar.
Parabéns, seu primeiro aplicativo de guia está em execução no Teams!
Saiba como solucionar problemas se o aplicativo não for executado localmente.
Para executar seu aplicativo com êxito no Teams, verifique se você habilitou o carregamento de aplicativo personalizado em sua conta do Teams. Você pode saber mais sobre o upload de aplicativo personalizado na seção Pré-requisitos .
Parabéns!
Você criou com êxito um aplicativo de guia usando C#. O Teams Toolkit adicionou o scaffolding necessário à estrutura de diretório do seu aplicativo. O tutorial já está concluído.
Tem algum problema com essa seção? Se tiver, envie seus comentários para que possamos melhorar esta seção.