Compartir a través de

Notas de la versión del canal experimental más reciente para el SDK de Aplicaciones para Windows

Importante

El canal experimental no es compatible para el uso en entornos de producción, y las aplicaciones que utilizan las versiones experimentales no se pueden publicar en Microsoft Store.

El canal experimental incluye versiones del SDK de Aplicaciones para Windows con características del canal experimental que se encuentran en las primeras fases de desarrollo. Las API de características experimentales tienen el atributo Experimental. Si llama a una API experimental en el código, recibirá una advertencia durante la compilación. Todas las API del canal experimental están sujetas a revisiones exhaustivas y cambios importantes. Las características experimentales y las API se pueden quitar de las versiones posteriores en cualquier momento.

Vínculos importantes:

Versión 1.8 Experimental (1.8.0-Experimental4)

Uso de la IA en dispositivos con las API de IA de Windows

Importante

Actualmente, los modelos de ML subyacentes necesarios para estas API requieren que el dispositivo ejecute la compilación más reciente de Windows 11 Insider Preview en el canal de desarrollo. Además, estas API requieren que su dispositivo sea un PC Copilot+. Consulte Guía del desarrollador de PC Copilot+ para obtener más información sobre estos dispositivos. Las APIs producirán una excepción cuando se llame en dispositivos que no tienen la compatibilidad necesaria.

El SDK de aplicaciones de Windows incorpora funcionalidades avanzadas de inteligencia artificial de Windows, lo que permite a los desarrolladores integrar sin problemas características inteligentes en sus aplicaciones. Estas mejoras incluyen funcionalidades de inteligencia artificial local, como responder a mensajes entrantes, reconocer texto dentro de imágenes, describir el contenido de la imagen, extraer objetos de imágenes, etc.

Para obtener información sobre las prácticas de desarrollo responsables que se usan durante la creación de las API de ia de Windows, que también se pueden aplicar al crear características asistidas por IA, consulte las instrucciones sobre desarrollo de aplicaciones y características de IA generativas responsables en Windows .

Microsoft Windows ML

Windows ML incorpora funcionalidades de aprendizaje automático aceleradas por hardware a las aplicaciones de Windows. El paquete Microsoft.WindowsAppSDK.ML proporciona una versión optimizada para Windows de ONNX Runtime con API simplificadas para administrar proveedores de ejecución.

Características principales:

  • Abstracción de hardware: detecta y administra automáticamente proveedores de ejecución compatibles con el hardware.
  • Administración simplificada de EP: controla la adquisición, la instalación y el registro de proveedores de ejecución en el dispositivo local en el que se ejecuta la aplicación.
  • Integración directa de ONNX Runtime: funciona directamente con las API en tiempo de ejecución de ONNX para la inferencia de modelos.
  • Compatibilidad con varios lenguajes: disponible para C++, C#, Python y otros lenguajes.

WindowsAppSDK.Packages ha cambiado el nombre

Se ha cambiado el nombre del paquete Microsoft.WindowsAppSDK.Packages de componentes de NuGet a Microsoft.WindowsAppSDK.Runtime. Este cambio refleja mejor el propósito del paquete y aclara su rol dentro del SDK, específicamente, que encapsula el componente en tiempo de ejecución.

Informe del límite de tamaño del mensaje

Permite a las aplicaciones determinar si una entrada supera el tamaño permitido para una llamada de Text Summarizer. Si la entrada es demasiado grande, la API devuelve un índice que indica el límite actual, lo que permite a los desarrolladores ajustar la entrada en consecuencia. Este límite se basa en el recuento de tokens en lugar de en bytes o longitud de caracteres, y puede variar con el tiempo debido a varios factores. Por lo tanto, las aplicaciones deben tratar el límite como dinámico y sujeto a cambios.

Tono del reescritor de texto

Habilita la reescritura de texto con tonos específicos. La opción Casual parafrasea el contenido para que suene más informal y conversacional, usando expresiones naturales y espontáneas mientras preserva el significado y el formato. La opción Formal transforma el texto en una versión pulida y profesional, manteniendo la estructura original y los detalles con un lenguaje preciso adecuado para el contexto formal. La opción General conserva el tono y la intención originales, lo que garantiza que el significado permanece sin cambios.

Opciones de resumen de conversación

Permite a los desarrolladores especificar el lenguaje de salida deseado para el resumen de conversación. Esto permite a las aplicaciones generar resúmenes en un idioma de destino, mejorar la localización y la experiencia del usuario.

Correcciones de errores

Nuevas API para 1.8-experimental4

Esta versión incluye las siguientes API experimentales nuevas y modificadas:

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
        TryGetAutomationProvider
 
    ContentSiteEnvironment
        CurrentOrientation
        NativeOrientation
        NotifyThemeChanged
 
    CoreWindowSiteBridge
    CoreWindowTopLevelWindowBridge
    DesktopChildSiteBridge
        AcceptRemoteEndpoint
        ConnectionInfo
        IsRemoteEndpointConnected
        RemoteEndpointConnecting
        RemoteEndpointDisconnected
        RemoteEndpointRequestedStateChanged
 
    DesktopPopupSiteBridge
        AnchoringBehavior
        AnchoringPixelAlignment
 
    DesktopSiteBridge
        TryCreatePopupSiteBridge
 
    EndpointConnectionEventArgs
    EndpointRequestedStateChangedEventArgs
    IContentIslandEndpointConnectionPrivate
    IContentNodeOwner
    IContentSiteBridgeEndpointConnectionPrivate
    PopupAnchoringOptions
    PopupWindowSiteBridge
    ProcessStarter
    SystemVisualSiteBridge

Microsoft.UI.Designer
 
    DesignerOutputHost

Microsoft.UI.Input
 
    InputKeyboardSource
        GetForWindowId
 
    InputLayoutPolicy
    InputLightDismissAction
        GetForIsland
 
    InputLightDismissEventArgs
    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior
        DirectManipulationHitTest
        GetForVisual
        GetForWindowId
        RemoveForVisual
        TouchHitTesting
        TrySetDeviceKinds
 
    InputPopupController
    LightDismissReason
    PopupPointerMode
    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
    InfoBar
        Opened
 
    InfoBarOpenedEventArgs
    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.MachineLearning
 
    ExecutionProvider
    ExecutionProviderCatalog
    ExecutionProviderReadyResult
    ExecutionProviderReadyResultState
    ExecutionProviderReadyState
    MachineLearningContract

Microsoft.Windows.AI.Text
 
    ConversationItem
    ConversationSummaryOptions
    InputKind
    LanguageModel
        CreateContext
        CreateContext
        CreateContext
        GenerateEmbeddingVectors
        GenerateEmbeddingVectors
        GenerateResponseAsync
        GenerateResponseAsync
        GenerateResponseAsync
        GenerateResponseFromEmbeddingsAsync
        GenerateResponseFromEmbeddingsAsync
        GenerateResponseFromEmbeddingsAsync
        GetUsablePromptLength
        GetUsablePromptLength
        GetVectorSpaceId
 
    LanguageModelEmbeddingVectorResult
    TextRewriter
        RewriteAsync
 
    TextRewriteTone
    TextSummarizer
        IsPromptLargerThanContext
        SummarizeConversationAsync

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.SemanticSearch
 
    EmbeddingVector
    SemanticSearchContract

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

Problemas conocidos

  • Al actualizar desde la versión 1.8.250610002-experimental3 (o posterior) del paquete NuGet Microsoft.WindowsAppSDK en un proyecto de C++, es posible que vea un error de compatibilidad, como con Microsoft.WindowsAppSDK.DWrite. Esto se deriva de una limitación en packages.config. Para resolverlo, quite todas las referencias existentes de WindowsAppSDK y vuelva a agregar el paquete Microsoft.WindowsAppSDK actualizado.

  • Windows ML requiere una implementación dependiente del marco; No se admite la implementación de autocontención. Las aplicaciones que usan Windows ML deben hacer referencia al paquete Microsoft.WindowsAppSDK, que incluye dependencias transitivas en los componentes Microsoft.WindowsAppSDK.ML y Microsoft.WindowsAppSDK.Runtime, ambos necesarios.

  • Windows ML solo se admite en windows 11 versión 24H2 o posterior (compilación 26100+) y solo en arquitecturas x64 y ARM64. No se admite x86.

  • Las API de StoragePickers (FileOpenPicker, FileSavePicker, FolderPicker) solo funcionan en implementaciones independientes debido a un error de localización. Las aplicaciones no autónomas se bloquearán durante la ejecución al invocar estos selectores. Como solución alternativa, copie Microsoft.WindowsAppRuntime.pri en la carpeta del proyecto y configúrelo para copiar en el directorio de salida mediante:

<ItemGroup>
   <None Update="Microsoft.WindowsAppRuntime.pri">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
   </None>
</ItemGroup>

Versión 1.8 Experimental (1.8.0-experimental3)

Expanda para ver los detalles de la versión experimental de Windows App SDK 1.8 (1.8.0-experimental3)

Uso de la IA en dispositivos con las API de IA de Windows

Importante

Actualmente, los modelos de ML subyacentes necesarios para estas API requieren que el dispositivo ejecute la compilación más reciente de Windows 11 Insider Preview en el canal de desarrollo. Además, estas API requieren que su dispositivo sea un PC Copilot+. Consulte Guía del desarrollador de PC Copilot+ para obtener más información sobre estos dispositivos. Las APIs producirán una excepción cuando se llame en dispositivos que no tienen la compatibilidad necesaria.

El SDK de aplicaciones de Windows incorpora funcionalidades avanzadas de inteligencia artificial de Windows, lo que permite a los desarrolladores integrar sin problemas características inteligentes en sus aplicaciones. Estas mejoras incluyen funcionalidades de inteligencia artificial local, como responder a mensajes entrantes, reconocer texto dentro de imágenes, describir el contenido de la imagen, extraer objetos de imágenes, etc.

Para obtener información sobre las prácticas de desarrollo responsables que se usan durante la creación de las API de ia de Windows, que también se pueden aplicar al crear características asistidas por IA, consulte las instrucciones sobre desarrollo de aplicaciones y características de IA generativas responsables en Windows .

Nuevas API para 1.8-experimental3

Esta versión incluye las siguientes API experimentales nuevas y modificadas:

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
        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.Designer

    DesignerOutputHost

Microsoft.UI.Input

    InputKeyboardSource
        GetForWindowId

    InputLayoutPolicy
    InputLightDismissAction
        GetForIsland

    InputLightDismissEventArgs
    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior
        DirectManipulationHitTest
        GetForVisual
        GetForWindowId
        RemoveForVisual
        TouchHitTesting
        TrySetDeviceKinds

    InputPopupController
    LightDismissReason
    PopupPointerMode
    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
    InfoBar
        Opened

    InfoBarOpenedEventArgs
    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.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.SemanticSearch

    EmbeddingVector
    SemanticSearchContract

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

Versión 1.8 Experimental (1.8.0-experimental2)

Expanda para ver los detalles de la versión experimental de Windows App SDK 1.8 (1.8.0-experimental2)

Uso de la IA en dispositivos con las API de IA de Windows

Importante

Actualmente, los modelos de ML subyacentes necesarios para estas API requieren que el dispositivo ejecute la compilación más reciente de Windows 11 Insider Preview en el canal de desarrollo. Además, estas API requieren que su dispositivo sea un PC Copilot+. Consulte Guía del desarrollador de PC Copilot+ para obtener más información sobre estos dispositivos. Las APIs producirán una excepción cuando se llame en dispositivos que no tienen la compatibilidad necesaria.

El SDK de aplicaciones de Windows incorpora funcionalidades avanzadas de inteligencia artificial de Windows, lo que permite a los desarrolladores integrar sin problemas características inteligentes en sus aplicaciones. Estas mejoras incluyen funcionalidades de inteligencia artificial local, como responder a mensajes entrantes, reconocer texto dentro de imágenes, describir el contenido de la imagen, extraer objetos de imágenes, etc.

Para obtener información sobre las prácticas de desarrollo responsables que se usan durante la creación de las API de ia de Windows, que también se pueden aplicar al crear características asistidas por IA, consulte las instrucciones sobre desarrollo de aplicaciones y características de IA generativas responsables en Windows .

Tipo de datos decimal

