Pré-requisitos para criar seu aplicativo do Teams
Antes de criar seu projeto de aplicativo do Microsoft Teams, verifique se os pré-requisitos estão em vigor. Você deve:
- Instalar ferramentas necessárias para criar seu aplicativo teams
- Preparar contas para criar seu aplicativo teams
- Verificar a permissão de carregamento de aplicativo personalizado
Instalar ferramentas necessárias para criar seu aplicativo teams
Verifique se os seguintes requisitos são atendidos antes de começar a criar seu aplicativo teams:
Ferramentas | Objetivo | Para tipo de ambiente | |
---|---|---|---|
Required | |||
Kit de ferramentas do Teams | Uma extensão do Microsoft Visual Studio Code que cria um scaffolding de projeto para seu aplicativo. Use a versão mais recente. | JavaScript e SPFx | |
Microsoft Teams | Colabore com todos com quem você trabalha por meio de aplicativos para chat, reuniões e chamadas - tudo em um só lugar. | JavaScript e SPFx | |
Node.js | Ambiente de runtime do JavaScript de back-end. Para obter mais informações, consulte Node.js tabela de compatibilidade de versão para o tipo de projeto. | JavaScript e SPFx | |
NPM (Gerenciador de Pacotes de Nós) | Instale e gerencie pacotes para uso em aplicativos Node.js e ASP.NET Core. | JavaScript e SPFx | |
Microsoft Edge (recomendado) ou Google Chrome | Um navegador com ferramentas de desenvolvedor. | JavaScript e SPFx | |
Microsoft Visual Studio Code | Ambientes de build JavaScript, TypeScript ou SPFx. Use a versão mais recente. | JavaScript e SPFx | |
Opcional | |||
Ferramentas do Azure para Visual Studio Code e CLI do Azure | Acesse dados armazenados ou implante um back-end baseado em nuvem para seu aplicativo teams no Azure. | JavaScript | |
React Ferramentas de Desenvolvedor para Chrome ou React Ferramentas de Desenvolvedor para Microsoft Edge | Uma extensão DevTools do navegador para a biblioteca JavaScript React de código aberto. | JavaScript | |
Microsoft Graph Explorer | Uma ferramenta baseada no navegador que permite executar uma consulta de dados do Microsoft Graph. | JavaScript e SPFx | |
Portal do Desenvolvedor do Teams | Um portal baseado na Web para configurar, gerenciar e distribuir seu aplicativo teams para sua organização ou para a Teams Store. | JavaScript e SPFx |
Contas para criar seu aplicativo do Teams
Verifique se você tem as seguintes contas antes de começar a criar seu aplicativo do Teams:
Contas | Objetivo | Para tipo de ambiente |
---|---|---|
Conta corporativa ou escolar do Microsoft 365 | Conta de desenvolvedor do Teams durante o desenvolvimento de um aplicativo. | JavaScript, TypeScript, SPFx e C# ou Blazor. |
Conta do Azure | Recursos de back-end no Azure. | JavaScript, TypeScript, SPFx e C# ou Blazor. |
Conta de administrador do site de coleção do SharePoint | Implantação para hospedagem. | SPFx. |
Programa para desenvolvedores do Microsoft 365
Observação
Para criar aplicativos do Teams, você deve ter uma conta do Microsoft 365 do trabalho ou da escola. O Microsoft 365 conta pessoal não pode ser usado.
Se você tiver uma assinatura do Visual Studio Enterprise ou Professional, ambos os programas incluem uma assinatura de desenvolvedor gratuita do Microsoft 365. Ele estará ativo desde que sua assinatura do Visual Studio esteja ativa. Para obter mais informações, consulte Assinatura de desenvolvedor do Microsoft 365.
Se você não tiver nenhum locatário do Microsoft 365, poderá se qualificar para uma assinatura de desenvolvedor Microsoft 365 E5 por meio do Programa de Desenvolvedores do Microsoft 365; para obter detalhes, consulte as perguntas frequentes. Como alternativa, você pode se inscrever para uma avaliação gratuita de 1 mês ou comprar um plano do Microsoft 365.
Você pode se inscrever no programa de desenvolvedor usando um dos seguintes tipos de conta:
Conta da Microsoft para uso pessoal
A conta microsoft fornece acesso aos produtos e serviços de nuvem da Microsoft, como Outlook, Messenger, OneDrive, MSN, Xbox Live ou Microsoft 365.
Inscreva-se em uma caixa de correio Outlook.com para criar uma conta do Microsoft 365. Use-o para acessar serviços de nuvem da Microsoft relacionados ao consumidor ou ao Azure.
Conta de trabalho da Microsoft para empresas
Essa conta fornece acesso a todos os serviços de nuvem microsoft pequenos, médios e empresariais de nível empresarial. Os serviços incluem O Azure, Microsoft Intune e Microsoft 365.
Quando você se inscreve em um desses serviços como uma organização, um diretório baseado em nuvem é provisionado automaticamente em Microsoft Entra ID para representar sua organização.
Criar uma conta de desenvolvedor gratuita do Microsoft 365
Para criar uma conta de desenvolvedor gratuita do Microsoft 365:
Selecione Ingressar agora.
Configure sua assinatura de conta de administrador.
Após a conclusão da assinatura, as seguintes informações serão exibidas:
Conta do Azure
Uma conta do Azure permite hospedar um aplicativo do Teams ou os recursos de back-end do seu aplicativo do Teams no Azure. Você pode fazer isso usando o Teams Toolkit no Visual Studio Code. Você deve ter uma assinatura do Azure nos seguintes cenários:
- Se você já tiver um aplicativo existente em um provedor de nuvem diferente do Azure e quiser integrar o aplicativo na plataforma do Teams.
- Se você quiser hospedar os recursos de back-end para seu aplicativo usando outro provedor de nuvem ou em seus próprios servidores, se eles estiverem disponíveis no domínio público.
Observação
Você pode usar a conta do Azure para provisionar o recurso do Azure para hospedar seu aplicativo do Teams. Você pode criar uma conta gratuita caso não tenha nenhuma. Se você não usar o Teams Toolkit para provisionar e implantar, a conta do Azure não será necessária.
Conta de administrador do site de coleção do SharePoint
Ao criar o aplicativo Teams usando o ambiente SPFx, você deve ter uma conta de administrador do site de coleção do SharePoint. Ele é necessário para implantar e hospedar seu aplicativo no site do SharePoint. Se você estiver usando um locatário do programa de desenvolvedor do Microsoft 365, poderá usar a conta de administrador que você criou no momento.
Verificar a permissã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.
Você pode verificar se a permissão de carregamento do aplicativo está habilitada usando Visual Studio Code ou cliente do Teams.
Verificar a permissão de carregamento de aplicativo personalizado usando Visual Studio Code
Você pode usar esse método para verificar a permissão de carregamento de aplicativo personalizado somente depois de criar um projeto de aplicativo usando o Teams Toolkit. Se você ainda não criou um projeto de aplicativo, poderá verificar a permissão de carregamento de aplicativo personalizado usando o cliente do Teams.
Abra o Visual Studio Code.
Selecione Kit de Ferramentas do Teams na barra de atividades Visual Studio Code.
Observação
Se você não conseguir ver a opção, consulte instalar o Teams Toolkit para instalar a extensão do Teams Toolkit no Visual Studio Code.
Crie um novo projeto de aplicativo do Teams Toolkit ou abra um projeto de aplicativo existente.
Selecione Entrar no Microsoft 365 em CONTAS.
Verifique se você pode ver a opção Sideloading habilitada , conforme mostrado na imagem a seguir:
Verificar a permissão de carregamento de aplicativo personalizado usando o cliente do Teams
No cliente do Teams, selecione Aplicativos>Gerenciar seus aplicativos>Carregar um aplicativo.
Verifique se você pode ver a opção Carregar um aplicativo personalizado.
Habilitar o upload de aplicativo personalizado usando o centro de administração
Se a opção de carregamento de aplicativo personalizado não estiver visível na extensão do Teams Toolkit no Visual Studio Code ou se a opção de carregar um aplicativo personalizado não estiver disponível no Teams, isso indica que você não tem a permissão necessária para carregamento de aplicativo personalizado.
Você deve habilitar o upload de aplicativo personalizado no Teams:
- Se você for um administrador de locatário, habilite a configuração de carregamento de aplicativo personalizado para seu locatário ou organização no centro de administração do Teams.
- Se você não for um administrador de locatário, entre em contato com o administrador do locatário para habilitar o carregamento personalizado do aplicativo.
Se você tiver direitos de administrador, poderá habilitar o upload de aplicativo personalizado:
Acessar o Centro de administração do Microsoft 365 com suas credenciais de administrador.
Selecione o ícone >Teams.
Observação
Pode levar até 24 horas para a opção Teams ser exibida. Você pode carregar seu aplicativo personalizado em um ambiente do Teams para teste e validação.
Entre no centro de administração do Microsoft Teams com suas credenciais de administrador.
Selecione o ícone >Políticas de instalaçãode aplicativos> do Teams.
Selecione Global (padrão em toda a organização).
Defina Carregar aplicativos personalizados como Ativado.
Selecione Salvar.
Observação
Pode levar até 24 horas para que o upload de aplicativo personalizado se torne ativo. Enquanto isso, você pode usar carregamento do seu locatário para testar seu aplicativo. Para carregar o arquivo do pacote .zip do aplicativo, consulte Carregar aplicativos personalizados.
Verifique se você tem a permissão de carregamento do aplicativo usando as etapas mencionadas na verificação da permissão de carregamento de aplicativo personalizado usando Visual Studio Code ou cliente do Teams.
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários