Desenvolver Widgets e Dashboards para Windows

Widgets

Os widgets do Windows são pequenos contentores de interface associados a uma aplicação instalada. O Quadro de Widgets mostra-os numa grelha sobre o ambiente de trabalho do Windows, com conteúdo personalizado e ações rápidas da sua aplicação. Pode definir conteúdo com Cartões Adaptativos, que vinculam dados a um template JSON, ou mostrar HTML a partir de uma URL com um fornecedor de widgets web. Os widgets web continuam a usar um payload Adaptive Card JSON para especificar o URL do conteúdo.

Para orientações de design, consulte Windows Widgets design overview.

Escolha um caminho de desenvolvimento de widgets

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

Se você quiser...	Use esta abordagem	Comece aqui
Adicione um widget de Cartão Adaptativo a uma aplicação de ambiente de trabalho C# empacotada	Implemente o IWidgetProvider, envie atualizações de modelos e dados com o WidgetManager, e registe o fornecedor através do manifesto do pacote.	Guia do fornecedor de widgets em C#
Adicione um widget de Adaptive Card a uma aplicação de ambiente de trabalho C++/WinRT empacotada	Implemente o IWidgetProvider no servidor COM fora de processo e registe as definições do CLSID e dos widgets no manifesto do pacote.	Guia passo a passo do fornecedor de widgets em C++/WinRT
Mostrar HTML a partir de uma URL dentro de um widget de ambiente de trabalho	Utilize um fornecedor de widgets da web. Esta funcionalidade está disponível apenas para utilizadores no EEE. O fornecedor continua a enviar um payload do Adaptive Card contendo a URL web e o conteúdo de contingência.	Fornecedores de widgets web
Adicionar um widget para uma Progressive Web App (PWA) existente	Defina o widget no manifesto da aplicação web e trate dos eventos do widget no service worker. Isto é separado do caminho do desktop IWidgetProvider.	Construção de widgets baseados em PWA
Gerir um botão ou uma ação de formulário no seu provedor do ambiente de trabalho	Use Action.Execute e trate o verbo em OnActionInvoked. Mostre-o apenas quando $host.isUserContextAuthenticated for verdadeiro.	Criar um modelo de widget
Abra uma página da aplicação ou site sem um callback do fornecedor	Use Action.OpenUrl. Isto mantém-se disponível quando o contexto do utilizador do widget não está autenticado.	Criar um modelo de widget
Deixe os utilizadores configurarem um widget	Implemente o IWidgetProvider2, definir o atributo IsCustomizable do manifesto e fornecer um payload de personalização.	Personalizar widgets
Adapte o conteúdo para tamanho, tema, definições, cabeçalho, suporte web ou autenticação	Utilize as propriedades do Windows $host no modelo Adaptive Card e declare todos os tamanhos suportados no manifesto do pacote.	Propriedades do anfitrião de widgets do Windows
Mostrar conteúdo a carregar ou sem sessão iniciada	Envie um modelo de contingência deliberado e dados. Define IsPlaceholderContent quando o conteúdo ainda não for personalizado ou acionável.	Fornecedores de widgets
Adicionar um feed de dashboard em vez de um widget individual	Implemente um fornecedor de feed. Os fornecedores de feeds são uma integração separada e estão disponíveis apenas no EEE.	Painéis e fornecedores de feeds
Pede ao GitHub Copilot para criar e validar um widget	Utilize o prompt reutilizável, que seleciona um caminho suportado e requer validação de pacote, manifesto, compilação e do Widgets Board.	Crie um widget para Windows com o GitHub Copilot

Dashboards

Os fornecedores de feeds registam feeds de conteúdo que aparecem como painéis no Quadro de Widgets. Um fornecedor de feeds é uma integração separada de um fornecedor de widgets; mostrar HTML dentro de um widget não regista um feed de dashboard.

Importante

Os fornecedores de feeds estão disponíveis apenas para utilizadores no Espaço Económico Europeu (EEE). Para requisitos de disponibilidade e implementação, consulte Dashboards e fornecedores de feeds.

Nesta secção

Tópico	Descrição
Fornecedores de alimentos para animais	Aprenda a registar os feeds de conteúdo da sua aplicação para aparecerem diretamente no Quadro de Widgets do Windows.
Fornecedores de widgets	Saiba como implementar um fornecedor de widgets que forneça conteúdo, layout e elementos interativos para os seus widgets.
Fornecedores de widgets web	Exiba HTML num widget e trate de pedidos de recursos e mensagens entre o seu provedor e o conteúdo web.
Estruturador de Cartões Adaptáveis	Explique como criar um modelo de widget usando o Cartões Adaptativos Designer.
Crie um widget para Windows com o GitHub Copilot	Utilize um prompt reutilizável para gerar, empacotar e validar um widget num repositório existente.