Desarrollo de widgets y paneles de Windows

Widgets

Windows widgets son contenedores de interfaz de usuario pequeños asociados a una aplicación instalada. El Panel de widgets los muestra en una cuadrícula sobre el escritorio de Windows, con contenido personalizado y acciones rápidas de tu aplicación. Puede definir contenido con Tarjetas adaptables, que enlazan datos a una plantilla JSON o muestran HTML desde una dirección URL con un proveedor de widgets web. Los widgets web siguen usando una carga JSON de Adaptive Card para especificar la dirección URL del contenido.

Para obtener instrucciones de diseño, consulte Windows Información general sobre el diseño de widgets.

Elección de una ruta de desarrollo de widgets

Use esta tabla para seleccionar la ruta de implementación y el siguiente tema que se va a abrir.

Si quieres...	Uso de este enfoque	Comience aquí
Agregar un widget de tarjeta adaptable a una aplicación de escritorio de C# empaquetada	Implemente IWidgetProvider, envíe actualizaciones de plantilla y datos con WidgetManager y registre el proveedor a través del manifiesto del paquete.	Tutorial del proveedor de widgets de C#
Agregar un widget de Adaptive Card a una aplicación de escritorio de C++/WinRT empaquetada	Implemente IWidgetProvider en el servidor COM fuera de proceso y registre su CLSID y las definiciones del widget en el manifiesto del paquete.	Tutorial del proveedor de widgets de C++/WinRT
Mostrar HTML desde una dirección URL dentro de un widget de escritorio	Usa un proveedor de widgets web. Esta característica está disponible solo para los usuarios del EEE. El proveedor sigue enviando una carga de Adaptive Card que contiene la dirección URL web y el contenido alternativo.	Proveedores de widgets web
Agregar un widget para una aplicación web progresiva existente (PWA)	Defina el widget en el manifiesto de la aplicación web y controle los eventos del widget en el worker de servicio. Esto es independiente de la ruta de IWidgetProvider de escritorio.	Creación de widgets controlados mediante PWA
Gestionar un botón o una acción de formulario en el proveedor de escritorio	Use Action.Execute y gestione el verbo en OnActionInvoked. Mostrarlo solo cuando $host.isUserContextAuthenticated es true.	Crear una plantilla de widget
Abrir una página de aplicación o un sitio web sin un callback del proveedor	Usa Action.OpenUrl. Esto permanece disponible cuando el contexto de usuario del widget no está autenticado.	Crear una plantilla de widget
Permitir que los usuarios configuren un widget	Implemente IWidgetProvider2, establezca el atributo IsCustomizable del manifiesto y proporcione una carga de personalización.	Implementar la personalización de widgets
Adaptar contenido para tamaño, tema, configuración, encabezado, soporte web o autenticación	Use las propiedades $host de Windows en la plantilla de Adaptive Card y declare todos los tamaños admitidos en el manifiesto del paquete.	propiedades del host del widget de Windows
Mostrar contenido de carga o de sesión cerrada	Envíe una plantilla y datos de reserva deliberados. Establezca IsPlaceholderContent cuando el contenido aún no se personalice ni sea accionable.	Proveedores de widgets
Agregar un feed del panel en lugar de un widget individual	Implemente un proveedor de feeds. Los proveedores de feeds son una integración independiente y solo están disponibles en el EEE.	Paneles y proveedores de fuentes
Pida a GitHub Copilot crear y validar un widget	Use la indicación reutilizable, que selecciona una ruta compatible y requiere la validación del paquete, el manifiesto, la compilación y Panel de widgets.	Crea un widget de Windows con GitHub Copilot

Dashboards

Los proveedores de fuentes registran fuentes de contenido que aparecen como paneles en Panel de widgets. Un proveedor de feeds es una integración independiente de un proveedor de widgets; mostrar HTML dentro de un widget no registra un feed del panel.

Important

Los proveedores de fuentes están disponibles solo para los usuarios del Espacio Económico Europeo (EEE). Para conocer los requisitos de disponibilidad e implementación, consulte Paneles y proveedores de feeds.

En esta sección

Tema	Descripción
Proveedores de fuentes	Obtenga información sobre cómo registrar las fuentes de contenido de la aplicación para que aparezcan directamente en el panel de widgets de Windows.
Proveedores de widgets	Obtenga información sobre cómo implementar un proveedor de widgets que proporciona contenido, diseño y elementos interactivos para los widgets.
Proveedores de widgets web	Mostrar HTML en un widget y controlar las solicitudes de recursos y mensajes entre tu proveedor y el contenido web.
Diseñador de Tarjetas Adaptivas (Tarjetas adaptables Designer)	Guía para crear una plantilla de widget mediante el Diseñador de Tarjetas adaptables.
Crea un widget de Windows con GitHub Copilot	Usa un prompt reutilizable para generar, empaquetar y validar un widget en un repositorio existente.