Compartilhar via


Pré-requisitos para criar a sua aplicação Teams

Antes de criar o projeto da aplicação Microsoft Teams, certifique-se de que os pré-requisitos estão implementados. Você deve:

Instalar as ferramentas necessárias para criar a sua aplicação Teams

Certifique-se de que os seguintes requisitos são cumpridos antes de começar a criar a sua aplicação Teams:

  Ferramentas Objetivo Para o tipo de ambiente
Required      
  Kit de ferramentas do Teams Uma extensão do Microsoft Visual Studio Code que cria um projeto estruturado para a sua aplicação. Utilize a versão mais recente. JavaScript e SPFx
  Microsoft Teams Colabore com todas as pessoas com quem trabalha através de aplicações para conversas, reuniões e chamadas, tudo num único local. JavaScript e SPFx
  Node.js Ambiente de runtime do JavaScript de back-end. Para obter mais informações, veja Node.js tabela de compatibilidade de versões para o tipo de projeto. JavaScript e SPFx
  Gestor de Pacotes de Nós (NPM) Instale e faça a gestão de pacotes para utilização em aplicações 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 compilação JavaScript, TypeScript ou SPFx. Utilize a versão mais recente. JavaScript e SPFx
Opcional      
  Ferramentas do Azure para Visual Studio Code e CLI do Azure Aceda a dados armazenados ou implemente um back-end baseado na cloud para a sua aplicação Teams no Azure. JavaScript
  React Developer Tools for Chrome or React Developer Tools for Microsoft Edge (Ferramentas de Programação do React para Chrome ou React Developer Tools para Microsoft Edge) Uma extensão DevTools do browser para a biblioteca DevTools do React JavaScript de código aberto. JavaScript
  Microsoft Graph Explorer Uma ferramenta baseada no browser que lhe permite executar uma consulta a partir de dados do Microsoft Graph. JavaScript e SPFx
  Portal do Desenvolvedor do Teams Um portal baseado na Web para configurar, gerir e distribuir a sua aplicação Teams para a sua organização ou para a Loja Teams. JavaScript e SPFx

Contas para criar a sua aplicação Teams

Certifique-se de que tem as seguintes contas antes de começar a criar a sua aplicação Teams:

Contas Objetivo Para o tipo de ambiente
Conta escolar ou profissional do Microsoft 365 Conta de programador do Teams ao desenvolver uma aplicação. 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 Implementação para alojamento. SPFx.

Programa para desenvolvedores do Microsoft 365

Observação

Para criar aplicações do Teams, tem de ter uma conta escolar ou profissional do Microsoft 365. Não é possível utilizar a conta pessoal do Microsoft 365.

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 não tiver nenhum inquilino do Microsoft 365, poderá qualificar-se para uma subscrição de programador do Microsoft 365 E5 através do Programa para Programadores do Microsoft 365; para obter detalhes, veja as FAQ. Em alternativa, pode inscrever-se numa avaliação gratuita de um mês ou comprar um plano do Microsoft 365.

Pode inscrever-se no programa de programador com um dos seguintes tipos de conta:

  • Conta da Microsoft para uso pessoal

    A conta Microsoft fornece acesso aos produtos e serviços cloud da Microsoft, como o Outlook, Messenger, OneDrive, MSN, Xbox Live ou Microsoft 365.

    Inscreva-se numa caixa de correio Outlook.com para criar uma conta do Microsoft 365. Utilize-a para aceder aos serviços cloud da Microsoft ou ao Azure relacionados com o consumidor.

    Captura de ecrã a mostrar o ícone da conta pessoal.

  • Conta de trabalho da Microsoft para empresas

    Esta conta fornece acesso a todos os serviços cloud da Microsoft de nível empresarial pequeno, médio e empresarial. Os serviços incluem o Azure, o Microsoft Intune e o Microsoft 365.

    Quando se inscreve num destes serviços como uma organização, é aprovisionado automaticamente um diretório baseado na cloud no Microsoft Entra ID para representar a sua organização.

    Captura de ecrã a mostrar o ícone da conta profissional.

Criar uma conta de programador gratuita do Microsoft 365

Para criar uma conta de programador gratuita do Microsoft 365:

  1. Acesse o Programa para desenvolvedores do Microsoft 365.

  2. Selecione Ingressar agora.

  3. Configure a subscrição da conta de administrador.

    Após a conclusão da subscrição, são apresentadas as seguintes informações:

    Captura de ecrã a mostrar as opções de subscrição da Conta M365.

Conta do Azure

Uma conta do Azure permite-lhe alojar uma aplicação do Teams ou os recursos de back-end da sua aplicação Teams no Azure. Pode fazê-lo com o Teams Toolkit no Visual Studio Code. Tem de ter uma subscrição do Azure nos seguintes cenários:

  • Se já tiver uma aplicação existente num fornecedor de cloud diferente do Azure e quiser integrar a aplicação na plataforma teams.
  • Se quiser alojar os recursos de back-end da sua aplicação com outro fornecedor de cloud ou nos seus próprios servidores, se estiverem disponíveis no domínio público.

