Pacote de aplicativos teams

Artigo
12/01/2023

Um pacote de aplicativo é um formato de arquivo que tem os recursos necessários para instalar e executar seu aplicativo no Teams e deve conter os seguintes arquivos:

Manifesto do aplicativo: descreve como seu aplicativo está configurado, incluindo seus recursos, recursos necessários e outros atributos importantes.
Ícones do aplicativo: cada pacote requer um ícone de cor e contorno para seu aplicativo.

Para distribuir seu aplicativo microsoft teams, você precisa fechar os arquivos na pasta de pacote de aplicativo e fornecer um nome adequado.

O Teams não hospeda seu aplicativo

Quando um usuário instala seu aplicativo no Teams, instala um pacote de aplicativo que contém apenas um arquivo de configuração (também conhecido como manifesto do aplicativo) e os ícones do aplicativo. A lógica e o armazenamento de dados do aplicativo são hospedados em outro lugar, como no localhost durante o desenvolvimento e nos Serviços Web do Azure. O Teams acessa esses recursos via HTTPS.

Ilustração mostrando a hospedagem de aplicativos para aplicativos do Teams

Manifesto do aplicativo

Um manifesto de aplicativo descreve a configuração do aplicativo, incluindo seus recursos, recursos necessários e outros atributos significativos com o nome manifest.json no pacote de aplicativos.

Você pode criar um aplicativo e configurar o manifesto do aplicativo por meio de uma das seguintes plataformas:

Kit de Ferramentas do Teams: um conjunto de ferramentas e extensões no Microsoft Visual Studio Code e no Visual Studio para criar, depurar e implantar um aplicativo. Ao criar um aplicativo, o manifesto do aplicativo gera a partir de um arquivo de modelo com base nos recursos selecionados. Em seguida, você pode personalizar em Visual Studio Code ou Visual Studio com base em seus requisitos, validar o arquivo de manifesto e fechar o pacote do aplicativo.
Portal do Desenvolvedor do Teams: uma plataforma baseada na Web que ajuda você a criar seu aplicativo, configurar o manifesto do aplicativo e gerar um pacote de aplicativos. Para criar um aplicativo por meio do Portal do Desenvolvedor do Teams, consulte criar e registrar um aplicativo.

Você pode adicionar bot, guia, extensões de mensagem e outros recursos ao seu aplicativo atualizando o manifesto do aplicativo com o recurso de aplicativo necessário. Para obter mais informações, confira criar aplicativo com recursos de aplicativo.

Ao publicar seu aplicativo na Microsoft Teams Store, verifique se o manifesto do aplicativo faz referências ao esquema de manifesto do aplicativo mais recente. Para o manifesto do aplicativo de exemplo, consulte Hello world sample app.

Ícones do aplicativo

Seu pacote de aplicativos deve incluir duas versões .png do ícone de seu aplicativo: Uma versão colorida e de contorno.

Observação

Se seu aplicativo tiver um bot ou uma extensão de mensagem, seus ícones serão incluídos no registro do Microsoft Azure Serviço de Bot.

Para que seu aplicativo passe pela revisão da Teams Store, esses ícones devem atender aos requisitos de tamanho a seguir.

Ícone de cor

A versão colorida do seu ícone é exibida na maioria dos cenários do Teams e deve ter 192 x 192 pixels. Seu símbolo de ícone (96 x 96 pixels) pode ser qualquer cor, mas deve estar em um plano de fundo quadrado sólido ou totalmente transparente.

O Teams corta automaticamente seu ícone para exibir um quadrado com cantos arredondados em vários cenários e uma forma hexagonal em cenários do bot. Para cortar o símbolo sem perder detalhes, inclua 48 pixels de preenchimento ao redor do símbolo.

Ícone de contorno

Um ícone de contorno é exibido em dois cenários:

Quando seu aplicativo estiver em uso e "hospedado" na barra de aplicativos no lado esquerdo do Teams.
Quando um usuário fixa a extensão de mensagens do aplicativo.

Verifique se o ícone é de 32x32 pixels. Ele deve ser branco com um plano de fundo transparente ou transparente com um fundo branco. Nenhuma outra cor é permitida. O ícone de contorno não deve conter nenhum preenchimento adicional ao redor do símbolo.

Práticas recomendadas

Fazer: siga as diretrizes precisas do ícone de contorno

Os valores RGB de branco usados no seu ícone devem ser vermelho: 255, verde: 255,azul: 255. Todas as outras partes do ícone de contorno devem ser totalmente transparentes, com o canal alfa definido como 0.

Não: corte em uma forma quadrada circular ou arredondada

O ícone de cor enviado no pacote do aplicativo deve ser quadrado. Não arredonde os cantos do ícone. O Teams ajusta automaticamente o raio do canto.

Não: copiar outras marcas

Seus ícones não devem imitar produtos protegidos pelos direitos autorais que você não possui. Por exemplo, um design semelhante a um produto ou marca da Microsoft.