Поделиться через

Последние заметки о выпуске экспериментального канала для пакета SDK для приложений Windows

Внимание

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

Экспериментальный канал включает выпуски пакета SDK для приложений Windows с функциями экспериментального канала на ранних этапах разработки. API для экспериментальных функций имеют экспериментальный атрибут. При вызове экспериментального API в коде вы получите предупреждение во время сборки. Все API в экспериментальном канале подвергаются обширным переработкам и разрушительным изменениям. Экспериментальные функции и API могут быть удалены из последующих выпусков в любое время.

Важные ссылки:

Архив примечаний к выпускам канала экспериментального:

Экспериментальная версия 1.8 (1.8.0-experimental2)

Использование ИИ на устройстве с API Windows AI

Внимание

Базовые модели машинного обучения, необходимые для этих API, в настоящее время требуют, чтобы устройство работало с последней сборкой предварительной версии Windows 11 Insider Preview на канале разработки. Кроме того, эти API-интерфейсы требуют, чтобы устройство было компьютером Copilot+. Дополнительные сведения об этих устройствах см. в руководстве разработчика Copilot+ PCs. API-интерфейсы вызывают исключение при вызове на устройствах, не имеющих необходимой поддержки.

Пакет SDK для приложений Windows включает расширенные возможности ИИ Windows, что позволяет разработчикам легко интегрировать интеллектуальные функции в свои приложения. Эти улучшения включают локальные функции ИИ, такие как реагирование на входящие запросы, распознавание текста в изображениях, описание содержимого изображения, извлечение объектов из рисунков и многое другое.

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

Десятичный тип данных