Observação

Pode utilizar a conta do Azure para aprovisionar o recurso do Azure para alojar a sua aplicação Teams. Pode criar uma conta gratuita caso não tenha nenhuma. Se não utilizar o Teams Toolkit para aprovisionar e implementar, a conta do Azure não é necessária.

Conta de administrador do site de coleção do SharePoint

Ao criar a aplicação Teams com o ambiente SPFx, tem de ter uma conta de administrador do site de coleção do SharePoint. É necessário para implementar e alojar a sua aplicação no site do SharePoint. Se estiver a utilizar um inquilino de programador do Microsoft 365, pode utilizar a conta de administrador que criou na altura.

Verificar a permissão de carregamento de aplicações personalizadas

Depois de criar o aplicativo, você deve carregar seu aplicativo no Teams sem distribuí-lo. Este processo é conhecido como carregamento de aplicações personalizadas. Inicie sessão na sua conta do Microsoft 365 para ver esta opção.

Pode verificar se a permissão de carregamento da aplicação está ativada com o Visual Studio Code ou o cliente do Teams.


Verificar a permissão de carregamento de aplicações personalizadas com o Visual Studio Code

Pode utilizar este método para verificar a permissão de carregamento de aplicações personalizadas apenas depois de ter criado um projeto de aplicação com o Teams Toolkit. Se ainda não criou um projeto de aplicação, pode verificar a permissão de carregamento de aplicações personalizadas com o cliente do Teams.

  1. Abra o Visual Studio Code.

  2. Selecione Teams Toolkit na barra de atividade do Visual Studio Code.

    Observação

    Se não conseguir ver a opção, consulte Instalar o Teams Toolkit para instalar a extensão do Teams Toolkit no Visual Studio Code.

  3. Crie um novo projeto de aplicação do Teams Toolkit ou abra um projeto de aplicação existente.

  4. Selecione Iniciar sessão no Microsoft 365 emCONTAS.

    Captura de ecrã a mostrar os detalhes das contas.

  5. Verifique se consegue ver a opção Sideloading ativada , conforme mostrado na imagem seguinte:

    Captura de ecrã a mostrar a opção ativada para carregamento de aplicações personalizada realçada a vermelho.


Verificar a permissão de carregamento de aplicações personalizadas com o cliente do Teams
  1. No cliente do Teams, selecione Aplicações>Gerir as suas aplicações>Carregar uma aplicação.

    Captura de ecrã a mostrar a opção para carregar uma aplicação no Teams.

  2. Verifique se consegue ver a opção Carregar uma aplicação personalizada.

    Captura de ecrã a mostrar a opção para carregar uma aplicação personalizada no Teams.

Ativar o carregamento de aplicações personalizadas com o centro de administração

Se a opção de carregamento de aplicações personalizadas não estiver visível na extensão do Teams Toolkit no Visual Studio Code ou se a opção para carregar uma aplicação personalizada não estiver disponível no Teams, significa que não tem a permissão necessária para o carregamento de aplicações personalizadas.

Tem de ativar o carregamento de aplicações personalizadas no Teams:

  • Se for um administrador de inquilinos, ative a definição de carregamento de aplicações personalizadas para o seu inquilino ou organização no centro de administração do Teams.
  • Se não for um administrador de inquilinos, contacte o administrador do inquilino para ativar o carregamento de aplicações personalizadas.

Se tiver direitos de administrador, pode ativar o carregamento de aplicações personalizadas:

  1. Acessar o Centro de administração do Microsoft 365 com suas credenciais de administrador.

  2. Selecione o ícone >Teams.

    Captura de ecrã a mostrar o cliente do Teams no painel esquerdo do Centro de administração do Microsoft 365.

    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.

  3. Inicie sessão no centro de administração do Microsoft Teams com as suas credenciais de administrador.

  4. Selecione o ícone >Políticas de configuração de aplicações> do Teams.

    Captura de ecrã a mostrar as políticas de Configuração em Aplicações do Teams no Centro de administração do Microsoft 365.

  5. Selecione Global (predefinição em toda a organização).

    Captura de ecrã a mostrar o separador Gerir políticas com a opção Global (predefinição de toda a organização) realçada.

  6. Defina a opção Carregar aplicações personalizadas como Ativado.

    Captura de ecrã a mostrar o botão de alternar Carregar aplicações personalizadas realçado.

  7. Selecione Salvar.

    Observação

    Pode demorar até 24 horas para que o carregamento de aplicações personalizadas 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.

    Certifique-se de que tem a permissão de carregamento da aplicação através dos passos mencionados em Verificar a permissão de carregamento de aplicações personalizadas com o Visual Studio Code ou o cliente do Teams.

Confira também