Заметки о выпуске стабильного канала для пакета SDK для приложений Windows 1.7

API Windows AI

Пакет SDK для приложений Windows теперь включает набор API искусственного интеллекта (ИИ), которые можно использовать с локальной языковой моделью для выполнения различных задач на компьютерах Copilot+ . Теперь приложения могут интеллектуально реагировать на запросы, распознавать текст в изображениях, описывать содержимое изображений, удалять объекты из изображений и многое другое.

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

Анализ текста phi Silica

С помощью Phi Silica самый мощный NPU,настроенный локальной языковой моделью Майкрософт, можно указать ее для выполнения распространенных задач, таких как сводка фрагмента текста, перезапись фрагмента текста для ясности и преобразование текста в формат таблицы. Phi Silica оптимизирован для повышения эффективности и производительности на устройствах Windows Copilot+ PCs, но по-прежнему предлагает множество возможностей, найденных в крупных языковых моделях (LLMs).

Дополнительные сведения см. в статье "Начало работы с Phi Silica" в пакете SDK для приложений Windows и справочнике по API для Phi Silica в пакете SDK для приложений Windows .

Описание изображения

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

Дополнительные сведения см. в статье "Что можно сделать с описанием изображения" и ссылкой на API для функций создания образов ИИ в пакете SDK для приложений Windows.

Распознавание текста

Распознавание текста, также известное как оптическое распознавание символов (OCR), обнаруживает и извлекает текст в изображениях, преобразуя его в потоки символов, доступные для чтения компьютером. Эти API определяют символы, слова, строки, границы многоугольника и предоставляют уровни достоверности для каждого совпадения. Пользуясь ускорением с помощью NPU, интерфейсы API с поддержкой искусственного интеллекта Windows выполняются быстрее и точнее, чем устаревшие API Windows.Media.Ocr.Ocr.OcrEngine .

Дополнительные сведения см. в статье "Начало работы с распознаванием текста" (OCR) в пакете SDK для приложений Windows и справочнике ПО API для распознавания текста с поддержкой искусственного интеллекта (OCR) в пакете SDK для приложений Windows.

Суперразрешение изображения

API ImageScaler могут увеличить резкость и ясность изображения и увеличить масштаб изображения до 8x его исходного разрешения.

Дополнительные сведения см. в статье "Что можно сделать с разрешением изображений"? И API ref for AI imageing features in the Windows App SDK.

Сегментация изображений

API сегментации изображений позволяют идентифицировать определенные объекты в изображении. При вводе изображения и объекта "подсказки" модель возвращает маску идентифицированного объекта.

Дополнительные сведения см. в статье "Что можно сделать с сегментацией изображений" и ссылкой на API для функций создания образов ИИ в пакете SDK для приложений Windows.

Поддержка создания папок ApplicationData.MachinePath

ApplicationData.MachineFolder теперь проще использовать в Windows >=10.0.26100.0 (Ge). Windows создаст папку Machine при добавлении пакета, который поддерживает opt-in, если Windows App SDK 1.7.2 присутствует в системе. Дополнительные сведения см. в спецификации ApplicationData.

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

• Исправлена телеметрия PackageDeploymentManager для правильного отслеживания состояния завершения. Дополнительные сведения см. в статье о проблеме GitHub #5296. (RuntimeCompatibilityChange: N/A)
• Исправлен сбой при использовании входных данных пера в приложении x86. (Совместимость во время выполнения изменена: InputStateManager_PenInputCrashX86)
• Исправлен потенциальный сбой, если окно уже уничтожено, когда WinUI пытается инициализировать для прокрутки. (RuntimeCompatibilityChange: ActivateDirectManipulationManager_CheckCanInit)
• Исправлены значения WINDOWSAPPSDK_RELEASE_PATCH определения и значения Microsoft::WindowsAppSDK::Release::P atch в WindowsAppSDK-VersionInfo.h, чтобы не всегда быть 0. Теперь определяется дата ymmdd сборки, а значение исправления — это дата mmd. Это изменение обеспечивает лучшую информацию об используемой версии среды выполнения без изменения размеров переменных или схемы версии. (RuntimeCompatibilityChange: N/A, изменение заголовка)
• Исправлена потенциальная проблема в загрузчике, если она используется для загрузки пакета SDK для приложений Windows версии 1.6 или более ранней версии. Дополнительные сведения см. в статье о проблеме GitHub #5349. (RuntimeCompatibilityChange: N/A)
• Исправлена проблема, из-за которой с помощью MSBuild для создания однопроектного приложения может быть неправильно выполнена ошибка сборки, если у него не было правильной launchSettings.json. (RuntimeCompatibilityChange: N/A, изменение целевых объектов сборки)
• Улучшена производительность отрисовки первого кадра при запуске приложения. (RuntimeCompatibilityChange: DwmCoreI_OptimizeFirstFrameLatency)

Новые API для версии 1.7.2

Этот выпуск включает следующие новые API по сравнению с предыдущим выпуском 1.7:

Microsoft.Graphics.Imaging

    ImageBuffer
    ImageBufferContract
    ImageBufferPixelFormat

Microsoft.Windows.AI

    AIFeatureReadyContract
    AIFeatureReadyResult
    AIFeatureReadyResultState
    AIFeatureReadyState

Microsoft.Windows.AI.ContentSafety

    ContentFilterOptions
    ContentSafetyContract
    ImageContentFilterSeverity
    SeverityLevel
    TextContentFilterSeverity

Microsoft.Windows.AI.Imaging

    ImageDescriptionContract
    ImageDescriptionGenerator
    ImageDescriptionKind
    ImageDescriptionResult
    ImageDescriptionResultStatus
    ImageObjectExtractor
    ImageObjectExtractorContract
    ImageObjectExtractorHint
    ImageScaler
    ImageScalerContract
    RecognizedLine
    RecognizedLineStyle
    RecognizedText
    RecognizedTextBoundingBox
    RecognizedWord
    TextRecognitionContract
    TextRecognizer

Microsoft.Windows.AI.Text

    LanguageModel
    LanguageModelContext
    LanguageModelContract
    LanguageModelOptions
    LanguageModelResponseResult
    LanguageModelResponseStatus
    TextIntelligenceContract
    TextRewriter
    TextSummarizer
    TextToTableConverter
    TextToTableResponseResult
    TextToTableRow

Microsoft.Windows.Workloads

    WorkloadPriority
    WorkloadsContract

Это выпуск пакета SDK для приложений Windows, содержащий критические исправления ошибок для выпуска 1.7.

• Улучшена телеметрия для сценариев сбоя в.exeWindowsAppRuntimeInstall-arch<>. Дополнительные сведения см. в статье о проблеме GitHub #5289. (RuntimeCompatibilityChange: N/A, изменение установщика).
• Исправлена проблема, из-за которой входные данные указателя перестают работать при использовании клавиш со стрелками одновременно. Дополнительные сведения см. в статье о проблеме GitHub #10126. (RuntimeCompatibilityChange: FixStuckPointerInputQueue).
• Исправлена проблема, из-за которой приложения в удаленном рабочем столе перестают отвечать на входные данные указателя. Дополнительные сведения см. в статье GitHub о проблеме 10009. (Это то же исправление, что и исправление ввода указателя и клавиш со стрелками, так как удаленный рабочий стол автоматически отправляет некоторые ключевые входные данные во время отключения и обратно.) (RuntimeCompatibilityChange: FixStuckPointerInputQueue).
• Исправлена потенциальная ошибка, пытающаяся восстановить фокус, если событие активации окна доставлено для окна, которое закрывается. (RuntimeCompatibilityChange: Исправление сбоя при закрытии окна и потере фокуса)
• Исправлена регрессия производительности, представленная в пакете SDK для приложений Windows 1.6 из-за отсутствия некоторых оптимизаций компоновщика WinUI. (RuntimeCompatibilityChange: N/A, измененные параметры компоновщика)
• Исправлен потенциальный сбой, если ProgressBar::SetProgressBarIndicatorWidth вызывается на панели ProgressBar, которая не находится в дереве. (RuntimeCompatibilityChange: FixSetProgressBarIndicatorWidthCrash)
• Исправлен потенциальный сбой, вызванный CPopup::EnsureBridgeClosed иногда активирует повторное выполнение. (RuntimeCompatibilityChange: Исправление ошибки переполнения очереди при закрытии всплывающего окна)
• Исправлена потенциальная ошибка при закрытии всплывающего окна из-за CUIElement::FlushPendingKeepVisibleOperations с использованием коллекции дочерних элементов NULL. (RuntimeCompatibilityChange: Исправление сбоя при выгрузке всплывающего окна)
• Исправлена ошибка PackageDeploymentManager.EnsurePackage*Ready для обеспечения замены версий. Дополнительные сведения см. в статье о проблеме GitHub #5191. (RuntimeCompatibilityChange: ОбеспечениеГотовностиПакетаВерсииСуперседенции)
• Исправлен потенциальный сбой, вызванный WebView2::UpdateCoreWebViewVisibility, иногда активируя повторное выполнение. Дополнительные сведения см. в статье о проблеме GitHub #10305. (RuntimeCompatibilityChange: ИсправлениеWebViewVisibilityReentrancyCrash)
• Исправлена проблема, из-за которой пользовательский интерфейс приложения иногда постоянно зависает и может остановить отрисовку из-за зависания диспетчераQueue. (RuntimeCompatibilityChange: FixRandomUIFreezeInDispatcher)

В следующих разделах описываются новые и обновленные функции и известные проблемы для версии 1.7.

Новая функция уведомлений о значках

Значок уведомления передает сводку или сведения о состоянии, относящиеся к приложению. Это может быть числовой (1-99) или глиф из одного из глифов, предоставляемых системой. Эта новая функция позволяет приложениям отображать состояние, например количество непрочитанных писем в почтовом приложении или количество новых записей в приложении социальных сетей.

Дополнительные сведения см. в разделе GitHub #4926.

Новый API CameraCaptureUI

Разработчики столкнулись с проблемами в классических средах из-за того, что WinRT CameraCaptureUI зависит от CoreWindows, и отсутствие поддержки InitializeWithWindow. Команда выпустила этот новый Microsoft.Windows.Media.Capture.CameraCaptureUI API в пакет SDK для приложений Windows, чтобы обеспечить упрощенное решение с похожим набором функций, теперь поддерживая WindowID в конструкторе для расширенной совместимости с настольными системами.

Дополнительные сведения см. в статье о проблеме GitHub #4721.

Новый API проверки подлинности

Новый OAuth2Manager API предоставляет упрощенное решение для аутентификации в вебе, предлагая возможности OAuth 2.0 с полным соответствием функций на всех платформах Windows, поддерживаемых Windows App SDK. Этот новый диспетчер проверки подлинности отличается от общедоступного API брокера webAuthentication, так как лучше соответствует рекомендациям OAuth.

Дополнительные сведения см. в статье о проблеме GitHub #4772.

Поддержка новой фоновой задачи

Фоновые задачи — это компоненты приложения, которые выполняются в фоновом режиме без пользовательского интерфейса, выполняя такие действия, как скачивание файлов, синхронизация данных, отправка уведомлений или обновление файлов. Новый BackgroundTaskBuilder API позволяет приложениям, зависящим от SDK для приложений Windows, напрямую регистрировать компоненты COM полного доверия с задачами фонового выполнения, устраняя необходимость в обходных решениях.

Дополнительные сведения см. в разделе GitHub #4831.

Новый элемент управления TitleBar

Новый TitleBar элемент управления упрощает создание отличной настраиваемой панели заголовков для приложения. Настройте такие свойства, как значок заголовка, название и субтитры, включите встроенную кнопку назад или даже добавьте пользовательский элемент управления, например поле поиска! Элемент управления включает надежные возможности панели заголовков, такие как области пустого пространства, которые можно перетаскивать, адаптивность в зависимости от темы, кнопки управления и встроенная поддержка доступности, что позволяет сосредоточиться на персонализированном дизайне и по-прежнему получить ту же надежную панель заголовков, что и в стандартном интерфейсе.

Дополнительные сведения см. в разделе GitHub #10056.

Поддержка MathML

RichEditBox Теперь поддерживает MathML, через RichEditTextDocument.SetMathMode и RichEditTextDocument.SetMathML.

Дополнительные сведения см. в разделе GitHub #4196.

Расширенная среда выполнения

• API динамических зависимостей пакета SDK для Windows делегируют все вызовы реализации Windows 11 при запуске >= Windows 11 24H2 (10.0.26100.0), обеспечивая улучшенную производительность и надежность. Это относится ко всем API C/C++ (Mdd*()) и WinRT (пространство имен Microsoft.Windows.ApplicationModel.DynamicDependency).
  • Пакетные процессы, вызывающие API динамических зависимостей пакета SDK для Windows, теперь поддерживаются в >= Windows 11 24H2 (10.0.26100.0). Это по-прежнему не поддерживается в старых системах (реализация пакета SDK для приложений Windows не поддерживает упакованные приложения).
  • Это не влияет на опыт разработчика. Вызывающие стороны могут продолжать использовать Bootstrapper API для добавления пакета Windows App SDK в граф пакетов вызывающего процессa.
  • Дополнительные сведения см. в разделе GitHub PR #4949.
• Неподключенная регистрация без поддержки WinRT (URFW) не включена >в = Windows 11 24H2 (10.0.26100.0). Реализация ОС обрабатывает все действия WinRT без регистрации в этих системах, обеспечивая улучшенную производительность и надежность. Дополнительные сведения см. в разделе GitHub PR #4949.
• Detours не используется в >= Windows 11 24H2 (10.0.26100.0). Detours использовался только реализацией пакета SDK для приложений Windows для динамических зависимостей и бесплатной регистрации WinRT, но так как эти функции теперь обрабатываются реализацией ОС, не требуется инициализировать или иным образом проводить обходы. Это обеспечивает небольшую производительность при загрузке Microsoft.WindowsAppRuntime.dll. Дополнительные сведения см. в разделе GitHub PR #4949.

Новые API AppWindow

Новые AppWindow API упрощают управление окнами приложений, чтобы создать отличный интерфейс. Новые возможности включают использование SetTaskBarIcon и SetTitleBarIcon независимое задание значков панели задач и заголовков, используя для задания светлой и темной темы панели заголовка, а AppWindowTitleBar.PreferredTheme также использование новых свойств, таких как OverlappedPresenter.PreferredMinimumWidth и OverlappedPresenter.PreferredMaximumHeight установка минимальной или максимальной ширины или высоты окна.

API Нового острова

Обновления в пространстве имен Microsoft.UI.Content представляют несколько существенных улучшений и новых функций, направленных на улучшение функциональности и взаимодействия API ContentIsland. Эти изменения предназначены для поддержки новых сценариев размещения, улучшения возможностей отрисовки и обеспечения более эффективной синхронизации состояний ввода и специальных возможностей. К ключевым обновлениям относятся:

1. Новые примитивы для размещения ContentIslands:
   • DesktopPopupSiteBridge: включает размещение ContentIsland в среде окна Win32 с WS_POPUP стилем, упрощая сценарии, в которых приложения используют всплывающие окна для диалоговых окон и полей сообщений.
   • ChildSiteLink: позволяет родителю ContentIsland размещать вложенный дочерний элемент ContentIsland, обеспечивая простое секционирование поверхности отрисовки без швов взаимодействия с пользователем.
   • DesktopAttachedSiteBridge: присоединяется к существующему окну Win32 вместо создания новой, предназначенной для размещения ContentIsland с помощью Windows.UI.Composition.Visuals в корне иерархии окон Win32, обеспечивая полный контроль над обработкой входных данных и специальными возможностями на основе Win32.
2. Улучшенная синхронизация отрисовки и ввода:
   • Свойства LocalToParentTransformMatrix объекта ActualSize обновляются относительно родительского ChildSiteLink элемента ContentIsland перед отрисовкой, избегая задержки и обеспечивая синхронизированные входные и специальные возможности.
3. ContentIslands с Windows.UI.Composition.Visuals:
   • ContentIsland можно использовать Windows.UI.Composition.Visuals для отрисовки и API окон Win32 для обработки входных данных, что позволяет взаимодействовать с приложениями, используюющими устаревшие платформы пользовательского интерфейса. Это позволяет постепенно внедрять более новые платформы пользовательского интерфейса, наложенные на граф сцены пакета SDK для Windows, например WinUI и React Native для Windows on Fabric. Эти обновления совместно повышают гибкость, производительность и взаимодействие API ContentIsland, что позволяет разработчикам создавать более сложные и адаптивные приложения.

Кроме того, обновления в пространстве имен Microsoft.UI.Xaml представляют новый XamlIsland API, который позволяет размещать содержимое Xaml в SiteBridge или a ChildSiteLink. Это XamlIsland обеспечивает большую гибкость по сравнению с DesktopWindowXamlSource API. Хотя DesktopWindowXamlSource требуется размещение в существующем окне Win32, предоставляется XamlIslandContentIslandдополнительный вариант размещения содержимого Xaml.

Другие важные изменения

• Новая RuntimeCompatibilityOptions поддержка позволит повысить контроль над тем, как изменения обслуживания влияют на приложения. Дополнительные сведения см. в разделе GitHub #4966.
• Новый ReleaseInfo API предоставляет простой доступ к используемой версии среды выполнения пакета SDK для приложений Windows. Дополнительные сведения см. в разделе GitHub #2893.
• Примечание. API Windows AI не включены в этот выпуск. Чтобы поэкспериментировать с этими API, продолжайте использовать выпуск 1.7-экспериментальный3 и поделитесь своими отзывами!

Новые API для версии 1.7.0

Этот выпуск включает следующие новые API по сравнению с стабильным выпуском 1.6:

Microsoft.Security.Authentication.OAuth

    AuthFailure
    AuthRequestParams
    AuthRequestResult
    AuthResponse
    ClientAuthentication
    CodeChallengeMethodKind
    OAuth2Manager
    TokenFailure
    TokenFailureKind
    TokenRequestParams
    TokenRequestResult
    TokenResponse

Microsoft.UI.Content

    ChildSiteLink
    ContentAutomationOptions
    ContentEnvironmentStateChangedEventArgs
        DidDisplayScaleChange

    ContentIsland
        AutomationOption
        Children
        CreateForSystemVisual
        FindAllForSystemCompositor
        FragmentRootAutomationProvider
        GetBySystemVisual
        LocalToClientTransformMatrix
        LocalToParentTransformMatrix
        NextSiblingAutomationProvider
        ParentAutomationProvider
        Popups
        PreviousSiblingAutomationProvider
        ProcessesKeyboardInput
        ProcessesPointerInput

    ContentIslandEnvironment
        DisplayScale

    ContentIslandStateChangedEventArgs
        DidLocalToClientTransformMatrixChange
        DidLocalToParentTransformMatrixChange

    ContentSite
        LocalToClientTransformMatrix
        LocalToParentTransformMatrix
        ProcessesKeyboardInput
        ProcessesPointerInput

    ContentSiteAutomationProviderRequestedEventArgs
    ContentSiteEnvironment
        DisplayScale

    ContentSiteEnvironmentView
        DisplayScale

    ContentSiteView
        AutomationOption
        LocalToClientTransformMatrix
        LocalToParentTransformMatrix
        ProcessesKeyboardInput
        ProcessesPointerInput

    DesktopAttachedSiteBridge
    DesktopChildSiteBridge
        CreateWithDispatcherQueue

    DesktopPopupSiteBridge
    IContentSiteAutomation
    IContentSiteInput
    IContentSiteLink

Microsoft.UI.Input

    InputFocusNavigationHost
        GetForSiteLink

Microsoft.UI.Text

    RichEditTextDocument
        GetMathML
        GetMathMode
        SetMathML
        SetMathMode

Microsoft.UI.Windowing

    AppWindow
        SetTaskbarIcon
        SetTitleBarIcon

    AppWindowTitleBar
        PreferredTheme

    OverlappedPresenter
        PreferredMaximumHeight
        PreferredMaximumWidth
        PreferredMinimumHeight
        PreferredMinimumWidth

    TitleBarTheme

Microsoft.UI.Xaml

    XamlIsland
    XamlRoot
        ContentIsland

Microsoft.UI.Xaml.Controls

    TitleBar
    TitleBarAutomationPeer
    TitleBarTemplateSettings

Microsoft.Windows.ApplicationModel.Background

    BackgroundTaskBuilder

Microsoft.Windows.ApplicationModel.Background.UniversalBGTask

    Task

Microsoft.Windows.ApplicationModel.WindowsAppRuntime

    ReleaseInfo
    RuntimeCompatibilityChange
    RuntimeCompatibilityOptions
    RuntimeInfo
    WindowsAppRuntimeVersion

Microsoft.Windows.BadgeNotifications

    BadgeNotificationGlyph
    BadgeNotificationManager

Microsoft.Windows.Media.Capture

    CameraCaptureUI
    CameraCaptureUIMaxPhotoResolution
    CameraCaptureUIMaxVideoResolution
    CameraCaptureUIMode
    CameraCaptureUIPhotoCaptureSettings
    CameraCaptureUIPhotoFormat
    CameraCaptureUIVideoCaptureSettings
    CameraCaptureUIVideoFormat

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

В этом выпуске содержатся следующие исправления ошибок:

• Изменено SplitButton , поэтому сенсорные входные данные теперь соответствуют поведению входных данных мыши. Дополнительные сведения см. в статье о проблеме GitHub #178.
• Изменены каскадные меню, поэтому вложенные меню теперь открываются немедленно, если щелкнуть. Дополнительные сведения см. в статье о проблеме GitHub #939.
• Исправлена проблема, из-за которой открытие ComboBox, находящегося во всплывающем элементе, закрывает все всплывающие элементы. Дополнительные сведения см. в статье о проблеме GitHub #1467.
• Исправлена проблема, из-за которой SwipeControl случайно приводил к сбою в ListView. Дополнительные сведения см. в статье о проблеме GitHub #2527.
• Исправлена проблема, из-за которой при перетаскивании только ListViewItem оно оставалось в неправильном визуальном состоянии. Дополнительные сведения см. в статье о проблеме GitHub #3458.
• Исправлена проблема в StackLayout, чтобы учитывать свойства ItemsRepeater.HorizontalAlignment и ItemsRepeater.VerticalAlignment (когда StackLayout.Orientation установлен в вертикальное и горизонтальное положение соответственно). Старый макет работал так, как если бы выравнивание ItemsRepeater было Stretch. Исправление приводит к тому, что макет выравнивает элементы по правому краю при использовании соответствующего выравнивания. Дополнительные сведения см. в статье GitHub о проблеме 3842.
• Исправлен потенциальный сбой при использовании ресурса, содержащего объект x:Bind. Дополнительные сведения см. в статье о проблеме GitHub #5786.
• Исправлена проблема, из-за которой удаление элементов в источнике ItemsRepeaterне создавало элементы, которые перемещались в представление. Дополнительные сведения см. в статье о проблеме GitHub #6661.
• Исправлена проблема, из-за которой правый клавиша ALT не отображала подсказки для ключей доступа. Дополнительные сведения см. в статье о проблеме GitHub #8447. Заметка: Это может привести к тому, что ключевые события для правого клавиши ALT больше не доставляются для обработки в приложении или элементах управления.
• Исправлена проблема, из-за которой использование ResourceDictionary, содержащего только один ресурс, не сможет найти этот ресурс и, скорее всего, приведет к сбою. Дополнительные сведения см. в статье о проблеме GitHub #8832.
• Исправлен сбой, когда UniformGridLayout иногда выбирал неправильную привязку макета, что приводило к бесконечному прохождению макетов при прокрутке назад. Дополнительные сведения см. в статье о проблеме GitHub #9199.
• Исправлена проблема, из-за которой установка NavigationFailedEventArgs.Handled в значение True всё равно приводила к исключению. Дополнительные сведения см. в статье о проблеме GitHub #9632.
• Исправлена проблема, из-за которой TabView не применялось ни одно из указанных CornerRadius. Дополнительные сведения см. в статье о проблеме GitHub #9846.
• Исправлена потенциальная аварийная ошибка цикла макета в StackLayout. Дополнительные сведения см. в статье о проблеме GitHub #9852.
• Исправлен потенциальный сбой ItemsView при удалении элементов. Дополнительные сведения см. в статье о проблеме GitHub #9868.
• Исправлена проблема в версии 1.7-preview1, в которой всплывающие окна больше не перемещены с родительским окном. Дополнительные сведения см. в статье о проблеме GitHub #10386.
• На основе отзывов от версии 1.7-preview1 переименованы некоторые свойства нового TitleBar элемента управления.