Entwickeln Windows Widgets und Dashboards

Widgets

Windows Widgets sind kleine UI-Container, die einer installierten App zugeordnet sind. Das Widgets Board zeigt sie in einem Raster über dem Windows Desktop mit personalisiertem Inhalt und schnellen Aktionen aus Ihrer App an. Sie können Inhalte mit Adaptive Karten definieren, die Daten an eine JSON-Vorlage binden oder HTML aus einer URL mit einem Web-Widget-Anbieter anzeigen. Web-Widgets verwenden weiterhin eine Adaptive-Card-JSON-Payload, um die Inhalts-URL anzugeben.

Entwurfsanleitungen finden Sie unter Windows Widgets design overview.

Widget-Entwicklungspfad auswählen

Verwenden Sie diese Tabelle, um den Implementierungspfad und das nächste zu öffnende Thema auszuwählen.

Wenn Sie möchten...	Verwenden Sie diesen Ansatz.	Beginne hier
Hinzufügen eines Adaptive Card-Widgets zu einer verpackten C#-Desktop-App	Implementieren Sie IWidgetProvider, senden Sie Vorlagen- und Datenaktualisierungen mit WidgetManager, und registrieren Sie den Anbieter über das Paketmanifest.	Schritt-für-Schritt-Anleitung für C#-Widgetanbieter
Hinzufügen eines Adaptive Card-Widgets zu einer verpackten C++/WinRT-Desktop-App	Implementieren Sie IWidgetProvider im Out-of-Process-COM-Server, und registrieren Sie ihre CLSID- und Widgetdefinitionen im Paketmanifest.	Exemplarische Vorgehensweise für C++/WinRT-Widget-Anbieter
Anzeigen von HTML aus einer URL innerhalb eines Desktop-Widgets	Verwenden Sie einen Web-Widget-Anbieter. Dieses Feature ist nur für Benutzer im EWR verfügbar. Der Anbieter sendet weiterhin eine Adaptive-Card-Payload, die die Web-URL und den Fallbackinhalt enthält.	Web-Widget-Anbieter
Hinzufügen eines Widgets für eine vorhandene Progressive Web App (PWA)	Definieren Sie das Widget im Web-App-Manifest, und behandeln Sie Widgetereignisse im Service Worker. Dies ist getrennt vom Desktop-IWidgetProvider-Pfad .	Erstellen von PWA-gesteuerten Widgets
Handhabung von Schaltflächen- oder Formularaktion in Ihrem Desktopanbieter	Verwenden Sie Action.Execute , und behandeln Sie das Verb in OnActionInvoked. Nur anzeigen, wenn $host.isUserContextAuthenticated wahr ist.	Erstellen einer Widgetvorlage
App-Seite oder Website ohne Provider-Callback öffnen	Verwenden Sie Action.OpenUrl. Dies bleibt verfügbar, wenn der Widget-Benutzerkontext nicht authentifiziert ist.	Widgetvorlage erstellen
Zulassen, dass Benutzer ein Widget konfigurieren	Implementieren Sie IWidgetProvider2, legen Sie das IsCustomizable-Attribut des Manifests fest, und geben Sie Konfigurationsdaten an.	Widgetanpassung implementieren
Anpassen von Inhalten für Größe, Design, Einstellungen, Kopfzeile, Webunterstützung oder Authentifizierung	Verwenden Sie Windows $host Eigenschaften in der Vorlage für Adaptive Card, und deklarieren Sie jede unterstützte Größe im Paketmanifest.	Eigenschaften des Windows-Widgethosts
Anzeige von Inhalten während des Ladevorgangs oder im abgemeldeten Zustand	Versenden einer gezielten Fallbackvorlage sowie -daten. Legen Sie IsPlaceholderContent fest, wenn Inhalte noch nicht personalisiert oder umsetzbar sind.	Widget-Anbieter
Dashboard-Feed statt eines einzelnen Widgets hinzufügen	Implementieren Sie einen Feed-Anbieter. Feedanbieter sind eine separate Integration und stehen nur im EWR zur Verfügung.	Dashboards und Feedanbieter
Fordern Sie GitHub Copilot auf, ein Widget zu erstellen und zu überprüfen	Verwenden Sie den wiederverwendbaren Prompt, der einen unterstützten Pfad auswählt und eine Paket-, Manifest-, Build- und Widgets Board-Überprüfung erfordert.	Erstellen Sie ein Windows-Widget mit GitHub Copilot

Dashboards

Feedanbieter registrieren Inhaltsfeeds, die als Dashboards im Widgets Board angezeigt werden. Ein Feedanbieter ist eine separate Integration von einem Widgetanbieter; Das Anzeigen von HTML in einem Widget registriert keinen Dashboardfeed.

Important

Feedanbieter sind nur für Benutzer im Europäischen Wirtschaftsraum (EWR) verfügbar. Informationen zu Verfügbarkeits- und Implementierungsanforderungen finden Sie unter Dashboards und Feedanbieter.

In diesem Abschnitt

Thema	Beschreibung
Feedanbieter	Erfahren Sie, wie Sie die Inhaltsfeeds Ihrer App registrieren, damit sie direkt im Windows Widgets Board angezeigt werden.
Widget-Anbieter	Erfahren Sie, wie Sie einen Widgetanbieter implementieren, der Inhalte, Layout und interaktive Elemente für Ihre Widgets bereitstellt.
Web-Widget-Anbieter	HTML in einem Widget anzeigen und Ressourcenanforderungen und Nachrichten zwischen Ihrem Provider und Webinhalten verarbeiten.
Designer für adaptive Karten	Gehen Sie durch das Erstellen einer Widgetvorlage mithilfe des Adaptive Karten-Designers.
Erstellen Sie ein Windows-Widget mit GitHub Copilot	Verwenden Sie einen wiederverwendbaren Prompt, um ein Widget in einem vorhandenen Repository zu generieren, zu packen und zu überprüfen.