Windows App SDK

Новое в версии Windows App SDK 1.8

Новое в версии 1.8.4 Stable (1.8.260101001) (13.01.2026):

Версия 1.8.4 (1.8.251106002)

Новое

• Windows AI Text Rewriter: добавлена поддержка пользовательских тонов
• Новый API RewriteCustomAsync позволяет задавать собственные инструкции для перефразирования текста (например, «переписать в стиле Шекспира» или «в стиле научной фантастики»)

Оптимизация

• Размер библиотеки Microsoft.Windows.AI.MachineLearning.dll уменьшен примерно на 160 КБ

Исправления ошибок

• Исправлены ошибки «Class not registered» при использовании Windows ML в self-contained развёртываниях
• Исправлен сбой при завершении процесса после использования Windows ML
• Улучшена работа FileOpenPicker и FileSavePicker:
  • Корректное отображение названий фильтров при скрытых расширениях
  • Файлы больше не обрезаются при сохранении, если не происходит перезапись
  • Сохранён порядок добавления типов файлов
• Исправлена проблема недоступности Image Super Resolution для некоторых приложений
• Исправлена ошибка запуска приложений при использовании PublishSingleFile с компонентными пакетами
• Исправлена проблема отображения IconElements, созданных через IconSource.CreateIconElement
• Уменьшено избыточное пересобирание при инкрементальных сборках с WinAppSDKSelfContained
• Исправлена ошибка сборки при использовании компонента DWrite с WinAppSDKSelfContained

Новые и обновлённые API

• Microsoft.Windows.AI.Text
  • TextRewriter: RewriteCustomAsync

Новое в версии Windows App SDK 1.8 Preview

Новое в 1.8 Preview (1.8.250814004-preview1) (19.08.2025):

Microsoft выпустила предварительную версию Windows App SDK 1.8 (канал preview). Разработчики могут обновить существующие проекты с Windows App SDK 1.7 (stable) до NuGet-пакета 1.8.0-preview. Также доступны обновлённые рантаймы и MSIX-пакеты.

Новые возможности

• Ограничение размера входных данных (Prompt Size Limit Reporting) — приложения могут проверять, не превышает ли вводимый текст допустимый лимит для вызова Text Summarizer. Если лимит превышен, API возвращает индекс ограничения. Ограничение считается по токенам, а не по символам, и может меняться со временем.
• Тон переписывания текста (Text Rewriter Tone) — позволяет задавать стиль при перефразировании текста:
  • Casual — более разговорный и непринуждённый стиль;
  • Formal — строгий, профессиональный стиль с сохранением структуры;
  • General — максимально близкий к исходному тону.
• Опции для сводки диалогов (Conversation Summary Options) — возможность задать язык итогового резюме беседы, что улучшает локализацию и пользовательский опыт.

Другие изменения

• Теперь для приложений в AppContainer требуется capability packageManagement. Ранее из-за ошибки инициализации DeploymentManager это не было обязательным.

Новые API (по сравнению с 1.7 Stable)

• Microsoft.Windows.AI.Foundation — AIFoundationContract, EmbeddingVector
• Microsoft.Windows.AI.Imaging — ImageObjectRemover, ImageObjectRemoverContract
• Microsoft.Windows.AI.Text — ConversationItem, ConversationSummaryOptions, InputKind, LanguageModel (создание контекста, генерация embedding-векторов и ответов, проверка длины промпта, получение идентификатора векторного пространства), LanguageModelEmbeddingVectorResult, TextRewriter, TextRewriteTone, TextSummarizer (сводка диалогов и проверка промптов)
• Microsoft.Windows.ApplicationModel.Background.UniversalBGTask — Task.Run
• Microsoft.Windows.Storage.Pickers — поддержка FileOpenPicker, FileSavePicker, FolderPicker и связанных контрактов
• Microsoft.Windows.Widgets.Feeds.Providers — FeedManager.TryRemoveAnnouncementById, IFeedManager3

Новые API по сравнению с 1.8-exp4

• TextSummarizer.IsPromptLargerThanContext
• FileSavePicker.SuggestedFolder

Известные проблемы

• При отдельном использовании компонентных пакетов (например, Microsoft.WindowsAppSDK.WinUI) потребуется ссылка на Microsoft.Windows.SDK.BuildTools.MSIX. Без этого возможна ошибка в некоторых решениях на базе wapproj («WinAppSdkExpandPriContent task not found»). Использование полного пакета Microsoft.WindowsAppSDK (основной сценарий) проблем не вызывает.

• Полный список изменений (оф.сайт, английский)

Новое в версии Windows App SDK 2.0 (Experimental)

Новое в версии 2.0 Experimental 3 (2.0.0-Experimental3) (17.11.2025):

Версия 2.0 Experimental 3 (2.0.0-Experimental3)

Новый контрол SplitMenuFlyoutItem

• SplitMenuFlyoutItem добавляет "split button" внутри MenuFlyout: основное действие + дополнительные варианты в подменю, что помогает сокращать длину меню и компактнее размещать функции.
• Появились свойства SubMenuPresenterStyle и SubMenuItemStyle для настройки подменю (например, можно использовать GridView как presenter).

Windows ML (обновления и изменения API)

• Переименования типов: WinMLCatalogModel переименован в ModelCatalog, CatalogModelSourceModelCatalogSource.
• Методы переведены в Async-форму: например, GetInstanceAsync, CreateFromUriAsync, FindModelAsync, FindAllModelsAsync.
• Изменения свойств и статусов: CatalogModelInfo.Size заменено на CatalogModelInfo.ModelSizeInBytes; добавлен CatalogModelInstanceStatus, а CatalogModelStatus теперь отражает доступность модели локально (Ready/NotReady).
• CatalogModelInfo: Alias -> Name, Revision -> Version, добавлен Publisher, удален DisplayName.
• Изменения JSON каталога: alias переименован в id; удалены modelType и description; executionProvider -> executionProviders, теперь это массив объектов (вместо строки со списком).
• Дополнительно: поддержка Windows 10 (1809)+; поддержка локальных файлов (включая MSIX); исправления падений при некорректном JSON каталога.

AppContentIndexer (обновления API)

• AppIndexQuery разделен на AppIndexTextQuery и AppIndexImageQuery.
• AppContentIndexer.CreateQuery заменен на CreateTextQuery и CreateImageQuery.
• Типы опций обновлены: удалены AppIndexQueryOptions, TextMatchOptions, ImageMatchOptions; добавлены TextQueryOptions и ImageQueryOptions.
• Метод WaitForIndexingIdleAsync теперь принимает TimeSpan (вместо integer) для более понятной настройки таймаута.
• API, которые раньше возвращали массивы, теперь возвращают IVectorView для консистентности и производительности.

Windows AI: новые возможности

• Video Super Resolution AI API (VideoScaler): real-time AI upscaling видео, оптимизированный для потоков с людьми (разговоры). Поддерживаются настройки разрешения, FPS и regions of interest, форматы BGR, RGB и NV12.
• Text Rewriter Tone (RewriteCustomAsync): переписывание текста по "подсказке стиля" (например, "Goofy" или "Pirate") для быстрых стилистических вариаций.
• AI image generation (ImageGenerator, Stable Diffusion): Text-to-Image, Image-to-Image, Magic Fill, Restyle и другие сценарии. Результаты возвращаются в формате RGB8 через ImageBuffer; заявлены встроенные content safety filters и настраиваемые параметры генерации.

Исправления

• Исправлен расчет bounding box при распознавании повернутого текста: в некоторых сценариях OCR-совпадения внутри изображений возвращали неточные или пустые границы.

Новые API (по сравнению с 2.0-experimental2)

• Microsoft.Graphics.Imaging.ImageBufferPixelFormat.Bgr8
• Microsoft.UI.Xaml.Automation.Peers.SplitMenuFlyoutItemAutomationPeer
• Microsoft.UI.Xaml.Controls.SplitMenuFlyoutItem
• Microsoft.Windows.AI.Imaging.ImageGenerator и связанные типы: ImageGenerationOptions, ImageGeneratorResult, ImageGeneratorResultStatus, а также опции/стили для text-to-image и image-to-image.
• Microsoft.Windows.AI.Imaging.TextRecognizer и TextRecognizerOptions
• Microsoft.Windows.AI.MachineLearning.ModelCatalog, ModelCatalogSource, CatalogModelInfo, CatalogModelInstance и связанные статусы/результаты.
• Microsoft.Windows.AI.Search.Experimental.AppContentIndex: AppContentIndexer.CreateTextQuery, CreateImageQuery, WaitForIndexingIdleAsync, а также новые типы запросов и опций.
• Microsoft.Windows.AI.Text.TextRewriter.RewriteCustomAsync
• Microsoft.Windows.AI.Video.VideoScaler и связанные типы: VideoScalerOptions, VideoScalerResult, ScaleFrameStatus.

• Полный список изменений Windows App SDK 2.0 (Experimental) (оф.сайт, английский)

Новое в версии 2.0 Experimental 2 (2.0.0-Experimental2) (06.11.2025):

Версия 2.0 Experimental 2 (2.0.0-Experimental2)

App Content Search (AppContentIndexer)

• API для индексации контента приложения (текст и изображения) с быстрым поиском.
• Поддерживаются лексический (по ключевым словам) и семантический (по смыслу) запросы.
• Описаны сценарии RAG: индекс можно использовать как базу знаний для генеративных моделей, чтобы ответы опирались на реальные документы/фрагменты из приложения.

Windows ML Model Catalog

