Notas de lançamento do SDK de Aplicações Windows 2.0

Foi adicionado suporte para a windows.diagnosticServiceModule extensão package-manifest. Aplicações .NET MSIX autónomas podem usar esta extensão para declarar módulos de diagnóstico, permitindo que o Windows Error Reporting os carregue e recolha crash dumps acionáveis.

Novas AppContentIndex APIs estão agora disponíveis como funcionalidade de acesso limitado (LAF) para aplicações que obtiveram um token LAF. Estas APIs permitem que as aplicações forneçam conteúdo de texto e imagem para indexação e consultem esse conteúdo usando correspondência lexical e, em dispositivos suportados com NPU, correspondência semântica. AppContentIndex suporta cenários de pesquisa semântica e de geração aumentada por recuperação (RAG). (RuntimeCompatibilityChange: AppContentSearchNewAPI_LafCheck)

• Foi corrigido um crash no tratamento de entradas de popup em janela quando um evento de foco ou ponteiro era processado depois de a ilha do popup ter sido eliminada. (RuntimeCompatibilityChange: PointerInputProcessor_ReleaseCaptureOnDisposedIsland)
• Corrigiu uma falha em NavigationView em que o redimensionamento do controlo podia produzir um painel MaxHeight negativo. (RuntimeCompatibilityChange: NavigationView_UpdatePaneLayoutNegativeMaxHeight)
• Corrigiu um problema em que o conjunto de propriedades devolvido por ElementCompositionPreview.GetPointerPositionPropertySet deixava de ser atualizado enquanto o ponteiro estava pressionado. (RuntimeCompatibilityChange: PointerPositionPropertySet_UpdateWhilePressed)
• Corrigiu uma falha em NavigationView quando o menu suspenso de um item expandido era apresentado após o item ter sido colapsado ou reciclado. (RuntimeCompatibilityChange: NavigationViewItem_DeferredFlyoutShowStaleState)
• Corrigida uma falha rápida quando um KeyboardAccelerator usava uma tecla OEM ou de pontuação, como uma vírgula, um ponto e vírgula ou um colchete, e apresentava o rótulo da tecla de atalho. (RuntimeCompatibilityChange: KeyboardAccelerator_OemKeyNoFailFast)
• Foi corrigido um encerramento fatal do processo que podia ocorrer durante o encerramento do XAML em aplicações que alojam o WinUI 3 em mais de um thread da interface do utilizador. (RuntimeCompatibilityChange: WindowsXamlManager_ActivationFactoryCacheResetRace)
• Corrigido um problema em que um CommandBar sem comandos secundários podia apresentar um botão de transbordo vazio em escalas de visualização fracionadas, como 175%. (RuntimeCompatibilityChange: CommandBar_SpuriousOverflowButtonAtFractionalScale)
• Corrigido um problema que impedia aplicações que usavam o System Composition Engine de chamar VisualInteractionSource.CreateFromIVisualElement. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Fixei gráficos de efeitos e SceneLighting renderização para aplicações usando o System Composition Engine. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Corrigido InputPointerSource.ActivationBehavior que não respeitava NoActivate ao utilizar o System Composition Engine. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Comportamento de seleção fixo CompositionEngine para entradas nulas e seleções no-op. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Corrigiu a personalização do cursor para entrada elevada ao usar o System Composition Engine. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Consultas fixas ICompositionObject em coleções de gradiente stop ao utilizar o System Composition Engine. (RuntimeCompatibilityChange: N/A, correção da composição do sistema operativo)
• Comportamento das bordas e dos fundos corrigido ContentExternalOutputLink ao usar o Motor de Composição do Sistema. (RuntimeCompatibilityChange: N/A, correção da composição do sistema operativo)
• Corrigido o acesso a VisualReferenceController ao usar o Motor de Composição do Sistema. (RuntimeCompatibilityChange: N/A, correção da composição do sistema operativo)
• Corrigido um problema de registo que pode ocorrer ao instalar o SDK de Aplicações Windows. (RuntimeCompatibilityChange: N/A, correção do registo de implementação)
• Corrigido um problema em que a Super-Resolução de Vídeo poderia falhar durante a inicialização ou inferência com a dependência atualizada do ONNX Runtime. (RuntimeCompatibilityChange: N/A, atualização de compatibilidade de dependências)

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

As aplicações WinUI 3 suportam agora háptica do touchpad e do rato do sistema operativo através de Windows.Devices.Haptics, juntamente com deslocamento com um dedo no touchpad, quando tal é suportado pelo sistema operativo e pelo hardware. (RuntimeCompatibilityChange: InputPointerSource_OSHaptics)

• Corrigiu um crash que podia ocorrer quando um toque ou contacto com a caneta deixava uma área deslocável com um timing preciso. (RuntimeCompatibilityChange: InputPointerSource_DepartingScrollInputCrashFix)
• Corrigido um problema em que os Storage Pickers (FileOpenPicker, FileSavePicker, e FolderPicker) deixavam a janela da aplicação WinUI chamada sem foco do teclado após o diálogo de ficheiro fechar. A aplicação recupera agora o foco anterior após o encerramento do diálogo. Para mais informações, consulte a edição #6505 do GitHub. (RuntimeCompatibilityChange: StoragePickers_RestoreFocusAfterDialogCloses)
• Corrigiu uma regressão em que MrmGetFilePathFromName devolvia ERROR_FILE_NOT_FOUND quando o ficheiro PRI não existia, em vez de devolver o caminho alternativo documentado. Para mais informações, consulte a edição #5940 do GitHub. (RuntimeCompatibilityChange: ResourceManager_RestoreDefaultFallbackPath)
• Foi corrigido um problema em que MICROSOFT_WINDOWSAPPRUNTIME_BASE_DIRECTORY podia ser herdado por processos subordinados, prejudicando o MRT Core e as pesquisas no catálogo. Para mais informações, consulte a edição #5987 do GitHub. (RuntimeCompatibilityChange: WindowsAppRuntime_BaseDirectoryIsolation)
• Corrigido um problema em que LanguageModel retornava um estado genérico Error para linguagens não suportadas ou linguagens de entrada e saída incompatíveis. Estas condições agora retornam LanguageModelResponseStatus.UnsupportedLanguage e LanguageModelResponseStatus.LanguageMismatch, respetivamente. (RuntimeCompatibilityChange: LanguageModel_LanguageDetectionStatus)
• Foi corrigida uma falha quando aplicações que usam o System Composition Engine invocavam VisualInteractionSource.TryRedirectForManipulation. (RuntimeCompatibilityChange: N/A, correção da ponte de composição do sistema operativo)
• Corrigido o modificador de acesso no assistente de entrada gerado em C# quando DISABLE_XAML_GENERATED_MAIN está definido. Para mais informações, consulte a edição #11245 do GitHub. (RuntimeCompatibilityChange: N/A, alteração nas ferramentas de build)

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

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

Foi adicionada a API XamlOptionalChanges , que permite às aplicações optar por alterações opcionais antes da inicialização do XAML. Para 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 definida, agora renomeia o método gerado main() (C#: XamlGeneratedProgram.XamlGeneratedMain(); C++/WinRT: wXamlGeneratedMain()) em vez de o remover completamente. Isto permite que um método personalizado main() invoque a implementação padrão.

Foi adicionada a API do CompositionEngine como uma Funcionalidade de Acesso Limitado (LAF) instável, que permite às aplicações optar por usar o sistema operativo como motor para as APIs de Composição. (RuntimeCompatibilityChange: CompositionEngine_API)

Corrigiu a deteção de NPUs, adicionou suporte para CPU e melhorou o desempenho da Super Resolução de Vídeo. (RuntimeCompatibilityChange: VideoSuperResolution_HardwareDetection)

• Enumeração fixa do fornecedor de execução em certos cenários. (RuntimeCompatibilityChange: WindowsML_ExecutionProviderEnumerationUpdate)
• Adicionado suporte para ARM64EC no Windows ML.

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

Algumas das otimizações abaixo são de adesão voluntária. Para os ativar, defina o XamlChangeId especificado conforme indicado em cada item.

• Adicionaram novos estilos otimizados XamlControlsResources , incluindo um modelo otimizado ScrollBar . Utilize o DefaultStyleOptimizations XamlChangeId para aderir a estes estilos. (RuntimeCompatibilityChange: Xaml_DefaultStyleOptimizations)
• FontIcon e BitmapIcon evitam inserir um Grid adicional na sua árvore visual para aplicações que optem pelo XamlChangeId IconNoGridOptimization. (RuntimeCompatibilityChange: Xaml_IconNoGridOptimization)
• Interrompido o carregamento de Style definidores de propriedades que não atribuem um valor. Utilize o OptimizeApplyStyles XamlChangeId para aderir. (RuntimeCompatibilityChange: Xaml_DeferStylePropertySetters)
• Atrasou-se a aplicação dos estilos FrameworkElement e Control até o elemento estar na árvore. Utilize o OptimizeApplyStyles XamlChangeId para aderir. (RuntimeCompatibilityChange: Xaml_DelayApplyStylesAfterCreationComplete)
• Inicialização otimizada CommandBar deixando de carregar todo o estado do Gestor de Estados Visuais. (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarInitialization)
• Melhoria do desempenho ao adicionar a CommandBarFlyout e PrimaryCommands de SecondaryCommands. (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarFlyoutUpdateCommands)
• Usei uma tabela de hash mais eficiente para ResourceDictionary. (RuntimeCompatibilityChange: Xaml_FasterResourceDictionary)
• Eliminou-se uma cópia e comparação da cadeia de caracteres da chave do recurso ao carregar recursos diferidos. (RuntimeCompatibilityChange: Xaml_LoadDeferredResourceOptimization)
• Melhor desempenho das ThemeResource consultas ao reduzir as comparações de cadeias. (RuntimeCompatibilityChange: Xaml_ThemeResourceUseResourceKeys)
• Melhoria do desempenho do processador durante a procura de recursos de tema XAML, ao reduzir a sobrecarga do cálculo de hash das chaves de recurso. (RuntimeCompatibilityChange: Xaml_ReduceThemeResourceLookupHashing)
• Desempenho melhorado do CPU para verificações internas comuns de tipos XAML em UIElement e FrameworkElement. (RuntimeCompatibilityChange: Xaml_CachedTypeChecks)
• Melhoria do desempenho do CPU nos caminhos internos de pesquisa de fábrica de ativação. (RuntimeCompatibilityChange: Xaml_ActivationFactoryFastPaths)
• Desempenho melhorado da decodificação de inteiros armazenados em ficheiros XBF. (RuntimeCompatibilityChange: Xaml_FasterXbfIntLoading)
• Redução das alocações de heap em caminhos de arranque e atravessamento de árvores ao reservar memória vetorial e otimizar um auxiliar RAII. (RuntimeCompatibilityChange: Xaml_ReserveVectorSpace)
• Desempenho melhorado ao reservar espaço nas coleções de rastreadores antes de adicionar vários itens. (RuntimeCompatibilityChange: Xaml_ReserveTrackerCollectionSpace)
• Associações otimizadas para associações de propriedades XamlUICommand. (RuntimeCompatibilityChange: XamlUICommand_LightweightBindings)
• Desempenho melhorado ao associar XamlUICommands que não definem atalhos de teclado. (RuntimeCompatibilityChange: XamlUICommand_SkipEmptyKeyboardAcceleratorBinding)
• Inicializar a propriedade TintLuminosityOpacity no markup para objetos AcrylicBrush de estilo predefinido, em vez de no código, evitando a instanciação forçada. (RuntimeCompatibilityChange: AcrylicBrush_InitializePropertyInMarkup)
• Evitou-se a inicialização por defeito desnecessária ContextFlyout em TextBlock e RichTextBlock ao entrarem ou saírem da árvore de elementos. Utilize o DeferContextFlyoutInit XamlChangeId para aderir. (RuntimeCompatibilityChange: Xaml_DeferContextFlyoutInit)
• Reduziu-se o tempo de espera no arranque devido à contenção de bloqueio do Direct3D ao registar o evento de remoção do dispositivo D3D do XAML durante a criação do dispositivo em segundo plano, em vez de o fazer mais tarde na thread da IU. (RuntimeCompatibilityChange: Xaml_EagerDeviceRemovedEventRegistration)
• Removido um registo redundante de notificações de energia de RefreshRateInfo, reduzindo a sobrecarga no arranque. (RuntimeCompatibilityChange: RefreshRateInfo_RemovePowerNotification)
• Removido uma dependência redundante version.dll do caminho de arranque do WinUI ao calcular a versão de runtime registada em tempo de compilação. (RuntimeCompatibilityChange: XamlInit_GetMuxVersionCompileTime)

• Foi corrigida uma falha de utilização após libertação em CPopupRoot::ReplayPointerUpdate quando um pop-up é fechado de forma síncrona durante a reprodução de eventos do ponteiro. (RuntimeCompatibilityChange: CPopupRoot_ReplayPointerUpdateCrash)
• Foi corrigida uma violação de acesso em CXamlIslandRoot::GetScreenOffset, provocada por consultas reentrantes de Automatização da Interface de Utilizador durante a desmontagem da XAML island. (RuntimeCompatibilityChange: XamlIslandRoot_UiaTeardownReentrancyCrash)
• Corrigiu um crash ModernCollectionBasePanel em que um contentor ou cabeçalho com rastreio na janela de visualização, reciclado por uma passagem de layout irmão, podia deixar uma âncora obsoleta que acionava um fail-fast na medida seguinte. (RuntimeCompatibilityChange: ModernCollectionBasePanel_StaleViewportAnchorRecycle)
• Corrigido um fail-fast em CPopup::RemoveChild quando um ToolTip fecho bombeava mensagens e reentrava no caminho de fecho. (RuntimeCompatibilityChange: Popup_RemoveChildIdempotentWhenClosing)
• Corrigida uma falha de reentrância em CXcpDispatcher quando o destrutor de Popup acionou UIADisconnectAllProviders com clientes ativos da Automatização da Interface de Utilizador. (RuntimeCompatibilityChange: UIAWindow_PauseNewDispatchOnDisconnectProviders)
• Foi corrigida uma falha quando um menu em cascata ou o temporizador de atraso na abertura AutoSuggestBox era acionado depois de a ilha ou o despachante proprietário já ter iniciado a desmontagem. (RuntimeCompatibilityChange: CascadingMenuHelper_DelayOpenTimerTickAfterUnload)
• Corrigida uma possível falha de utilização após libertação durante o descarregamento de DLLs, quando os ponteiros COM em tipos personalizados de metadados não eram devidamente libertados. (RuntimeCompatibilityChange: CustomMetadataTypes_InvalidateUseAfterFree)
• Corrigido um crash ao abrir a Popup a partir de um CompositionTarget.Rendering callback devido à reentrada do despachante durante as mudanças de foco. (RuntimeCompatibilityChange: CPopup_OpenSetFocusReentrancy)
• Corrigiu uma falha em MediaPlayerPresenter quando o dispositivo GPU é perdido durante o processamento de eventos de reprodução multimédia. (RuntimeCompatibilityChange: MediaPlayerPresenter_DeviceLostCrash)
• Foi corrigida uma potencial violação de acesso na renderização de texto no Direct2D quando ocorreu a recuperação após perda do dispositivo durante a criação da textura da sequência de glifos. (RuntimeCompatibilityChange: HWBuildGlyphRunTextures_DeviceGuardScope)
• Corrigida uma falha em CFocusRectManager::FindFocusRectHost quando o foco incide num controlo alojado em linha através de InlineUIContainer em RichTextBlock ou TextBlock. (RuntimeCompatibilityChange: FocusRectManager_FindFocusRectHostCrash)
• Corrigiu uma falha que podia fazer com que backgroundTaskHost.exe falhasse repetidamente quando uma tarefa em segundo plano não tinha um CLSID armazenado, e adicionou um tratamento adequado para quando CoCreateInstance falha. Para mais informações, consulte a edição #5870 do GitHub. (RuntimeCompatibilityChange: UniversalBGTask_RunCrash)
• Fixaram os flyouts com janelas e sem janela que aparecem desalinhados (cerca de uma altura de item acima do item principal) para colocações laterais quando abrem para cima, perto da parte inferior do ecrã. (RuntimeCompatibilityChange: Flyout_SidePlacementFlipUpAlignmentFix)
• Corrigiu uma falha (desreferenciação nula de LayoutState) em UniformGridLayout e FlowLayout que podia ocorrer quando uma alteração de coleção era acionada num ItemsRepeater que já não estava carregado. (RuntimeCompatibilityChange: UniformGridLayoutFlowLayout_OnItemsChangedNullLayoutStateCrash)
• Corrigiu ApplicationData.GetForUnpackaged().LocalSettings() a abertura de uma chave de registo no caminho errado (HKCU\SOFTWARE\publisher\product em vez de HKCU\SOFTWARE\Classes\Local Settings\Software\publisher\product), que é uma localização de roaming e não uma local da máquina. Para mais informações, consulte a edição #6559 do GitHub. (RuntimeCompatibilityChange: ApplicationData_GetForUnpackaged_LocalSettings)
• Corrigiu uma situação de corrida na gestão do estado das teclas modificadoras que podia provocar falhas nas aplicações durante entrada simultânea no thread da interface do utilizador. (RuntimeCompatibilityChange: WindowsServices_GetKeyboardModifiersStateRace)
• Corrigido um crash do AppxSvc que pode ocorrer durante a instalação, atualização ou desinstalação de pacotes. (RuntimeCompatibilityChange: N/A, correção de crash do service-host)

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 Microsoft.Windows.AI.Video.VideoScaler API oferece aprimoramento de vídeo em tempo real por meio de escalonamento avançado de IA, otimizado para fluxos com pessoas em conversa. Permite aos desenvolvedores fornecer visuais mais nítidos e claros em plataformas de conferência, streaming e edição, mesmo sob condições de rede adversas. A API suporta personalização de 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 capacidades para que as aplicações possam validar o suporte VSR em tempo de execução. Não é necessária inicialização explícita do Windows ML.

Uma nova API Microsoft.Windows.Storage.ApplicationData.GetForUnpackaged() oferece às aplicações não embaladas um ponto de entrada WinRT de primeira classe para dados de aplicação por utilizador/máquina, correspondendo à superfície anteriormente disponível apenas para aplicações empacotadas. Isto simplifica futuras migrações empacotado↔não empacotado e elimina a necessidade de soluções alternativas para a API do Registo.

Foram adicionadas sobrecargas do setter de valor sem boxing a XamlBindingHelper (SetPropertyFromThickness, SetPropertyFromCornerRadius, SetPropertyFromColor) e exposta a propriedade de dependência Setter.ValueProperty.

• Foi corrigida uma falha em RenderTargetBitmap quando o elemento de destino sai da árvore visual (por exemplo, uma janela contextual fecha-se) antes de PreCommit concluir. RenderAsync passa agora a devolver E_ABORT em vez de falhar. (RuntimeCompatibilityChange: RenderTargetBitmap_PreCommitCrashOnTreeLeave)
• Corrigida uma falha de uso após libertação em ScrollView, quando o controlo é destruído enquanto o disparo do temporizador para ocultar os indicadores ainda está pendente. Para mais informações, consulte GitHub edição #10514. (RuntimeCompatibilityChange: ScrollView_HideIndicatorsTimerUseAfterFree)
• Corrigida uma potencial falha em Microsoft.UI.Xaml.dll!DirectUI::DXamlCore::GetPeerPrivate causada pela tentativa de aceder a um objeto programado para ser libertado. (RuntimeCompatibilityChange: GetPeerPrivate_UseAfterFree)
• Corrigiu um problema em que Microsoft.UI.System.ThemeSettings podia fazer uma aplicação crashar se esta fosse destruída num thread em segundo plano (por exemplo, quando destruída pelo .NET coletor de lixo). (RuntimeCompatibilityChange: ThemeSettings_OffThreadDestructorFix)
• Corrigiu uma falha inesperada que podia ocorrer em determinados dispositivos quando pontos de contacto táteis ativos eram cancelados por um dispositivo de entrada, como quando a entrada por caneta se sobrepõe a esses contactos. (RuntimeCompatibilityChange: InputPointerSource_PointerCancelCrashFix)
• Corrigido um problema em que aplicações com pacotes dispersos não conseguiam descobrir ficheiros PRI específicos de cada módulo. Para mais informações, consulte GitHub edição #6375. (RuntimeCompatibilityChange: MRTCore_SparsePackagedPriFallback)
• Corrigido um bug de propriedade de cadeias ao usar a API do Flat-C Windows ML Catalog. (RuntimeCompatibilityChange: WindowsMLFlatCCatalog_CallbackStringOwnership)
• Corrigido um problema potencial no Windows ML durante o encerramento do processo. (RuntimeCompatibilityChange: WindowsML_ComRundownFix)
• Corrigidos possíveis problemas de inicialização e desmontagem do COM no Windows ML. (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 as partes que TitleBar.Content são arrastáveis e adiciona APIs que dão aos programadores controlo explícito sobre as regiões de arrasto. Veja a PR microsoft/microsoft-ui-xaml#10936 e a questão de acompanhamento #10421.

O que mudou

• Novo comportamento por defeito — A estrutura agora percorre recursivamente a árvore visual e exclui automaticamente apenas os controlos interativos da região de arrasto. Espaços vazios e elementos visuais não interativos podem ser arrastados por defeito, sem necessidade de alterações ao código de marcação.
• Novas APIs para controlo explícito:
  • TitleBar.IsDragRegion — booleano anulável anexado para assinalar um elemento como arrastável (True), clicável (False) ou definido pelo framework (não definido).
  • TitleBar.AutoRefreshDragRegions — quando True, as regiões de arrasto são atualizadas automaticamente com as atualizações do esquema.
  • TitleBar.RecomputeDragRegions() — recalcula manualmente as regiões de arrastar após alterações dinâmicas no conteúdo.

Porquê

As barras de título personalizadas misturam frequentemente controlos interativos com elementos visuais não interativos em esquemas Grid/StackPanel. A abordagem anterior de "furar a área de conteúdo completa" deixou lacunas inesperadas e não arrastáveis nos layouts, com espaço vazio, espaçamento irregular ou interface 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 e controlos interativos excluídos:

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

A API do Adaptador de Baixa Classificação (LoRA) para o Phi Silica passou a estável.

O LoRA permite aos programadores afinar finamente o modelo de linguagem Phi Silica no dispositivo com os 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 através de LanguageModelOptions.LowRankAdapter ao chamar GenerateResponseAsync. Veja Phi Silica LoRA para detalhes.

Uma nova API AICapabilities.HasAICapability permite que aplicações 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 ONNX Runtime para mais informações.

• Adicionou suporte para múltiplos fornecedores de execução dentro de um único pacote MSIX. (RuntimeCompatibilityChange: WindowsML_MultiEpPerPackage)
• Suporte adicional para descobrir fornecedores de execução fornecidos como pacotes de framework. (RuntimeCompatibilityChange: WindowsML_FrameworkEpEnumeration)
• Adicionou o modo de seleção do fornecedor de execução para configurações de implementação flexíveis. (RuntimeCompatibilityChange: WindowsML_EpSelectionMode)

• Corrigiu uma fuga de memória em ItemsRepeater onde elementos reciclados nunca foram recolhidos devido a um ciclo de referência através do RecyclePool, que também podia causar crashes em InvalidateChildrenMeasure. (RuntimeCompatibilityChange: ItemTemplateWrapper_RecyclePoolLeak)
• Corrigida uma falha em que um callback implícito de conclusão da animação de Mostrar/Ocultar podia aceder a CUIElement depois de este ter sido destruído, causando uma violação de acesso. O callback usa agora uma referência fraca para lidar com segurança o caso em que o elemento é destruído antes da animação terminar. (RuntimeCompatibilityChange: Animation_FixImplicitHideAnimationCrash)
• Corrigido um problema em que o conteúdo do pop-up em janela aberto numa ilha XAML não respeitava a configuração de OverrideScale, fazendo com que o conteúdo parecesse sobredimensionado e fosse recortado. Para mais informações, consulte GitHub edição #11000. (RuntimeCompatibilityChange: Popup_WindowedPopupOverrideScale)
• Corrigido um crash de falha rápida causado pelo despacho de reentrantes durante operações de lançamento COM entre apartamentos em UIAffinityReleaseQueue::DoCleanup. (RuntimeCompatibilityChange: UIAffinityReleaseQueue_PauseDispatchDuringCleanup)
• WinUI: Corrigido a consulta ambígua de módulos 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 por endereço. (RuntimeCompatibilityChange: GetModuleHandle_FixAmbiguousModuleLookup)
• Corrigida uma falha de divisão inteira por zero em UniformGridLayout::GetMajorSize quando um ItemsRepeater é apresentado numa largura disponível inferior ao passo secundário de um item. (RuntimeCompatibilityChange: UniformGridLayout_GetItemsPerLineDivideByZero)
• Corrigido um possível crash quando um pacote foi desinstalado antes de ser processado. (RuntimeCompatibilityChange: PackageManager_FixCrash)
• Corrigiu um problema em que GetReadyState podiam devolver códigos de erro incorretos (por exemplo, DisabledByUser ou NotSupportedOnCurrentSystem) quando os pacotes necessários ainda não tinham sido implementados. A API agora reporta NotReady corretamente neste cenário, melhorando a clareza diagnóstica. (RuntimeCompatibilityChange: ModelInitialization_GetReadyStateAvailabilityGuard)
• Diagnósticos internos de desempenho melhorados para LanguageModel.GenerateResponseAsync identificar melhor fontes de latência antes de o primeiro token ser devolvido. (RuntimeCompatibilityChange: LanguageModelInsights_GetPartialResultLatency)
• Corrigido um problema em que erros do compilador XAML eram silenciosamente perdidos ao usar dotnet build, aparecendo apenas MSB3073: exited with code 1 em vez das mensagens de erro reais. Para mais informações, consulte GitHub edição #9813. (RuntimeCompatibilityChange: N/A, alteração nas ferramentas do compilador XAML em tempo de compilação)
• Corrigido um problema em que o Microsoft.Windows.Workloads.dll não carregava em compilações Windows anteriores ao 22000 devido a importações estáticas de APIs de Dependências Dinâmicas indisponíveis nessas versões do SO. As funções são agora resolvidas dinamicamente, pelo que falhas em versões do sistema operativo não suportadas surgem como um diálogo normal HRESULT em vez de um diálogo de erro do carregador. (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 de Aplicações Windows 2.0 é a primeira versão do novo esquema de versionamento SDK de Aplicações 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 versionamento ao alinhar a versão do SDK de Aplicações Windows com a versão do pacote NuGet. Referenciar o SDK de Aplicações Windows 2.0 no seu projeto significa agora que irá usar a versão correspondente do NuGet, sem um número de compilação separado baseado em datas para acompanhar:

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

O nome da família do pacote também se alinha com a versão principal em vez da versão menor, pelo que a próxima versão lado a lado do SDK de Aplicações Windows será a versão 3.0.0. De acordo com o SemVer, mudanças disruptivas só são permitidas em atualizações de versões maiores (consulte SDK de Aplicações Windows deployment architecture).

O pacote NuGet Microsoft.WindowsAppSDK.ML foi refatorado, adicionando uma nova dependência base. A funcionalidade do pacote NuGet de ML existente mantém-se a mesma, mas as funcionalidades principais Windows ML foram refatoradas num pacote base chamado Microsoft.Windows.AI.MachineLearning. Este novo pacote contém um conjunto mínimo de dependências; suporta aplicações até ao Windows 10 v1903. Se precisares de suporte Windows 10 v1809, continua a usar o pacote existente Microsoft.WindowsAppSDK.ML.

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

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

• Secções de Instalação, Dados e Código Distribuível Reestruturadas para maior clareza.
• Uma nova secção de Aviso de Conformidade para Fornecedores de Execução (EP) esclarece as responsabilidades dos programadores relativamente aos fornecedores de execução acelerada por hardware.
• Ligações diretas para acordos de licença de fornecedores para NVIDIA TensorRT, Intel OpenVINO e Qualcomm QNN (Qualcomm Neural Network SDK).

• As APIs Phi Silica são agora aplicadas como parte de uma Funcionalidade de Acesso Limitado (LAF). Consulte Phi Silica para mais detalhes.
• Foram adicionados novos estados ao AIFeatureReadyState para ajudar as aplicações a explicar falhas temporárias e duradouras durante o processo de aquisição do modelo de IA: CapabilityMissing, NotCompatibleWithSystemHardware, e OSUpdateNeeded. As aplicações podem usar estes estados para dar aos utilizadores 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 do Windows Update durante a instalação de modelos de IA, sinalizando falhas duradouras para que os utilizadores possam compreender porque é que os pacotes de modelos falharam na instalação.
• Diagnóstico melhorado para APIs de Inteligência de Texto usadas em cenários de IA do Windows.

Ativado o suporte de arrastar para conteúdos WebView2 alojados em aplicações WinUI 3. Esta funcionalidade não era anteriormente suportada e está agora disponível sem a introdução de novas APIs públicas. (O acesso a um controlo WebView2 a partir de fontes externas já era suportado.)

Cenários suportados

• Conteúdo padrão para arrastar e largar. É suportado arrastar texto, HTML, imagens e URLs. Arrastar uma imagem para fora da aplicação resulta atualmente num nome de ficheiro predefinido (por exemplo, download.jpg) quando inserido no Explorador de Ficheiros.
• Cancelamento de arrasto. O cancelamento sob demanda de uma operação de arrasto ativo é suportado, pelo que uma aplicação pode bloquear condicionalmente operações de arrasto para conteúdos restritos ou efémeros após o arrasto ter sido iniciado.
• Visuais de arrasto personalizados. É suportada uma interface personalizada de arrastar, como ícones ou pré-visualizações, para ajudar os utilizadores a identificar claramente o conteúdo a ser arrastado.
• Dados de arrasto personalizáveis. É suportada a edição e personalização de dados de arrasto, permitindo cenários específicos da aplicação, como arrastar mensagens dentro da própria aplicação ou anexar metadados contextuais (por exemplo, "da aplicação <nome>") que o destino pode ler ao soltar.

Limitations:

• Alguns tipos adicionais de dados de arrasto não são atualmente suportados, incluindo DownloadURL.

Requisitos:

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

A API Microsoft.Windows.Storage.Pickers (introduzida em SDK de Aplicações Windows 1.8) foi alargada para simplificar a seleção de ficheiros e pastas, permitindo aos programadores definir as localizações iniciais e persistentes das pastas e agrupar filtros de tipos de ficheiros com rótulos claros para facilitar a navegação.

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

• Posicionamento relativo dos popups. A nova PopupAnchor API permite que DesktopPopupSiteBridge suporte posicionamento relativo ao ser ancorado à sua janela ou ilha proprietária, tratando a limitação em que os pop-ups só podiam ser posicionados absolutamente usando coordenadas de ecrã. Novas propriedades DesktopPopupSiteBridge.AnchoringBehavior e DesktopPopupSiteBridge.AnchoringPixelAlignment controlam o comportamento de ancoragem.
• O teclado dá indicações de orientação. A nova InputFocusController.ShouldShowKeyboardCues propriedade orienta os desenvolvedores sobre se devem mostrar as indicações do teclado logo após a criação de um ContentIsland.
• API de conveniência do PointerPoint. O novo PointerPoint.GetCurrentPoint método permite aos programadores obter os dados ativos PointerPoint de um pointerId.

O novo Microsoft.UI.Xaml.Controls.SystemBackdropElement é um FrameworkElement leve que permite às aplicações colocar um fundo de sistema como Mica ou Acrílico em qualquer lugar do layout XAML, com uma propriedade CornerRadius para áreas arredondadas de fundo. Elimina uma lacuna antiga do WinUI 3, onde os efeitos acrílicos na aplicação (anteriormente simples no WinUI 2 via AcrylicBrush.BackgroundSource) não tinham equivalente direto.

O namespace Microsoft.Windows.Management.Deployment adiciona uma framework de validação de pacotes e uma API PackageVolume para gerir os volumes de armazenamento onde os pacotes são estacionados.

• Validadores. Nova IPackageValidator interface mais três validadores incorporados (PackageCertificateEkuValidator, PackageFamilyNameValidator, PackageMinimumVersionValidator) que podem ser ligados AddPackageOptions / StagePackageOptions através da propriedade nova PackageValidators. PackageValidationEventArgs, PackageValidationEventSource, e PackageValidationHandler suportam eventos de validação; IsPackageValidationSupported e GetValidationEventSourceForUri permitem que os chamadores verifiquem o suporte antes de invocar a implementação.
• Volume do Pacote. Novo PackageVolume tipo com GetDefault, GetPackageVolumeByName, GetPackageVolumeByPath, AddAsync, RemoveAsync, GetAvailableSpaceAsync, IsOffline, SetDefault, SetOfflineAsync, SetOnlineAsync e IsFeatureSupported para deteção de capacidades em tempo de execução (PackageVolumeFeature).

A nova interface IXamlCondition permite que os programadores definam condições personalizadas que se integram com a sintaxe condicional do namespace do XAML e são avaliadas no momento da análise do XAML. Isto substitui a interface experimental IXamlPredicate . Condições personalizadas permitem cenários XAML condicionais baseados em fatores específicos da aplicação, como flags de funcionalidade, capacidades de dispositivos, lógica de negócio, definições de configuração e outras condições de execução.

• Corrigido um problema em que o instalador do WindowsAppSDK não mostrava progresso durante a instalação, fazendo parecer que estava parado. O instalador agora fornece um feedback de progresso mais claro.
• Melhor tratamento de erros para cenários onde WindowsAppSDKSelfContained está ativado para bibliotecas de classes.
• Corrigi os avisos de compilação MSB8027 e LNK4042 causados por itens duplicados ClCompile em ficheiros SDK de Aplicações Windows NuGet .targets ao mover definições de pré-processadores dos blocos <Target> para <ItemDefinitionGroup>. Está incluído um mecanismo de exclusão (WindowsAppSDK_Arm64EcCompilerWorkaround) para compilações ARM64EC+LTCG para evitar um erro conhecido do compilador interno MSVC.
• Corrigido um crash do ListView que podia ocorrer durante a navegação por teclado (Tab/Shift+Tab) após a atualização da lista de itens.
• Corrigido um problema em que o WinUI 3 podia bloquear se o foco fosse movido para o CoreWebView2Controller enquanto o controlador não estava visível.
• A fiabilidade foi melhorada DeleteIndex de modo que já não falhe ERROR_SHARING_VIOLATION em algumas situações (Pesquisa de Conteúdo da Aplicação; permanece no canal experimental).
• Corrigiu-se as caixas delimitadoras OCR que retornavam valores negativos em alguns casos limite.
• Corrigido um bug no Windows ML em que invocar RegisterCertifiedAsync novamente no mesmo processo retornava incorretamente 0 provedores de execução (EP).

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

Atualizar do 2.0 Experimental7. O pacote experimental Microsoft.WindowsAppSDK.ML foi lançado com um número de patch superior ao da estável 2.0.0, o que pode surgir como um erro de downgrade do NuGet (especialmente em projetos C++). Se estiveram no Experimental7, sigam o guia NuGet Uninstall para remover o pacote experimental antes de referenciar a versão 2.0.0.

• A Pesquisa de Conteúdos da App continua experimental. A superfície API Microsoft.Windows.Search.AppContentIndex (Pesquisa de Conteúdo da Aplicação) foi removida na versão 2.0-Preview2 para melhorar os fundamentos e garantir compatibilidade futura. Não está incluído na versão estável 2.0.1. Para experimentar com isso, continue a usar lançamentos experimentais. Se instalaste anteriormente o pacote experimental Microsoft.Windows.Search, desinstala-o através do guia NuGet Uninstall antes de passar para a versão 2.0.1 estável.
• As APIs já foram enviadas em serviço 1.8. Algumas funcionalidades experimentais que foram pré-visualizadas durante o ciclo 2.0 foram promovidas a APIs estáveis nas versões de serviço 1.8 e, por isso, não são novas na 2.0.1. Incluem ModelCatalog (1.8.3), TextRewriter.RewriteCustomAsync (1.8.4) e SplitMenuFlyoutItem plus SplitMenuFlyoutItemAutomationPeer (1.8.6). Consulte as notas de lançamento da versão 1.8 para mais detalhes.

• AICapabilities está ausente da versão 2.0.1. Microsoft.Windows.AI.AICapabilities e AICapabilityCategory.CopilotPlusPCCapable (um teste de capacidade Copilot+ PC) foram lançados na versão 1.8.7, mas não foram incluídos na 2.0.1. Planeamos 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 mantém-se a mesma, mas as funcionalidades principais do Windows ML foram refatoradas num pacote base dependente chamado Microsoft.Windows.AI.MachineLearning. Este novo pacote contém um conjunto mínimo de dependências, mas em C#/WinRT ou C++/WinRT só suporta até ao Windows 10 18362. Se precisar Windows 10 suporte 17763, use o pacote existente Microsoft.WindowsAppSDK.ML.

Para novas dependências transitivas, recomendamos a utilização de ferramentas para atualizar o pacote (nuget.exe ou VS). Ver também: notas de lançamento SDK de Aplicações Windows 1.6.

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

As APIs Phi Silica foram forçadas a serem parte de uma funcionalidade de acesso limitado.

Foram adicionadas verificações para vários erros de rede e do Windows Update durante a instalação de modelos de IA, sinalizando falhas duradouras para que os utilizadores possam compreender porque é que os pacotes de modelos falharam na instalação.

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

A Pesquisa de Conteúdos de Aplicações foi removida da pré-visualização 2.0 enquanto trabalhamos para melhorar os fundamentos e garantir compatibilidade futura à medida que os modelos de IA subjacentes mudam. Entretanto, por favor continue a usar o canal experimental para experimentar as últimas alterações.

Ativado o suporte de arrastar para conteúdos WebView2 alojados em aplicações WinUI 3. Esta funcionalidade não era anteriormente suportada e está agora disponível sem a introdução de novas APIs públicas. Nota: O acesso ao WebView2 a partir de fontes externas já é suportado.

Cenários suportados

• Conteúdo padrão de arrastar e largar É suportado arrastar texto, HTML, imagens e URLs. Com base no comportamento atual, arrastar imagens para fora da aplicação resulta num nome de ficheiro predefinido (por exemplo, download.jpg) quando inserido no Explorador de Ficheiros. Exemplo de cenário: Um utilizador seleciona texto ou imagem dentro do WebView2 e arrasta-o para dentro da aplicação ou para outro destino, como o Explorador de Ficheiros.

• Cancelamento de arrasto É suportado o cancelamento sob demanda de uma operação ativa de arrasto. Exemplo de cenário: Uma aplicação bloqueia condicionalmente operações de arrasto para certos tipos de conteúdo (como conteúdo restrito ou efémero) cancelando o arrasto após este ter sido iniciado.

• Visuais personalizados de arrasto É suportada uma interface personalizada de arrastar, como ícones ou pré-visualizações, para ajudar os utilizadores a identificar claramente o conteúdo a ser arrastado. Exemplo de cenário: Uma aplicação mostra uma pré-visualização ou ícone em miniatura enquanto o utilizador arrasta conteúdos multimédia, deixando claro qual o item que está a ser movido no momento.

• Dados de arrasto personalizáveis É suportada a edição e personalização dos dados de arrasto, permitindo cenários específicos da aplicação, como arrastar mensagens dentro da aplicação (por exemplo, como uma interação alternativa para o encaminhamento de mensagens). Exemplo de cenário: Uma aplicação personaliza a carga útil de arrastar para incluir metadados contextuais, como o nome da aplicação de origem. Quando o conteúdo é descartado, o destino pode mostrar ou processar informações como "De <nome da aplicação>" para indicar a origem do conteúdo arrastado.

Limitações

• O suporte para tipos adicionais de dados de arrasto é limitado. Os seguintes formatos não são atualmente suportados:
  • DownloadURL

Requisitos

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

A interface IXamlCondition permite aos programadores definir condições personalizadas que se integram com a sintaxe condicional do espaço de nomes do XAML e são avaliadas durante a análise de XAML. Isto é uma renomeação e graduação da interface experimental IXamlPredicate . Condições personalizadas permitem cenários XAML condicionais baseados em fatores específicos da aplicação, como flags de funcionalidade, capacidades de dispositivos, lógica de negócio, definições de configuração e outras condições de execução.

• Corrigidos os avisos de compilação MSB8027 e LNK4042 causados por itens duplicados do ClCompile em ficheiros .targets do SDK de Aplicações Windows NuGet ao mover as definições de pré-processadores dos blocos <Target> para <ItemDefinitionGroup>. Está incluído um mecanismo de exclusão (WindowsAppSDK_Arm64EcCompilerWorkaround) para compilações ARM64EC+LTCG para evitar um erro conhecido do compilador interno MSVC.
• Corrigido um crash do ListView que podia ocorrer durante a navegação por teclado (Tab/Shift+Tab) após a atualização da lista de itens.
• Corrigido um problema em que o WinUI 3 podia crashar 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 a 2.0-Preview1:

Microsoft.UI.Xaml.Markup

    IXamlCondition

• A versão do ONNX Runtime no Windows ML foi atualizada para 1.24 RC
• Corrigido um erro em que, se o RegisterCertifiedAsync for chamado novamente no mesmo processo, devolve incorretamente 0 fornecedores de execução (EP - Execution Provider)

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

• Fiabilidade melhorada DeleteIndex . Por vezes, DeleteIndex falhava com o erro ERROR_SHARING_VIOLATION.

• Correção para caixas delimitadoras de OCR que devolvem valores negativos em algumas situações extremas.

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

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

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

  • AppContentIndexer
    • ObterItensDeConteúdoNecessitamDeReindexação
    • Remover -> RemoverItemdeConteúdo
    • RemoverMúltiplos -> RemoverItensDeConteúdo
    • RemoverTodosOsItensDeConteúdo
    • ObterEstadoDaIndexaçãoDoConteúdo -> ObterEstadoDoItemDeConteúdo
    • ObterEstadoDaIndexaçãoDeMúltiplosConteúdos -> ObterEstadosDosItensDeConteúdo
    • GetContentItems
  • AppContentIndexListener
    • EstadoDeIndexaçãoAlterado -> EstadoDoItemDeConteúdoAlterado
  • AppIndexTextQuerySession
    • UpdateQuery -> UpdateQueryPhrase
    • MaisRecenteResultado -> ObterResultado
    • MaisRecenteResultadoMudado -> ResultadoMudado
  • AppIndexImageQuerySession
    • UpdateQuery -> UpdateQueryPhrase
    • MaisRecenteResultado -> ObterResultado
    • MaisRecenteResultadoMudado -> ResultadoMudado
  • AppManagedImageQueryMatch
    • Sub-região -> RegiãoDeInteresse
  • ResultadoDoEstadoDoItemDeConteúdo
    • StatusDeReindexação * EstadoDeReindexaçãoDeItemDeConteúdo
  • TextQuerySessionResult
    • IsValid
  • ImageQuerySessionResult
    • IsValid
  • QueryContentItemsFilterFlags

• Corrigido um problema em que o instalador do WindowsAppSDK não mostrava progresso durante a instalação, fazendo parecer que estava parado. O instalador agora fornece um feedback de progresso mais claro.
• Melhor tratamento de erros em cenários onde o WindowsAppSDKSelfContained está ativado para bibliotecas de classes.

Esta versão inclui as seguintes APIs experimentais novas e modificadas em comparação com a 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

• As novas APIs AIComputeDevice permitem que as aplicações selecionem o dispositivo de execução predefinido, CPU ou NPU ao criar um TextRecognizer. ContentRegionImageOptions.PreferredTextRecognizerDevice define a mesma preferência de dispositivo para o OCR efetuado durante a indexação de imagens do App Content Index.
• A IA Speech utiliza agora o SpeechRecognitionModelFactory e o SpeechRecognitionModelFactoryOptions para configurar e criar modelos de reconhecimento de voz. Os métodos de entrada de áudio agora aceitam buffers de amostras 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 fornecedor.
• LanguageModel.ModelName, LanguageModelVersion, e LanguageModelLowRankAdapterStatus permitem que as aplicações identifiquem o modelo de linguagem instalado e inspecionem o resultado de compatibilidade ao carregar um adaptador de rank baixo.
• LanguageModelResponseStatus.BlockedByGameMode e LanguageModelResponseStatus.LowOnVram identificam respostas que não conseguiram ser concluídas porque o modo de jogo estava ativo ou a memória de vídeo disponível estava baixa.

A nova API experimental FrameworkElement.SetThemeResourceBinding permite às aplicações criar o equivalente a uma {ThemeResource} binding a partir do código. (RuntimeCompatibilityChange: WinUI_SetThemeResourceBinding)

Um novo construtor experimental DataTemplate aceita um delegado fornecido pela aplicação que cria a subárvore de elementos do modelo. (RuntimeCompatibilityChange: WinUI_DataTemplateFromDelegate)

O controlo TableView experimental está agora disponível nos WinMDs públicos. Suporta agrupamento com cabeçalhos de grupo baseados em modelos, ordenação e filtragem com indicadores de ordenação nos cabeçalhos de coluna, redimensionamento de colunas com o rato e o teclado, e descrições opcionais para células e cabeçalhos de coluna. (RuntimeCompatibilityChange: TableView_TabularBinaryActivation)

Esta versão adiciona um controlo experimental de gráfico WinUI 3 Chart para apresentar dados cartesianos como séries de linhas, de área e de barras. O controlo suporta eixos configuráveis, legendas, rótulos de dados e marcadores de dados. (RuntimeCompatibilityChange: Charts_ExperimentalControlApi)

• Adicionaram o InkPresenter.ActivateCustomDrying e o InkSynchronizer, que permitiam às aplicações renderizar tinta comprometida por si próprias usando BeginDry e EndDry.
• Foi corrigida uma violação de acesso que podia ocorrer ao ler InkPresenter.StrokeContainer enquanto o modo de secagem personalizado estava ativo.
• Corrigido o dimensionamento do apresentador do InkCanvas num RenderTransform.
• Alinhei a API experimental do InkToolbar com o design revisto. A barra de ferramentas agora direciona diretamente um InkPresenter sem necessidade de um InkCanvas. (RuntimeCompatibilityChange: InkCanvas_InkingSupport)

• Corrigido um problema de rastreamento de recursos no WinUI que podia fazer com que o uso de memória crescesse quando as aplicações criavam repetidamente storyboards de estado visual ou resolviam recursos estáticos ou de tema. (RuntimeCompatibilityChange: WinUI_ResourceGraphExpiredDependencyPruning)
• Limpeza melhorada de objetos WinUI nativos inatingíveis em aplicações .NET após o desmantelamento de um separador ou de uma 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 para tinta-tinta para WinUI 3 através do InkCanvas, InkToolbar e InkPresenter, incluindo entrada com caneta e toque, suporte a prancheta, suporte a alto contraste, entrada por traços 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 dão às aplicações uma forma compatível com DPI de obter e definir o tamanho de uma janela em píxeis lógicos (da área de cliente), diretamente a partir do código ou da marcação, sem ter de recorrer a Window.AppWindow nem efetuar manualmente a conversão de DPI lógico para físico. As propriedades Companion Window.MinWidth, Window.MinHeight, Window.MaxWidth e Window.MaxHeight limitam o tamanho da janela. Agradecemos o seu feedback.

O SpeechAudioProvider experimental (utilizado para enviar áudio PCM mono de 16 kHz e 16 bits para o reconhecimento de voz) agora implementa IClosable, para que as aplicações possam libertar o fornecedor de forma determinística com Close/Dispose quando terminarem a transmissão de áudio.

As APIs experimentais do App Content Index acrescentam novas capacidades de indexação e melhorias significativas de fiabilidade e desempenho nesta versão:

• Indexação por lote mais rápida. Uma nova API AppContentIndexer.BatchAddOrUpdate permite que múltiplos itens sejam indexados em conjunto. O pipeline de indexação foi também redesenhado para suportar execução em estágios paralelos e processamento em lote mais eficiente.
• Tokenização multilíngue melhorada. O App Content Index utiliza agora um quebrador de palavras baseado em ICU, melhorando a correção da tokenização entre línguas enquanto elimina a dependência do WinRT WordsSegmenter.
• Melhoria na indexação e no desempenho das consultas. As atualizações de índice evitam agora reescritas lexicais desnecessárias, tornam o processamento de limpeza em lote mais eficiente e colocam em cache as capacidades do índice entre consultas, reduzindo substancialmente a sobrecarga nas operações comuns de consulta e indexação.
• Classificação lexical mais estável. A pontuação BM25 agora mantém estatísticas de comprimento dos documentos de forma independente, mantendo uma classificação consistente à medida que o conteúdo é atualizado ou removido incrementalmente.
• Recuperação automática de dados corrompidos. O Índice de Conteúdo da Aplicação deteta corrupção da base de dados e alterações incompatíveis no esquema ao abrir um índice e recupera automaticamente ao iniciar um reindex, em vez de deixar o índice inutilizável. GetOrCreateIndexStatus.RecoveredFromCorruption indica quando ocorreu a recuperação.
• Aumentos de ranking estáticos. As novas APIs permitem que as aplicações deem prioridade na classificação a itens de conteúdo individuais ou a regiões específicas, permitindo influenciar os resultados com base em sinais fornecidos pela aplicação. Use reforços estáticos quando a sua aplicação tiver conhecimento sobre a importância relativa do conteúdo que não é captado pelo próprio conteúdo, por exemplo, para ajudar a destacar um documento especialmente importante ou frequentemente procurado pelos seus utilizadores.
• Indexação de conteúdos de imagens. As aplicações podem agora indexar diretamente conteúdos bitmap ou fluxos de imagens, com opções que controlam a extração OCR e a indexação semântica do texto extraído. Utilize a indexação de imagens quando informação pesquisável significativa está contida numa imagem em vez de já disponível como texto, como capturas de ecrã, documentos digitalizados ou outro conteúdo visual.
• Controlo de indexação semântica para texto. Uma nova propriedade ContentRegionTextOptions.Alallow SemanticIndexing permite às aplicações optar por excluir regiões de texto individuais da indexação semântica. Isto é útil para textos que devam manter-se pesquisáveis lexicalmente, mas que dificilmente tirarão partido da correspondência semântica, dando às aplicações mais controlo sobre que conteúdos participam na 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 do modelo de linguagem funcionam agora em PCs sem Copilot+ equipados com uma GPU suportada, levando capacidades locais de modelos de linguagem a uma gama mais alargada de dispositivos Windows 11. O hardware suportado inclui NVIDIA GeForce RTX série 30 e versões mais recentes com 6+ GB de vRAM. A inferência de GPU requer que o Modo Desenvolvedor esteja ativado e uma compilação do Windows Insider Experimental Channel.

O modelo da GPU não está pré-instalado. É descarregado sob demanda via EnsureReadyAsync através de Windows Update. As aplicações devem verificar GetReadyState e mostrar um diálogo de consentimento antes de ativar o download. Os utilizadores podem gerir o modelo em Definições > Sistema > Componentes de IA.

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

As novas APIs de reconhecimento de fala no dispositivo em Microsoft.Windows.AI.Speech permitem a conversão de fala em texto tanto em lote como em fluxo. BatchRecognition reconhece uma fonte de áudio completa numa única chamada, e StreamingRecognition gera eventos Recognizing e Recognized. O áudio pode ser obtido a partir de um dispositivo (AudioConfiguration.FromAudioDevice), ficheiro (FromFile), fluxo de entrada (FromStream), ou enviado pelo chamador via SpeechAudioProvider (16 kHz, 16 bits, PCM de canal único). O modelo no dispositivo é gerido via SpeechRecognitionModel.EnsureReadyAsync / TryCreateAsync, sendo o progresso da transferência e do carregamento comunicado através de SpeechRecognitionModelProgress.

Um novo enum Microsoft.Windows.Workloads.NpuType expõe a classe NPU no dispositivo atual (por exemplo, Qnn, Lnl, Stx, Win365, Unknown, None), para que as aplicações e a infraestrutura de Workloads possam 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 no 2.0 Experimental 7) agora devolve um tipo dedicado GenerateStructuredJsonResponseResult com uma GenerateStructuredJsonResponseStatus propriedade, em vez do par genérico LanguageModelResponseResult / LanguageModelResponseStatus . O novo enum de estado é específico para geração com restrições de 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 desta divisão, o ResponseInvalidJson valor foi removido do enum estável LanguageModelResponseStatus (onde anteriormente tinha sido adicionado para suportar saída JSON estruturada). As aplicações que geriam ResponseInvalidJson a partir de LanguageModelResponseStatus devem transferir essa gestão para o novo GenerateStructuredJsonResponseStatus devolvido por GenerateStructuredJsonResponseAsync. Outros chamadores de LanguageModelResponseStatus já não precisam de ter em conta um valor de falha específico de 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 de Aplicações Windows 2.0.0-experimental7 introduz suporte experimental para CMake (em desenvolvimento ativo), permitindo aos programadores C++ consumir pacotes NuGet do SDK de Aplicações Windows de projetos baseados em CMake.

A integração com o CMake baseia-se no NuGetCMakePackage, um módulo CMake de código aberto que faz a ponte entre a gestão de pacotes do NuGet e o fluxo de trabalho nativo find_package() do CMake. O NuGetCMakePackage gera o download e a restauração de pacotes NuGet durante a configuração via add_nuget_packages(), sonda cada pacote em busca de uma configuração cmake incorporada em build/cmake/<package>-config.cmake, e expõe os cabeçalhos do pacote, bibliotecas de importação, DLLs em tempo de execução e metadados WinRT como alvos padrão do CMake.

Cada componente SDK de Aplicações Windows NuGet e pacote dependente incorpora agora um ficheiro de configuração CMake sob build/cmake/, que, com a ajuda da biblioteca NuGetCMakePackage, permite que o find_package() do CMake descubra automaticamente alvos, cabeçalhos, bibliotecas e DLLs em tempo de execução sem configuração manual de caminhos. Isto abrange todos os pacotes componentes, incluindo Foundation, InteractiveExperiences, DWrite, Widgets, AI, ML e WinUI, bem como dependências como Base e Runtime.

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

Esta funcionalidade é experimental e está a ser lançada antecipadamente para recolher feedback da comunidade. As convenções de nomenclatura alvo e os padrões de configuração estão sujeitos a alterações consoante a entrada do programador. Como este é um voo antecipado, envolve alguma cerimónia e configuração – por favor, consulte as aplicações de exemplo CMake que ilustram a configuração e utilização de ponta a ponta em todos os quatro cenários de implementação (SelfContained|FrameworkDependent x Packaged|Unpackaged).

Gostaríamos de ouvir a sua opinião! Se se deparar com um cenário que ainda não está coberto, tiver sugestões para melhorar a experiência dos programadores ou tiver problemas, por favor envie o seu feedback no separador Issues no repositório open-source SDK de Aplicações Windows ou inicie uma conversa em Discussões. A sua contribuição irá moldar diretamente o desenvolvimento ativo desta funcionalidade.

Esta versão experimental integra as alterações e correções incluídas nas versões 2.0-Preview1 e 2.0-Preview2. Os itens apresentados são resumidos abaixo; consulte as notas de lançamento da versão prévia para mais detalhes.

A partir do 2.0-Preview1:

• Windows ML: Correção para RegisterCertifiedAsync devolver 0 fornecedores de execução quando chamada novamente no mesmo processo.
• Microsoft.UI.Content: Nova propriedade InputFocusController.ShouldShowKeyboardCues e nova API conveniente PointerPoint.GetCurrentPoint.
• Microsoft.Windows.Management.Deployment: Novas APIs PackageVolume para paridade+ com Windows.Management.Deployment (incluindo AddAsync, GetDefault, GetAvailableSpaceAsync, IsAppxInstallSupported, IsOffline, IsFeatureSupported, entre outras). Novo IPackageValidator ponto de extensibilidade em AddPackageOptions e StagePackageOptions, com três validadores incorporados: PackageCertificateEkuValidator, PackageFamilyNameValidator, e PackageMinimumVersionValidator.
• Microsoft.Windows.Storage.Pickers:
  • Novas Title propriedades em FileOpenPicker, FileSavePicker e FolderPicker, que permitem títulos de diálogo personalizados.
  • Novas propriedades em SettingsIdentifier, FileOpenPicker e FileSavePicker, permitindo um estado específico da instância do seletor ao longo das sessões.
  • Novas InitialFileTypeIndex propriedades em FileOpenPicker e FileSavePicker, permitindo aos programadores definir o filtro de tipo de ficheiro selecionado por defeito por índice (baseado em 0).
  • Nova ShowOverwritePrompt propriedade em FileSavePicker. Por predefinição, true controla se o seletor avisa sobre sobrescrever quando o utilizador seleciona um ficheiro existente através de FileSavePicker.
  • Alterado o comportamento padrão de FileSavePicker: a partir do WindowsAppSDK 2.0, o FileSavePicker NÃO criará um ficheiro vazio quando o utilizador escolhe um ficheiro inexistente, permitindo que os programadores decidam quando criar o ficheiro.
  • Novo PickMultipleFoldersAsync método em FolderPicker, permitindo a seleção de várias pastas numa única operação.
• Correções de bugs: Relatórios de progresso do instalador; Melhor gestão de erros para WindowsAppSDKSelfContained bibliotecas de classes.

De 2.0 a Pré-visualização2:

• Windows APIs de IA: As APIs Phi Silica são aplicadas como uma Funcionalidade de Acesso Limitado; os novos valores AIFeatureReadyState revelam problemas de aquisição de modelos, como capacidades em falta, hardware incompatível e atualizações necessárias do sistema operativo; falhas persistentes de instalação de rede/Windows Update são agora sinalizadas; melhorando o diagnóstico para APIs de Inteligência de Texto.
• Condicionais XAML Personalizados: IXamlCondition gradua e renomeia a interface experimental IXamlPredicate , permitindo condições personalizadas avaliadas em tempo de análise XAML.
• WebView2 (WinUI 3): Suporte a arrastar para conteúdos alojados no WebView2 (texto, HTML, imagens, URLs), cancelamento de arrasto, visuais personalizados de arrastar e dados de arrasto personalizáveis. Requer o Runtime WebView2 144.0.3719.11 ou superior. (DownloadURL Ainda não suportado.)
• Correções de bugs: avisos de compilação MSB8027/LNK4042 provenientes de itens ClCompile duplicados em ficheiros .targets (com uma solução alternativa WindowsAppSDK_Arm64EcCompilerWorkaround para ARM64EC+LTCG); Falha do ListView durante a navegação por teclado após atualizações da lista de itens; WinUI 3 entra em falha quando o foco move-se para um CoreWebView2Controller invisível.

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

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

• Novas AppContentIndexer.GetExistingIndexes e AppContentIndexer.IsContentKindSupported APIs.
• Novo AppManagedOcrTextQueryMatch tipo e QueryMatchContentKind.AppManagedOcrText valor para suportar a consulta ao conteúdo da aplicação através de texto derivado do OCR.
• Novo GetOrCreateIndexOptions.CreateAlways para forçar a criação de um novo índice.
• Novo ContentItemErrorDetail.InsufficientDiskSpace para destacar 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 a 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

O Windows ML pode agora ser usado a partir de projetos C++ usando CMake. Consulte a página Comece para saber mais.

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

• NPUPowerMode foi descontinuado em favor de APIs de gestão de energia mais recentes.
• GetReadyState Agora retorna NotSupported de forma elegante quando o corretor de sessões não está disponível, em vez de lançar uma exceção.

• Adicionado suporte ao formato de saída NV12 para Video Super Resolution.

• Fiabilidade melhorada DeleteIndex . Por vezes, DeleteIndex falhava com o erro ERROR_SHARING_VIOLATION.

• Correção para caixas delimitadoras de OCR que devolvem valores negativos em algumas situações extremas.

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

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

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

  • AppContentIndexer
    • ObterItensDeConteúdoNecessitamDeReindexação
    • Remover -> RemoverItemdeConteúdo
    • RemoverMúltiplos -> RemoverItensDeConteúdo
    • RemoverTodosOsItensDeConteúdo
    • ObterEstadoDaIndexaçãoDoConteúdo -> ObterEstadoDoItemDeConteúdo
    • ObterEstadoDaIndexaçãoDeMúltiplosConteúdos -> ObterEstadosDosItensDeConteúdo
    • GetContentItems
  • AppCOntentIndexListener
    • EstadoDeIndexaçãoAlterado -> EstadoDoItemDeConteúdoAlterado
  • AppIndexTextQuerySession
    • UpdateQuery -> UpdateQueryPhrase
    • MaisRecenteResultado -> ObterResultado
    • MaisRecenteResultadoMudado -> ResultadoMudado
  • AppIndexImageQuerySession
    • UpdateQuery -> UpdateQueryPhrase
    • MaisRecenteResultado -> ObterResultado
    • MaisRecenteResultadoMudado -> ResultadoMudado
  • AppManagedImageQueryMatch
    • Sub-região -> RegiãoDeInteresse
  • ResultadoDoEstadoDoItemDeConteúdo
    • StatusDeReindexação * EstadoDeReindexaçãoDeItemDeConteúdo
  • TextQuerySessionResult
    • IsValid
  • ImageQuerySessionResult
    • IsValid
  • QueryContentItemsFilterFlags

• Corrigiu a falha de ImageDescription.DescribeAsync com InternalError devido a uma condição de corrida.

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

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetContentItems
        GetContentItemStatus
        GetContentItemStatuses
        RemoveAllContentItems
        RemoveContentItem
        RemoveContentItems

    AppContentIndexListener
        ContentItemStatusChanged

    AppManagedImageQueryMatch
    ContentItemErrorDetail
        IndexCorruption

    ContentItemReindexingStatus
        Unspecified

    QueryContentItemsFilterFlags

• Acordo de licença simplificado com termos mais claros para ISVs que constroem aplicações com Windows ML.
• Reestruturaram secções que abrangem Instalação, Dados e Código Distribuível com maior clareza.
• A secção de Aviso de Conformidade para Novos Fornecedores de Execução (EP) esclarece as responsabilidades dos programadores relativamente aos fornecedores de execução acelerada por hardware.
• Ligações diretas para acordos de licença de fornecedores para NVIDIA TensorRT, Intel OpenVINO e Qualcomm QNN (Qualcomm Neural Network SDK).

• As versões experimentais do Windows ML alinham-se com a versão principal 1.24 do ONNX Runtime para melhorar a compatibilidade e estabilidade.
• Os fornecedores de execução da Stable Application Binary Interface (ABI) são exigidos para garantir um comportamento previsível entre dispositivos, com os fornecedores de execução não-estáveis excluídos do processo de aquisição.
  • Apenas o fornecedor de execução OpenVINO é suportado, com fornecedores adicionais de execução a serem adicionados ao longo do tempo à medida que cumpram os requisitos de estabilidade.
• O tamanho de Microsoft,Windows.AI.MachineLearning.dll foi reduzido em aproximadamente 160 KB.

• Novas APIs experimentais para consultar estatísticas de itens indexados. Isto dá visibilidade sobre o que está a acontecer no índice.
• Suporte para cancelamento de consultas para permitir que as aplicações executem uma consulta e a atualizem caso haja uma nova consulta antes da atual ser concluída. Isto permite responder mais rapidamente à consulta à medida que o utilizador escreve a string da consulta.
• Suporte para correspondência de prefixos para fragmentos curtos para melhorar os resultados à medida que o utilizador escreve.

• O VideoScaler é agora descartável, melhorando a gestão de recursos e o controlo do ciclo de vida.
• O modelo VSR é agora compilado e armazenado em cache para melhorar o desempenho e reduzir custos de inicialização repetidos.
• Foi adicionada uma verificação de capacidade para validar o suporte VSR antes da utilização.
• A inicialização explícita do WinML já não é necessária ao usar a Super Resolução de Vídeo.

• O controlo FlowLayout agora utiliza os termos ItemSpacing e LineSpacing em vez das propriedades de espaçamento horizontal e vertical. A nomenclatura alinhada melhora a clareza e a consistência com padrões de layout modernos em diversos frameworks de interface de usuário.

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

• Implementei a IXamlPredicate interface para definir predicados personalizados que se integram perfeitamente com a sintaxe do namespace condicional de XAML e são avaliados em tempo de análise XAML.
• Predicados personalizados permitem cenários XAML condicionais baseados em fatores específicos da aplicação, tais como:
  • Marcadores de funcionalidade
  • Capacidades do dispositivo
  • Lógica de negócio
  • Definições de configuração
  • Outras condições de funcionamento

• Pacotes atualizados para permitir a usabilidade externa, o que inclui alterações a:
  • Microsoft.UI.DCPP.Dependencies.Minimal
  • Microsoft.UI.DCPP.Dependencies.Edge
  • ExpPointerPointStatics
• Adicionado suporte de compilação para Visual Studio 2026
• Introduziu ferramentas e scripts para uso por programadores externos para construir e testar o WinUI.

• [desvalorizado] DependencyObject.Dispatcher
• [desvalorizado] Window.Current
• [obsoleto] FocusManager.GetFocusedElement
• [renomeado] SystemBackdropHost para SystemBackdropElement

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

• Corrigiram-se erros de "Classe não registada" ao usar implantação autónoma com o Windows ML. Os programadores que usam implementação autónoma já não precisam de registar todas as classes ativáveis do pacote Foundation que eram usadas internamente.
• Corrigido um possível crash que ocorria no desligamento do processo ao usar Windows ML.
• Corrigi o ImageForegroundExtractor caminho de encaminhamento da API para que as chamadas cheguem ao endpoint correto.
• Garantiu-se que o progresso de instalação e download do provedor de execução seja corretamente transmitido para os aplicativos durante a implantação do pacote.
• Corrigido um crash em SystemBackdrop quando o alvo se desconecta, protegendo caminhos de desconexão inválidos.
• Corrigiu um problema que impedia que as APIs de IA do Windows estivessem disponíveis para algumas aplicações.

Esta versão inclui as seguintes APIs experimentais novas e modificadas em comparação com a 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 no tempo de execução do ONNX faz com que a super-resolução de vídeo falhe nos dispositivos Qualcomm. Uma atualização pendente do fornecedor de execução NPU da Qualcomm resolve este problema.

O novo controlo experimental SplitMenuFlyoutItem foi projetado para proporcionar uma experiência de botão dividido num menu desdobrável. 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 funcionalidades complexas em um espaço menor e economizar o comprimento total do menu.

Junto 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 do 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

• O nome de WinMLCatalogModel foi mudado para ModelCatalog
• O nome de CatalogModelSource foi mudado 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

• Recuperar 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 do CatalogModelInfo

• O nome de Alias foi mudado para Name
• O nome de Revision foi mudado para Version
• Adicionado Publisher
• Removido DisplayName

Alterações JSON

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

Alterações adicionais

• ModelCatalog agora retorna uma lista de Provedores de Execução (EPs) quando uma instância é criada.
• Adicionei suporte para Windows 10 (1809) e superiores.
• Adicionado suporte para arquivos locais, incluindo arquivos regulares e pacotes MSIX.
• Corrigidas 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 namespace que anteriormente retornavam matrizes agora retornam AppContentIndex para melhorar a consistência e o IVectorView desempenho.

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

A VideoScaler API oferece aprimoramento de vídeo em tempo real por meio de escalonamento avançado de IA, otimizado para fluxos com pessoas em conversa. Permite aos desenvolvedores fornecer visuais mais nítidos e claros em plataformas de conferência, streaming e edição, mesmo sob condições de rede adversas. A API suporta personalização de 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 fornecer uma cadeia de caracteres de entrada que orienta Phi Silica na reescrita do texto selecionado. Você pode experimentar novos estilos criativos como "Divertido" ou "Pirata" para transformar instantaneamente o seu conteúdo.

A ImageGenerator classe aproveita os modelos de difusão estável para fornecer recursos poderosos de geração de imagens. Suporta cenários de geração múltipla:

• Conversão de texto em imagem: Gere imagens a partir de prompts de texto descritivos.

• Imagem para imagem: Transforme imagens existentes com base em descrições de texto.

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

• Estilo do livro de colorir: Gere imagens no estilo de livro para colorir.

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

Todas as imagens geradas são retornadas no formato RGB8 através de objetos ImageBuffer . A API inclui filtros de segurança de conteúdo integrados e suporta 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 a 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

• Cálculo de caixa delimitadora fixa quando o texto é girado. Em algumas circunstâncias, a correspondência de texto OCR dentro das imagens relatou limites de região imprecisos ou vazios quando o texto foi girado.

As APIs do AppContentIndexer permitem que os desenvolvedores indexem com eficiência o conteúdo do aplicativo, incluindo texto e imagens para recuperação rápida e relevante. Suportando pesquisas lexicais (baseadas em palavras-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.

Esse recurso 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 palavras-chave.
  Exemplo: Uma consulta por "cronograma do projeto" pode revelar conteúdo que mencione "cronograma" ou "datas de entrega", mesmo que essas palavras não tenham sido usadas.
• Geração Aumentada por Recuperação (RAG)
  O conteúdo indexado pode servir como uma base de conhecimento para modelos generativos de IA. Quando um usuário faz uma pergunta, o aplicativo recupera os documentos ou trechos mais relevantes de seu índice e os alimenta no modelo, permitindo respostas precisas e sensíveis ao contexto baseadas em dados reais.

As APIs do Catálogo de Modelos ML do Windows permitem que a sua aplicação ou biblioteca descubra e descarregue dinamicamente grandes ficheiros de modelos de IA a partir dos seus próprios catálogos de modelos online, eliminando a necessidade de empacotar estes ficheiros grandes diretamente com a sua aplicação ou biblioteca. O catálogo de modelos ajuda a garantir a compatibilidade dos dispositivos, filtrando os modelos e descarregando apenas aqueles aplicáveis ao dispositivo Windows específico em uso.

A atualização mais recente Microsoft.Windows.Storage.Pickers simplifica a seleção de ficheiros e pastas, permitindo aos programadores definir as localizações iniciais e persistentes das pastas, e agrupando filtros de tipos de ficheiro com rótulos claros para facilitar a navegação.

A PopupAnchor API agora permite DesktopPopupSiteBridge suportar o posicionamento relativo ao ancorar na sua própria janela ou ilha, abordando a limitação em que as janelas pop-up só podiam ser posicionadas absolutamente usando coordenadas de ecrã.

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

SystemBackdropHost Permite colocar um pano de fundo do sistema (acrílico/MICA) em qualquer lugar dentro da árvore visual de um aplicativo.

O WrapPanel é um painel de layout WinUI XAML que organiza elementos filhos em uma posição sequencial da esquerda para a direita. Os itens que transbordam a linha serão passados para a próxima linha automaticamente no final do painel que os contém. É útil para layouts responsivos.

Esta é uma adaptação do controlo existente Windows Community Toolkit.

Esta versão inclui as seguintes APIs experimentais novas e modificadas em comparação com a 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 a partir de um thread em segundo plano. Usá-lo no thread da interface do usuário pode travar ou causar longas pausas que afetam a experiência do usuário.
• Resultados da consulta usando AppIndexQuery.GetNextTextMatches e AppIndexQuery.GetNextImageMatches serão nulos quando não houver correspondências, em vez de uma lista vazia.
• As correspondências de imagem utilizando AppManagedImageQueryMatch.Subregion com base em valores de OCR podem ocasionalmente ser imprecisas, particularmente quando o texto está rodado ou inclinado.
• A correspondência de imagens usando AppManagedImageQueryMatch.Subregion pode às vezes 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 a sua aplicação ou biblioteca descarregue dinamicamente grandes ficheiros de modelos de IA a partir dos seus próprios catálogos de modelos online sem enviar esses ficheiros grandes diretamente para a sua aplicação ou biblioteca. Além disso, o catálogo de modelos ajuda a filtrar quais os modelos compatíveis com o dispositivo Windows em que está a correr, para que o modelo correto seja descarregado para o dispositivo.

Principais benefícios:

• Adicionar catálogos: adicione um ou vários catálogos online
• Descubra modelos compatíveis: encontre automaticamente modelos que funcionam com os fornecedores de hardware e execução do utilizador
• Download de modelos: Baixe e armazene 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

• Corrigido um problema no DeploymentManager que resultava 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