Поставщики мини-приложений

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

Для упакованного классического приложения вы реализуете поставщик мини-приложений, который отвечает на запросы узла мини-приложения и отправляет обновления через WidgetManager. PWA использует определения виджетов в манифесте веб-приложения и обрабатывает события виджетов в service worker.

Общие сведения о Windows мини-приложениях и руководстве по проектированию для создания собственных мини-приложений см. в Windows мини-приложениях.

В настоящее время можно реализовать поставщик мини-приложений с помощью упаковаемого классического приложения Win32 или прогрессивного веб-приложения (PWA). Дополнительные сведения см. в следующих разделах:

API и возможности поставщика виджетов рабочего стола

Реализуйте IWidgetProvider для создания виджетов, удаления, активации, изменения контекста и действий пользователей. Базовый интерфейс остается обязательным при добавлении необязательных интерфейсов для настройки или веб-содержимого.

Capability API или руководство Availability
Жизненный цикл виджета и обновления адаптивной карточки IWidgetProvider и WidgetManager Windows App SDK 1.2
Настройка пользователя IWidgetProvider2 и атрибут манифеста IsCustomizable Windows App SDK 1.4
Веб-содержимое, запросы ресурсов и обмен сообщениями Поставщики веб-мини-приложений, IWidgetResourceProvider, IWidgetProviderMessage и WidgetManager.SendMessageToContent Windows App SDK 1.6.3; также проверьте хост веб-виджета и региональные требования.
Указание содержимого, которое еще не персонализировано или не пригодно для использования WidgetUpdateRequestOptions.IsPlaceholderContent Windows App SDK 1.6.6
Обратные вызовы аналитики виджета IWidgetProviderAnalytics Доска мини-приложений Windows поддерживает эти обратные вызовы, начиная с Windows 11 сборки 26900. Другие узлы также должны поддерживать интерфейс; см. примечания API.

Версии пакета SDK указывают, когда API-интерфейсы стали доступными, а не какой выпуск следует установить. Используйте стабильный выпуск из каналов выпуска Windows App SDK и проверьте возможности, которые вы используете, на целевом устройстве Windows и в узле мини-приложений. Параметры отображения заголовка см. в разделе Настройка области заголовка виджета. API service worker PWA — это отдельный путь реализации; интерфейсы для настольных ПК в этой таблице к нему не применяются.

Хост виджета может независимо активировать и выгружать ваш провайдер вне зависимости от времени существования закрепленных виджетов. Восстановите состояние мини-приложения при запуске поставщика и не сохраняйте объекты аргумента обратного вызова после возврата обратного вызова IWidgetProvider . Дополнительные сведения см. в примечаниях IWidgetProvider.

Полный справочник по API см. в пространстве имен Microsoft.Windows.Widgets.Providers.

Пошаговое руководство по созданию мини-приложения и реализации поставщика мини-приложений см. в эпизоде Tabs vs Spaces "Создание мини-приложений для Windows 11".

Дополнительные ресурсы

  • Последнее обновление: