Разработка мини-приложений и панелей мониторинга Windows

Widgets

Виджеты Windows — это небольшие контейнеры пользовательского интерфейса, связанные с установленным приложением. Панель мини-приложений отображает их в виде сетки на рабочем столе Windows с персонализированным содержимым и быстрыми действиями из вашего приложения. Можно задать содержимое с помощью Adaptive Cards, которые привязывают данные к шаблону JSON или отображают HTML из URL-адреса с помощью поставщика веб-мини-приложений. Веб-виджеты по-прежнему используют полезные данные JSON Adaptive Card для указания URL-адреса содержимого.

Для руководства по проектированию см. Обзор проектирования виджетов Windows.

Выбор пути разработки виджетов

Используйте эту таблицу, чтобы выбрать путь реализации и следующий раздел, который следует открыть.

Если вы хотите...	Используйте этот подход	Начните здесь
Добавление виджета адаптивной карточки в упакованое классическое приложение C#	Реализуйте IWidgetProvider, отправьте обновления шаблонов и данных с помощью WidgetManager и зарегистрируйте поставщика через манифест пакета.	Пошаговое руководство по поставщику виджетов C#
Добавление виджета адаптивной карточки в упакованое классическое приложение C++/WinRT	Реализуйте IWidgetProvider на сервере COM вне процесса и зарегистрируйте его CLSID и определения мини-приложений в манифесте пакета.	Пошаговое руководство по поставщику виджетов C++/WinRT
Отображение HTML из URL-адреса в классическом мини-приложении	Используйте поставщика веб-виджетов. Эта функция доступна только пользователям в EEA. Поставщик по-прежнему отправляет полезные данные адаптивной карты, содержащие веб-URL-адрес и резервное содержимое.	Поставщики веб-мини-приложений
Добавить мини-приложение для существующего прогрессивного веб-приложения (PWA)	Определите виджет в манифесте веб-приложения и обработайте события виджета в сервис-воркере. Это отдельно от пути IWidgetProvider для настольных компьютеров.	Создание виджетов с использованием PWA
Обработка действия кнопки или формы в поставщике для компьютера	Используйте Action.Execute и обработайте глагол в OnActionInvoked. Показывать его только в том случае, если $host.isUserContextAuthenticated истинно.	Создайте шаблон виджета
Откройте страницу приложения или веб-сайт без обратного вызова поставщика	Используйте Action.OpenUrl. Это остается доступным, если контекст пользователя мини-приложения не аутентифицирован.	Создать шаблон виджета
Разрешить пользователям настраивать мини-приложение	Реализуйте IWidgetProvider2, задайте атрибут IsCustomizable манифеста и укажите полезные данные настройки.	Реализуйте настройку виджета
Адаптируйте содержимое для размера, темы, параметров, заголовка, веб-поддержки или проверки подлинности	Используйте свойства Windows $host в шаблоне адаптивной карточки и объявите каждый поддерживаемый размер в манифесте пакета.	свойства хоста мини-приложения Windows
Показывать содержимое при загрузке или после выхода из системы	Отправьте преднамеренный резервный шаблон и данные. Установите IsPlaceholderContent, если содержимое еще не персонализировано или не пригодно для использования.	Поставщики мини-приложений
Добавьте веб-канал панели мониторинга вместо отдельного виджета	Реализуйте поставщика веб-канала. Поставщики фидов являются отдельной интеграцией и доступны только в ЕЭЗ.	Информационные панели и поставщики каналов
Попросите GitHub Copilot создать и проверить виджет	Используйте повторно используемый промпт, который выбирает поддерживаемый путь и требует проверки пакета, манифеста, сборки и Widgets Board.	Создайте виджет Windows с помощью GitHub Copilot

Dashboards

Поставщики веб-каналов регистрируют веб-каналы контента, которые отображаются как панели мониторинга в Widgets Board. Поставщик ленты — это отдельная интеграция от поставщика виджетов; отображение HTML в виджете не регистрирует ленту панели мониторинга.

Important

Поставщики веб-каналов доступны только пользователям в Европейской экономической зоне (EEA). Требования к доступности и реализации см. в разделе Панели мониторинга и поставщики лент.

В этом разделе

Тема	Описание
Поставщики каналов данных	Узнайте, как зарегистрировать каналы содержимого вашего приложения для отображения непосредственно на панели виджетов Windows.
Поставщики мини-приложений	Узнайте, как реализовать поставщик мини-приложений, предоставляющий содержимое, макет и интерактивные элементы для мини-приложений.
Поставщики веб-мини-приложений	Отображение HTML в виджете и обработка запросов ресурсов и сообщений между поставщиком и веб-контентом.
конструктор Adaptive Cards	Пошаговое руководство по созданию шаблона мини-приложения с помощью конструктора Adaptive Cards.
Создайте мини-приложение Windows с помощью GitHub Copilot	Используйте повторно используемый промпт для создания, упаковки и проверки виджета в существующем репозитории.