Новая Decimal поддержка предлагает высокоточный десятичный числовой тип данных, который является бесценным для финансовых и научных вычислений, избегая неточности и ошибок округления, присущих числовым типам данных с плавающей точкой. Он структурирован как 96-разрядное (12-байтовое) целое число без знака, масштабируемое переменной мощностью 10, что позволяет точно представлять десятичные значения. Это обеспечивает десятичную поддержку языков программирования без десятичных типов данных и обеспечивает взаимодействие с языками, поддерживающими десятичную (например, C#, Python).

Метапакет NuGet

NuGet пакет SDK для приложений Windows был преобразован в метапакет NuGet. Каждый компонент, участвующий в Windows App SDK, теперь является пакетом NuGet и указывается в качестве зависимости в метапакете. Это позволяет разработчикам выбирать метапакет или выбирать определенные пакеты компонентов для своих приложений. Использование отдельных пакетов компонентов позволяет разработчикам включать только API и функциональные возможности, необходимые для своих приложений. Интерфейс по умолчанию ведет себя так, как если бы WindowsAppSDKSelfContained был установлен в значение True, но для использования развертывания пакета платформы необходимо ссылаться на пакет Microsoft.WindowsAppSDK.Packages.

Microsoft.Windows.SDK.BuildTools.MSIX Рефакторинг

Поддержка публикации MSIX была включена в отдельный пакет NuGet, который может поддерживаться и использоваться Windows App SDK и другими проектами независимо. Кроме того, были решены некоторые недоработки в функционале с решениями Single-Project, включая создание пакетов MSIX и пакетов загрузки MSIX.

API Windows AI

Low-Rank Адаптация (LoRA) для Phi Silica

Low-Rank Адаптация (LoRA) для Phi Silica позволяет разработчикам настраивать с точностью языковую модель на устройстве (Phi Silica), используя пользовательские данные. Этот адаптер позволяет выровнять выходные данные для конкретных сценариев, таких как финансы, медицинские и учебные заведения. Дополнительные сведения см. в разделе Phi Silica LoRA .

Аналитика текста — сводка по беседе

Phi Silica теперь имеет функцию "Сводка беседы", которая позволяет суммировать то, что люди сказали по электронной почте, чату или потоку. Дополнительные сведения см. в разделе Phi Silica .

Новые API для экспериментальной версии 1.8-2

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

Microsoft.UI.Composition

    CompositionNotificationDeferral
    CompositionProjectedShadow
        MaxOpacity
        MinOpacity
        OpacityFalloff

    CompositionProjectedShadowCaster
        AncestorClip
        Mask

    CompositionProjectedShadowDrawOrder
    CompositionProjectedShadowReceiver
        DrawOrder
        Mask

Microsoft.UI.Composition.Experimental

    ExpCompositionVisualSurface
    ExpExpressionNotificationProperty
    IExpCompositionPropertyChanged
    IExpCompositionPropertyChangedListener
    IExpCompositor
    IExpVisual

Microsoft.UI.Content

    ContentAppWindowBridge
    ContentDisplayOrientations
    ContentExternalBackdropLink
    ContentExternalOutputLink
    ContentIsland
        Connected
        ConnectionInfo
        ConnectRemoteEndpoint
        Disconnected
        IsRemoteEndpointConnected
        Root

    ContentIslandEnvironment
        CurrentOrientation
        NativeOrientation
        ThemeChanged

    ContentSite
        SetContentNodeParent
        TryGetAutomationProvider

    ContentSiteEnvironment
        CurrentOrientation
        NativeOrientation
        NotifyThemeChanged

    CoreWindowSiteBridge
    CoreWindowTopLevelWindowBridge
    DesktopChildSiteBridge
        AcceptRemoteEndpoint
        ConnectionInfo
        IsRemoteEndpointConnected
        RemoteEndpointConnecting
        RemoteEndpointDisconnected
        RemoteEndpointRequestedStateChanged

    DesktopSiteBridge
        TryCreatePopupSiteBridge

    EndpointConnectionEventArgs
    EndpointRequestedStateChangedEventArgs
    IContentIslandEndpointConnectionPrivate
    IContentNodeOwner
    IContentSiteBridgeEndpointConnectionPrivate
    PopupWindowSiteBridge
    ProcessStarter
    SystemVisualSiteBridge

Microsoft.UI.Input

    InputKeyboardSource
        GetForWindowId

    InputLayoutPolicy
    InputLightDismissAction
        GetForIsland

    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior
        DirectManipulationHitTest
        GetForVisual
        GetForWindowId
        RemoveForVisual
        TouchHitTesting
        TrySetDeviceKinds

    ProximityEvaluation
    TouchHitTestingEventArgs

Microsoft.UI.Windowing

    AppWindow
        GetCurrentPlacement
        PersistedStateId
        PlacementRestorationBehavior
        SaveCurrentPlacement
        SaveCurrentPlacementForAllPersistedStateIds
        SetCurrentPlacement

    AppWindowPlacementDetails
    DisplayArea
        GetMetricsFromWindowId

    PlacementInfo
    PlacementRestorationBehavior

Microsoft.UI.Xaml

    XamlIsland
        ShouldConstrainPopupsToWorkArea

Microsoft.UI.Xaml.Automation.Peers

    AutomationEvents
        Notification

    InkCanvasAutomationPeer
    PagerControlAutomationPeer

Microsoft.UI.Xaml.Controls

    ContentDialogPlacement
        UnconstrainedPopup

    DoInkPresenterWork
    ElementFactory
    FlowLayout
    FlowLayoutAnchorInfo
    FlowLayoutLineAlignment
    FlowLayoutState
    IApplicationViewSpanningRects
    IndexPath
    InkCanvas
    ISelfPlayingAnimatedVisual
    ItemContainer
        CanUserInvoke
        CanUserInvokeProperty
        CanUserSelect
        CanUserSelectProperty
        ItemInvoked
        MultiSelectMode
        MultiSelectModeProperty

    ItemContainerInteractionTrigger
    ItemContainerInvokedEventArgs
    ItemContainerMultiSelectMode
    ItemContainerUserInvokeMode
    ItemContainerUserSelectMode
    LayoutPanel
    NumberBox
        InputScope
        InputScopeProperty
        TextAlignment
        TextAlignmentProperty

    PagerControl
    PagerControlButtonVisibility
    PagerControlDisplayMode
    PagerControlSelectedIndexChangedEventArgs
    PagerControlTemplateSettings
    ProgressRing
        DeterminateSource
        DeterminateSourceProperty
        IndeterminateSource
        IndeterminateSourceProperty

    RecyclePool
    RecyclingElementFactory
    ScrollingScrollStartingEventArgs
    ScrollingZoomStartingEventArgs
    ScrollView
        ScrollStarting
        ZoomStarting

    SelectionModel
    SelectionModelChildrenRequestedEventArgs
    SelectionModelSelectionChangedEventArgs
    SelectTemplateEventArgs
    StackLayout
        IsVirtualizationEnabled
        IsVirtualizationEnabledProperty

    StackLayoutState
    TeachingTip
        Opened

    TeachingTipOpenedEventArgs
    UniformGridLayoutState

Microsoft.UI.Xaml.Controls.Primitives

    ScrollPresenter
        ScrollStarting
        ZoomStarting

Microsoft.Windows.AI.Foundation

    AIFoundationContract
    EmbeddingVector

Microsoft.Windows.AI.Imaging

    ImageObjectRemover
    ImageObjectRemoverContract

Microsoft.Windows.AI.Text

    ConversationItem
    ConversationSummaryOptions
    InputKind
    LanguageModel
        CreateContext
        CreateContext
        CreateContext
        GenerateEmbeddingVectors
        GenerateEmbeddingVectors
        GenerateResponseAsync
        GenerateResponseAsync
        GenerateResponseAsync
        GenerateResponseFromEmbeddingsAsync
        GenerateResponseFromEmbeddingsAsync
        GenerateResponseFromEmbeddingsAsync
        GetUsablePromptLength
        GetUsablePromptLength
        GetVectorSpaceId

    LanguageModelEmbeddingVectorResult
    TextSummarizer
        SummarizeConversationAsync

Microsoft.Windows.AI.Text.Experimental (C#-only, see Known Issues)
 
    LowRankAdaptation
    LanguageModelOptionsExperimental
    LanguageModelExperimental

Microsoft.Windows.ApplicationModel.Background.UniversalBGTask

    Task
        Run

Microsoft.Windows.ApplicationModel.WindowsAppRuntime

    DeploymentManager
        Repair

    DeploymentStatus
        PackageRepairFailed

Microsoft.Windows.AppNotifications

    AppNotification
        ConferencingConfig

    AppNotificationConferencingConfig

Microsoft.Windows.AppNotifications.Builder

    AppNotificationBuilder
        AddCameraPreview

    AppNotificationButton
        SetSettingStyle

    AppNotificationButtonSettingStyle

Microsoft.Windows.Storage

    ApplicationData
        GetForUnpackaged

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
    FileSavePicker
    FolderPicker
    PickerLocationId
    PickerViewMode
    PickFileResult
    PickFolderResult

Microsoft.Windows.Vision

    ScreenRegionBoundingBox
    ScreenRegionDetectionContract
    ScreenRegionLabel

Microsoft.Windows.Widgets.Feeds.Providers

    FeedManager
        TryRemoveAnnouncementById

    IFeedManager3

Microsoft.Windows.Widgets.Providers

    WidgetInfo
        Rank

    WidgetUpdateRequestOptions
        Rank

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

  • Проекции API Microsoft.Windows.AI.Text.Experimental для C++ отсутствуют в этом выпуске. Проекции доступны для использования из C#.
  • Если вы используете пакет компонента Microsoft.WindowsAppSDK.WinUI в автономном режиме по умолчанию, установите для свойства WebView2EnableCsWinRTProjection значение true при использовании API WebView2. Это помогает предотвратить конфликты версий и избежать связанных предупреждений.
  • При использовании пакетов компонентов WindowsAppSDK можно заметить предупреждение NU1603 , указывающее, что указанная версия зависимого пакета компонентов не найдена, но была устранена другая. Ожидается, что в экспериментальной сборке и NuGet будет правильно разрешать более новую версию пакета, которая позволит вашему проекту создавать. Если предупреждения рассматриваются как ошибки, можно временно рассматривать это предупреждение как не ошибку, указав свойство <WarningsNotAsErrors>NU1603</WarningsNotAsErrors>.

Экспериментальная версия 1.8 (1.8.0-experimental1)

Использование ИИ на устройстве с API Windows AI

Внимание

Базовые модели машинного обучения, необходимые для этих API, в настоящее время требуют, чтобы устройство работало с последней сборкой предварительной версии Windows 11 Insider Preview на канале разработки. Кроме того, эти API-интерфейсы требуют, чтобы устройство было компьютером Copilot+. Дополнительные сведения об этих устройствах см. в руководстве разработчика Copilot+ PCs. API-интерфейсы вызывают исключение при вызове на устройствах, не имеющих необходимой поддержки.

API-интерфейсы ИИ Windows предлагают несколько функций и API, управляемых ИИ, для упрощения, эффективного и ответственного использования моделей ИИ на устройстве в приложениях Windows. В этом выпуске мы предлагаем несколько api, ориентированных на сценарии, для использования мощных возможностей без необходимости находить, запускать или оптимизировать собственные модели машинного обучения (ML).

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

Это последний выпуск экспериментального канала.

Чтобы скачать, измените версию NuGet WinAppSDK на 1.8.250515001-experimental1.

Удаление объекта

Данный ImageObjectRemover можно использовать для удаления объектов из изображений. Модель принимает как изображение, так и маску с серой шкалой, указывающую на удаление объекта, удаляет маскированную область из изображения и заменяет стертую область фоном изображения.

Новые API для 1.8-experimental1

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

Microsoft.Graphics.Imaging

    ImageBuffer
    ImageBufferContract
    ImageObjectExtractor
    ImageObjectExtractorContract
    ImageObjectExtractorHint
    ImageObjectRemover
    ImageObjectRemoverContract
    ImageScaler
    ImageScalerContract
    PixelFormat

Microsoft.UI.Composition

    CompositionNotificationDeferral
    CompositionProjectedShadow
        MaxOpacity
        MinOpacity
        OpacityFalloff

    CompositionProjectedShadowCaster
        AncestorClip
        Mask

    CompositionProjectedShadowDrawOrder
    CompositionProjectedShadowReceiver
        DrawOrder
        Mask

Microsoft.UI.Composition.Experimental

    ExpCompositionVisualSurface
    ExpExpressionNotificationProperty
    IExpCompositionPropertyChanged
    IExpCompositionPropertyChangedListener
    IExpCompositor
    IExpVisual

Microsoft.UI.Content

    ContentAppWindowBridge
    ContentDisplayOrientations
    ContentExternalBackdropLink
    ContentExternalOutputLink
    ContentIsland
        Connected
        ConnectionInfo
        ConnectRemoteEndpoint
        Disconnected
        IsRemoteEndpointConnected
        Root

    ContentIslandEnvironment
        CurrentOrientation
        NativeOrientation
        ThemeChanged

    ContentSite
        SetContentNodeParent
        TryGetAutomationProvider

    ContentSiteEnvironment
        CurrentOrientation
        NativeOrientation
        NotifyThemeChanged

    CoreWindowSiteBridge
    CoreWindowTopLevelWindowBridge
    DesktopChildSiteBridge
        AcceptRemoteEndpoint
        ConnectionInfo
        IsRemoteEndpointConnected
        RemoteEndpointConnecting
        RemoteEndpointDisconnected
        RemoteEndpointRequestedStateChanged

    DesktopSiteBridge
        TryCreatePopupSiteBridge

    EndpointConnectionEventArgs
    EndpointRequestedStateChangedEventArgs
    IContentIslandEndpointConnectionPrivate
    IContentNodeOwner
    IContentSiteBridgeEndpointConnectionPrivate
    PopupWindowSiteBridge
    ProcessStarter
    SystemVisualSiteBridge

Microsoft.UI.Input

    InputKeyboardSource
        GetForWindowId

    InputLayoutPolicy
    InputLightDismissAction
        GetForIsland

    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior
        DirectManipulationHitTest
        GetForVisual
        GetForWindowId
        RemoveForVisual
        TouchHitTesting
        TrySetDeviceKinds

    ProximityEvaluation
    TouchHitTestingEventArgs

Microsoft.UI.Input.Experimental

    ExpInputSite
    ExpPointerPoint

Microsoft.UI.Windowing

    AppWindow
        GetCurrentPlacement
        PersistedStateId
        PlacementRestorationBehavior
        SaveCurrentPlacement
        SaveCurrentPlacementForAllPersistedStateIds
        SetCurrentPlacement

    AppWindowPlacementDetails
    DisplayArea
        GetMetricsFromWindowId

    PlacementInfo
    PlacementRestorationBehavior

Microsoft.UI.Xaml

    XamlIsland
        ShouldConstrainPopupsToWorkArea

Microsoft.UI.Xaml.Automation.Peers

    AutomationEvents
        Notification

    InkCanvasAutomationPeer
    PagerControlAutomationPeer

Microsoft.UI.Xaml.Controls

    ContentDialogPlacement
        UnconstrainedPopup

    DoInkPresenterWork
    ElementFactory
    FlowLayout
    FlowLayoutAnchorInfo
    FlowLayoutLineAlignment
    FlowLayoutState
    IApplicationViewSpanningRects
    IndexPath
    InkCanvas
    ISelfPlayingAnimatedVisual
    ItemContainer
        CanUserInvoke
        CanUserInvokeProperty
        CanUserSelect
        CanUserSelectProperty
        ItemInvoked
        MultiSelectMode
        MultiSelectModeProperty

    ItemContainerInteractionTrigger
    ItemContainerInvokedEventArgs
    ItemContainerMultiSelectMode
    ItemContainerUserInvokeMode
    ItemContainerUserSelectMode
    LayoutPanel
    NumberBox
        InputScope
        InputScopeProperty
        TextAlignment
        TextAlignmentProperty

    PagerControl
    PagerControlButtonVisibility
    PagerControlDisplayMode
    PagerControlSelectedIndexChangedEventArgs
    PagerControlTemplateSettings
    ProgressRing
        DeterminateSource
        DeterminateSourceProperty
        IndeterminateSource
        IndeterminateSourceProperty

    RecyclePool
    RecyclingElementFactory
    ScrollingScrollStartingEventArgs
    ScrollingZoomStartingEventArgs
    ScrollView
        ScrollStarting
        ZoomStarting

    SelectionModel
    SelectionModelChildrenRequestedEventArgs
    SelectionModelSelectionChangedEventArgs
    SelectTemplateEventArgs
    StackLayout
        IsVirtualizationEnabled
        IsVirtualizationEnabledProperty

    StackLayoutState
    UniformGridLayoutState

Microsoft.UI.Xaml.Controls.Primitives

    ScrollPresenter
        ScrollStarting
        ZoomStarting

Microsoft.Windows.AI

    AIFeatureReadyContract
    AIFeatureReadyResult
    AIFeatureReadyResultState
    AIFeatureReadyState

Microsoft.Windows.AI.ContentModeration

    ContentFilterOptions
    ContentModerationContract
    ImageContentFilterSeverity
    SeverityLevel
    TextContentFilterSeverity

Microsoft.Windows.AI.Generative

    ImageDescriptionContract
    ImageDescriptionGenerator
    ImageDescriptionKind
    ImageDescriptionResult
    ImageDescriptionResultStatus
    LanguageModel
    LanguageModelContext
    LanguageModelContract
    LanguageModelEmbeddingVectorResult
    LanguageModelOptions
    LanguageModelResponseResult
    LanguageModelResponseStatus

Microsoft.Windows.ApplicationModel.WindowsAppRuntime

    DeploymentManager
        Repair

    DeploymentStatus
        PackageRepairFailed

Microsoft.Windows.AppNotifications

    AppNotification
        ConferencingConfig

    AppNotificationConferencingConfig

Microsoft.Windows.AppNotifications.Builder

    AppNotificationBuilder
        AddCameraPreview

    AppNotificationButton
        SetSettingStyle

    AppNotificationButtonSettingStyle

Microsoft.Windows.SemanticSearch

    EmbeddingVector
    SemanticSearchContract

Microsoft.Windows.Storage

    ApplicationData
        GetForUnpackaged

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
    FileSavePicker
    FolderPicker
    PickerLocationId
    PickerViewMode
    PickFileResult
    PickFolderResult

Microsoft.Windows.Vision

    BoundingBox
    DetectedLineStyle
    OrientationDetectionOptions
    RecognizedLine
    RecognizedLineStyle
    RecognizedText
    RecognizedWord
    TextRecognitionContract
    TextRecognizer
    TextRecognizerOptions

Microsoft.Windows.Widgets.Feeds.Providers

    FeedManager
        TryRemoveAnnouncementById

    IFeedManager3

Microsoft.Windows.Workloads

    WorkloadPriority
    WorkloadsContract

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

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

  • Исправлена проблема, из-за которой входные данные колесика мыши игнорируются, если параметр "Прокрутка неактивных окон при наведении на них" в параметрах Windows отключен. Дополнительные сведения см. в статье о проблеме GitHub #10091.