Paquete de aplicación de Teams

Artículo
12/01/2023

Un paquete de aplicación es un formato de archivo que tiene los recursos necesarios para instalar y ejecutar la aplicación en Teams y debe contener los siguientes archivos:

Manifiesto de aplicación: describe cómo se configura la aplicación, incluidas sus funcionalidades, los recursos necesarios y otros atributos importantes.
Iconos de aplicación: cada paquete requiere un icono de color y contorno para la aplicación.

Para distribuir la aplicación de Microsoft Teams, debe comprimir los archivos en la carpeta del paquete de la aplicación y proporcionar un nombre adecuado.

Teams no hospeda su aplicación

Cuando un usuario instala la aplicación en Teams, instala un paquete de aplicación que solo contiene un archivo de configuración (también conocido como manifiesto de aplicación) y los iconos de la aplicación. La lógica y el almacenamiento de datos de la aplicación se hospedan en otro lugar, por ejemplo, en localhost durante el desarrollo y en los servicios web de Azure. Teams accede a estos recursos a través de HTTPS.

Ilustración que muestra el hospedaje de aplicaciones para aplicación de Teams

Manifiesto de la aplicación

Un manifiesto de aplicación describe la configuración de la aplicación, incluidas sus funcionalidades, los recursos necesarios y otros atributos significativos con el nombre manifest.json en el paquete de la aplicación.

Puede crear una aplicación y configurar el manifiesto de la aplicación a través de una de las siguientes plataformas:

Kit de herramientas de Teams: un conjunto de herramientas y extensiones en Microsoft Visual Studio Code y Visual Studio para crear, depurar e implementar una aplicación. Al crear una aplicación, el manifiesto de la aplicación genera a partir de un archivo de plantilla en función de las funcionalidades seleccionadas. Después, puede personalizar en Visual Studio Code o Visual Studio según sus requisitos, validar el archivo de manifiesto y comprimir el paquete de la aplicación.
Portal para desarrolladores de Teams: una plataforma basada en web que le ayuda a crear la aplicación, configurar el manifiesto de la aplicación y generar un paquete de aplicación. Para crear una aplicación a través del Portal para desarrolladores de Teams, consulte Creación y registro de una aplicación.

Puede agregar bot, pestaña, extensiones de mensaje y otras funcionalidades a la aplicación actualizando el manifiesto de la aplicación con la funcionalidad de aplicación necesaria. Para obtener más información, consulte Compilación de una aplicación con funcionalidades de aplicación.

Al publicar la aplicación en microsoft Teams Store, asegúrese de que las referencias de manifiesto de la aplicación al esquema de manifiesto de aplicación más reciente. Para ver un manifiesto de aplicación de ejemplo, consulte Aplicación de ejemplo Hola mundo.

Iconos de la aplicación

El paquete de la aplicación debe incluir dos versiones .png del icono de la aplicación: una versión de color y contorno.

Nota:

Si la aplicación tiene un bot o una extensión de mensaje, los iconos se incluyen en el registro de Microsoft Azure Bot Service.

Para que la aplicación pase la revisión de la Tienda Teams, estos iconos deben cumplir los siguientes requisitos de tamaño.

Icono de color

La versión en color de su icono se muestra en la mayoría de los escenarios de Teams y debe tener 192x192 píxeles. El símbolo de icono (96 x 96 píxeles) puede ser cualquier color, pero debe situarse sobre un fondo cuadrado sólido o totalmente transparente.

Teams recorta automáticamente el icono para mostrar un cuadrado con esquinas redondeadas en varios escenarios y una forma hexagonal en escenarios de bot. Para recortar el símbolo sin perder ningún detalle, incluya 48 píxeles de relleno alrededor del símbolo.

Icono de esquema

Un icono de esquema se muestra en dos escenarios:

Cuando la aplicación está en uso y “hospedada” en la barra de aplicaciones del lado izquierdo de Teams.
Cuando un usuario ancla la extensión de mensaje de la aplicación.

Asegúrese de que el icono es de 32 x 32 píxeles. Debe ser blanco con un fondo transparente o transparente con un fondo blanco. No se permiten otros colores. El icono de esquema no debe contener ningún relleno adicional alrededor del símbolo.

Procedimientos recomendados

Hacer: seguir las directrices precisas del icono de esquema

Los valores RGB de blanco usados en el icono deben ser Rojo: 255, Verde: 255, Azul: 255. Todas las demás partes del icono de esquema deben ser totalmente transparentes, con el canal alfa establecido en 0.

No: recortar con una forma cuadrada circular o redondeada

El icono de color enviado en el paquete de la aplicación debe ser cuadrado. No redondee las esquinas del icono. Teams ajusta automáticamente el radio de la esquina.

No: copiar otras marcas

Los iconos no deben imitar ningún producto protegido por derechos de autor que no posea. Por ejemplo, un diseño similar a un producto o marca de Microsoft.