Интеграция с средство выбора мини-приложений

В текущем выпуске единственным узлом мини-приложений является доска мини-приложений, встроенная в Windows 11. Доска мини-приложений отображает мини-приложения и управляет их макетом на доске. Он также предоставляет средство выбора мини-приложений, позволяющее пользователю выбрать доступные мини-приложения, видимые на доске. В этой статье описываются ресурсы, необходимые для успешного интеграции мини-приложения в средство выбора мини-приложений.

Изображение мини-приложения

Каждое мини-приложение должно предоставить изображение снимка экрана, отображаемое в качестве предварительного просмотра в средство выбора мини-приложений при фокусе мини-приложения. Снимок экрана указывается поставщиком мини-приложений в манифесте пакета для приложения. Технические сведения о том, как указать файл изображения, используемый для снимка экрана мини-приложения, см. в разделе "Реализация поставщика мини-приложений" в формате XML манифеста пакета win32 и поставщика мини-приложений.

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

Требования к изображению снимок экрана

Чтобы обеспечить согласованный пользовательский интерфейс, снимки экрана мини-приложений для средства выбора мини-приложений должны соответствовать приведенным ниже рекомендациям.

• Снимок экрана должен отображать среднюю версию мини-приложения.
• Изображение должно иметь ширину 300 пикселей и высоту 304 пикселей.
• Изображение должно иметь прозрачные, округленные угла.

Манифест поставщика мини-приложений включает три различных элемента снимка экрана , которые можно задать. Снимок экрана верхнего уровня является обязательным и будет использоваться в качестве используемого по умолчанию средства выбора мини-приложений. Разделы LightMode и DarkMode манифеста являются необязательными и позволяют указать отдельные снимки экрана для мини-приложения в светлых и темных режимах. Если вы предоставляете один или оба этих необязательных снимка экрана, средство выбора мини-приложений будет использовать тот, который соответствует текущей теме устройства. Если вы не предоставляете изображение специально для текущей темы, средство выбора мини-приложений будет использовать стандартный снимок экрана верхнего уровня.

Вы можете предоставить мини-снимки экрана для нескольких языковых стандартов. Языковой стандарт для каждого снимка экрана указывается с путем к ресурсу относительно пакета приложения.

• Создайте каталог в проекте упаковки для ресурсов образа. Например: "Активы".
• Ресурсы, нейтральные по языку или резервные ресурсы, можно поместить непосредственно в эту папку. Например: "Активы/Screenshot.png"
• Ресурсы, относящиеся к языку, можно поместить в подкаталогы с именем языкового стандарта, к которому они применяются. Например:
  • Активы "английский (США)" должны размещаться в подкаталоге с именем "en-us": "Assets/en-us/Screenshot.png".
  • Активы "французский (Франция)" должны размещаться в подкаталоге с именем fr-fr: "Assets/fr-fr/Screenshot.png"
• Ссылки на эти изображения в appxmanifest с помощью схемы URI ms-appx. Например: снимок экрана="ms-appx:Assets\Screenshot.png"
• Если вы не включаете образ для определенного языкового стандарта, будет использоваться резервный образ в корневом каталоге.

Загрузчик ресурсов автоматически выбирает соответствующий языку ресурс для отображения. Дополнительные сведения см. в статье о загрузке изображений и ресурсов, адаптированных для масштабирования, темы, высокой контрастности и других.

Ниже приведен пример изображения снимка экрана мини-приложения.