La nueva Decimal compatibilidad ofrece un tipo de datos numérico base-10 de alta precisión que es valioso para los cálculos financieros y científicos, evitando errores imprecisos y redondeos inherentes a los tipos de datos de punto flotante. Se estructura como un entero de 96 bits (12 bytes) sin signo, escalado por una potencia variable de 10, lo que permite una representación precisa de valores decimales. Esto permite la compatibilidad decimal con lenguajes de programación que carecen de tipos de datos decimales y proporciona interoperabilidad con lenguajes que admiten decimales (por ejemplo, C#, Python).

Metapaquete de NuGet

El paquete NuGet del SDK de aplicaciones de Windows se ha convertido en un metapaquete de NuGet. Cada componente que forma parte del SDK de aplicaciones de Windows es ahora un paquete de componente NuGet y se lista como dependencia en el metapaquete. Esto permite a los desarrolladores elegir el metapaquete o seleccionar paquetes de componentes específicos para sus aplicaciones. El uso de paquetes de componentes individuales permite a los desarrolladores incluir solo las API y las funcionalidades necesarias para sus aplicaciones. La experiencia predeterminada se comporta como si WindowsAppSDKSelfContained se hubiera establecido como True, pero se puede hacer referencia al paquete Microsoft.WindowsAppSDK.Packages para usar la implementación del paquete del marco de trabajo.

Refactorización Microsoft.Windows.SDK.BuildTools.MSIX

La compatibilidad con la publicación de MSIX se ha factorizado en un paquete NuGet independiente, que puede mantenerse y consumirse de forma independiente por el Windows App SDK y otros proyectos. Además, se han solucionado varias lagunas de funcionalidades con las soluciones de Single-Project, incluida la generación de paquetes MSIX y paquetes de carga de MSIX.

Las API de inteligencia artificial de Windows

Adaptación de bajo rango (LoRA) para Phi Silica

Low-Rank Adaption (LoRA) for PhiLice permite a los desarrolladores ajustar el modelo de lenguaje en el dispositivo (PhiLice) con sus propios datos personalizados. Este adaptador permite que la salida se alinee para escenarios específicos, como finanzas, médicos y educación. Consulte PhiLice LoRA para obtener más información.

Text Intelligence : resumen de conversación

Phi Silica ahora tiene una función para resumir conversaciones que le permite resumir lo que las personas han dicho a través de un correo electrónico, un chat o un hilo. Consulte PhiLice para obtener más detalles.

Nuevas API para 1.8-experimental2

Esta versión incluye las siguientes API experimentales nuevas y modificadas:

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

Problemas conocidos

  • En esta versión faltan las proyecciones de la API Microsoft.Windows.AI.Text.Experimental para C++. Las proyecciones están disponibles para su uso en C#.
  • Si usa el paquete de componentes Microsoft.WindowsAppSDK.WinUI en su modo independiente predeterminado, asegúrese de establecer la propiedad WebView2EnableCsWinRTProjection en true al usar las API de WebView2. Esto ayuda a evitar conflictos de versiones y evita advertencias relacionadas.
  • Al usar los paquetes de componentes de WindowsAppSDK, puede observar una advertencia NU1603 que indica que no se encontró la versión especificada de un paquete de componentes dependiente, sino que se resolvió otra en su lugar. Esto se espera con la compilación experimental2 y NuGet resolverá correctamente una versión más reciente del paquete que permitirá que el proyecto se compile. Si trata las advertencias como errores, puede tratar temporalmente esta advertencia específica como no un error especificando la propiedad <WarningsNotAsErrors>NU1603</WarningsNotAsErrors>.

Versión 1.8 Experimental (1.8.0-experimental1)

Expanda para ver los detalles de la versión experimental de Windows App SDK 1.8 (1.8.0-experimental1)

Uso de la IA en dispositivos con las API de IA de Windows

Importante

Actualmente, los modelos de ML subyacentes necesarios para estas API requieren que el dispositivo ejecute la compilación más reciente de Windows 11 Insider Preview en el canal de desarrollo. Además, estas API requieren que su dispositivo sea un PC Copilot+. Consulte Guía del desarrollador de PC Copilot+ para obtener más información sobre estos dispositivos. Las APIs producirán una excepción cuando se llame en dispositivos que no tienen la compatibilidad necesaria.

Las API de inteligencia artificial de Windows ofrecen varias características y API con tecnología de inteligencia artificial para que pueda usar fácilmente, de forma eficaz y responsable los modelos de inteligencia artificial en dispositivos en las aplicaciones de Windows. En esta versión, estamos poniendo a disposición varias API centradas en escenarios para que pueda aprovechar funcionalidades eficaces sin necesidad de encontrar, ejecutar o optimizar sus propios modelos de Machine Learning (ML).

Obtenga más información sobre las prácticas de desarrollo responsables que se usan durante el desarrollo de la API de IA de Windows que también puede aplicar a medida que crea características asistidas por IA en la guía Desarrollo de aplicaciones y características de IA generativas responsables en windows .

Esta es la versión más reciente del canal experimental.

Para descargarlo, vuelva a establecer la versión de NuGet de WinAppSDK en 1.8.250515001-experimental1.

Borrado de objeto

ImageObjectRemover se puede usar para quitar objetos de imágenes. El modelo toma una imagen y una máscara de escala de grises que indica el objeto que se va a quitar, borra el área enmascarada de la imagen y reemplaza el área borrada por el fondo de la imagen.

Nuevas API para 1.8-experimental1

Esta versión incluye las siguientes API experimentales nuevas y modificadas:

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

Corrección de errores

En esta versión se incluyen las siguientes correcciones de errores:

  • Se ha corregido un problema por el que la entrada de la rueda del mouse se omite si la opción "Desplazar las ventanas inactivas al mantener el puntero sobre ellos" en Configuración de Windows está deshabilitada. Para obtener más información, consulte El problema de GitHub n.º 10091.

Archivo de notas de la versión del canal experimental

Expandir los enlaces a notas de la versión archivadas del canal experimental