Package d’application Teams

Article
12/01/2023

Un package d’application est un format de fichier qui a les ressources nécessaires pour installer et exécuter votre application dans Teams et qui doit contenir les fichiers suivants :

Manifeste de l’application : décrit comment votre application est configurée, y compris ses fonctionnalités, les ressources requises et d’autres attributs importants.
Icônes d’application : chaque package nécessite une icône de couleur et de plan pour votre application.

Pour distribuer votre application Microsoft Teams, vous devez compresser les fichiers dans le dossier du package d’application et fournir un nom approprié.

Teams n’héberge pas votre application

Lorsqu’un utilisateur installe votre application dans Teams, il installe un package d’application qui contient un seul fichier de configuration (également appelé manifeste d’application) et les icônes de votre application. La logique de l’application et le stockage des données sont hébergés ailleurs, par exemple sur localhost pendant le développement et sur Azure Web Services. Teams accède à ces ressources via HTTPS.

Illustration montrant l’hébergement d’applications pour Application Teams

Manifeste d'application

Un manifeste d’application décrit la configuration de votre application, notamment ses fonctionnalités, ses ressources requises et d’autres attributs significatifs portant le nom manifest.json dans le package d’application.

Vous pouvez créer une application et configurer le manifeste de l’application via l’une des plateformes suivantes :

Kit de ressources Teams : ensemble d’outils et d’extensions dans Microsoft Visual Studio Code et Visual Studio pour créer, déboguer et déployer une application. Lors de la création d’une application, le manifeste de l’application est généré à partir d’un fichier de modèle basé sur les fonctionnalités sélectionnées. Vous pouvez ensuite personnaliser dans Visual Studio Code ou Visual Studio en fonction de vos besoins, valider le fichier manifeste et compresser le package d’application.
Portail des développeurs Teams : plateforme web qui vous permet de créer votre application, de configurer votre manifeste d’application et de générer un package d’application. Pour créer une application via le portail des développeurs Teams, consultez Créer et inscrire une application.

Vous pouvez ajouter un bot, un onglet, des extensions de message et d’autres fonctionnalités à votre application en mettant à jour le manifeste de l’application avec la fonctionnalité d’application requise. Pour plus d’informations, consultez Créer une application avec des fonctionnalités d’application.

Lorsque vous publiez votre application dans le Microsoft Teams Store, vérifiez que votre manifeste d’application fait référence au schéma de manifeste d’application le plus récent. Pour obtenir un exemple de manifeste d’application, consultez Exemple d’application Hello World.

Icônes d’application

Votre package de l’application doit inclure deux versions de format PNG de l’icône de votre application : une version de couleur et une version de contour.

Remarque

Si votre application a une extension de bot ou de message, vos icônes sont incluses dans votre inscription Microsoft Azure Bot Service.

Pour que votre application passe la révision du Magasin Teams, ces icônes doivent répondre aux exigences de taille suivantes.

Icône de couleur

La version de couleur de votre icône s’affiche dans la plupart des scénarios Teams et doit être de 192x192 pixels. Le symbole de votre icône (96 x 96 pixels) peut être de n’importe quelle couleur, mais il doit se trouver sur un arrière-plan carré plein ou entièrement transparent.

Teams rogne automatiquement votre icône pour afficher un carré avec des coins arrondis dans plusieurs scénarios et une forme hexagonale dans les scénarios de bot. Pour rogner le symbole sans perdre de détail, incluez 48 pixels de remplissage autour de votre symbole.

Icône de contour

Une icône de contour s’affiche dans deux scénarios :

Lorsque votre application est en cours d’utilisation et « hissée » dans la barre de l’application sur le côté gauche de Teams.
Lorsqu’un utilisateur épingle l’extension de message de votre application.

Vérifiez que l’icône est de 32 x 32 pixels. Il doit être blanc avec un arrière-plan transparent ou transparent avec un arrière-plan blanc. Aucune autre couleur n’est autorisée. L’icône de contour ne doit pas contenir de remplissage supplémentaire autour du symbole.

Meilleures pratiques

À faire : suivez les instructions précises sur les icônes de contour

Les valeurs RVB de blanc utilisées dans votre icône doivent être Rouge : 255, Vert : 255, Bleu : 255. Toutes les autres parties de l’icône de contour doivent être entièrement transparentes, avec le canal alpha sur 0.

À ne pas faire : rogner dans une forme circulaire ou carrée arrondie

L’icône de couleur envoyée dans votre package de l’application doit être carrée. N’arrondissez pas les coins de votre icône. Teams ajuste automatiquement le rayon de l’angle.

À ne pas faire : copier d’autres marques

Vos icônes ne doivent pas imiter les produits protégés par des droits d’auteur que vous ne possédez pas. Par exemple, une conception similaire à un produit ou une marque Microsoft.