Pacote de aplicativos teams
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.
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.
Se você estiver usando o Kit de Ferramentas do Teams para desenvolver um aplicativo, o manifesto do aplicativo gera a partir de um arquivo de modelo com base nos recursos selecionados ao desenvolver o aplicativo. Em seguida, você pode personalizar o arquivo de manifesto no Microsoft Visual Studio Code ou no Microsoft Visual Studio com base em seus requisitos. Você também pode fechar o pacote do aplicativo e validar o arquivo de manifesto do aplicativo no Teams Toolkit.
Ao publicar na Microsoft Teams Store, verifique se o manifesto faz referências ao esquema mais recente.
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.
Referência de código de exemplo para manifesto de aplicativo
Í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.
Exemplos
Veja como os ícones de aplicativo aparecem em diferentes recursos e contextos do Teams.
Aplicativo pessoal
Bot (canal)
Extensão de mensagem
Próxima etapa
Escolha como você planeja distribuir seu aplicativo: