notas de versão do SDK do Aplicativo Windows 2.0

Adicionado suporte à extensão windows.diagnosticServiceModule package-manifest. Aplicativos MSIX .NET autônomos podem usar essa extensão para declarar módulos de diagnóstico, permitindo que o Relatório de Erros do Windows os carregue e colete despejos de memória de falha acionáveis.

Novas AppContentIndex APIs agora estão disponíveis em um recurso de acesso limitado (LAF) para aplicativos que obtiveram um token de LAF. Essas APIs permitem que os aplicativos forneçam conteúdo de texto e imagem para indexação e consulta desse conteúdo usando correspondência lexical e, em dispositivos habilitados para NPU com suporte, correspondência semântica. AppContentIndex oferece suporte a cenários como pesquisa semântica e geração aumentada por recuperação (RAG). (RuntimeCompatibilityChange: AppContentSearchNewAPI_LafCheck)

• Corrigido um travamento no tratamento de entrada de pop-up em janela quando um evento de foco ou de ponteiro era processado depois que a ilha do pop-up havia sido descartada. (RuntimeCompatibilityChange: PointerInputProcessor_ReleaseCaptureOnDisposedIsland)
• Corrigido um travamento em NavigationView ao redimensionar o controle, que poderia produzir um MaxHeight painel negativo. (RuntimeCompatibilityChange: NavigationView_UpdatePaneLayoutNegativeMaxHeight)
• Correção de um problema em que o conjunto de propriedades retornado por ElementCompositionPreview.GetPointerPositionPropertySet parava de ser atualizado enquanto um ponteiro estava pressionado. (RuntimeCompatibilityChange: PointerPositionPropertySet_UpdateWhilePressed)
• Correção de uma falha quando NavigationView o submenu de um item expandido foi mostrado depois que o item foi recolhido ou reciclado. (RuntimeCompatibilityChange: NavigationViewItem_DeferredFlyoutShowStaleState)
• Corrigida uma falha imediata quando KeyboardAccelerator usava uma tecla OEM ou de pontuação, como vírgula, ponto e vírgula ou colchete, e exibia o rótulo do atalho do acelerador. (RuntimeCompatibilityChange: KeyboardAccelerator_OemKeyNoFailFast)
• Correção de um encerramento fatal do processo que poderia ocorrer durante o encerramento do XAML em aplicativos que hospedam o WinUI 3 em mais de uma thread de UI. (RuntimeCompatibilityChange: WindowsXamlManager_ActivationFactoryCacheResetRace)
• Corrigido um problema em que um CommandBar sem comandos secundários podia exibir um botão de menu adicional vazio em escalas de exibição fracionárias, como 175%. (RuntimeCompatibilityChange: CommandBar_SpuriousOverflowButtonAtFractionalScale)
• Correção de um problema que impedia que os aplicativos que usavam o Mecanismo de Composição do Sistema chamassem VisualInteractionSource.CreateFromIVisualElement. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Corrigidos os gráficos de efeitos e a renderização SceneLighting para apps que usam o Mecanismo de Composição do Sistema. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Corrigido o problema em que InputPointerSource.ActivationBehavior não respeitava NoActivate ao usar o Mecanismo de Composição do Sistema. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Corrigido o comportamento de seleção de CompositionEngine para entradas nulas e seleções sem efeito. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Correção da personalização do cursor para entrada levantada ao usar o Mecanismo de Composição do Sistema. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Correção ICompositionObject de consultas em coleções de parada de gradiente ao usar o Mecanismo de Composição do Sistema. (RuntimeCompatibilityChange: N/A, correção de composição do sistema operacional)
• Corrigido o comportamento da borda e do fundo ContentExternalOutputLink ao usar o Mecanismo de Composição do Sistema. (RuntimeCompatibilityChange: N/A, correção de composição do sistema operacional)
• Corrigido o acesso a VisualReferenceController ao usar o Mecanismo de Composição do Sistema. (RuntimeCompatibilityChange: N/A, correção de composição do sistema operacional)
• Correção de um problema de registro que poderia ocorrer ao instalar o SDK do Aplicativo Windows. (RuntimeCompatibilityChange: N/A, correção de registro de implantação)
• Corrigido um problema em que a Super-Resolução de Vídeo poderia falhar durante a inicialização ou a inferência com a dependência atualizada do ONNX Runtime. (RuntimeCompatibilityChange: N/A, atualização de compatibilidade de dependência)

Esta versão inclui as seguintes novas APIs em comparação com a versão 2.4.0:

Microsoft.Windows.Search.AppContentIndex

    AppIndexContentRegion
        CreateFromBitmap
        CreateFromImageStream

    AppManagedIndexableAppContent
        CreateFromBitmap
        CreateFromImageStream

    ContentRegionImageOptions

    ContentRegionTextOptions
        AllowSemanticIndexing

    ImageOcrIndexingOptions

Os aplicativos WinUI 3 agora oferecem suporte a feedback tátil (haptics) de mouse e touchpad do sistema operacional por meio de Windows.Devices.Haptics, bem como à panorâmica com um dedo no touchpad, quando o sistema operacional e o hardware oferecem suporte a esses recursos. (RuntimeCompatibilityChange: InputPointerSource_OSHaptics)

• Corrigido um travamento que podia ocorrer quando um toque ou contato com a caneta saía de uma área rolável em um momento preciso. (RuntimeCompatibilityChange: InputPointerSource_DepartingScrollInputCrashFix)
• Corrigido um problema em que os seletores de armazenamento (FileOpenPicker, FileSavePicker e FolderPicker) deixavam a janela do aplicativo WinUI que os chamou sem foco de teclado após o fechamento da caixa de diálogo de arquivo. O aplicativo agora restaura seu foco anterior após o fechamento da caixa de diálogo. Para obter mais informações, consulte GitHub problema nº 6505. (RuntimeCompatibilityChange: StoragePickers_RestoreFocusAfterDialogCloses)
• Correção de uma regressão em que MrmGetFilePathFromName retornava ERROR_FILE_NOT_FOUND quando o arquivo PRI não existia, em vez de retornar o caminho de fallback documentado. Para obter mais informações, consulte GitHub problema nº 5940. (RuntimeCompatibilityChange: ResourceManager_RestoreDefaultFallbackPath)
• Corrigido um problema em que MICROSOFT_WINDOWSAPPRUNTIME_BASE_DIRECTORY podia ser herdado por processos filhos, prejudicando o MRT Core e as consultas de catálogo. Para obter mais informações, consulte GitHub problema nº 5987. (RuntimeCompatibilityChange: WindowsAppRuntime_BaseDirectoryIsolation)
• Corrigido um problema em que LanguageModel retornava um status genérico Error para idiomas sem suporte ou idiomas de entrada e saída incompatíveis. Essas condições agora retornam LanguageModelResponseStatus.UnsupportedLanguage e LanguageModelResponseStatus.LanguageMismatch, respectivamente. (RuntimeCompatibilityChange: LanguageModel_LanguageDetectionStatus)
• Corrigida uma falha que ocorria quando aplicativos que utilizam o System Composition Engine chamavam VisualInteractionSource.TryRedirectForManipulation. (RuntimeCompatibilityChange: N/A, correção da ponte de composição do sistema operacional)
• Corrigido o modificador de acesso no auxiliar do ponto de entrada C# gerado quando DISABLE_XAML_GENERATED_MAIN está definido. Para obter mais informações, consulte GitHub problema nº 11245. (RuntimeCompatibilityChange: N/A, alteração de ferramentas de tempo de compilação)

Esta versão inclui as seguintes novas APIs em comparação com a versão 2.3.1:

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        LanguageMismatch
        UnsupportedLanguage

Adicionada a API de Saída JSON Estruturada (Microsoft.Windows.AI.Text.LanguageModel.GenerateStructuredJsonResponseAsync), que gera respostas de modelo de linguagem restritas a um esquema JSON fornecido pelo chamador. (RuntimeCompatibilityChange: LanguageModel_StructuredJsonOutput)

Adicionada a API XamlOptionalChanges , que permite que os aplicativos optem por alterações de quebra opcionais antes da inicialização do XAML. Para obter mais informações, consulte GitHub PR microsoft/microsoft-ui-xaml#11110. (RuntimeCompatibilityChange: XamlSettings_OptionalChangesApi)

Alterou o comportamento da DISABLE_XAML_GENERATED_MAIN constante do pré-processador para que, quando definido, agora renomeie o método gerado main() (C#: XamlGeneratedProgram.XamlGeneratedMain(); C++/WinRT: wXamlGeneratedMain()) em vez de removê-lo completamente. Isso permite que um método personalizado main() invoque a implementação padrão.

A API CompositionEngine foi adicionada como um LAF (recurso de acesso limitado) instável, que permite que os aplicativos optem por usar o sistema operacional como o mecanismo para as APIs de Composição. (RuntimeCompatibilityChange: CompositionEngine_API)

Corrigida a detecção da NPU, adicionado suporte à CPU e melhorado o desempenho do recurso Super Resolução de Vídeo. (RuntimeCompatibilityChange: VideoSuperResolution_HardwareDetection)

• Correção da enumeração do provedor de execução em determinados cenários. (RuntimeCompatibilityChange: WindowsML_ExecutionProviderEnumerationUpdate)
• Adicionado suporte ao ARM64EC para o Windows ML.

Adicionada a documentação do IntelliSense para APIs estáveis no pacote Microsoft.WindowsAppSDK.AI NuGet.

Várias das otimizações abaixo são opcionais. Para habilitá-los, defina o XamlChangeId especificado, conforme observado em cada item.

• Adicionados novos estilos otimizados XamlControlsResources , incluindo um modelo otimizado ScrollBar . Use o DefaultStyleOptimizations XamlChangeId para aceitar esses estilos. (RuntimeCompatibilityChange: Xaml_DefaultStyleOptimizations)
• FontIcon e BitmapIcon evitam inserir um Grid extra na árvore visual dos aplicativos que aderem a XamlChangeId IconNoGridOptimization. (RuntimeCompatibilityChange: Xaml_IconNoGridOptimization)
• Interrupção do carregamento de setters da propriedade Style que não aplicam um valor. Use XamlChangeId OptimizeApplyStyles para aceitar. (RuntimeCompatibilityChange: Xaml_DeferStylePropertySetters)
• A aplicação dos estilos FrameworkElement e Control foi adiada até que o elemento esteja na árvore. Use XamlChangeId OptimizeApplyStyles para aceitar. (RuntimeCompatibilityChange: Xaml_DelayApplyStylesAfterCreationComplete)
• Inicialização otimizada CommandBar ao não mais carregar todo o estado do gerenciador de estado visual. (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarInitialization)
• Aprimoramento no desempenho quando se adiciona CommandBarFlyout, PrimaryCommands e SecondaryCommands. (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarFlyoutUpdateCommands)
• Usou uma tabela de hash mais performante para ResourceDictionary. (RuntimeCompatibilityChange: Xaml_FasterResourceDictionary)
• Eliminação da cópia e da comparação de uma cadeia de caracteres de chave de recurso quando se carrega recursos diferidos. (RuntimeCompatibilityChange: Xaml_LoadDeferredResourceOptimization)
• Melhor desempenho das ThemeResource pesquisas reduzindo as comparações de cadeia de caracteres. (RuntimeCompatibilityChange: Xaml_ThemeResourceUseResourceKeys)
• Aprimoramento no desempenho da CPU a pesquisa de recursos de tema do XAML ao se reduzir a sobrecarga do cálculo de hash de chave de recurso. (RuntimeCompatibilityChange: Xaml_ReduceThemeResourceLookupHashing)
• Melhoria no desempenho da CPU para verificações comuns de tipos internos do XAML em UIElement e FrameworkElement. (RuntimeCompatibilityChange: Xaml_CachedTypeChecks)
• Aprimoramento no desempenho da CPU nos caminhos de pesquisa de fábrica de ativação interna. (RuntimeCompatibilityChange: Xaml_ActivationFactoryFastPaths)
• Desempenho aprimorado da decodificação de inteiros armazenados em arquivos XBF. (RuntimeCompatibilityChange: Xaml_FasterXbfIntLoading)
• Redução das alocações de heap nos caminhos de inicialização e na passagem da árvore ao se reservar memória de vetores e otimizar um auxiliar de RAII. (RuntimeCompatibilityChange: Xaml_ReserveVectorSpace)
• Melhorou o desempenho ao reservar espaço nas coleções do rastreador antes de adicionar vários itens. (RuntimeCompatibilityChange: Xaml_ReserveTrackerCollectionSpace)
• Associações otimizadas para associações de propriedade em XamlUICommand. (RuntimeCompatibilityChange: XamlUICommand_LightweightBindings)
• Aprimoramento no desempenho ao associar XamlUICommands que não definem aceleradores de teclado. (RuntimeCompatibilityChange: XamlUICommand_SkipEmptyKeyboardAcceleratorBinding)
• A propriedade TintLuminosityOpacity foi inicializada na marcação para objetos AcrylicBrush com estilo padrão, em vez de no código, evitando a instanciação forçada. (RuntimeCompatibilityChange: AcrylicBrush_InitializePropertyInMarkup)
• Evitamos a inicialização padrão desnecessária de ContextFlyout em TextBlock e RichTextBlock ao entrar ou sair da árvore de elementos. Use XamlChangeId DeferContextFlyoutInit para aceitar. (RuntimeCompatibilityChange: Xaml_DeferContextFlyoutInit)
• Redução do tempo de espera de inicialização causado pela contenção de bloqueio no Direct3D ao se registrar o evento de remoção do dispositivo D3D do XAML durante a criação do dispositivo em segundo plano, em vez de fazê-lo posteriormente no thread da interface do usuário. (RuntimeCompatibilityChange: Xaml_EagerDeviceRemovedEventRegistration)
• Foi removido de RefreshRateInfo um registro redundante de notificação de energia, reduzindo a sobrecarga de inicialização. (RuntimeCompatibilityChange: RefreshRateInfo_RemovePowerNotification)
• Remoção de uma dependência redundante version.dll do caminho de inicialização do WinUI ao se calcular a versão de runtime registrada em log no tempo de build. (RuntimeCompatibilityChange: XamlInit_GetMuxVersionCompileTime)

• Correção de uma falha use-after-free em CPopupRoot::ReplayPointerUpdate, quando um pop-up é fechado de forma síncrona durante a repetição de pointer-event. (RuntimeCompatibilityChange: CPopupRoot_ReplayPointerUpdateCrash)
• Correção de uma violação de acesso em CXamlIslandRoot::GetScreenOffset, disparada por consultas de Automação da Interface do Usuário re-entrante durante a desinstalação da ilha XAML. (RuntimeCompatibilityChange: XamlIslandRoot_UiaTeardownReentrancyCrash)
• Correção de uma falha em ModernCollectionBasePanel na qual um cabeçalho ou contêiner viewport-tracked, reciclado por uma passagem de layout irmã, poderia deixar uma âncora obsoleta que acionava uma falha fail-fast na medição seguinte. (RuntimeCompatibilityChange: ModernCollectionBasePanel_StaleViewportAnchorRecycle)
• Correção de um fail-fast em CPopup::RemoveChild quando o fechamento de ToolTip injetou mensagens e entrou novamente no caminho de fechamento. (RuntimeCompatibilityChange: Popup_RemoveChildIdempotentWhenClosing)
• Correção de uma falha de reentrância em CXcpDispatcher quando um destrutor de Popup disparou UIADisconnectAllProviders com clientes de Automação da Interface do Usuário ativos. (RuntimeCompatibilityChange: UIAWindow_PauseNewDispatchOnDisconnectProviders)
• Correção de uma falha quando cascading-menu ou o temporizador delay-open AutoSuggestBox disparou após o dispatcher ou a ilha proprietária ter iniciado a desinstalação. (RuntimeCompatibilityChange: CascadingMenuHelper_DelayOpenTimerTickAfterUnload)
• Correção de uma possível falha use-after-free ao se descarregar a DLL quando os ponteiros COM em tipos personalizados de metadados não tinham sido liberados corretamente. (RuntimeCompatibilityChange: CustomMetadataTypes_InvalidateUseAfterFree)
• Correção de uma falha ao se abrir um Popup direto de um callback de CompositionTarget.Rendering devido à reentrada do dispatcher durante alterações de foco. (RuntimeCompatibilityChange: CPopup_OpenSetFocusReentrancy)
• Correção de uma falha em MediaPlayerPresenter quando o dispositivo GPU é perdido durante o tratamento de eventos de reprodução de mídia. (RuntimeCompatibilityChange: MediaPlayerPresenter_DeviceLostCrash)
• Correção de uma possível violação de acesso na renderização de texto de Direct2D quando a recuperação após a perda do dispositivo ocorrer durante a criação da textura glyph-run. (RuntimeCompatibilityChange: HWBuildGlyphRunTextures_DeviceGuardScope)
• Correção de uma falha em CFocusRectManager::FindFocusRectHost quando o foco é direcionado para um controle hospedado embutido por meio de InlineUIContainer em RichTextBlock ou TextBlock. (RuntimeCompatibilityChange: FocusRectManager_FindFocusRectHostCrash)
• Correção de uma falha que poderia derrubar repetidamente backgroundTaskHost.exe quando uma tarefa em segundo plano não tivesse um CLSID armazenado, e ocorresse a adição de tratamento adequado quando CoCreateInstance falhasse. Para obter mais informações, consulte GitHub problema nº 5870. (RuntimeCompatibilityChange: UniversalBGTask_RunCrash)
• Correção do problema em que os submenus non-windowed apareciam desalinhados (cerca de uma altura de item acima do item pai) em posicionamentos laterais ao serem abertos para cima, perto da parte inferior da tela. (RuntimeCompatibilityChange: Flyout_SidePlacementFlipUpAlignmentFix)
• Correção de uma falha (desreferência LayoutStatenula) em UniformGridLayout e FlowLayout que poderia ocorrer quando uma alteração de coleção fosse gerada em um ItemsRepeater que não estivesse mais carregado. (RuntimeCompatibilityChange: UniformGridLayoutFlowLayout_OnItemsChangedNullLayoutStateCrash)
• Correção de ApplicationData.GetForUnpackaged().LocalSettings() na abertura de uma chave do Registro no caminho errado (HKCU\SOFTWARE\publisher\product em vez de HKCU\SOFTWARE\Classes\Local Settings\Software\publisher\product), que é um local de roaming, em vez de um local no computador. Para obter mais informações, consulte GitHub problema nº 6559. (RuntimeCompatibilityChange: ApplicationData_GetForUnpackaged_LocalSettings)
• Correção de uma condição de corrida no tratamento modifier-state do teclado que poderia causar falhas em aplicativos durante entrada UI-thread simultânea. (RuntimeCompatibilityChange: WindowsServices_GetKeyboardModifiersStateRace)
• Correção de uma falha do AppxSvc que pode ocorrer durante a instalação, atualização ou desinstalação do pacote. (RuntimeCompatibilityChange: N/A, correção de falha do host de serviço)

Esta versão inclui as seguintes novas APIs em comparação com a versão 2.2.0:

Microsoft.UI.Composition

    CompositionEngine
    CompositionEngineType

Microsoft.UI.Xaml.Settings

    XamlChangeId
    XamlOptionalChanges

Microsoft.Windows.AI.Text

    GenerateStructuredJsonResponseResult
    GenerateStructuredJsonResponseStatus
    LanguageModel
        GenerateStructuredJsonResponseAsync

A API Microsoft.Windows.AI.Video.VideoScaler fornece melhoria de vídeo em tempo real por meio de dimensionamento de IA avançada, otimizada para streamings onde pessoas estão em conversação. Ele permite que os desenvolvedores forneçam visuais mais nítidos e claros em plataformas de conferência, streaming e edição, mesmo em condições de rede ruins. A API dá suporte à personalização da resolução de saída, taxa de quadros e regiões de interesse, com compatibilidade para vários formatos de vídeo, incluindo BGR, RGB e NV12.

VideoScaler é descartável e inclui uma verificação de funcionalidade para que os aplicativos possam validar o suporte do VSR em runtime. Não é necessária a inicialização explícita do Windows ML.

Uma nova API Microsoft.Windows.Storage.ApplicationData.GetForUnpackaged() fornece aos aplicativos não empacotados um ponto de entrada WinRT de primeira classe para dados de aplicativo por usuário/por computador, correspondendo à superfície disponível anteriormente apenas para aplicativos empacotados. Isso simplifica futuras migrações entre versões empacotadas e não empacotadas e elimina a necessidade de soluções alternativas para a API do Registro.

Adição de sobrecargas de setter de valor boxing-free a XamlBindingHelper (SetPropertyFromThickness, SetPropertyFromCornerRadius, SetPropertyFromColor) e exposição da propriedade de dependência Setter.ValueProperty.

• Correção de uma falha em RenderTargetBitmap quando o elemento de destino sai da árvore visual (por exemplo, quando um pop-up é fechado) antes que PreCommit seja concluído. RenderAsync agora retorna E_ABORT em vez de falhar. (RuntimeCompatibilityChange: RenderTargetBitmap_PreCommitCrashOnTreeLeave)
• Correção de uma falha de use-after-free em ScrollView quando o controle é destruído enquanto seu respectivo tique de temporizador hide-indicators ainda está pendente. Para obter mais informações, consulte GitHub problema #10514. (RuntimeCompatibilityChange: ScrollView_HideIndicatorsTimerUseAfterFree)
• Corrigida uma possível falha em Microsoft.UI.Xaml.dll!DirectUI::DXamlCore::GetPeerPrivate, causada pela tentativa de acessar um objeto programado para ser liberado. (RuntimeCompatibilityChange: GetPeerPrivate_UseAfterFree)
• Corrigido um problema em que Microsoft.UI.System.ThemeSettings poderia travar um aplicativo se ele fosse destruído em um thread em segundo plano (por exemplo, quando destruído pelo coletor de lixo .NET). (RuntimeCompatibilityChange: ThemeSettings_OffThreadDestructorFix)
• Correção de uma falha que poderia ocorrer em determinados dispositivos quando contatos de toque ativos eram cancelados por hardware de entrada, como quando a entrada de caneta os substitui. (RuntimeCompatibilityChange: InputPointerSource_PointerCancelCrashFix)
• Corrigido um problema em que os aplicativos com empacotamento esparso não conseguiam localizar arquivos PRI específicos do módulo. Para obter mais informações, consulte GitHub problema #6375. (RuntimeCompatibilityChange: MRTCore_SparsePackagedPriFallback)
• Correção de um bug de propriedade de cadeia de caracteres ao se usar a API do Catálogo de ML do Windows Flat-C. (RuntimeCompatibilityChange: WindowsMLFlatCCatalog_CallbackStringOwnership)
• Correção de um possível problema no Windows ML durante o desligamento do processo. (RuntimeCompatibilityChange: WindowsML_ComRundownFix)
• Correção de possíveis problemas de desinstalação e inicialização do COM no ML do Windows. (RuntimeCompatibilityChange: WindowsML_ComInitializationFix)

Esta versão inclui as seguintes novas APIs em comparação com a versão 2.1.3:

Microsoft.UI.Xaml

    Setter
        ValueProperty

Microsoft.UI.Xaml.Markup

    XamlBindingHelper
        SetPropertyFromColor
        SetPropertyFromCornerRadius
        SetPropertyFromThickness

Microsoft.Windows.AI.Video

    VideoScaler
    VideoScalerOptions
    VideoScalerResult
    VideoScalerStatus

Microsoft.Windows.Storage

    ApplicationData
        GetForUnpackaged

Melhora a forma como TitleBar decide quais partes de TitleBar.Content podem ser arrastadas e adiciona APIs que dão aos desenvolvedores controle explícito sobre regiões de arraste. Consulte PR microsoft/microsoft-ui-xaml#10936 e o problema de rastreamento #10421.

O que mudou

• Novo comportamento padrão – a estrutura agora orienta recursivamente a árvore visual e exclui automaticamente apenas controles interativos da região de arrastar. Lacunas vazias e visuais não interativos são arrastáveis por padrão, sem a necessidade de alterações de marcação.
• Novas APIs para controle explícito:
  • TitleBar.IsDragRegion — anexou um bool anulável para marcar um elemento como arrastável (True), clicável (False) ou definido pela estrutura (unset).
  • TitleBar.AutoRefreshDragRegions — quando True, as áreas de arraste são atualizadas automaticamente nas atualizações de layout.
  • TitleBar.RecomputeDragRegions() — recalcula manualmente as regiões de arraste após alterações no conteúdo dinâmico.

Por que

As barras de título personalizadas geralmente misturam controles interativos com elementos visuais não interativos dentro de layouts Grid/StackPanel. A abordagem anterior de “furar buracos na área total de conteúdo” deixou lacunas inesperadas que não podiam ser arrastadas em layouts com espaço vazio, espaçamento irregular ou interface do usuário dinâmica.

Comparação visual

Comportamento padrão (anterior) — lacunas não arrastáveis:

A área central vazia não pode ser arrastada.

Comportamento atual (novo) – lacunas arrastáveis, controles interativos excluídos:

O espaço vazio é arrastável; os controles interativos são excluídos corretamente. (RuntimeCompatibilityChange: TitleBar_ContentDragRegions)

A API do LoRA (Low-Rank Adapter) para Phi Silica passou a ser estável.

O LoRA permite que os desenvolvedores ajustem o modelo de linguagem Phi Silica no dispositivo com seus próprios dados personalizados, alinhando a saída para cenários específicos, como finanças, medicina e educação. Carregue um adaptador com LanguageModelLowRankAdapter.CreateFromPath e passe-o por meio de LanguageModelOptions.LowRankAdapter ao chamar GenerateResponseAsync. Consulte Phi Silica LoRA para obter detalhes.

Uma nova API AICapabilities.HasAICapability permite que aplicativos de terceiros determinem se o dispositivo é um Copilot+ PC.

A versão do ONNX Runtime foi atualizada para 1.24.6. Consulte as versões de Runtime do ONNX para obter mais informações.

• Adicionado suporte para vários provedores de execução em um único pacote MSIX. (RuntimeCompatibilityChange: WindowsML_MultiEpPerPackage)
• Adicionado suporte para descobrir provedores de execução entregues como pacotes de estrutura. (RuntimeCompatibilityChange: WindowsML_FrameworkEpEnumeration)
• Adicionado o modo de seleção do provedor de execução para configurações de implantação flexíveis. (RuntimeCompatibilityChange: WindowsML_EpSelectionMode)

• Correção de um vazamento de memória em ItemsRepeater no qual os elementos reciclados nunca eram coletados pelo coletor de lixo devido a um ciclo de referências por meio de RecyclePool, o que também poderia causar falhas em InvalidateChildrenMeasure. (RuntimeCompatibilityChange: ItemTemplateWrapper_RecyclePoolLeak)
• Correção de uma falha em que um callback implícito de conclusão da animação de mostrar/ocultar poderia acessar um CUIElement destruído, causando uma violação de acesso. O callback agora usa uma referência fraca para lidar com segurança com o caso em que o elemento é destruído antes que a animação seja concluída. (RuntimeCompatibilityChange: Animation_FixImplicitHideAnimationCrash)
• Correção de um problema em que o conteúdo pop-up em janelas aberto em uma Ilha XAML não respeitava OverrideScale, fazendo com que o conteúdo parecesse superdimensionado e recortado. Para obter mais informações, consulte GitHub problema #11000. (RuntimeCompatibilityChange: Popup_WindowedPopupOverrideScale)
• Correção de uma falha fail-fast causada pela expedição de reentrada durante operações de liberação COM cross-apartment em UIAffinityReleaseQueue::DoCleanup. (RuntimeCompatibilityChange: UIAffinityReleaseQueue_PauseDispatchDuringCleanup)
• WinUI: correção da pesquisa de módulo ambígua quando vários módulos com o mesmo nome são carregados no mesmo processo. GetModuleHandleW foi substituído por GetModuleHandleExW para que o módulo correto seja resolvido pelo endereço. (RuntimeCompatibilityChange: GetModuleHandle_FixAmbiguousModuleLookup)
• Correção de uma falha divide-by-zero em UniformGridLayout::GetMajorSize quando um ItemsRepeater é disposto em uma largura disponível menor que o stride secundário de um item. (RuntimeCompatibilityChange: UniformGridLayout_GetItemsPerLineDivideByZero)
• Correção de uma possível falha quando um pacote foi desinstalado antes de ser processado. (RuntimeCompatibilityChange: PackageManager_FixCrash)
• Correção de um problema em que GetReadyState poderia retornar códigos de erro incorretos (por exemplo, DisabledByUser ou NotSupportedOnCurrentSystem) quando os pacotes necessários ainda não foram implantados. A API agora informa corretamente NotReady neste cenário, melhorando a clareza no diagnóstico. (RuntimeCompatibilityChange: ModelInitialization_GetReadyStateAvailabilityGuard)
• Aprimoramento do diagnóstico de desempenho interno de LanguageModel.GenerateResponseAsync para identificar melhor as fontes de latência antes que o primeiro token seja retornado. (RuntimeCompatibilityChange: LanguageModelInsights_GetPartialResultLatency)
• Corrigido um problema em que os erros do compilador XAML eram perdidos sem aviso ao usar dotnet build, mostrando apenas MSB3073: exited with code 1 em vez das mensagens de erro reais. Para obter mais informações, consulte GitHub problema #9813. (RuntimeCompatibilityChange: N/A, alteração de ferramentas do compilador XAML em tempo de build)
• Corrigido um problema em que Microsoft.Windows.Workloads.dll falhava ao carregar em builds de Windows antes de 22000 devido a importações estáticas de APIs de Dependências Dinâmicas indisponíveis nessas versões do sistema operacional. As funções agora são resolvidas dinamicamente; portanto, as falhas nas versões do sistema operacional sem suporte aparecem como um HRESULT padrão em vez de uma caixa de diálogo de erro de carregamento. (RuntimeCompatibilityChange: N/A, sem contenção)

Esta versão inclui as seguintes novas APIs em comparação com a versão 2.0.1:

Microsoft.UI.Xaml.Controls

    TitleBar
        AutoRefreshDragRegions
        AutoRefreshDragRegionsProperty
        GetIsDragRegion
        IsDragRegionProperty
        RecomputeDragRegions
        SetIsDragRegion

Microsoft.Windows.AI

    AICapabilities

    AICapabilityCategory

Microsoft.Windows.AI.Text

    LanguageModelLowRankAdapter

    LanguageModelLowRankAdapterResult

    LanguageModelOptions
        LowRankAdapter

    LanguageModelResponseStatus
        IncompatibleLowRankAdapter

SDK do Aplicativo Windows 2.0 é a primeira versão do novo esquema de controle de versão SDK do Aplicativo Windows, padronizado no Semantic Versioning 2.0.0. Esta também é a primeira vez que incrementamos o número de versão principal.

O novo esquema simplifica o controle de versão alinhando a versão SDK do Aplicativo Windows com a versão do pacote NuGet. Referenciar SDK do Aplicativo Windows 2.0 em seu projeto agora significa que você usará a versão correspondente do NuGet, sem um número de build baseado em data separado para acompanhar:

<PackageDependency Name="Microsoft.WindowsAppSDK" Version="2.0.1" />

O nome da família de pacotes também se alinha à versão principal em vez da versão secundária, portanto, a próxima versão lado a lado do SDK do Aplicativo Windows será a versão 3.0.0. Em SemVer, atualizações que quebram a compatibilidade só são permitidas em versões principais (consulte a arquitetura de implantação do SDK do Aplicativo Windows).

O pacote NuGet Microsoft.WindowsAppSDK.ML foi refatorado, adicionando uma nova dependência base. A funcionalidade do pacote NuGet do ML existente permanece a mesma, mas os principais recursos de Windows ML foram refatorados em um pacote base chamado Microsoft.Windows.AI.MachineLearning. Este novo pacote contém um conjunto mínimo de dependências; suporte a aplicativos até Windows 10 v1903. Se você precisar de suporte do Windows 10 v1809, continue usando o pacote Microsoft.WindowsAppSDK.ML existente.

ONNX Runtime. A versão do ONNX Runtime incluída no Windows ML foi atualizada para 1.24.5. Consulte as versões de Runtime do ONNX para obter mais informações. Essa versão também inclui uma alteração aditiva da API ORT para dar suporte à compilação de modelo usando grafos produzidos pela OrtModelEditor API (uma lacuna de recursos na superfície anterior OrtCompileApi ). A alteração não é disruptiva e foi feita para desbloquear os próximos cenários de navegador WebNN; consulte o ONNX Runtime PR #27332 subjacente para obter detalhes.

Licenciamento. O contrato de licença do Windows ML foi simplificado com termos mais claros para ISVs:

• Seções de instalação, dados e código distribuível reestruturados para maior clareza.
• Uma nova seção de Aviso de Conformidade do EP (Provedor de Execução) esclarece as responsabilidades do desenvolvedor em relação aos provedores de execução aceleradas por hardware.
• Links diretos para os acordos de licença de fornecedores para NVIDIA TensorRT, Intel OpenVINO e Qualcomm QNN (SDK de Rede Neural Qualcomm).

• As APIs de Phi Silica agora são impostas como parte de um Recurso de Acesso Limitado (LAF). Consulte Phi Silica para obter detalhes.
• Foram adicionados novos estados para AIFeatureReadyState ajudar os aplicativos a explicar falhas transitórias e duráveis durante o processo de aquisição do modelo de IA: CapabilityMissing, NotCompatibleWithSystemHardwaree OSUpdateNeeded. Os aplicativos podem usar esses estados para fornecer aos usuários orientações acionáveis em vez de tratar cada condição "não pronta" como uma falha genérica.
• Foram adicionadas verificações para vários erros de rede e Windows Update durante a instalação do modelo de IA, sinalizando falhas duráveis para que os usuários possam entender por que os pacotes de modelo falharam na instalação.
• Diagnóstico aprimorado para APIs de Inteligência de Texto usadas em cenários de IA Windows.

Habilitação do suporte de arrastar para conteúdo WebView2 hospedado em aplicativos WinUI 3. Esse recurso anteriormente não tinha suporte e agora está disponível sem introduzir novas APIs públicas. (Já havia suporte para soltar em um controle WebView2 direto de fontes externas.)

Cenários com suporte:

• Conteúdo padrão de arrastar e soltar. Há suporte para arrastar texto, HTML, imagens e URLs. Arrastar uma imagem para fora do aplicativo atualmente resulta em um nome de arquivo padrão (por exemplo, download.jpg) quando inserido no Explorador de Arquivos.
• Arraste o cancelamento. Há suporte para o cancelamento sob demanda de uma operação de arrastar ativa, portanto, um aplicativo pode bloquear condicionalmente as operações de arrastar para conteúdo restrito ou efêmero depois que o arrastar for iniciado.
• Visuais de arrastar personalizados. Há suporte para uma interface personalizada de arrastar e soltar, como ícones ou visualizações, que permite aos usuários identificar claramente o conteúdo que está sendo arrastado.
• Dados de arrastar personalizáveis. Há suporte para edição e personalização de dados de arrastar, habilitando cenários específicos do aplicativo, como arrastar mensagens dentro do aplicativo ou anexar metadados contextuais (por exemplo, "Do<nome do aplicativo>") que o destino possa ler ao soltar.

Limitações:

• Atualmente, não há suporte para alguns tipos de dados de arrastar adicionais, incluindo DownloadURL.

Requirements:

• Versão mínima do Runtime do WebView2 (canal Beta do Edge): 144.0.3719.11.

A API Microsoft.Windows.Storage.Pickers (introduzida no SDK do Aplicativo Windows 1.8) foi estendida para simplificar a seleção de arquivos e pastas, permitindo que os desenvolvedores definam locais de pastas iniciais e persistentes e filtros de tipo de arquivo de grupo com rótulos claros para facilitar a navegação.

• FileOpenPicker adiciona FileTypeChoices, InitialFileTypeIndex, SettingsIdentifier, SuggestedFolder, SuggestedStartFolder e Title.
• FileSavePicker adiciona InitialFileTypeIndex, SettingsIdentifier, ShowOverwritePrompt, SuggestedStartFoldere Title.
• FolderPicker adiciona PickMultipleFoldersAsync, SettingsIdentifier, SuggestedFolder, SuggestedStartFoldere Title.

• Posicionamento de pop-up relativo. A nova PopupAnchor API permite que DesktopPopupSiteBridge suporte posicionamento relativo ao se ancorar em sua janela ou ilha própria, abordando a limitação onde os pop-ups só podiam ser posicionados de forma absoluta usando coordenadas de tela. Novas DesktopPopupSiteBridge.AnchoringBehavior e DesktopPopupSiteBridge.AnchoringPixelAlignment propriedades controlam o comportamento de ancoragem.
• Diretrizes de indicações de teclado. A nova InputFocusController.ShouldShowKeyboardCues propriedade orienta os desenvolvedores sobre se as indicações de teclado devem ser mostradas logo após a criação de um ContentIsland.
• API de conveniência do PointerPoint. O novo PointerPoint.GetCurrentPoint método permite que os desenvolvedores obtenham os dados ativos PointerPoint de um fornecido pointerId.

O novo Microsoft.UI.Xaml.Controls.SystemBackdropElement é um FrameworkElement leve que permite que os aplicativos coloquem um pano de fundo do sistema, como Mica ou Acrílico, em qualquer parte do layout XAML, com uma propriedade CornerRadius para áreas de fundo arredondadas. Ele fecha uma lacuna do WinUI 3 de longa data, onde os efeitos acrílicos em aplicativos (anteriormente facilmente aplicáveis no WinUI 2 via AcrylicBrush.BackgroundSource) não tinham equivalente direto.

O namespace Microsoft.Windows.Management.Deployment adiciona uma estrutura de validação de pacote e uma API PackageVolume para gerenciar os volumes de armazenamento nos quais os pacotes são preparados.

• Validadores. Nova IPackageValidator interface, além de três validadores internos (PackageCertificateEkuValidator, PackageFamilyNameValidator, PackageMinimumVersionValidator) que podem ser anexados a AddPackageOptions / StagePackageOptions por meio da nova propriedade PackageValidators. PackageValidationEventArgs, PackageValidationEventSource, e PackageValidationHandler carregam eventos de validação; IsPackageValidationSupported e GetValidationEventSourceForUri permitem que os chamadores avaliem o suporte antes de invocar a implantação.
• Volume do Pacote. Novo PackageVolume tipo com GetDefault, GetPackageVolumeByName, GetPackageVolumeByPath, AddAsync, RemoveAsync, GetAvailableSpaceAsync, IsOffline, SetDefault, SetOfflineAsync, SetOnlineAsync, e IsFeatureSupported para detecção de capacidade de tempo de execução (PackageVolumeFeature).

A nova IXamlCondition interface permite que os desenvolvedores definam condições personalizadas que se integram à sintaxe de namespace condicional do XAML e são avaliadas no momento da análise do XAML. Isso substitui a interface experimental IXamlPredicate . As condições personalizadas permitem cenários XAML condicionais com base em fatores específicos do aplicativo, como sinalizadores de recursos, recursos de dispositivo, lógica de negócios, configurações de configuração e outras condições de runtime.

• Correção de um problema em que o instalador do WindowsAppSDK não mostrava nenhum progresso durante a instalação, fazendo com que parecesse paralisado. O instalador agora fornece comentários de progresso mais claros.
• Melhor tratamento de erros para cenários em que WindowsAppSDKSelfContained está habilitado para bibliotecas de classes.
• Correção de avisos de build MSB8027 e LNK4042 causados por itens ClCompile duplicados nos arquivos .targets NuGet do SDK do Aplicativo Windows ao se mover definições de pré-processador dos blocos <Target> para <ItemDefinitionGroup>. Uma solução alternativa de recusa (WindowsAppSDK_Arm64EcCompilerWorkaround) é incluída para builds ARM64EC+LTCG a fim de evitar um erro conhecido do compilador interno do MSVC.
• Correção de uma falha de ListView que poderia ocorrer durante a navegação do teclado (Tab/Shift+Tab) depois que a lista de itens foi atualizada.
• Correção de um problema em que o WinUI 3 poderia falhar se o foco fosse movido para CoreWebView2Controller enquanto o controlador não estivesse visível.
• Aprimoramento na confiabilidade de DeleteIndex para que não ocorram falhas ERROR_SHARING_VIOLATION em alguns cenários (Pesquisa de Conteúdo do Aplicativo; permanece em canal experimental).
• Correção das caixas delimitadoras de OCR quando estas retornavam valores negativos em alguns casos extremos.
• Correção de um bug do ML do Windows em que chamar RegisterCertifiedAsync novamente no mesmo processo incorretamente retornava 0 provedor de execução (EP).

Esta versão contém uma refatoração das referências transitivas do NuGet. Para atualizar um projeto C++ existente, recomendamos que você use ferramentas (nuget.exe ou Visual Studio) para remover a referência de pacote SDK do Aplicativo Windows existente e adicionar a nova referência. Isso soluciona problemas de atualização com projetos baseados em packages.config.

Atualizando a partir da 2.0 Experimental7. O pacote experimental Microsoft.WindowsAppSDK.ML foi enviado com um número de patch maior do que a versão 2.0.0 estável, o que pode resultar em um erro de downgrade do NuGet (especialmente em projetos C++). Se você estiver no Experimental7, siga o guia de Desinstalação do NuGet para remover o pacote experimental antes de referenciar 2.0.0.

• A Pesquisa de Conteúdo do Aplicativo permanece experimental. A superfície da API Microsoft.Windows.Search.AppContentIndex (Pesquisa de Conteúdo do Aplicativo) foi removida em 2.0-Preview2 para melhorar os conceitos básicos e garantir a compatibilidade futura. Isso não está incluído na versão 2.0.1 estável. Para experimentar, continue usando versões experimentais. Se você instalou anteriormente o pacote experimental Microsoft.Windows.Search, desinstale-o por meio do guia NuGet Uninstall antes de mover para o estável 2.0.1.
• APIs já enviadas na manutenção do 1.8. Alguns recursos experimentais que foram visualizados durante o ciclo 2.0 foram promovidos a APIs estáveis em versões de manutenção 1.8 e, portanto, não são novos na 2.0.1. Eles incluem ModelCatalog (1.8.3), TextRewriter.RewriteCustomAsync (1.8.4) e SplitMenuFlyoutItem mais SplitMenuFlyoutItemAutomationPeer (1.8.6). Confira as notas sobre a versão 1.8 para obter detalhes.

• AICapabilities está ausente de 2.0.1. Microsoft.Windows.AI.AICapabilities e AICapabilityCategory.CopilotPlusPCCapable (uma verificação de capacidade do Copilot+ PC) lançados na versão 1.8.7, mas que não foram incluídos na versão 2.0.1. Planejamos restaurá-los na versão de maio.

Esta versão inclui as seguintes novas APIs em comparação com a versão estável 1.8.7:

Microsoft.Graphics.Imaging

    ImageBufferPixelFormat
        Bgr8

Microsoft.UI.Content

    DesktopPopupSiteBridge
        AnchoringBehavior
        AnchoringPixelAlignment

    PopupAnchor

Microsoft.UI.Input

    InputFocusController
        ShouldShowKeyboardCues

    PointerPoint
        GetCurrentPoint

Microsoft.UI.Xaml.Controls

    SystemBackdropElement

Microsoft.UI.Xaml.Markup

    IXamlCondition

Microsoft.Windows.AI

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

Microsoft.Windows.Management.Deployment

    AddPackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

    IPackageValidator
    PackageCertificateEkuValidator
    PackageFamilyNameValidator
    PackageMinimumVersionValidator
    PackageValidationEventArgs
    PackageValidationEventSource
    PackageValidationHandler
    PackageVolume
        AddAsync
        GetAvailableSpaceAsync
        GetDefault
        GetPackageVolumeByName
        GetPackageVolumeByPath
        IsFeatureSupported
        IsOffline
        RemoveAsync
        SetDefault
        SetOfflineAsync
        SetOnlineAsync

    PackageVolumeFeature
    StagePackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

Microsoft.Windows.SemanticSearch

    EmbeddingVector
    SemanticSearchContract

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        FileTypeChoices
        InitialFileTypeIndex
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

    FileSavePicker
        InitialFileTypeIndex
        SettingsIdentifier
        ShowOverwritePrompt
        SuggestedStartFolder
        Title

    FolderPicker
        PickMultipleFoldersAsync
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

Microsoft.Windows.Vision

    ScreenRegionBoundingBox
    ScreenRegionDetectionContract
    ScreenRegionLabel

Microsoft.Windows.AI

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

O pacote NuGet Microsoft.WindowsAppSDK.ML foi refatorado, adicionando uma nova dependência base. A funcionalidade do pacote NuGet de ML existente permanece a mesma, mas os principais recursos do Windows ML foram refatorados em um pacote base dependente chamado Microsoft.Windows.AI.MachineLearning. Esse novo pacote contém um conjunto mínimo de dependências, mas em C#/WinRT ou C++/WinRT ele só dá suporte a Windows 10 18362. Se você precisar de suporte para o Windows 10 17763, use o pacote existente Microsoft.WindowsAppSDK.ML.

Para novas dependências transitivas, recomendamos usar ferramentas para atualizar o pacote (nuget.exe ou VS). Veja também: Notas de versão 1.6 do SDK do Aplicativo Windows.

A versão do ONNX Runtime foi atualizada para 1.24.4. Consulte as versões de Runtime do ONNX para obter mais informações.

Imposição das APIs Phi Silica como parte de um Recurso de Acesso Limitado.

Foram adicionadas verificações para vários erros de rede e Windows Update durante a instalação do modelo de IA, sinalizando falhas duráveis para que os usuários possam entender por que os pacotes de modelo falharam na instalação.

Diagnóstico aprimorado para APIs de Inteligência de Texto usadas em cenários de IA Windows.

A Pesquisa de Conteúdo do Aplicativo foi removida da versão prévia 2.0 enquanto trabalhamos para melhorar os conceitos básicos e garantir a compatibilidade futura à medida que os modelos de IA subjacentes são alterados. Enquanto isso, continue usando o canal experimental para experimentar as alterações mais recentes.

Habilitação do suporte de arrastar para conteúdo WebView2 hospedado em aplicativos WinUI 3. Esse recurso anteriormente não tinha suporte e agora está disponível sem introduzir novas APIs públicas. Observação: Já há suporte para o Drop into WebView2 de fontes externas.

Cenários com suporte

• Conteúdo padrão de arrastar e soltar Há suporte para arrastar texto, HTML, imagens e URLs. Com base no comportamento atual, arrastar imagens para fora do aplicativo resulta em um nome de arquivo padrão (por exemplo, download.jpg) quando elas são soltas no Explorador do Windows. Cenário de exemplo: Um usuário seleciona o texto ou uma imagem dentro do WebView2 e arrasta-o dentro do aplicativo ou para outro destino, como o Explorador de Arquivos.

• Cancelamento de arraste É oferecido suporte para o cancelamento sob demanda de uma operação de arraste ativa. Cenário de exemplo: Um aplicativo bloqueia condicionalmente as operações de arrastar para determinados tipos de conteúdo (como conteúdo restrito ou efêmero) cancelando o arrastar depois de iniciado.

• Visuais de arrastar personalizados Há suporte para a interface do usuário de arrastar personalizada, como ícones ou visualizações, para ajudar os usuários a identificar claramente o conteúdo que está sendo arrastado. Cenário de exemplo: Um aplicativo exibe uma visualização ou ícone de miniatura enquanto um usuário arrasta o conteúdo da mídia, deixando claro qual item está sendo movido no momento.

• Dados de arrastar personalizáveis Há suporte para edição e personalização de dados de arrastar, permitindo cenários específicos do aplicativo, como arrastar mensagens dentro do aplicativo (por exemplo, como uma interação alternativa para o encaminhamento de mensagens). Cenário de exemplo: um aplicativo personaliza o payload de arrastar para incluir metadados contextuais, como o nome do aplicativo de origem. Quando o conteúdo é descartado, o destino pode exibir ou processar informações como "Do <nome do aplicativo>" para indicar a origem do conteúdo arrastado.

Limitações

• O suporte para tipos de dados de arrastar adicionais é limitado. No momento, não há suporte para os seguintes formatos:
  • DownloadURL

Requisitos

• Versão mínima do Runtime do WebView2 (canal Beta do Edge): 144.0.3719.11

A interface IXamlCondition permite que os desenvolvedores definam condições personalizadas que se integram à sintaxe do namespace condicional do XAML e são avaliadas no momento da análise do XAML. Essa é uma renomeação e graduação da interface experimental IXamlPredicate . As condições personalizadas permitem cenários XAML condicionais com base em fatores específicos do aplicativo, como sinalizadores de recursos, recursos de dispositivo, lógica de negócios, configurações de configuração e outras condições de runtime.

• Correção dos avisos de build MSB8027 e LNK4042 causados por itens ClCompile duplicados nos arquivos .targets do NuGet do SDK do Aplicativo Windows, movendo as definições do pré-processador dos blocos <Target> para <ItemDefinitionGroup>. Uma solução alternativa de recusa (WindowsAppSDK_Arm64EcCompilerWorkaround) é incluída para builds ARM64EC+LTCG a fim de evitar um erro conhecido do compilador interno do MSVC.
• Correção de uma falha de ListView que poderia ocorrer durante a navegação do teclado (Tab/Shift+Tab) depois que a lista de itens foi atualizada.
• Correção de um problema em que o WinUI 3 poderia falhar se o foco fosse movido para o CoreWebView2Controller enquanto o controlador não estava visível.

Esta versão inclui as seguintes APIs novas e modificadas em comparação com 2.0-Preview1:

Microsoft.UI.Xaml.Markup

    IXamlCondition

• A versão do ONNX Runtime no Windows ML foi atualizada para 1.24 RC
• Correção de um bug em que, se RegisterCertifiedAsync fosse chamado novamente no mesmo processo, ele retornaria incorretamente 0 EP (provedor de execução)

• Nova InputFocusController.ShouldShowKeyboardCues propriedade para orientar os desenvolvedores sobre se as indicações de teclado devem ser mostradas logo após a criação de um ContentIsland.
• Nova API PointerPoint.GetCurrentPoint de conveniência, para permitir que os desenvolvedores obtenham os dados ativos PointerPoint dos dados fornecidos por pointerId.

• Confiabilidade aprimorada DeleteIndex . Às vezes, DeleteIndex falhava com ERROR_SHARING_VIOLATION.

• Correção para as Caixas Delimitadoras de OCR quando estas retornavam valores negativos em alguns casos extremos.

• A Pesquisa de Conteúdo do Aplicativo faz parte de um pacote Microsoft.Windows.Search separado em vez de fazer parte do Microsoft.Windows.AI package.

• Correção da pesquisa de prefixo que não funcionava com cadeias de caracteres de consulta curtas.

• Novas APIs e renomeações com base na revisão oficial da API.

  • AppContentIndexer
    • GetContentItemsRequiringReindexing
    • Remover –> RemoveContentItem
    • RemoveMultiple –> RemoveContentItems
    • RemoveAllContentItems
    • GetContentIndexingStatus –> GetContentItemStatus
    • GetMultipleContentIndexingStatus –> GetContentItemStatuses
    • GetContentItems
  • AppContentIndexListener
    • IndexingStatusChanged –> ContentItemStatusChanged
  • AppIndexTextQuerySession
    • UpdateQuery –> UpdateQueryPhrase
    • MostRecentResult –> GetResult
    • MostRecentResultChanged –> ResultChanged
  • AppIndexImageQuerySession
    • UpdateQuery –> UpdateQueryPhrase
    • MostRecentResult –> GetResult
    • MostRecentResultChanged –> ResultChanged
  • AppManagedImageQueryMatch
    • Sub-região de Interesse -> RegiãoDeInteresse
  • ContentItemStatusResult
    • Status da reindexação * Status da reindexação do item de conteúdo
  • TextQuerySessionResult
    • IsValid
  • ImageQuerySessionResult
    • IsValid
  • QueryContentItemsFilterFlags

• Correção de um problema em que o instalador do WindowsAppSDK não mostrava nenhum progresso durante a instalação, fazendo com que parecesse paralisado. O instalador agora fornece comentários de progresso mais claros.
• Melhor tratamento de erros de cenários em que o WindowsAppSDKSelfContained está habilitado para bibliotecas de classes.

Esta versão inclui as seguintes APIs experimentais novas e modificadas em comparação com 1,8.5:

---

Microsoft.Graphics.Imaging

    ImageBufferPixelFormat
        Bgr8

Microsoft.UI.Content

    DesktopPopupSiteBridge
        AnchoringBehavior
        AnchoringPixelAlignment

    PopupAnchor

Microsoft.UI.Input

    InputFocusController
        ShouldShowKeyboardCues

    PointerPoint
        GetCurrentPoint

Microsoft.UI.Xaml.Automation.Peers

    SplitMenuFlyoutItemAutomationPeer

Microsoft.UI.Xaml.Controls

    SplitMenuFlyoutItem
    SystemBackdropElement

Microsoft.Windows.Management.Deployment

    AddPackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

    IPackageValidator
    PackageCertificateEkuValidator
    PackageFamilyNameValidator
    PackageMinimumVersionValidator
    PackageValidationEventArgs
    PackageValidationEventSource
    PackageValidationHandler
    PackageVolume
        AddAsync
        GetAvailableSpaceAsync
        GetDefault
        GetPackageVolumeByName
        GetPackageVolumeByPath
        IsFeatureSupported
        IsOffline
        RemoveAsync
        SetDefault
        SetOfflineAsync
        SetOnlineAsync

    PackageVolumeFeature
    StagePackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexContract
    AppContentIndexer
    AppContentIndexListener
    AppIndexContentRegion
    AppIndexImageQuery
    AppIndexImageQuerySession
    AppIndexQueryMatch
    AppIndexTextQuery
    AppIndexTextQuerySession
    AppIndexTextStreamEncoding
    AppManagedImageQueryMatch
    AppManagedIndexableAppContent
    AppManagedTextQueryMatch
    ContentItemErrorDetail
    ContentItemReader
    ContentItemReindexingStatus
    ContentItemStatus
    ContentItemStatusResult
    ContentRegionTextOptions
    DeleteIndexResult
    DeleteIndexStatus
    DeleteIndexWhileInUseBehavior
    GetOrCreateIndexOptions
    GetOrCreateIndexResult
    GetOrCreateIndexStatus
    ImageQueryMatch
    ImageQueryOptions
    ImageQuerySessionResult
    IndexableAppContent
    IndexCapabilities
    IndexCapabilitiesOfCurrentSystem
    IndexCapability
    IndexCapabilityInitializationStatus
    IndexCapabilityLanguageStatus
    IndexCapabilityOfCurrentSystemStatus
    IndexCapabilityRequirement
    IndexCapabilityState
    IndexStatistics
    QueryContentItemsFilterFlags
    QueryMatchContentKind
    QueryMatchScope
    RegionContentKind
    TextLexicalMatchType
    TextQueryMatch
    TextQueryOptions
    TextQuerySessionResult

Microsoft.Windows.SemanticSearch

    EmbeddingVector
    SemanticSearchContract

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        FileTypeChoices
        InitialFileTypeIndex
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

    FileSavePicker
        InitialFileTypeIndex
        SettingsIdentifier
        ShowOverwritePrompt
        SuggestedStartFolder
        Title

    FolderPicker
        PickMultipleFoldersAsync
        SettingsIdentifier
        SuggestedFolder
        SuggestedStartFolder
        Title

Microsoft.Windows.Vision

    ScreenRegionBoundingBox
    ScreenRegionDetectionContract
    ScreenRegionLabel

• Novas APIs AIComputeDevice permitem que os aplicativos selecionem o dispositivo de execução padrão, CPU ou NPU ao criar um TextRecognizer. ContentRegionImageOptions.PreferredTextRecognizerDevice define a mesma preferência de dispositivo para o OCR realizado durante a indexação de imagens no Índice de Conteúdo do Aplicativo.
• A Fala de IA agora usa SpeechRecognitionModelFactory e SpeechRecognitionModelFactoryOptions para configurar e criar modelos de reconhecimento de fala. Os métodos de entrada de áudio agora aceitam buffers de exemplo de 16 bits, o reconhecimento contínuo é interrompido de forma assíncrona e os eventos de reconhecimento de streaming expõem propriedades específicas do provedor.
• LanguageModel.ModelName, LanguageModel.ModelVersion e LanguageModelLowRankAdapterStatus permitem que os aplicativos identifiquem o modelo de idioma instalado e inspecionem o resultado da compatibilidade ao carregar um adaptador de baixa classificação.
• LanguageModelResponseStatus.BlockedByGameMode e LanguageModelResponseStatus.LowOnVram identificam respostas que não puderam ser concluídas porque o modo de jogo estava ativo ou a memória de vídeo disponível era baixa.

A nova API experimental FrameworkElement.SetThemeResourceBinding permite que os aplicativos criem o equivalente a uma {ThemeResource} associação a partir do código. (RuntimeCompatibilityChange: WinUI_SetThemeResourceBinding)

Um novo construtor DataTemplate experimental aceita um delegado fornecido pelo aplicativo que cria a subárvore do elemento do modelo. (RuntimeCompatibilityChange: WinUI_DataTemplateFromDelegate)

O controle TableView experimental agora está disponível nos WinMDs públicos. Ele oferece suporte a agrupamento com cabeçalhos de grupo baseados em modelo, ordenação e filtragem com indicadores de ordenação no cabeçalho da coluna, redimensionamento de colunas por ponteiro e teclado e tooltips opcionais para células e cabeçalhos de coluna. (RuntimeCompatibilityChange: TableView_TabularBinaryActivation)

Esta versão adiciona um controle experimental do WinUI 3 Chart para exibir dados cartesianos na forma de séries de linha, área e barras. O controle dá suporte a eixos configuráveis, legendas, rótulos de dados e marcadores de dados. (RuntimeCompatibilityChange: Charts_ExperimentalControlApi)

• Adição de InkPresenter.ActivateCustomDrying e InkSynchronizer, que permitem que os aplicativos renderizem tinta confirmada usando BeginDry e EndDry.
• Correção de uma violação de acesso que poderia ocorrer ao ler InkPresenter.StrokeContainer enquanto a secagem personalizada estava ativa.
• Dimensionamento corrigido do apresentador InkCanvas sob um RenderTransform.
• Alinhou a API experimental InkToolbar ao design revisado. A barra de ferramentas agora tem como destino um InkPresenter diretamente sem exigir um InkCanvas. (RuntimeCompatibilityChange: InkCanvas_InkingSupport)

• Correção de um problema de acompanhamento de recursos do WinUI que poderia fazer com que o uso de memória aumentasse quando os aplicativos criassem repetidamente storyboards de estado visual ou resolvessem recursos estáticos ou de tema. (Alteração de compatibilidade em tempo de execução: WinUI_ResourceGraphExpiredDependencyPruning)
• Limpeza aprimorada de objetos nativos do WinUI inacessíveis em aplicativos .NET após o encerramento de uma aba ou página. (RuntimeCompatibilityChange: WinUI_OrphanedObjectGCCollection)

Esta versão inclui as seguintes APIs novas e atualizadas em comparação com a versão experimental 2.4 :

Microsoft.UI.Xaml

    DataTemplate
        DataTemplate (elementFactory)

    DataTemplateElementFactory

    FrameworkElement
        SetThemeResourceBinding

Microsoft.UI.Xaml.Controls

    InkPresenter
        ActivateCustomDrying
        HighContrastAdjustment

    InkToolbar
        TargetInkPresenter

    InkStrokeInput
        InkPresenter

    InkSynchronizer

    InkUnprocessedInput
        InkPresenter

Microsoft.UI.Xaml.Controls.Charts

    AreaSeries
    Axis
    BarOrientation
    BarSeries
    CartesianAxis
    CartesianSeries
    CategoryAxis
    CategorySortKey
    Chart
    DataLabelOverride
    DataMarkerOverride
    DateTimeAxis
    DateTimeIntervalType
    GridLines
    LinearAxis
    LineSeries
    MarkerShape
    Samples
    SortOrder
    StrokeDashStyle
    WinUIChartingContract
    XamlChartsResources

Microsoft.UI.Xaml.Controls.Tabular

    ITableViewSortComparer
    SortDirection
    TableView
    TableViewAutomationPeer
    TableViewBeginningEditEventArgs
    TableViewCellAutomationPeer
    TableViewCellEditEndingEventArgs
    TableViewCellsPanel
    TableViewColumn
    TableViewColumnHeaderAutomationPeer
    TableViewDensity
    TableViewEditAction
    TableViewFrozenEdge
    TableViewGridLinesVisibility
    TableViewGroupHeader
    TableViewGroupHeaderAutomationPeer
    TableViewGroupHeaderToggleRequestedEventArgs
    TableViewGroupInfo
    TableViewHeadersVisibility
    TableViewIdentitySelector
    TableViewKeySelector
    TableViewPredicate
    TableViewRow
    TableViewRowAutomationPeer
    TableViewRowTemplateSelector
    TableViewSelectionMode
    TableViewSortCycle
    TableViewSortedEventArgs
    TableViewSortingEventArgs
    TableViewSource
    TableViewTemplateColumn
    TableViewTextColumn
    TabularControlsResources

Microsoft.UI.Xaml.XamlTypeInfo

    XamlControlsChartsXamlMetaDataProvider
    XamlControlsTabularXamlMetaDataProvider

Microsoft.Windows.AI

    AIComputeContract
    AIComputeDevice

Microsoft.Windows.AI.Imaging

    TextRecognizer
        CreateAsync
        EnsureReadyAsync
        GetReadyState

Microsoft.Windows.AI.Speech

    BatchRecognition
        Recognize

    SpeechAudioProvider
        PushData

    SpeechRecognitionModelFactory
    SpeechRecognitionModelFactoryOptions

    StreamingRecognition
        StopContinuousRecognitionAsync

    StreamingRecognizedEventArgs
        GetProperty

    StreamingRecognizingEventArgs
        GetProperty

Microsoft.Windows.AI.Text

    LanguageModel
        ModelName
        ModelVersion

    LanguageModelLowRankAdapterResult
        Status

    LanguageModelLowRankAdapterStatus

    LanguageModelResponseStatus
        BlockedByGameMode
        LowOnVram

Microsoft.Windows.Search.AppContentIndex

    ContentRegionImageOptions
        PreferredTextRecognizerDevice

Esta versão adiciona suporte à escrita à tinta para WinUI 3 por meio do InkCanvas, InkToolbar e InkPresenter, incluindo entrada por caneta e toque, suporte à área de transferência, suporte de alto contraste, entrada de traço e entrada não processada. (RuntimeCompatibilityChange: InkCanvas_InkingSupport)

Esta versão inclui as seguintes novas APIs em comparação com a versão 2.3 Experimental A :

Microsoft.UI.Xaml.Automation.Peers

    InkToolbarAutomationPeer
    InkToolbarFlyoutItemAutomationPeer
    InkToolbarMenuButtonAutomationPeer
    InkToolbarToolButtonAutomationPeer

Microsoft.UI.Xaml.Controls

    InkCanvas
        InkPresenter

    InkHighContrastAdjustment
    InkInputConfiguration
    InkInputProcessingConfiguration
    InkInputProcessingMode
    InkInputRightDragAction
    InkPresenter
    InkStrokeContainer
    InkStrokeInput
    InkStrokesCollectedEventArgs
    InkStrokesErasedEventArgs
    InkToolbar
    InkToolbarBallpointPenButton
    InkToolbarButtonFlyoutPlacement
    InkToolbarCustomPen
    InkToolbarCustomPenButton
    InkToolbarCustomToggleButton
    InkToolbarCustomToolButton
    InkToolbarEraserButton
    InkToolbarEraserFlyoutItemClickedEventArgs
    InkToolbarEraserFlyoutItemKind
    InkToolbarEraserKind
    InkToolbarFlyoutItem
    InkToolbarFlyoutItemKind
    InkToolbarHighlighterButton
    InkToolbarInitialControls
    InkToolbarIsStencilButtonCheckedChangedEventArgs
    InkToolbarMenuButton
    InkToolbarMenuKind
    InkToolbarPenButton
    InkToolbarPencilButton
    InkToolbarPenConfigurationControl
    InkToolbarRulerButton
    InkToolbarStencilButton
    InkToolbarStencilKind
    InkToolbarToggle
    InkToolbarToggleButton
    InkToolbarTool
    InkToolbarToolButton
    InkUnprocessedInput

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        LanguageMismatch
        UnsupportedLanguage

Novas propriedades experimentais Window.Width e Window.Height fornecem aos aplicativos uma maneira com reconhecimento de DPI de obter e definir o tamanho de uma janela em pixels lógicos (cliente) diretamente do código ou marcação, sem acessar o Window.AppWindow e executar a conversão manual de DPI lógica para física. As propriedades Companion Window.MinWidth, Window.MinHeight, Window.MaxWidth e Window.MaxHeight restringem o tamanho da janela. Agradecemos seus comentários.

O SpeechAudioProvider experimental (usado para efetuar push de áudio PCM de 16 kHz, de 16 bits e de canal único no reconhecimento de fala) agora implementa IClosable, para que os aplicativos possam liberar deterministicamente o provedor com Close/Dispose quando terminarem de transmitir áudio.

As APIs experimentais do Índice de Conteúdo de Aplicativo adicionam novos recursos de indexação e melhorias significativas de confiabilidade e desempenho nesta versão:

• Indexação em lote mais rápida. Uma nova API AppContentIndexer.BatchAddOrUpdate permite que vários itens sejam indexados juntos. O pipeline de indexação também foi redesenhado para dar suporte à execução em estágio paralelo e ao processamento em lote mais eficiente.
• Tokenização multilíngue aprimorada. O App Content Index agora usa um segmentador de palavras baseado em ICU, melhorando a precisão da tokenização em vários idiomas e eliminando a dependência do WinRT WordsSegmenter.
• Melhor desempenho de indexação e consulta. As atualizações de índice agora evitam reescritas lexicais desnecessárias, executam a limpeza em lote com mais eficiência e armazenam em cache os recursos do índice entre consultas, reduzindo substancialmente a sobrecarga nos fluxos comuns de consulta e indexação.
• Classificação lexical mais estável. A pontuação BM25 agora mantém as estatísticas de comprimento do documento de forma independente, preservando a classificação consistente à medida que o conteúdo é atualizado ou removido incrementalmente.
• Recuperação automática de corrupção de dados. O Índice de Conteúdo do Aplicativo detecta alterações de esquema incompatíveis e corrompidas do banco de dados ao abrir um índice e se recupera automaticamente iniciando um reindex em vez de deixar o índice inutilizável. GetOrCreateIndexStatus.RecoveredFromCorruption indica quando a recuperação ocorreu.
• Aumentos de classificação estáticos. Novas APIs permitem que os aplicativos apliquem aumentos de classificação a itens ou regiões de conteúdo individuais, permitindo que os resultados sejam tendenciosos usando sinais fornecidos pelo aplicativo. Use impulsos estáticos quando seu aplicativo tiver conhecimento sobre a importância relativa do conteúdo que não é capturado pelo próprio conteúdo, por exemplo, para ajudar a exibir um documento especialmente importante ou comumente procurado pelos usuários.
• Indexação de conteúdo de imagem. Agora, os aplicativos podem indexar conteúdo de bitmap ou fluxo de imagem diretamente, com opções que controlam a extração de OCR e a indexação semântica de texto extraído. Use a indexação de imagem quando informações pesquisáveis significativas estiverem contidas em uma imagem, em vez de já disponíveis como texto, como capturas de tela, documentos verificados ou outro conteúdo visual.
• Controle de indexação semântica para texto. Uma nova propriedade ContentRegionTextOptions.AllowSemanticIndexing permite que os aplicativos optem por regiões de texto individuais fora da indexação semântica. Isso é útil para texto que deve permanecer pesquisável lexicamente, mas é improvável que se beneficie da correspondência semântica, dando aos aplicativos mais controle sobre qual conteúdo participa da recuperação semântica.

Esta versão inclui as seguintes novas APIs em comparação com a versão 2.2 Experimental 9 :

Microsoft.UI.Composition

    CompositionEngine
    CompositionEngineType

Microsoft.UI.Xaml

    Window
        Height
        MaxHeight
        MaxWidth
        MinHeight
        MinWidth
        Width

Microsoft.UI.Xaml.Settings

    XamlChangeId
    XamlOptionalChanges

Microsoft.Windows.AI.Speech

    SpeechAudioProvider
        Dispose

Microsoft.Windows.AI.Text

    GenerateStructuredJsonResponseResult
    GenerateStructuredJsonResponseStatus
    LanguageModel
        GenerateStructuredJsonResponseAsync

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        BatchAddOrUpdate
        GetContentStaticBoost
        GetRegionStaticBoost
        ResetAllStaticBoosts
        SetContentStaticBoost
        SetRegionStaticBoost

    AppIndexContentRegion
        CreateFromBitmap
        CreateFromImageStream
        StaticBoost

    AppManagedIndexableAppContent
        CreateFromBitmap
        CreateFromImageStream

    BatchAddOrUpdateItemResult
    BatchAddOrUpdateResult
    ContentRegionImageOptions
    ContentRegionTextOptions
        AllowSemanticIndexing

    GetOrCreateIndexStatus
        RecoveredFromCorruption

    ImageOcrIndexingOptions
    IndexableAppContent
        StaticBoost

As APIs de modelo de linguagem agora funcionam em PCs sem Copilot+ equipados com uma GPU compatível, levando recursos locais de modelos de linguagem a uma gama mais ampla de dispositivos com Windows 11. O hardware com suporte inclui a série NVIDIA GeForce RTX 30 e mais recente com mais de 6 GB de vRAM. A inferência na GPU requer que o Modo de Desenvolvedor esteja habilitado e uma compilação do Canal Experimental do Windows Insider.

O modelo de GPU não está pré-instalado. Ele é baixado sob demanda via EnsureReadyAsync pelo Windows Update. Os aplicativos devem verificar GetReadyState e exibir uma caixa de diálogo de consentimento antes de disparar o download. Os usuários podem gerenciar o modelo em Configurações > Sistema > Componentes de IA.

Para obter orientações sobre IA responsável, consulte a nova Nota de Transparência: APIs de Modelos de Linguagem em PCs sem Copilot+.

As novas APIs de reconhecimento de fala no dispositivo em Microsoft.Windows.AI.Speech habilitam a conversão de fala em texto tanto em lote quanto em streaming. BatchRecognition reconhece uma fonte de áudio completa em uma única chamada e StreamingRecognition gera Recognizing e Recognized eventos. O áudio pode ser obtido de um dispositivo (AudioConfiguration.FromAudioDevice), de um arquivo (FromFile), de um fluxo de entrada (FromStream) ou fornecido pelo chamador por meio de SpeechAudioProvider (PCM de canal único, 16 kHz, 16 bits). O modelo no dispositivo é gerenciado por meio de SpeechRecognitionModel.EnsureReadyAsync / TryCreateAsync, com o progresso do download e do carregamento informado por meio de SpeechRecognitionModelProgress.

Uma nova enumeração Microsoft.Windows.Workloads.NpuType exibe a classe NPU no dispositivo atual (por exemplo, Qnn, Lnl, Stx, Win365, Unknown, None), para que a infraestrutura de aplicativos e cargas de trabalho possa encaminhar cargas de trabalho de IA para o caminho de execução apropriado.

Esta versão inclui as seguintes novas APIs em comparação com a versão 2.1 Experimental 8 :

Microsoft.UI.Xaml

    Setter
        ValueProperty

Microsoft.UI.Xaml.Markup

    XamlBindingHelper
        SetPropertyFromColor
        SetPropertyFromCornerRadius
        SetPropertyFromThickness

Microsoft.Windows.AI.Speech

    AudioConfiguration
    BatchRecognition
    SpeechAudioProvider
    SpeechContract
    SpeechRecognitionModel
    SpeechRecognitionModelProgress
    SpeechRecognitionModelProgressStatus
    SpeechRecognitionModelResult
    StreamingRecognition
    StreamingRecognizedEventArgs
    StreamingRecognizingEventArgs

Microsoft.Windows.AI.Text.Experimental

    LanguageModelExperimental
        CompressPromptAsync
        GenerateResponseAsync
        GenerateResponseFromEmbeddingsAsync

    LanguageModelOptionsExperimental
        PreferredRetentionRatio

Microsoft.Windows.Workloads

    NpuType

LanguageModelExperimental.GenerateStructuredJsonResponseAsync (introduzido na versão 2.0 Experimental 7) agora retorna um tipo GenerateStructuredJsonResponseResult dedicado com uma propriedade GenerateStructuredJsonResponseStatus, em vez do par genérico LanguageModelResponseResult / LanguageModelResponseStatus A nova enumeração de status é específica à geração restrita ao esquema: inclui um ResponseInvalidJson valor para o caso em que a saída do modelo não satisfez o esquema JSON solicitado, separado das falhas genéricas de resposta do modelo de linguagem.

Como parte dessa divisão, o ResponseInvalidJson valor foi removido da enumeração estável LanguageModelResponseStatus (em que ele havia sido adicionado anteriormente para dar suporte à saída JSON estruturada). Os aplicativos que lidavam com ResponseInvalidJson direto de LanguageModelResponseStatus devem mover esse tratamento para o novo GenerateStructuredJsonResponseStatus retornado por GenerateStructuredJsonResponseAsync. Outros chamadores de LanguageModelResponseStatus não precisam mais levar em conta um valor de falha específico para JSON.

Esta versão inclui as seguintes novas APIs em comparação com a versão 2.0 Experimental 7 :

Microsoft.UI.Xaml.Controls

    TitleBar
        AutoRefreshDragRegions
        AutoRefreshDragRegionsProperty
        GetIsDragRegion
        IsDragRegionProperty
        RecomputeDragRegions
        SetIsDragRegion

Microsoft.Windows.AI

    AICapabilities

    AICapabilityCategory

Microsoft.Windows.AI.Text

    LanguageModelLowRankAdapter

    LanguageModelLowRankAdapterResult

    LanguageModelOptions
        LowRankAdapter

    LanguageModelResponseStatus
        IncompatibleLowRankAdapter

Microsoft.Windows.AI.Text.Experimental

    GenerateStructuredJsonResponseResult

    GenerateStructuredJsonResponseStatus

    LanguageModelOptionsExperimental
        LowRankAdapter [Experimental]

O SDK do Aplicativo Windows 2.0.0-experimental7 apresenta o suporte experimental para CMake (em desenvolvimento ativo), permitindo que desenvolvedores C++ consumam pacotes NuGet do SDK do Aplicativo Windows de projetos baseados em CMake.

A integração do CMake é criada no NuGetCMakePackage, um módulo do CMake de software livre que faz a ponte entre o gerenciamento de pacotes NuGet e o fluxo de trabalho nativo find_package() do CMake. O NuGetCMakePackage gerencia o download e a restauração de pacotes NuGet no momento da configuração via add_nuget_packages(), sonda cada pacote para uma configuração cmake embutida (em build/cmake/<package>-config.cmake) e expõe os cabeçalhos do pacote, as bibliotecas de importação, as DLLs de execução e os metadados do WinRT como alvos padrão do CMake.

Cada componente do NuGet SDK do Aplicativo Windows e o pacote dependente agora inserem um arquivo de configuração do CMake em build/cmake/, que com a ajuda da biblioteca NuGetCMakePackage, permite que o find_package() do CMake descubra automaticamente destinos, cabeçalhos, bibliotecas e DLLs de runtime sem a configuração manual do caminho. Isso abrange todos os pacotes de componentes, incluindo Foundation, InteractiveExperiences, DWrite, Widgets, IA, ML e WinUI, bem como dependências como Base e Runtime.

Para obter uma visão geral do modelo de consumo do CMake e orientações para começar, consulte a página inicial do CMake.

Esse recurso é experimental e está sendo enviado antecipadamente para coletar comentários da comunidade. As convenções de nomenclatura de destino e os padrões de configuração estão sujeitos a alterações com base na entrada do desenvolvedor. Como este é um pré-lançamento antecipado, há alguma cerimônia e configuração envolvidas – consulte os aplicativos de exemplo do CMake que ilustram a configuração e o uso de ponta a ponta em todos os quatro cenários de implantação (SelfContained|FrameworkDependent x Packaged|Unpackaged).

Queremos ouvir você! Se você encontrar um cenário que não esteja coberto no momento, tenha sugestões para melhorar a experiência do desenvolvedor ou encontre problemas, envie comentários na guia Issues no repositório de software livre SDK do Aplicativo Windows ou inicie uma conversa no Discussions. Sua entrada formatará diretamente o desenvolvimento ativo desse recurso.

Esta versão experimental acumula as alterações e correções enviadas em 2.0-Preview1 e 2.0-Preview2. Os itens apresentados são resumidos abaixo; consulte as notas de versão da Versão Prévia vinculada para obter detalhes completos.

A partir da versão 2.0-Preview1:

• ML do Windows: correção para RegisterCertifiedAsync que retorna 0 provedor de execução quando chamado novamente no mesmo processo.
• Microsoft.UI.Content: nova propriedade InputFocusController.ShouldShowKeyboardCues e nova API prática PointerPoint.GetCurrentPoint.
• Microsoft.Windows.Management.Deployment: novas APIs PackageVolume para parity+ com Windows.Management.Deployment (incluindo AddAsync, GetDefault, GetAvailableSpaceAsync, IsAppxInstallSupported, IsOffline, IsFeatureSupported e muito mais). Novo ponto de extensibilidade em IPackageValidator, AddPackageOptions e StagePackageOptions, com três validadores internos: PackageCertificateEkuValidator, PackageFamilyNameValidator e PackageMinimumVersionValidator.
• Microsoft.Windows. Storage.Pickers:
  • Novas propriedades Title em FileOpenPicker, FileSavePicker e FolderPicker, habilitando títulos de caixa de diálogo personalizados.
  • Novas propriedades SettingsIdentifier em FileOpenPicker, FileSavePicker e FolderPicker, habilitando o estado específico da instância do seletor pelas sessões.
  • Novas propriedades InitialFileTypeIndex em FileOpenPicker e FileSavePicker, permitindo que os desenvolvedores definam o filtro de tipo de arquivo selecionado padrão por índice (baseado em 0).
  • Nova propriedade ShowOverwritePrompt em FileSavePicker. Usa o padrão true e controla se o seletor avisa sobre a substituição quando o usuário seleciona um arquivo existente por meio de FileSavePicker.
  • Alterado o comportamento padrão de FileSavePicker: a partir do WindowsAppSDK 2.0, o FileSavePicker NÃO criará um arquivo vazio quando o usuário escolher um arquivo não existente, permitindo que os desenvolvedores decidam quando fazer o arquivo.
  • Novo método PickMultipleFoldersAsync no FolderPicker, habilitando a seleção de várias pastas em uma única operação.
• Correções de erros: relato do progresso da instalação; melhor tratamento de erros nas bibliotecas de classes.

Da versão 2.0-Preview2:

• APIs de IA do Windows: as APIs Phi Silica são impostas como um recurso de Acesso Limitado; novos valores AIFeatureReadyState apresentam problemas de aquisição de modelo, como recursos ausentes, hardware incompatível e atualizações necessárias do sistema operacional; falhas persistentes na instalação de rede ou no Windows Update agora são sinalizadas; capacidade de diagnóstico aprimorada para as APIs de Inteligência de Texto.
• Condicionais XAML personalizadas: IXamlCondition gradua e renomeia a interface experimental IXamlPredicate , permitindo condições personalizadas avaliadas em tempo de análise XAML.
• WebView2 (WinUI 3): Suporte para arrastar conteúdo hospedado no WebView2 (texto, HTML, imagens, URLs), cancelamento de arraste, visuais personalizados para arrastar e dados de arraste personalizáveis. Requer WebView2 Runtime 144.0.3719.11 ou posterior. (DownloadURL ainda não suportado.)
• Correções de bugs: avisos de build MSB8027/LNK4042 de itens ClCompile duplicados em arquivos .targets (com uma solução alternativa de recusa WindowsAppSDK_Arm64EcCompilerWorkaround para ARM64EC+LTCG); falha do ListView durante a navegação pelo teclado após atualizações na lista de itens; falha do WinUI 3 quando o foco é movido para um CoreWebView2Controller não visível.

• Passagem de renomeação de API para clareza e consistência:
  • ScaleFrameStatus → VideoScalerStatus
  • VideoScalerOptions.RegionOfInterests → VideoScalerOptions.RegionsOfInterest
  • VideoScaler.ScaleFrame → VideoScaler.Scale e VideoScaler.ScaleImageBuffer
• Várias correções de bug e melhorias de qualidade no VSR.

• Nova API LanguageModelExperimental.GenerateStructuredJsonResponseAsync em Microsoft.Windows.AI.Text.Experimental para gerar a saída JSON estruturada de um modelo de linguagem.
• Novo LanguageModelResponseStatus.ResponseInvalidJson valor de status para indicar que um modelo retornou uma resposta que não foi analisada como JSON válido.

• Novas AppContentIndexer.GetExistingIndexes e AppContentIndexer.IsContentKindSupported APIs.
• Novo AppManagedOcrTextQueryMatch tipo e QueryMatchContentKind.AppManagedOcrText valor para dar suporte à consulta de conteúdo do aplicativo por meio de texto derivado do OCR.
• Novo GetOrCreateIndexOptions.CreateAlways para forçar a criação de um índice.
• Nova funcionalidade ContentItemErrorDetail.InsufficientDiskSpace para identificar falhas de pouco espaço em disco durante a indexação.

Esta versão inclui as seguintes APIs experimentais novas e modificadas em comparação com 2.0.0-experimental6:

Microsoft.UI.Input

    InputFocusController
        ShouldShowKeyboardCues

    PointerPoint
        GetCurrentPoint

Microsoft.UI.Xaml.Markup

    IXamlCondition

Microsoft.Windows.AI

    AIFeatureReadyResult
        PackageInstallationFailed

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        ResponseInvalidJson

Microsoft.Windows.AI.Text.Experimental

    LanguageModelExperimental
        GenerateStructuredJsonResponseAsync

Microsoft.Windows.AI.Video

    VideoScaler
        Scale
        ScaleImageBuffer

    VideoScalerOptions
        RegionsOfInterest

    VideoScalerStatus

Microsoft.Windows.Management.Deployment

    AddPackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

    IPackageValidator
    PackageCertificateEkuValidator
    PackageFamilyNameValidator
    PackageMinimumVersionValidator
    PackageValidationEventArgs
    PackageValidationEventSource
    PackageValidationHandler
    PackageVolume
        AddAsync
        GetAvailableSpaceAsync
        GetDefault
        GetPackageVolumeByName
        GetPackageVolumeByPath
        IsFeatureSupported
        IsOffline
        RemoveAsync
        SetDefault
        SetOfflineAsync
        SetOnlineAsync

    PackageVolumeFeature
    StagePackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetExistingIndexes
        IsContentKindSupported

    AppManagedOcrTextQueryMatch
    ContentItemErrorDetail
        InsufficientDiskSpace

    GetOrCreateIndexOptions
        CreateAlways

    QueryMatchContentKind
        AppManagedOcrText

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        InitialFileTypeIndex
        SettingsIdentifier
        Title

    FileSavePicker
        InitialFileTypeIndex
        SettingsIdentifier
        ShowOverwritePrompt
        Title

    FolderPicker
        PickMultipleFoldersAsync
        SettingsIdentifier
        Title

Windows ML agora pode ser usado em projetos C++ com o CMake. Consulte a página Introdução para saber mais.

A versão do ONNX Runtime foi atualizada para 1.24.2. Consulte as versões de Runtime do ONNX para obter mais informações.

• NPUPowerMode foi preterido em favor de APIs de gerenciamento de energia mais recentes.
• GetReadyState agora retorna NotSupported normalmente quando o agente de sessão não está disponível, em vez de gerar uma exceção.

• Adicionado suporte ao formato de saída NV12 para a Super Resolução de Vídeo.

• Confiabilidade aprimorada DeleteIndex . Às vezes, DeleteIndex falhava com ERROR_SHARING_VIOLATION.

• Correção para as Caixas Delimitadoras de OCR quando estas retornavam valores negativos em alguns casos extremos.

• A Pesquisa de Conteúdo do Aplicativo faz parte de um pacote Microsoft.Windows.Search separado em vez de fazer parte do Microsoft.Windows.AI package.

• Correção da pesquisa de prefixo que não funcionava com cadeias de caracteres de consulta curtas.

• Novas APIs e renomeações com base na revisão oficial da API.

  • AppContentIndexer
    • GetContentItemsRequiringReindexing
    • Remover –> RemoveContentItem
    • RemoveMultiple –> RemoveContentItems
    • RemoveAllContentItems
    • GetContentIndexingStatus –> GetContentItemStatus
    • GetMultipleContentIndexingStatus –> GetContentItemStatuses
    • GetContentItems
  • AppCOntentIndexListener
    • IndexingStatusChanged –> ContentItemStatusChanged
  • AppIndexTextQuerySession
    • UpdateQuery –> UpdateQueryPhrase
    • MostRecentResult –> GetResult
    • MostRecentResultChanged –> ResultChanged
  • AppIndexImageQuerySession
    • UpdateQuery –> UpdateQueryPhrase
    • MostRecentResult –> GetResult
    • MostRecentResultChanged –> ResultChanged
  • AppManagedImageQueryMatch
    • Sub-região de Interesse -> RegiãoDeInteresse
  • ContentItemStatusResult
    • Status da reindexação * Status da reindexação do item de conteúdo
  • TextQuerySessionResult
    • IsValid
  • ImageQuerySessionResult
    • IsValid
  • QueryContentItemsFilterFlags

• Correção de ImageDescription.DescribeAsync falhando com InternalError devido a uma condição de corrida.

Esta versão inclui as seguintes APIs experimentais novas e modificadas em comparação com 2.0.0-experimental5:

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetContentItems
        GetContentItemStatus
        GetContentItemStatuses
        RemoveAllContentItems
        RemoveContentItem
        RemoveContentItems

    AppContentIndexListener
        ContentItemStatusChanged

    AppManagedImageQueryMatch
    ContentItemErrorDetail
        IndexCorruption

    ContentItemReindexingStatus
        Unspecified

    QueryContentItemsFilterFlags

• Contrato de licença simplificado com termos mais claros para ISVs que criam aplicativos com Windows ML.
• Seções reestruturadas que abrangem Instalação, Dados e Código Distribuível com maior clareza.
• A seção Aviso de Conformidade do Novo Provedor de Execução (EP) esclarece as responsabilidades do desenvolvedor em relação aos provedores de execução aceleradas por hardware.
• Links diretos para os acordos de licença de fornecedores para NVIDIA TensorRT, Intel OpenVINO e Qualcomm QNN (SDK de Rede Neural Qualcomm).

• As versões experimentais do Windows ML se alinham à versão principal do ONNX Runtime, versão 1.24, para melhorar a compatibilidade e a estabilidade.
• Provedores de execução da Interface Binária de Aplicativo Estável (ABI) são obrigatórios para garantir um comportamento previsível em diferentes dispositivos, com provedores de execução não estáveis excluídos da aquisição.
  • Somente o provedor de execução OpenVINO tem suporte, com provedores de execução adicionais a serem adicionados ao longo do tempo à medida que atendem aos requisitos de estabilidade.
• O tamanho de Microsoft.Windows.AI.MachineLearning.dll foi reduzido em aproximadamente 160 KB.

• Novas APIs experimentais para pesquisar estatísticas de itens que estão sendo indexados. Isso fornece visibilidade do que está acontecendo no índice.
• Suporte para cancelamento de consulta para permitir que os aplicativos executem uma consulta e atualizem-na se houver uma nova consulta antes que a atual seja concluída. Isso permite responder mais rapidamente à consulta enquanto o usuário digita na cadeia de caracteres de consulta.
• Suporte à correspondência de prefixo para cadeias de caracteres curtas, visando melhorar os resultados enquanto o usuário digita.

• O VideoScaler agora é descartável, melhorando o gerenciamento de recursos e o controle do ciclo de vida.
• O modelo VSR agora é compilado e armazenado em cache para melhorar o desempenho e reduzir os custos de inicialização repetidos.
• Uma verificação de funcionalidade foi adicionada para validar o suporte do VSR antes do uso.
• A inicialização explícita do WinML não é mais necessária ao usar a Super Resolução de Vídeo.

• O FlowLayout controle agora usa a terminologia ItemSpacing e LineSpacing em vez de propriedades de espaçamento horizontal e vertical. A nomenclatura alinhada melhora a clareza e a consistência com padrões de layout modernos em estruturas de interface do usuário.

• O WrapPanel controle agora usa a nomenclatura ItemSpacing e LineSpacing em vez das propriedades de espaçamento horizontal e vertical anteriores.

• Implementação de uma interface IXamlPredicate para definir predicados personalizados que se integram perfeitamente com a sintaxe do namespace condicional do XAML e são avaliados em tempo de análise do XAML.
• Predicados personalizados permitem cenários XAML condicionais com base em fatores específicos do aplicativo, como:
  • Sinalizadores de recursos
  • Funcionalidades de dispositivo
  • Lógica de negócios
  • Definições de configuração
  • Outras condições de tempo de execução

• Pacotes atualizados para habilitar a usabilidade externa, que inclui alterações em:
  • Microsoft.UI.DCPP.Dependencies.Minimal
  • Microsoft.UI.DCPP.Dependencies.Edge
  • ExpPointerPointStatics
• Suporte de build adicionado para Visual Studio 2026
• Ferramentas e scripts introduzidos para uso por desenvolvedores externos para criar e testar o WinUI.

• [preterido] DependencyObject.Dispatcher
• [desativado] Window.Current
• [preterido] FocusManager.GetFocusedElement
• [renomeado] SystemBackdropHost para SystemBackdropElement

• [renomeado] Microsoft.Windows.AI.Search.Experimental.AppContentIndex para Microsoft.Windows.Search.AppContentIndex

• Correção dos erros de "Classe não registrada" ao se usar a implantação autocontidas com o ML do Windows. Os desenvolvedores que usam a implantação autônoma não precisam mais registrar todas as classes ativáveis do pacote Foundation que foram usadas internamente.
• Correção de uma possível falha no desligamento do processo ao usar Windows ML.
• Correção do caminho de roteamento da ImageForegroundExtractor API para que as chamadas chegassem ao ponto de extremidade correto.
• Garanta que o progresso da instalação e do download do provedor de execução seja encaminhado corretamente para os aplicativos durante a implantação do pacote.
• Correção de uma falha em SystemBackdrop quando o destino se desconecta, guardando caminhos de desconexão inválidos.
• Correção de um problema que impedia que as APIs de IA Windows fossem disponibilizadas para alguns aplicativos.

Esta versão inclui as seguintes APIs experimentais novas e modificadas em comparação com 2.0.0-experimental3:

Microsoft.UI.Content

    ChildSiteLink
        IsHitTestVisible

Microsoft.UI.Xaml.Controls

    FlowLayout
        LineSpacing
        LineSpacingProperty
        MinItemSpacing
        MinItemSpacingProperty

    SystemBackdropElement
    WrapPanel
        ItemSpacing
        ItemSpacingProperty
        ItemsStretch
        ItemsStretchProperty
        LineSpacing
        LineSpacingProperty

    WrapPanelItemsStretch

Microsoft.UI.Xaml.Markup

    IXamlPredicate

Microsoft.Windows.AI.Video

    VideoScaler
        Dispose

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexContract
    AppContentIndexer
    AppContentIndexListener
    AppIndexContentRegion
    AppIndexImageQuery
    AppIndexImageQuerySession
    AppIndexQueryMatch
    AppIndexTextQuery
    AppIndexTextQuerySession
    AppIndexTextStreamEncoding
    AppManagedImageQueryMatch
    AppManagedIndexableAppContent
    AppManagedTextQueryMatch
    ContentItemErrorDetail
    ContentItemReader
    ContentItemReindexingStatus
    ContentItemStatus
    ContentItemStatusResult
    ContentRegionTextOptions
    DeleteIndexResult
    DeleteIndexStatus
    DeleteIndexWhileInUseBehavior
    GetOrCreateIndexOptions
    GetOrCreateIndexResult
    GetOrCreateIndexStatus
    ImageQueryMatch
    ImageQueryOptions
    ImageQuerySessionResult
    IndexableAppContent
    IndexCapabilities
    IndexCapabilitiesOfCurrentSystem
    IndexCapability
    IndexCapabilityInitializationStatus
    IndexCapabilityLanguageStatus
    IndexCapabilityOfCurrentSystemStatus
    IndexCapabilityRequirement
    IndexCapabilityState
    IndexStatistics
    QueryMatchContentKind
    QueryMatchScope
    RegionContentKind
    TextLexicalMatchType
    TextQueryMatch
    TextQueryOptions
    TextQuerySessionResult

• Uma regressão do ONNX Runtime faz com que a Super Resolução de Vídeo falhe em dispositivos Qualcomm. Uma atualização pendente para o provedor de execução de NPU da Qualcomm resolve esse problema.

O novo controle experimental SplitMenuFlyoutItem foi projetado para fornecer uma experiência de botão dividido em um submenu de menu. Esse controle permitirá que os desenvolvedores exponham uma ação primária padrão e, ao mesmo tempo, ofereçam opções adicionais por meio de um submenu, ideal para condensar a funcionalidade complexa em um volume menor e salvar o comprimento geral do menu.

Juntamente com os recursos de MenuFlyoutItem e MenuFlyoutSubItem, o controle vem com duas outras propriedades: SubMenuPresenterStyle e SubMenuItemStyle, que permite a personalização do submenu, como usar GridView para o apresentador de submenu.

    <Button Content="Open file">
        <Button.Flyout>
            <MenuFlyout>
                <SplitMenuFlyoutItem Text="Open with Notepad">
                    <MenuFlyoutItem Text="Visual Studio" />
                    <MenuFlyoutItem Text="VS Code" />
                    <MenuFlyoutItem Text="Word" />
                </SplitMenuFlyoutItem>
            </MenuFlyout>
        </Button.Flyout>
    </Button>

Tipos renomeados

• WinMLCatalogModel renomeado para ModelCatalog
• CatalogModelSource renomeado para ModelCatalogSource

Atualizações de método

• CatalogModelInfo: renomeado GetInstance para GetInstanceAsync
• ModelCatalogSource: renomeado CreateFromUri para CreateFromUriAsync
• ModelCatalog: renomeado FindModel para FindModelAsync
• ModelCatalog: renomeado FindAllModels para FindAllModelsAsync

Alterações de propriedade

• Atualizado CatalogModelInfo.Size para CatalogModelInfo.ModelSizeInBytes

Atualizações de comportamento

• Recupere a instância de CatalogModelInstanceResult usando .GetInstance()
• CatalogModelStatus agora retorna Ready ou NotReady com base na disponibilidade local
• Adicionado CatalogModelInstanceStatus para separar o status da instância do status do modelo

Aprimoramentos de CatalogModelInfo

• Alias renomeado para Name
• Revision renomeado para Version
• Adicionado Publisher
• Removido DisplayName

Alterações JSON

• Nome mudado alias para id.
• Removido modelType e description.
• Nome mudado executionProvider para executionProviders.
• executionProviders Atualizado para ser uma matriz de objetos JSON em vez de uma lista separada por vírgulas.

Alterações adicionais

• ModelCatalog agora retorna uma lista de Provedores de Execução (EPs) quando uma instância é criada.
• Adicionado suporte para Windows 10 (1809) e superior.
• Adicionado suporte para arquivos locais, incluindo arquivos regulares e pacotes MSIX.
• Corrigidas as falhas causadas por JSON de catálogo inválido.

• O tipo anterior AppIndexQuery , que incluía GetNextTextMatches e GetNextImageMatches métodos, foi dividido em dois tipos distintos: AppIndexTextQuery e AppIndexImageQuery. O AppContentIndexer.CreateQuery método foi substituído por: CreateTextQuery e CreateImageQuery.

• Esses métodos agora retornam AppIndexTextQuery e AppIndexImageQuery , respectivamente. Para simplificar o uso, os tipos de opções também foram atualizados:

  • Removido: AppIndexQueryOptions, TextMatchOptions e ImageMatchOptions
  • Adicionado: TextQueryOptions e ImageQueryOptions

• As APIs no AppContentIndex namespace que retornaram matrizes anteriormente agora retornam IVectorView para melhorar a consistência e o desempenho.

• O AppContentIndexer.WaitForIndexingIdleAsync método foi atualizado para aceitar um TimeSpan parâmetro em vez de um inteiro, fornecendo tratamento de tempo limite mais claro e flexível.

A API VideoScaler fornece melhoria de vídeo em tempo real por meio de dimensionamento de IA avançada, otimizada para streamings onde pessoas estão em conversação. Ele permite que os desenvolvedores forneçam visuais mais nítidos e claros em plataformas de conferência, streaming e edição, mesmo em condições de rede ruins. A API dá suporte à personalização da resolução de saída, taxa de quadros e regiões de interesse, com compatibilidade para vários formatos de vídeo, incluindo BGR, RGB e NV12.

A nova API RewriteCustomAsync permite que você forneça uma cadeia de caracteres de entrada que orienta o Phi Silica na reescrita do texto selecionado. Você pode experimentar novos estilos criativos como "Pateta" ou "Pirata" para transformar instantaneamente seu conteúdo.

A ImageGenerator classe aproveita os modelos de Difusão Estável para fornecer recursos avançados de geração de imagem. Ele dá suporte a vários cenários de geração:

• Texto para Imagem: Gere imagens a partir de instruções textuais descritivas.

• Imagem para imagem: Transformar imagens existentes com base em descrições textuais.

• Preenchimento Mágico: Preencha regiões mascaradas de imagens com conteúdo gerado por IA.

• Estilo do livro de colorir: Gerar imagens no estilo de livro de cores.

• Restyle: Altere o estilo artístico das imagens existentes, preservando a estrutura.

Todas as imagens geradas são retornadas no formato RGB8 por meio de objetos ImageBuffer . A API inclui filtros de segurança de conteúdo internos e dá suporte a parâmetros de geração personalizáveis.

using Microsoft.Windows.AI.Imaging;
using Microsoft.Graphics.Imaging;
 
public async Task GenerateImageFromText()
{
    var readyState = ImageGenerator.GetReadyState();
    if (readyState != AIFeatureReadyState.Ready)
    {
        var progress = new Progress<double>(p => Console.WriteLine($"Download progress: {p:P}"));
        var result = await ImageGenerator.EnsureReadyAsync();
        if (result.Status != AIFeatureReadyResultState.Success)
        {
            Console.WriteLine("Failed to prepare models");
            return;
        }
    }
 
    using var generator = await ImageGenerator.CreateAsync();
 
    var options = new ImageGenerationOptions
    {
        MaxInferenceSteps = 6,
        Creativity = 0.8,
        Seed = 42
    };
 
    var result = generator.GenerateImageFromTextPrompt("A beautiful sunset over a mountain lake", options);
 
    if (result.Status == ImageGeneratorResultStatus.Success)
    {
        await SaveImageBufferAsync(result.Image, "generated_image.png");
    }
}

Esta versão inclui as seguintes APIs experimentais novas e modificadas em comparação com 2.0-experimental2:

Microsoft.Graphics.Imaging

    ImageBufferPixelFormat
        Bgr8

Microsoft.UI.Xaml.Automation.Peers

    SplitMenuFlyoutItemAutomationPeer

Microsoft.UI.Xaml.Controls

    SplitMenuFlyoutItem

Microsoft.Windows.AI.Imaging

    ImageFromImageGenerationOptions
    ImageFromImageGenerationStyle
    ImageFromTextGenerationOptions
    ImageFromTextGenerationStyle
    ImageGenerationOptions
    ImageGenerator
    ImageGeneratorContract
    ImageGeneratorResult
    ImageGeneratorResultStatus
    TextRecognizer
        RecognizeTextFromImage
        RecognizeTextFromImageAsync

    TextRecognizerOptions

Microsoft.Windows.AI.MachineLearning

    CatalogModelInfo
    CatalogModelInstance
    CatalogModelInstanceResult
    CatalogModelInstanceStatus
    CatalogModelStatus
    ModelCatalog
    ModelCatalogSource

Microsoft.Windows.AI.Search.Experimental.AppContentIndex

    AppContentIndexer
        CreateImageQuery
        CreateTextQuery
        WaitForIndexingIdleAsync

    AppIndexImageQuery
    AppIndexTextQuery
    ImageQueryOptions
    TextQueryOptions

Microsoft.Windows.AI.Text

    TextRewriter
        RewriteCustomAsync

Microsoft.Windows.AI.Video

    ScaleFrameStatus
    VideoScaler
    VideoScalerOptions
    VideoScalerResult

• Correção do cálculo da caixa delimitadora quando o texto é girado. Em algumas circunstâncias, a correspondência de texto via OCR em imagens relatou limites de área imprecisos ou vazios quando o texto foi girado.

As APIs AppContentIndexer capacitam os desenvolvedores a indexar com eficiência o conteúdo do aplicativo, incluindo texto e imagens para recuperação rápida e relevante. Suportando pesquisas léxicos (baseadas em palavra-chave) e semânticas (baseadas em significado), essas APIs permitem que os aplicativos forneçam resultados rápidos e relevantes com base na intenção e no contexto do usuário, em vez de apenas palavras-chave exatas.

Essa funcionalidade desbloqueia os seguintes cenários avançados:

• Pesquisa Semântica
  Os aplicativos podem retornar resultados com base na intenção e no significado, em vez de correspondências exatas de palavra-chave.
  Exemplo: Uma consulta para "linha do tempo do projeto" pode exibir conteúdo que menciona "agenda" ou "datas de entrega", mesmo que essas palavras exatas não foram usadas.
• Geração Aprimorada por Recuperação (RAG)
  O conteúdo indexado pode servir como uma base de dados de conhecimento para modelos de IA generativos. Quando um usuário faz uma pergunta, o aplicativo recupera os documentos ou snippets mais relevantes de seu índice e os alimenta no modelo, permitindo respostas precisas e com reconhecimento de contexto fundamentadas em dados reais.

As APIs do Catálogo de Modelos do Windows ML permitem que seu aplicativo ou biblioteca descubra e baixe arquivos de modelo de IA grandes dinamicamente de seus próprios catálogos de modelos online, eliminando a necessidade de empacotar esses arquivos grandes diretamente com seu aplicativo ou biblioteca. O catálogo de modelos ajuda a garantir a compatibilidade do dispositivo filtrando modelos e baixando somente aqueles aplicáveis ao dispositivo Windows específico em uso.

A atualização Microsoft.Windows.Storage.Pickers mais recente simplifica a seleção de arquivos e pastas, permitindo que os desenvolvedores definam locais de pastas iniciais e persistentes e agrupando filtros de tipo de arquivo com rótulos claros para facilitar a navegação.

A API PopupAnchor agora permite que DesktopPopupSiteBridge ofereça suporte ao posicionamento relativo por meio de ancoragem em sua janela ou ilha própria, abordando a limitação em que os pop-ups só podiam ser posicionados absolutamente usando coordenadas de tela.

A InputUnderlyingWindowController API permite que os desenvolvedores designem o HWND de destino para receber mensagens de entrada que foram originalmente enviadas para um ContentIsland criado a partir de um SystemVisual (consulte ContentIsland.CreateForSystemVisual).

SystemBackdropHost permite colocar um cenário do sistema (acrílico/mica) em qualquer lugar dentro da árvore visual de um aplicativo.

O WrapPanel é um painel de layout XAML do WinUI que organiza elementos filho em uma posição sequencial da esquerda para a direita; os itens que excedem a linha serão movidos para a próxima linha automaticamente ao final do painel de contenção. É útil para layouts responsivos.

Essa é uma porta do controle do Kit de Ferramentas da Comunidade do Windows.

Esta versão inclui as seguintes APIs experimentais novas e modificadas em comparação com 2.0-experimental1:

Microsoft.UI.Content

    PopupAnchor

Microsoft.UI.Input

    InputUnderlyingWindowController

Microsoft.UI.Xaml.Controls

    StretchChild
    SystemBackdropHost
    WrapPanel

Microsoft.Windows.AI.Imaging

    ImageForegroundExtractor
    ImageForegroundExtractorContract

Microsoft.Windows.AI.Search.Experimental.AppContentIndex

    AppContentIndexContract
    AppContentIndexer
    AppContentIndexListener
    AppIndexContentRegion
    AppIndexQuery
    AppIndexQueryMatch
    AppIndexQueryOptions
    AppIndexTextStreamEncoding
    AppManagedImageQueryMatch
    AppManagedIndexableAppContent
    AppManagedTextQueryMatch
    ContentItemReader
    ContentItemStatus
    ContentItemStatusResult
    ContentRegionTextOptions
    DeleteIndexResult
    DeleteIndexStatus
    DeleteIndexWhileInUseBehavior
    GetOrCreateIndexOptions
    GetOrCreateIndexResult
    GetOrCreateIndexStatus
    ImageMatchOptions
    ImageQueryMatch
    IndexableAppContent
    IndexCapabilities
    IndexCapabilitiesOfCurrentSystem
    IndexCapability
    IndexCapabilityInitializationStatus
    IndexCapabilityLanguageStatus
    IndexCapabilityOfCurrentSystemStatus
    IndexCapabilityRequirement
    IndexCapabilityState
    IndexStatistics
    QueryMatchContentKind
    QueryMatchScope
    RegionContentKind
    TextLexicalMatchType
    TextMatchOptions
    TextQueryMatch

Microsoft.Windows.AI.Text.Experimental

    LanguageModelExperimental
    LanguageModelExperimentalContract
    LanguageModelOptionsExperimental
    LowRankAdaptation

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        FileTypeChoices
        SuggestedFolder
        SuggestedStartFolder

    FileSavePicker
        SuggestedStartFolder

    FolderPicker
        SuggestedFolder
        SuggestedStartFolder

• AppContentIndexer As APIs devem ser chamadas de um thread em segundo plano. Usá-la no thread de interface do usuário pode travar ou causar longas pausas que afetam a experiência do usuário.
• Os resultados da consulta usando AppIndexQuery.GetNextTextMatches e AppIndexQuery.GetNextImageMatches serão nulos quando não houver correspondências, em vez de uma lista vazia.
• Correlações de imagem utilizando AppManagedImageQueryMatch.Subregion com base nos valores de OCR podem ocasionalmente ser imprecisas, especialmente quando o texto é girado ou inclinado.
• As correspondências de imagem que usam AppManagedImageQueryMatch.Subregion às vezes podem incluir retângulos de tamanho zero ou extremamente pequenos, levando a resultados imprecisos.
• Uma consulta vazia de AppContentIndex.CreateQuery pode gerar uma exceção.

As APIs do catálogo de modelos Windows ML permitem que seu aplicativo ou biblioteca baixe dinamicamente arquivos de modelo de IA grandes de seus próprios catálogos de modelos online sem enviar esses arquivos grandes diretamente com seu aplicativo ou biblioteca. Além disso, o catálogo de modelos ajudará a filtrar quais modelos são compatíveis com o dispositivo Windows em que está sendo executado, para que o modelo correto seja baixado para o dispositivo.

Principais benefícios:

• Adicionar catálogos: adicionar um ou muitos catálogos online
• Descobrir modelos compatíveis: localize automaticamente modelos que funcionam com os provedores de hardware e execução do usuário
• Baixar modelos: baixar e armazenar modelos de várias fontes
• Compartilhar modelos entre aplicativos: se vários aplicativos usarem a mesma fonte de catálogo, os modelos serão compartilhados em disco sem duplicar downloads

• Correção de um problema no DeploymentManager que resultou no relatório incorreto de PackageInstallRequired em alguns casos.

Esta versão inclui as seguintes APIs experimentais novas e 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

    ChildSiteLink
        IsBelowContent

    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
    IContentSiteBridgeEndpointConnectionPrivate
    PopupAnchoringOptions
    PopupWindowSiteBridge
    ProcessStarter
    SystemVisualSiteBridge

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

    CatalogModelInfo
    CatalogModelInstance
    CatalogModelInstanceResult
    CatalogModelSource
    CatalogModelStatus
    WinMLModelCatalog

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

    ScreenRegionBoundingBox
    ScreenRegionDetectionContract
    ScreenRegionLabel