Opracowywanie widżetów Windows i pulpitów nawigacyjnych

Widgets

Widżety systemu Windows to małe kontenery interfejsu użytkownika skojarzone z zainstalowaną aplikacją. Tablica widżetów wyświetla je w siatce na pulpicie Windows z spersonalizowaną zawartością i szybkimi akcjami z aplikacji. Zawartość można definiować przy użyciu Adaptive Cards, wiązać dane z szablonem JSON lub wyświetlać kod HTML z adresu URL za pomocą dostawcy widżetu internetowego. Widżety internetowe nadal używają ładunku JSON karty Adaptive Card, aby określić adres URL zawartości.

Aby uzyskać wskazówki dotyczące projektowania, zobacz przegląd projektu widżetów Windows.

Wybierz ścieżkę tworzenia widżetu

Użyj tej tabeli, aby wybrać ścieżkę implementacji i następny temat do otwarcia.

Jeśli chcesz...	Użyj tego podejścia	Zacznij tutaj
Dodawanie widżetu karty adaptacyjnej do spakowanej aplikacji klasycznej w języku C#	Zaimplementuj IWidgetProvider, wyślij aktualizacje szablonu i danych za pomocą narzędzia WidgetManager i zarejestruj dostawcę za pośrednictwem manifestu pakietu.	Przewodnik po dostawcy kontrolek języka C#
Dodawanie widżetu karty adaptacyjnej do spakowanej aplikacji klasycznej C++/WinRT	Zaimplementuj IWidgetProvider na serwerze COM poza procesem i zarejestruj identyfikator CLSID oraz definicje widżetów w manifeście pakietu.	Przewodnik po dostawcy widżetów języka C++/WinRT
Wyświetlanie zawartości HTML z adresu URL wewnątrz widżetu pulpitu	Użyj dostawcy widżetów internetowych. Ta funkcja jest dostępna tylko dla użytkowników w EOG. Dostawca nadal wysyła ładunek karty Adaptive Card zawierający adres URL sieci Web i zawartość rezerwową.	Dostawcy widżetów sieci Web
Dodaj widżet dla istniejącej progresywnej aplikacji internetowej (PWA)	Zdefiniuj widżet w manifeście aplikacji internetowej i obsłuż zdarzenia widżetu w service worker. Jest to oddzielone od ścieżki desktopowej IWidgetProvider.	Tworzenie widżetów opartych na programie PWA
Obsługa przycisku lub akcji formularza w dostawcy desktop	Użyj polecenia Action.Execute i obsłuż czasownik w wywołaniu OnActionInvoked. Pokaż go tylko wtedy, gdy $host.isUserContextAuthenticated ma wartość true.	Utwórz szablon widżetu
Otwórz stronę aplikacji lub witrynę internetową bez wywołania zwrotnego dostawcy	Użyj Action.OpenUrl. Pozostaje to dostępne, gdy kontekst użytkownika widżetu nie jest uwierzytelniony.	Tworzenie szablonu widżetu
Zezwalanie użytkownikom na konfigurowanie widżetu	Zaimplementuj element IWidgetProvider2, ustaw atrybut IsCustomizable manifestu i dostarcz ładunek personalizacji.	Wdrożyć dostosowywanie widżetu
Dostosowywanie zawartości pod kątem rozmiaru, motywu, ustawień, nagłówka, obsługi internetowej lub uwierzytelniania	Użyj właściwości okna $host w szablonie karty adaptacyjnej i zadeklaruj każdy obsługiwany rozmiar w manifeście pakietu.	Właściwości hosta widżetów systemu Windows
Pokaż zawartość podczas ładowania lub zawartość dla wylogowanych użytkowników	Wyślij zamierzony rezerwowy szablon i dane. Ustaw właściwość IsPlaceholderContent, gdy zawartość nie jest jeszcze spersonalizowana ani nie wymaga działania.	Dostawcy widżetów
Dodaj kanał pulpitu nawigacyjnego zamiast pojedynczego widżetu	Zaimplementuj dostawcę źródła danych. Dostawcy feedów są oddzielną integracją i są dostępni tylko w EOG.	Pulpity nawigacyjne i dostawcy źródeł danych
Poproś GitHub Copilot o utworzenie i zweryfikowanie widżetu	Użyj monitu wielokrotnego użytku, który wybiera obsługiwaną ścieżkę i wymaga weryfikacji pakietu, manifestu, kompilacji i Widgets Board.	Tworzenie widżetu Windows za pomocą GitHub Copilot

Dashboards

Dostawcy kanałów rejestrują kanały treści, które są wyświetlane jako pulpity nawigacyjne na tablicy widżetów. Dostawca kanału informacyjnego to osobna integracja od dostawcy widżetu; wyświetlanie kodu HTML wewnątrz widżetu nie powoduje zarejestrowania kanału informacyjnego pulpitu nawigacyjnego.

Important

Dostawcy kanałów są dostępni tylko dla użytkowników Europejskiego Obszaru Gospodarczego (EOG). Aby uzyskać informacje o wymaganiach dotyczących dostępności i implementacji, zobacz Pulpity i dostawcy kanałów informacyjnych.

W tym dziale

Temat	Opis
Dostawcy kanału informacyjnego	Dowiedz się, jak zarejestrować kanały zawartości aplikacji, aby były wyświetlane bezpośrednio na tablicy widżetów Windows.
Dostawcy widżetów	Dowiedz się, jak zaimplementować dostawcę widżetów dostarczającego zawartość, układ i elementy interaktywne dla widżetów.
Dostawcy widżetów sieci Web	Wyświetl kod HTML w widżecie i obsłuż żądania zasobów oraz komunikaty między dostawcą a zawartością internetową.
Projektant kart adaptacyjnych	Zapoznaj się z tworzeniem szablonu widżetu przy użyciu projektanta Adaptive Cards.
Utwórz widżet systemu Windows za pomocą GitHub Copilot	Użyj monitu wielokrotnego użytku, aby wygenerować, spakować i zweryfikować widżet w istniejącym repozytorium.