Sviluppare widget e dashboard di Windows

Widgets

Windows widget sono contenitori di interfaccia utente di piccole dimensioni associati a un'app installata. La Bacheca dei widget li visualizza in una griglia sul desktop di Windows, con contenuti personalizzati e azioni rapide dalla tua app. È possibile definire il contenuto con Schede adattive, che associano i dati a un modello JSON o visualizzano HTML da un URL con un provider di widget Web. I widget Web usano ancora un payload JSON di Adaptive Card per specificare l'URL del contenuto.

Per indicazioni sulla progettazione, vedere Panoramica della progettazione dei widget di Windows.

Scegliere un percorso di sviluppo del widget

Utilizzare questa tabella per selezionare il percorso di implementazione e l'argomento successivo da aprire.

Se vuoi...	Usare questo approccio	Iniziare da qui
Aggiungere un widget Adaptive Card a un'app desktop C# in pacchetto	Implementare IWidgetProvider, inviare aggiornamenti di modelli e dati con WidgetManager e registrare il provider tramite il manifesto del pacchetto.	Procedura dettagliata per il provider di widget C#
Aggiungere un widget Adaptive Card a un'app desktop C++/WinRT in pacchetto	Implementare IWidgetProvider nel server COM out-of-process e registrare le relative definizioni CLSID e widget nel manifest del pacchetto.	Procedura dettagliata per il provider di widget C++/WinRT
Visualizzare HTML da un URL all'interno di un widget desktop	Usa un provider di widget web. Questa funzionalità è disponibile solo per gli utenti del SEE. Il provider invia comunque un payload della scheda adattiva contenente l'URL Web e il contenuto di fallback.	Provider di widget Web
Aggiungere un widget per un'app Web progressiva esistente (PWA)	Definire il widget nel manifesto dell'app Web e gestire gli eventi del widget nel service worker. Questo è separato dal percorso desktop IWidgetProvider.	Creare widget guidati da PWA
Gestisci un pulsante o un'azione del modulo nel provider desktop	Usare Action.Execute e gestire il verbo in OnActionInvoked. Mostrarlo solo quando $host.isUserContextAuthenticated è true.	Creare un modello di widget
Apri una pagina dell'app o un sito web senza callback del provider	Usare Action.OpenUrl. Questo rimane disponibile quando il contesto utente del widget non è autenticato.	Creare un modello di widget
Consentire agli utenti di configurare un widget	Implementare IWidgetProvider2, impostare l'attributo IsCustomizable del manifesto e fornire un payload di personalizzazione.	Personalizzazione dei widget
Adattare il contenuto per dimensioni, tema, impostazioni, intestazione, supporto Web o autenticazione	Usare le proprietà di Windows $host nel modello di Adaptive Card e dichiarare tutte le dimensioni supportate nel manifest del pacchetto.	Proprietà dell'host del widget Windows
Visualizzare il contenuto di caricamento o per utenti non autenticati	Inviare un modello di fallback deliberato e dati. Impostare IsPlaceholderContent quando il contenuto non è ancora personalizzato o utilizzabile.	Provider di widget
Aggiungere un feed del dashboard invece di un singolo widget	Implementa un provider di feed. I provider di feed sono un'integrazione separata e sono disponibili solo nel SEE.	Dashboard e fornitori di feed
Chiedi a GitHub Copilot di creare e convalidare un widget	Usare il prompt riutilizzabile, che seleziona un percorso supportato e richiede la convalida del pacchetto, del manifesto, della compilazione e di Widgets Board.	Creare un widget Windows con GitHub Copilot

Dashboards

I provider di feed registrano i feed di contenuto visualizzati come dashboard nella bacheca dei widget. Un provider di feed è un'integrazione separata da un provider di widget; la visualizzazione del codice HTML all'interno di un widget non registra un feed del dashboard.

Importante

I fornitori di feed sono disponibili solo per gli utenti dell'Area economica europea (SEE). Per i requisiti di disponibilità e implementazione, vedere Dashboard e provider di feed.

In questa sezione

Argomento	Descrizione
Fornitori di feed	Informazioni su come registrare i feed di contenuto dell'app per essere visualizzati direttamente nella scheda Windows Widget.
Provider di widget	Informazioni su come implementare un provider di widget che fornisce contenuto, layout ed elementi interattivi per i widget.
Provider di widget Web	Visualizzare il codice HTML in un widget e gestire le richieste di risorse e i messaggi tra il tuo provider e il contenuto Web.
Schede adattive Designer	Procedura dettagliata per la creazione di un modello di widget tramite la finestra di progettazione Schede adattive.
Creare un widget Windows con GitHub Copilot	Usare un prompt riutilizzabile per generare, creare un pacchetto e convalidare un widget in un repository esistente.