• Позволяет динамически находить и загружать большие AI-модели из собственных онлайн-каталогов без упаковки моделей вместе с приложением.
• Каталог помогает подбирать совместимые модели под конкретное устройство Windows (железо и execution providers).

Pickers: постоянные и стартовые папки

• В Microsoft.Windows.Storage.Pickers появились опции, упрощающие выбор файлов и папок: можно задавать начальное расположение и сохранять предпочитаемые папки, а также группировать фильтры типов файлов с подписями.

PopupAnchor: относительное позиционирование

• PopupAnchor расширяет DesktopPopupSiteBridge и дает возможность якорного (relative) позиционирования попапов относительно окна/острова, а не только через абсолютные координаты экрана.

Input routing для SystemVisual ContentIslands

• InputUnderlyingWindowController позволяет указать целевой HWND, который будет получать сообщения ввода, пришедшие в ContentIsland, созданный из SystemVisual.

SystemBackdropHost: гибкое размещение backdrop

• SystemBackdropHost позволяет размещать системный backdrop (acrylic/mica) в любой части визуального дерева приложения.

WrapPanel для WinUI XAML

• WrapPanel раскладывает элементы последовательно слева направо с переносом на следующую строку при переполнении, что удобно для адаптивных UI.

Новые API (по сравнению с 2.0-experimental1)

• Microsoft.UI.Content.PopupAnchor
• Microsoft.UI.Input.InputUnderlyingWindowController
• Microsoft.UI.Xaml.Controls.SystemBackdropHost, WrapPanel, StretchChild
• Microsoft.Windows.Storage.Pickers: SuggestedStartFolder, SuggestedFolder, FileTypeChoices (и др.)
• Microsoft.Windows.AI.Search.Experimental.AppContentIndex: новые типы контракта, индексатор, слушатель, типы результатов, match-объекты и опции запросов.

Известные проблемы

• AppContentIndexer рекомендуется вызывать из фонового потока: использование в UI-потоке может приводить к зависаниям/длинным паузам.
• Результаты GetNextTextMatches / GetNextImageMatches могут возвращать null при отсутствии совпадений (вместо пустого списка).
• OCR-области для image matches иногда могут быть неточными (особенно при повороте/искажении текста) и иногда включать нулевые или очень маленькие прямоугольники.
• Пустой запрос из AppContentIndex.CreateQuery может приводить к исключению.

• Полный список изменений Windows App SDK 2.0 (Experimental) (оф.сайт, английский)

Новое в версии 2.0 Experimental 1 (2.0.0-Experimental1) (02.10.2025):

Версия 2.0 Experimental 1 (2.0.0-Experimental1)

Windows AI APIs: on-device AI в приложениях

• Windows App SDK начинает интеграцию Windows AI API для локальных (on-device) сценариев: распознавание текста в изображениях, обработка контента, извлечение объектов и другие функции.
• Важно: для работы требуются поддерживаемые устройства (Copilot+ ПК) и актуальные сборки Windows 11 Insider Preview (Dev Channel). На неподдерживаемых устройствах вызовы API могут завершаться исключениями.

Microsoft Windows ML: Model Catalog APIs

• API каталога моделей позволяют приложению или библиотеке динамически загружать крупные модели из собственных онлайн-каталогов вместо включения их в установочный пакет.
• Каталог помогает находить совместимые модели и делиться загруженными файлами моделей между приложениями, избегая дублирования на диске.

Исправления

• Исправлена проблема в DeploymentManager, из-за которой в некоторых случаях некорректно возвращалось состояние PackageInstallRequired.

Новые API (2.0-experimental1)

• В release notes перечислен большой набор новых/экспериментальных API в пространствах имен WinUI/Composition/Windowing/Input и др., а также первые типы для Windows ML Model Catalog.

• Полный список изменений Windows App SDK 2.0 (Experimental) (оф.сайт, английский)

Системные требования для Windows App SDK включают:

• Операционная система:

  • Windows 10 версии 1809 (сборка 17763) или выше.
  • Windows 11.

• Среда разработки:

  • Visual Studio 2019 версии 16.9 или выше.
  • Visual Studio 2022.

• Языки программирования:

  • C#.
  • C++/WinRT.
  • Rust.

• Дополнительные компоненты:

  • .NET 5 или выше для разработки на C#.
  • Windows 10 SDK версии 10.0.19041.0 или выше.

Эти требования позволяют разрабатывать и тестировать приложения, используя последние технологии и библиотеки, предоставляемые Windows App SDK.

• Microsoft выпустила Windows ML — среда выполнения для локального запуска ИИ-моделей на Windows 11 ПК
• Бесплатные виртуальные машины Windows 11: Visual Studio 2022 и другие инструменты разработки
• В Windows 11 доступны новые виджеты для мониторинга ресурсов системы: CPU, GPU, Память, Сеть
• Microsoft добавит панель «Расширенные параметры Windows» для опытных пользователей Windows 11