Desenvolver widgets e painéis Windows

Widgets

Windows widgets são pequenos contêineres de interface do usuário associados a um aplicativo instalado. O Painel de Widgets exibe eles em uma grade na área de trabalho do Windows, com conteúdo personalizado e ações rápidas do seu aplicativo. Você pode definir o conteúdo com Cartões Adaptáveis, que associam dados a um modelo JSON ou exibem HTML de uma URL com um provedor de widget Web. Os widgets da Web ainda usam uma carga JSON do Adaptive Card para especificar a URL de conteúdo.

Para obter diretrizes de design, consulte visão geral de design de Widgets do Windows.

Escolher um caminho de desenvolvimento de widget

Use esta tabela para selecionar o caminho de implementação e o próximo tópico a ser aberto.

Se você quiser...	Use essa abordagem	Comece por aqui
Adicionar um widget de Adaptive Card a um aplicativo de área de trabalho C# empacotado	Implemente IWidgetProvider, envie template e atualizações de dados com WidgetManager e registre o provedor por meio do manifesto do pacote.	Passo a passo do provedor de widget do C#
Adicionar um widget de Cartão Adaptável a um aplicativo de área de trabalho C++/WinRT empacotado	Implemente IWidgetProvider no servidor COM fora de processo e registre seu CLSID e as definições de widget no manifesto do pacote.	Passo a passo do provedor de widget do C++/WinRT
Exibir HTML de uma URL dentro de um widget da área de trabalho	Utilize um provedor de widgets para a web. Esse recurso está disponível somente para usuários no EEE. O provedor ainda envia um conteúdo de Cartão Adaptável que contém a URL da Web e o conteúdo de fallback.	Provedores de widget web
Adicionar um widget para um PWA (Aplicativo Web Progressivo) existente	Defina o widget no manifesto do aplicativo Web e manipule eventos de widget no service worker. Isso é separado do caminho IWidgetProvider da área de trabalho.	Criar widgets impulsionados por PWA
Manipular uma ação de botão ou formulário em seu provedor para desktop	Use Action.Execute e manipule o verbo em OnActionInvoked. Mostre-o somente quando $host.isUserContextAuthenticated for verdadeiro.	Criar um modelo de widget
Abrir uma página de aplicativo ou site sem um callback do provedor	Use Action.OpenUrl. Isso permanece disponível quando o contexto do usuário do widget não é autenticado.	Criar um modelo de widget
Permitir que os usuários configurem um widget	Implemente IWidgetProvider2, defina o atributo IsCustomizable do manifesto e forneça um conteúdo de personalização.	Implementar a personalização do widget
Adaptar conteúdo para tamanho, tema, configurações, cabeçalho, suporte à Web ou autenticação	Use as propriedades do Windows $host no modelo de Cartão Adaptável e declare todos os tamanhos com suporte no manifesto do pacote.	Propriedades do host de widget do Windows
Exibir conteúdo de carregamento ou de usuário desconectado	Envie um modelo de contingência e dados específicos. Defina IsPlaceholderContent quando o conteúdo ainda não estiver personalizado ou acionável.	Provedores de widget
Adicionar um feed de dashboard em vez de um widget individual	Implementar um provedor de feed. Os provedores de feed são uma integração separada e estão disponíveis apenas no EEA.	Painéis e provedores de feeds
Peça a GitHub Copilot para criar e validar um widget	Use o prompt reutilizável, que seleciona um caminho com suporte e requer validação de pacote, manifesto, build e Widgets Board.	Criar um widget Windows com GitHub Copilot

Dashboards

Os provedores de feed registram feeds de conteúdo que aparecem como painéis no Painel de Widgets. Um provedor de feed é uma integração separada de um provedor de widget; exibir HTML dentro de um widget não registra um feed de dashboard.

Importante

Os provedores de feed estão disponíveis apenas para usuários na Área Econômica Europeia (EEE). Para requisitos de disponibilidade e implementação, consulte Dashboards e provedores de feed.

Nesta seção

Tópico	Descrição
Provedores de feed	Saiba como registrar os feeds de conteúdo do aplicativo para aparecer diretamente no Painel de Widgets do Windows.
Provedores de widget	Saiba como implementar um provedor de widget que fornece conteúdo, layout e elementos interativos para seus widgets.
Provedores de widget web	Exiba HTML em um widget e manipule solicitações de recursos e mensagens entre seu provedor e o conteúdo da Web.
Designer de Cartões Adaptáveis	Passo a passo para criar um template de widget usando o Cartões Adaptáveis Designer.
Criar um widget Windows com GitHub Copilot	Use um prompt reutilizável para gerar, empacotar e validar um widget em um repositório existente.