informacje o wersji Zestaw SDK do aplikacji systemu Windows 2.0

Dodano obsługę windows.diagnosticServiceModule rozszerzenia package-manifest. Samodzielne aplikacje .NET w pakiecie MSIX mogą używać tego rozszerzenia do deklarowania modułów diagnostycznych, umożliwiając funkcji Raportowanie błędów systemu Windows ich ładowanie i zbieranie zrzutów awaryjnych przydatnych do analizy.

Nowe AppContentIndex interfejsy API są już dostępne w ramach funkcji o ograniczonym dostępie (LAF) dla aplikacji, które uzyskały token LAF. Te interfejsy API umożliwiają aplikacjom udostępnianie zawartości tekstu i obrazu na potrzeby indeksowania i wykonywania zapytań dotyczących tej zawartości przy użyciu dopasowywania leksyktycznego i, na obsługiwanych urządzeniach z obsługą jednostek NPU, dopasowywanie semantyczne. AppContentIndex obsługuje scenariusze wyszukiwania semantycznego i generowania wspomaganego wyszukiwaniem (RAG). (RuntimeCompatibilityChange: AppContentSearchNewAPI_LafCheck)

• Naprawiono awarię obsługi danych wejściowych okien wyskakujących okien, gdy zdarzenie fokusu lub wskaźnika zostało przetworzone po usunięciu wyspy wyskakujących okienek. (RuntimeCompatibilityChange: PointerInputProcessor_ReleaseCaptureOnDisposedIsland)
• Naprawiono awarię w NavigationView, która mogła wystąpić, gdy zmiana rozmiaru kontrolki powodowała utworzenie ujemnego panelu MaxHeight. (RuntimeCompatibilityChange: NavigationView_UpdatePaneLayoutNegativeMaxHeight)
• Rozwiązano problem, w wyniku którego zestaw właściwości zwracany przez ElementCompositionPreview.GetPointerPositionPropertySet przestawał się aktualizować, gdy wskaźnik był naciśnięty. (RuntimeCompatibilityChange: Aktualizacja zestawu właściwości pozycji wskaźnika podczas naciśnięcia)
• Naprawiono awarię w NavigationView, która występowała, gdy po zwinięciu elementu lub jego ponownym wykorzystaniu było wyświetlane menu wysuwane rozwiniętego elementu. (RuntimeCompatibilityChange: NavigationViewItem_DeferredFlyoutShowStaleState)
• Naprawiono błąd powodujący natychmiastowe zakończenie działania, gdy element KeyboardAccelerator używał klawisza OEM lub klawisza interpunkcyjnego, takiego jak przecinek, średnik lub nawias, i wyświetlana była etykieta skrótu klawiszowego. (RuntimeCompatibilityChange: KeyboardAccelerator_OemKeyNoFailFast)
• Naprawiono problem powodujący awaryjne zakończenie procesu, który mógł wystąpić podczas zamykania środowiska XAML w aplikacjach hostujących WinUI 3 w więcej niż jednym wątku interfejsu użytkownika. (RuntimeCompatibilityChange: WindowsXamlManager_ActivationFactoryCacheResetRace)
• Rozwiązano problem polegający na tym, że obiekt CommandBar bez dodatkowych poleceń mógł wyświetlać pusty przycisk przepełnienia na ułamkowych skalach wyświetlania, takich jak 175%. (RuntimeCompatibilityChange: CommandBar_SpuriousOverflowButtonAtFractionalScale)
• Naprawiono problem, który uniemożliwiał aplikacjom korzystającym z System Composition Engine wywoływanie elementu VisualInteractionSource.CreateFromIVisualElement. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Naprawiono grafy efektów i renderowanie SceneLighting w aplikacjach korzystających z aparatu kompozycji systemu. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Naprawiono problem, przez który InputPointerSource.ActivationBehavior nie uwzględniał NoActivate podczas korzystania z silnika kompozycji systemu. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Naprawiono CompositionEngine zachowanie wyboru dla danych wejściowych o wartości null i wyborów no-op. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Naprawiono dostosowywanie kursora dla uniesionego wejścia podczas korzystania z silnika kompozycji systemu. (RuntimeCompatibilityChange: CompositionEngine_SwitcherSeptemberFixes)
• Naprawiono ICompositionObject zapytania dotyczące kolekcji punktów zatrzymania gradientu podczas korzystania z silnika kompozycji systemu. (RuntimeCompatibilityChange: N/A, poprawka kompozycji systemu operacyjnego)
• Naprawiono działanie obramowania i tła ContentExternalOutputLink podczas korzystania z silnika kompozycji systemu. (RuntimeCompatibilityChange: N/A, poprawka kompozycji systemu operacyjnego)
• Naprawiono dostęp do VisualReferenceController podczas korzystania z mechanizmu System Composition Engine. (RuntimeCompatibilityChange: N/A, poprawka kompozycji systemu operacyjnego)
• Rozwiązano problem z rejestracją, który mógł wystąpić podczas instalowania Zestaw SDK do aplikacji systemu Windows. (RuntimeCompatibilityChange: N/A, poprawka rejestracji wdrożenia)
• Rozwiązano problem, przez który funkcja Video Super Resolution mogła nie działać podczas inicjalizacji lub inferencji po zaktualizowaniu zależności ONNX Runtime. (RuntimeCompatibilityChange: N/A, aktualizacja zgodności zależności)

Ta wersja zawiera następujące nowe interfejsy API w porównaniu z wersją 2.4.0:

Microsoft.Windows.Search.AppContentIndex

    AppIndexContentRegion
        CreateFromBitmap
        CreateFromImageStream

    AppManagedIndexableAppContent
        CreateFromBitmap
        CreateFromImageStream

    ContentRegionImageOptions

    ContentRegionTextOptions
        AllowSemanticIndexing

    ImageOcrIndexingOptions

Aplikacje WinUI 3 obsługują teraz haptykę gładzika i myszy za pośrednictwem Windows.Devices.Haptics, a także przewijanie jednym palcem na gładziku, jeśli są one obsługiwane przez system operacyjny i sprzęt. (RuntimeCompatibilityChange: InputPointerSource_OSHaptics)

• Naprawiono błąd, który mógł powodować awarię, gdy dotknięcie ekranu lub użycie pióra opuszczało obszar przewijania w określonym momencie. (RuntimeCompatibilityChange: InputPointerSource_DepartingScrollInputCrashFix)
• Rozwiązano problem, przez który selektory magazynu danych (FileOpenPicker, FileSavePicker i FolderPicker) powodowały, że po zamknięciu okna dialogowego wyboru pliku okno wywołującej aplikacji WinUI nie odzyskiwało fokusu klawiatury. Aplikacja przywraca teraz poprzedni fokus po zamknięciu okna dialogowego. Aby uzyskać więcej informacji, zobacz GitHub problem #6505. (RuntimeCompatibilityChange: StoragePickers_RestoreFocusAfterDialogCloses)
• Naprawiono regresję, w której MrmGetFilePathFromName zwracano ERROR_FILE_NOT_FOUND , gdy plik PRI nie istniał, zamiast zwracać udokumentowaną ścieżkę rezerwową. Aby uzyskać więcej informacji, zobacz GitHub problem #5940. (RuntimeCompatibilityChange: ResourceManager_RestoreDefaultFallbackPath)
• Rozwiązano problem, przez który element MICROSOFT_WINDOWSAPPRUNTIME_BASE_DIRECTORY mógł być dziedziczony przez procesy podrzędne, co zakłócało wyszukiwanie w MRT Core i katalogu. Aby uzyskać więcej informacji, zobacz GitHub problem #5987. (RuntimeCompatibilityChange: WindowsAppRuntime_BaseDirectoryIsolation)
• Rozwiązano problem, w wyniku którego Error zwracał ogólny status LanguageModel w przypadku nieobsługiwanych języków lub gdy języki wejściowy i wyjściowy nie były zgodne. Te warunki zwracają teraz odpowiednio LanguageModelResponseStatus.UnsupportedLanguage i LanguageModelResponseStatus.LanguageMismatch. (RuntimeCompatibilityChange: LanguageModel_LanguageDetectionStatus)
• Naprawiono awarię występującą, gdy aplikacje używające silnika kompozycji systemu wywoływały VisualInteractionSource.TryRedirectForManipulation. (RuntimeCompatibilityChange: N/A, poprawka mostka kompozycji systemu operacyjnego)
• Naprawiono modyfikator dostępu w pomocniku wygenerowanego punktu wejścia w języku C#, jeśli zdefiniowano DISABLE_XAML_GENERATED_MAIN. Aby uzyskać więcej informacji, zobacz GitHub problem nr 11245. (RuntimeCompatibilityChange: N/A, zmiana narzędzi w czasie kompilacji)

Ta wersja zawiera następujące nowe interfejsy API w porównaniu z wersją 2.3.1:

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        LanguageMismatch
        UnsupportedLanguage

Dodano interfejs API danych wyjściowych JSON ze strukturą (Microsoft.Windows.AI.Text.LanguageModel.GenerateStructuredJsonResponseAsync), który generuje odpowiedzi modelu językowego ograniczone do schematu JSON dostarczonego przez obiekt wywołujący. (RuntimeCompatibilityChange: LanguageModel_StructuredJsonOutput)

Dodano interfejs API XamlOptionalChanges, który umożliwia aplikacjom włączenie opcjonalnych zmian wprowadzających niezgodność przed inicjalizacją XAML. Aby uzyskać więcej informacji, zobacz pull request w serwisie GitHub microsoft/microsoft-ui-xaml#11110. (RuntimeCompatibilityChange: XamlSettings_OptionalChangesApi)

Zmieniono działanie stałej preprocesora DISABLE_XAML_GENERATED_MAIN w taki sposób, że po jej zdefiniowaniu powoduje ona teraz zmianę nazwy wygenerowanej metody main() (C#: XamlGeneratedProgram.XamlGeneratedMain(); C++/WinRT: wXamlGeneratedMain()), zamiast całkowicie ją usuwać. Dzięki temu metoda niestandardowa main() wywołuje domyślną implementację.

Dodano interfejs API CompositionEngine jako niestabilną funkcję ograniczonego dostępu (LAF), która umożliwia aplikacjom korzystanie z systemu operacyjnego jako aparatu interfejsów API kompozycji. (RuntimeCompatibilityChange: CompositionEngine_API)

Naprawiono wykrywanie jednostek NPU, dodano obsługę procesora CPU i zwiększono wydajność funkcji Video Super Resolution. (RuntimeCompatibilityChange: VideoSuperResolution_HardwareDetection)

• Naprawiono enumerację dostawców wykonania w niektórych scenariuszach. (RuntimeCompatibilityChange: WindowsML_ExecutionProviderEnumerationUpdate)
• Dodano obsługę ARM64EC dla usługi Windows ML.

Dodano dokumentację funkcji IntelliSense dla stabilnych interfejsów API w pakiecie Microsoft.WindowsAppSDK.AI NuGet.

Kilka z poniższych optymalizacji wymaga włączenia. Aby je włączyć, ustaw wskazaną wartość XamlChangeId zgodnie z informacją przy każdym elemencie.

• Dodano nowe, zoptymalizowane style XamlControlsResources, w tym zoptymalizowany szablon ScrollBar. Użyj identyfikatora DefaultStyleOptimizations XamlChangeId, aby wyrazić zgodę na te style. (RuntimeCompatibilityChange: Xaml_DefaultStyleOptimizations)
• FontIcon i BitmapIcon nie wstawiają dodatkowego elementu Grid do swojego drzewa wizualnego w aplikacjach, które włączają tę funkcję za pomocą identyfikatora XamlChangeId IconNoGridOptimization. (RuntimeCompatibilityChange: Xaml_IconNoGridOptimization)
• Zatrzymano ładowanie Style zestawów właściwości, które nie stosują wartości. Użyj identyfikatora OptimizeApplyStyles XamlChangeId, aby wyrazić zgodę. (RuntimeCompatibilityChange: Xaml_DeferStylePropertySetters)
• Opóźniono zastosowanie stylów FrameworkElement i Control, dopóki element nie znajdzie się w drzewie. Użyj identyfikatora OptimizeApplyStyles XamlChangeId, aby wyrazić zgodę. (RuntimeCompatibilityChange: Xaml_DelayApplyStylesAfterCreationComplete)
• Zoptymalizowano inicjalizację CommandBar, rezygnując z ładowania całego stanu Menedżera Stanów Wizualnych. (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarInitialization)
• Poprawiono wydajność dodawania do CommandBarFlyout i PrimaryCommands w SecondaryCommands. (RuntimeCompatibilityChange: Xaml_OptimizedCommandBarFlyoutUpdateCommands)
• Użyliśmy bardziej wydajnej tabeli skrótów dla elementu ResourceDictionary. (RuntimeCompatibilityChange: Xaml_FasterResourceDictionary)
• Wyeliminowano, w ramach optymalizacji, kopiowanie i porównywanie ciągu znaków klucza zasobu podczas ładowania odroczonych zasobów. (RuntimeCompatibilityChange: Xaml_LoadDeferredResourceOptimization)
• Poprawiono wydajność ThemeResource wyszukiwań poprzez ograniczenie liczby porównań ciągów. (RuntimeCompatibilityChange: Xaml_ThemeResourceUseResourceKeys)
• Zwiększona wydajność procesora CPU podczas wyszukiwania zasobów motywu XAML dzięki zmniejszeniu nakładu pracy związanego z tworzeniem skrótów kluczy zasobów. (RuntimeCompatibilityChange: Xaml_ReduceThemeResourceLookupHashing)
• Poprawiono wydajność procesora podczas typowych wewnętrznych sprawdzań typów XAML dla UIElement i FrameworkElement. (RuntimeCompatibilityChange: Xaml_CachedTypeChecks)
• Poprawiono wydajność procesora we wewnętrznych ścieżkach wyszukiwania fabryki aktywacji. (RuntimeCompatibilityChange: Xaml_ActivationFactoryFastPaths)
• Zwiększona wydajność dekodowania liczb całkowitych przechowywanych w plikach XBF. (RuntimeCompatibilityChange: Xaml_FasterXbfIntLoading)
• Zmniejszono liczbę alokacji na stercie podczas uruchamiania i przechodzenia drzewa dzięki wstępnej rezerwacji pamięci dla wektorów oraz optymalizacji pomocniczego mechanizmu RAII. (RuntimeCompatibilityChange: Xaml_ReserveVectorSpace)
• Zwiększona wydajność dzięki zarezerwowaniu miejsca w kolekcjach trackerów przed dołączeniem wielu elementów. (RuntimeCompatibilityChange: Xaml_ReserveTrackerCollectionSpace)
• Zoptymalizowane powiązania dla XamlUICommand powiązań właściwości. (RuntimeCompatibilityChange: XamlUICommand_LightweightBindings)
• Zwiększona wydajność, gdy powiązania XamlUICommandnie definiują akceleratorów klawiatury. (RuntimeCompatibilityChange: XamlUICommand_SkipEmptyKeyboardAcceleratorBinding)
• Zainicjowano właściwość TintLuminosityOpacity w znacznikach dla obiektów AcrylicBrush o stylu domyślnym, a nie w kodzie, co pozwoliło uniknąć wymuszonego tworzenia. (RuntimeCompatibilityChange: AcrylicBrush_InitializePropertyInMarkup)
• Uniknięto niepotrzebnej domyślnej inicjalizacji ContextFlyout w TextBlock i RichTextBlock podczas wchodzenia do drzewa elementów lub opuszczania go. Użyj identyfikatora DeferContextFlyoutInit XamlChangeId, aby wyrazić zgodę. (RuntimeCompatibilityChange: Xaml_DeferContextFlyoutInit)
• Skrócono czas oczekiwania podczas uruchamiania spowodowany konkurencją o blokadę Direct3D dzięki zarejestrowaniu w XAML zdarzenia informującego o usunięciu urządzenia D3D podczas tworzenia urządzenia w tle, zamiast robić to później w wątku interfejsu użytkownika. (RuntimeCompatibilityChange: Xaml_EagerDeviceRemovedEventRegistration)
• Usunięto nadmiarową rejestrację powiadomień związanych z zasilaniem z RefreshRateInfo, zmniejszając narzut podczas uruchamiania. (RuntimeCompatibilityChange: RefreshRateInfo_RemovePowerNotification)
• Usunięto zbędną zależność version.dll z sekwencji uruchamiania WinUI przez obliczenie rejestrowanej wersji środowiska uruchomieniowego w czasie kompilacji. (RuntimeCompatibilityChange: XamlInit_GetMuxVersionCompileTime)

• Naprawiono awarię typu use-after-free w CPopupRoot::ReplayPointerUpdate, gdy wyskakujące okno jest zamykane synchronicznie podczas ponownego odtwarzania zdarzeń wskaźnika. (RuntimeCompatibilityChange: CPopupRoot_ReplayPointerUpdateCrash)
• Naprawiono naruszenie ochrony pamięci w CXamlIslandRoot::GetScreenOffset, wywoływane przez reentrantne zapytania automatyzacja interfejsu użytkownika podczas demontażu wyspy XAML. (RuntimeCompatibilityChange: XamlIslandRoot_UiaTeardownReentrancyCrash)
• Naprawiono awarię w ModernCollectionBasePanel, w której kontener lub nagłówek śledzony względem obszaru widoku, poddany recyklingowi przez przebieg układu elementu równorzędnego, mógł pozostawić przestarzały punkt zakotwiczenia, który wywoływał mechanizm fail-fast podczas następnego pomiaru. (RuntimeCompatibilityChange: ModernCollectionBasePanel_StaleViewportAnchorRecycle)
• Naprawiono błąd CPopup::RemoveChildToolTip podczas zamykania pompowanych komunikatów i ponownie wprowadzono ścieżkę zamknięcia. (RuntimeCompatibilityChange: Popup_RemoveChildIdempotentWhenClosing)
• Naprawiono awarię spowodowaną ponownym wejściem w CXcpDispatcher, gdy destruktor Popup wywoływał UIADisconnectAllProviders przy aktywnych klientach automatyzacja interfejsu użytkownika. (RuntimeCompatibilityChange: UIAWindow_PauseNewDispatchOnDisconnectProviders)
• Naprawiono awarię występującą, gdy menu kaskadowe lub licznik opóźnionego otwarcia AutoSuggestBox uruchamiał się po rozpoczęciu demontażu powiązanej wyspy lub dyspozytora. (RuntimeCompatibilityChange: CascadingMenuHelper_DelayOpenTimerTickAfterUnload)
• Naprawiono potencjalną awarię spowodowaną odwołaniem do już zwolnionej pamięci podczas wyładowywania biblioteki DLL, gdy wskaźniki COM w niestandardowych typach metadanych nie zostały poprawnie zwolnione. (RuntimeCompatibilityChange: CustomMetadataTypes_InvalidateUseAfterFree)
• Naprawiono awarię występującą podczas otwierania Popup z poziomu wywołania zwrotnego CompositionTarget.Rendering z powodu ponownego wejścia dyspozytora podczas zmiany fokusu. (RuntimeCompatibilityChange: CPopup_OpenSetFocusReentrancy)
• Naprawiono awarię w MediaPlayerPresenter, gdy podczas obsługi zdarzeń związanych z odtwarzaniem multimediów utracono urządzenie GPU. (RuntimeCompatibilityChange: MediaPlayerPresenter_DeviceLostCrash)
• Naprawiono potencjalne naruszenie dostępu do pamięci podczas renderowania tekstu w Direct2D, gdy odzyskiwanie po utracie urządzenia wystąpiło w trakcie tworzenia tekstury dla ciągu glifów. (RuntimeCompatibilityChange: HWBuildGlyphRunTextures_DeviceGuardScope)
• Naprawiono awarię w CFocusRectManager::FindFocusRectHost, gdy fokus trafił na kontrolkę osadzoną śródwierszowo za pośrednictwem InlineUIContainer w RichTextBlock lub TextBlock. (RuntimeCompatibilityChange: FocusRectManager_FindFocusRectHostCrash)
• Naprawiono usterkę, która mogła powodować wielokrotne awarie backgroundTaskHost.exe, gdy zadanie w tle nie miało zapisanego identyfikatora CLSID, oraz dodano odpowiednią obsługę sytuacji, gdy CoCreateInstance kończy się niepowodzeniem. Aby uzyskać więcej informacji, zobacz GitHub problem #5870. (RuntimeCompatibilityChange: UniversalBGTask_RunCrash)
• Naprawiono problem z nieprawidłowym wyrównaniem okienkowych i nieokienkowych wysuwanych menu (o około jedną wysokość elementu powyżej elementu nadrzędnego) przy położeniu z boku, gdy otwierają się ku górze w pobliżu dolnej krawędzi ekranu. (RuntimeCompatibilityChange: Flyout_SidePlacementFlipUpAlignmentFix)
• Naprawiono awarię spowodowaną odwołaniem do wartości null (LayoutState) w UniformGridLayout i FlowLayout, która mogła wystąpić, gdy zgłoszono zmianę w kolekcji dla obiektu ItemsRepeater, który nie był już załadowany. (RuntimeCompatibilityChange: UniformGridLayoutFlowLayout_OnItemsChangedNullLayoutStateCrash)
• Naprawiono ApplicationData.GetForUnpackaged().LocalSettings() problem z otwieraniem klucza rejestru pod niewłaściwą ścieżką (HKCU\SOFTWARE\publisher\product zamiast HKCU\SOFTWARE\Classes\Local Settings\Software\publisher\product), która jest lokalizacją mobilną, a nie lokalną dla komputera. Aby uzyskać więcej informacji, zobacz GitHub problem #6559. (RuntimeCompatibilityChange: ApplicationData_GetForUnpackaged_LocalSettings)
• Naprawiono warunek wyścigu w obsłudze stanu modyfikatora klawiatury, który może spowodować awarię aplikacji w ramach współbieżnych danych wejściowych wątku interfejsu użytkownika. (RuntimeCompatibilityChange: WindowsServices_GetKeyboardModifiersStateRace)
• Naprawiono awarię appxSvc, która może wystąpić podczas instalowania, aktualizowania lub odinstalowywania pakietu. (RuntimeCompatibilityChange: N/A, poprawka awarii hosta usługi)

Ta wersja zawiera następujące nowe interfejsy API w porównaniu z wersją 2.2.0:

Microsoft.UI.Composition

    CompositionEngine
    CompositionEngineType

Microsoft.UI.Xaml.Settings

    XamlChangeId
    XamlOptionalChanges

Microsoft.Windows.AI.Text

    GenerateStructuredJsonResponseResult
    GenerateStructuredJsonResponseStatus
    LanguageModel
        GenerateStructuredJsonResponseAsync

Interfejs Microsoft.Windows.AI.Video.VideoScaler API zapewnia ulepszenia wideo w czasie rzeczywistym dzięki zaawansowanej skalowaniu sztucznej inteligencji zoptymalizowanej pod kątem strumieni z udziałem osób w konwersacji. Dzięki temu deweloperzy mogą udostępniać ostrzejsze, jaśniejsze wizualizacje na platformach konferencji, przesyłania strumieniowego i edytowania, nawet w przypadku słabych warunków sieciowych. Interfejs API obsługuje dostosowywanie rozdzielczości danych wyjściowych, szybkości klatek i regionów zainteresowania, zgodność z wieloma formatami wideo, w tym BGR, RGB i NV12.

VideoScaler jest tymczasowy i zawiera mechanizm sprawdzania możliwości, dzięki czemu aplikacje mogą weryfikować obsługę VSR w czasie działania. Jawne inicjowanie Windows ML nie jest wymagane.

Nowy interfejs API Microsoft.Windows.Storage.ApplicationData.GetForUnpackaged() udostępnia aplikacjom niepakietowanym pełnoprawny punkt wejścia WinRT do danych aplikacji na użytkownika i na komputer, odpowiadający zakresowi funkcji, który wcześniej był dostępny tylko dla aplikacji pakietowanych. Upraszcza to przyszłą migrację między wersją spakowaną a niespakowaną oraz eliminuje konieczność stosowania obejść interfejsu Registry API.

Dodano przeciążenia metody ustawiającej wartość bez boksowania dla XamlBindingHelper (SetPropertyFromThickness, SetPropertyFromCornerRadius, SetPropertyFromColor) oraz udostępniono właściwość zależności Setter.ValueProperty.

• Naprawiono awarię w RenderTargetBitmap, gdy element docelowy opuści drzewo wizualne (na przykład zamknie się wyskakujące okno), zanim zakończy się PreCommit. RenderAsync teraz zwraca E_ABORT zamiast powodować awarię. (RuntimeCompatibilityChange: RenderTargetBitmap_PreCommitCrashOnTreeLeave)
• Naprawiono awarię typu use-after-free w ScrollView przypadku zniszczenia kontrolki, podczas gdy jego znacznik czasomierza ukryj wskaźniki jest nadal oczekujący. Aby uzyskać więcej informacji, zobacz GitHub problem #10514. (RuntimeCompatibilityChange: ScrollView_HideIndicatorsTimerUseAfterFree)
• Naprawiono potencjalną awarię w Microsoft.UI.Xaml.dll!DirectUI::DXamlCore::GetPeerPrivate, spowodowaną próbą uzyskania dostępu do obiektu przeznaczonego do zwolnienia. (RuntimeCompatibilityChange: GetPeerPrivate_UseAfterFree)
• Rozwiązano problem polegający na tym, że Microsoft.UI.System.ThemeSettings mogła spowodować awarię aplikacji, jeśli została ona zniszczona w wątku w tle (na przykład w przypadku zniszczenia przez moduł odśmiecający pamięci .NET). (RuntimeCompatibilityChange: ThemeSettings_OffThreadDestructorFix)
• Naprawiono awarię, która mogła wystąpić na niektórych urządzeniach, gdy aktywne punkty dotyku zostały anulowane przez urządzenie wejściowe, na przykład gdy wprowadzanie piórem miało nad nimi priorytet. (ZmianaZgodnościCzasuWykonania: NaprawaBłęduAnulowaniaWskaźnikaWejściowego)
• Rozwiązano problem, przez który aplikacje w pakietach rozproszonych nie mogły odnajdywać plików PRI właściwych dla danego modułu. Aby uzyskać więcej informacji, zobacz GitHub problem #6375. (RuntimeCompatibilityChange: MRTCore_SparsePackagedPriFallback)
• Naprawiono błąd związany z własnością ciągu znaków podczas korzystania z interfejsu API katalogu Windows ML Flat-C. (RuntimeCompatibilityChange: WindowsMLFlatCCatalog_CallbackStringOwnership)
• Rozwiązano potencjalny problem w usłudze Windows ML podczas zamykania procesu. (RuntimeCompatibilityChange: WindowsML_ComRundownFix)
• Naprawiono potencjalne problemy z inicjalizacją i zamykaniem COM w Windows ML. (RuntimeCompatibilityChange: WindowsML_ComInitializationFix)

Ta wersja zawiera następujące nowe interfejsy API w porównaniu z wersją 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

Usprawnia sposób, w jaki TitleBar określa, które części TitleBar.Content można przeciągać, oraz dodaje interfejsy API, które dają deweloperom bezpośrednią kontrolę nad obszarami przeciągania. Zobacz PR microsoft/microsoft-ui-xaml#10936 i zgłoszenie śledzące #10421.

Co się zmieniło

• Nowe domyślne zachowanie — Framework rekurencyjnie przechodzi przez drzewo wizualne i automatycznie wyklucza tylko interaktywne kontrolki z obszaru przeciągania. Puste luki i wizualizacje nieinterakcyjne są domyślnie przeciągane bez konieczności wprowadzania zmian znaczników.
• Nowe interfejsy API dla jawnej kontroli:
  • TitleBar.IsDragRegion — dołączona wartość logiczna dopuszczająca wartość null, służąca do oznaczenia elementu jako możliwego do przeciągania (True), klikalnego (False) lub określanego przez framework (nieustawione).
  • TitleBar.AutoRefreshDragRegions — gdy True, obszary przeciągania odświeżają się automatycznie przy aktualizacjach układu.
  • TitleBar.RecomputeDragRegions() — ręczne ponowne obliczanie regionów przeciągania po zmianie zawartości dynamicznej.

Dlaczego

Niestandardowe paski tytułu często łączą interaktywne kontrolki z nieinteraktywnymi elementami wizualnymi w układach Grid/StackPanel. Poprzednie podejście polegające na „wycinaniu otworów w całym obszarze zawartości” pozostawiało nieoczekiwane obszary, których nie można było przeciągać w układach z pustą przestrzenią, nierównymi odstępami lub dynamicznym interfejsem użytkownika.

Porównanie wizualne

Domyślne (poprzednie) zachowanie — luki, których nie można przeciągać:

Pustego środkowego obszaru nie można przeciągać.

Bieżące (nowe) zachowanie — luki można przeciągać, interaktywne elementy sterujące wyłączone:

Puste miejsce można przeciągać; kontrolki interakcyjne są poprawnie wykluczone. (RuntimeCompatibilityChange: Obszary przeciągania zawartości paska tytułu)

Interfejs API adaptera Low-Rank (LoRA) dla Phi Silica uzyskał status stabilnej wersji.

Usługa LoRA umożliwia deweloperom dostosowanie modelu języka Phi Silica na urządzeniu przy użyciu własnych niestandardowych danych, dostosowanie danych wyjściowych do określonych scenariuszy, takich jak finanse, opieka medyczna i edukacja. Załaduj adapter za pomocą LanguageModelLowRankAdapter.CreateFromPath i przekaż go przez LanguageModelOptions.LowRankAdapter podczas wywołania GenerateResponseAsync. Aby uzyskać szczegółowe informacje, zobacz Phi Silica LoRA .

Nowy interfejs API AICapabilities.HasAICapability umożliwia aplikacjom innych firm określenie, czy urządzenie jest Copilot+ PC.

Wersja środowiska uruchomieniowego ONNX została zaktualizowana do wersji 1.24.6. Aby uzyskać więcej informacji, zobacz wersje środowiska uruchomieniowego ONNX .

• Dodano obsługę wielu dostawców wykonywania obliczeń w ramach jednego pakietu MSIX. (RuntimeCompatibilityChange: WindowsML_MultiEpPerPackage)
• Dodano obsługę wykrywania dostawców wykonania dostarczanych jako pakiety platformy. (RuntimeCompatibilityChange: WindowsML_FrameworkEpEnumeration)
• Dodano tryb wyboru dostawcy wykonywania dla elastycznych konfiguracji wdrażania. (RuntimeCompatibilityChange: WindowsML_EpSelectionMode)

• Naprawiono wyciek pamięci w ItemsRepeater, w którym elementy poddane recyklingowi nigdy nie były usuwane przez mechanizm odśmiecania pamięci z powodu cyklu referencji przez RecyclePool, co mogło również powodować awarie w InvalidateChildrenMeasure. (RuntimeCompatibilityChange: ItemTemplateWrapper_RecyclePoolLeak)
• Naprawiono awarię polegającą na tym, że niejawne wywołanie zwrotne pokazywania/ukrywania animacji mogło uzyskać dostęp do zniszczonego CUIElementelementu powodującego naruszenie dostępu. Funkcja zwrotna używa teraz słabego odwołania, aby bezpiecznie obsłużyć sytuację, w której element zostanie zniszczony przed zakończeniem animacji. (Zmiana zgodności środowiska uruchomieniowego: Animation_FixImplicitHideAnimationCrash)
• Rozwiązano problem polegający na tym, że zawartość okna podręcznego otwarta na wyspie XAML nie uwzględniała wartości OverrideScale, co powodowało, że zawartość pojawiała się powiększona i obcięta. Aby uzyskać więcej informacji, zobacz GitHub problem #11000. (Zmiana zgodności środowiska uruchomieniowego: Popup_WindowedPopupOverrideScale)
• Naprawiono awarię typu "fail-fast" spowodowaną ponownym wejściem podczas operacji zwalniania COM w różnych apartamentach w UIAffinityReleaseQueue::DoCleanup. (RuntimeCompatibilityChange: UIAffinityReleaseQueue_PauseDispatchDuringCleanup)
• WinUI: poprawiono niejednoznaczne wyszukiwanie modułów, gdy wiele modułów o tej samej nazwie jest ładowanych w tym samym procesie. GetModuleHandleW został zastąpiony elementem GetModuleHandleExW , więc poprawny moduł jest rozpoznawany przez adres. (RuntimeCompatibilityChange: GetModuleHandle_FixAmbiguousModuleLookup)
• Naprawiono awarię spowodowaną dzieleniem całkowitym przez zero w elemencie UniformGridLayout::GetMajorSize, gdy element ItemsRepeater jest układany w dostępnej szerokości mniejszej niż pomocniczy odstęp jednego elementu. (RuntimeCompatibilityChange: UniformGridLayout_GetItemsPerLineDivideByZero)
• Naprawiono potencjalną awarię, gdy pakiet został odinstalowany przed przetworzeniem. (RuntimeCompatibilityChange: PackageManager_FixCrash)
• Rozwiązano problem polegający na tym, że GetReadyState mógł zwracać nieprawidłowe kody błędów (na przykład DisabledByUser lub NotSupportedOnCurrentSystem), gdy wymagane pakiety nie były jeszcze wdrożone. Interfejs API teraz poprawnie raportuje NotReady w tym scenariuszu, zwiększając przejrzystość diagnostyki. (RuntimeCompatibilityChange: ModelInitialization_GetReadyStateAvailabilityGuard)
• Ulepszono wewnętrzną diagnostykę wydajności, LanguageModel.GenerateResponseAsync aby lepiej zidentyfikować źródła opóźnienia przed zwróceniem pierwszego tokenu. (RuntimeCompatibilityChange: LanguageModelInsights_GetPartialResultLatency)
• Rozwiązano problem polegający na tym, że błędy kompilatora XAML zostały utracone w trybie dyskretnym w przypadku używania polecenia dotnet build, pokazującego tylko MSB3073: exited with code 1 zamiast rzeczywistych komunikatów o błędach. Aby uzyskać więcej informacji, zobacz GitHub problem #9813. (RuntimeCompatibilityChange: N/A, zmiana narzędzi kompilatora XAML w czasie kompilacji)
• Rozwiązano problem polegający na tym, że Microsoft.Windows.Workloads.dll nie można było załadować na kompilacjach Windows poprzedzających 22000 z powodu statycznego importowania interfejsów API Dynamic Dependencies, które były niedostępne w tych wersjach systemu operacyjnego. Funkcje są teraz wiązane dynamicznie, więc niepowodzenia na nieobsługiwanych wersjach systemu są zgłaszane jako zwykły HRESULT, zamiast jako okno dialogowe błędu programu ładującego. (RuntimeCompatibilityChange: N/A, bez hermetyzacji)

Ta wersja zawiera następujące nowe interfejsy API w porównaniu z wersją 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

Zestaw SDK do aplikacji systemu Windows 2.0 to pierwsza wersja nowego schematu przechowywania wersji Zestaw SDK do aplikacji systemu Windows, ustandaryzowana w Semantic Versioning 2.0.0. Jest to również pierwszy raz, gdy zwiększamy numer wersji głównej.

Nowy schemat upraszcza przechowywanie wersji przez dostosowanie wersji Zestaw SDK do aplikacji systemu Windows do wersji pakietu NuGet. Odwołanie się do Zestaw SDK do aplikacji systemu Windows 2.0 w projekcie oznacza teraz, że użyjesz odpowiedniej wersji NuGet, bez potrzeby śledzenia oddzielnego numeru kompilacji opartego na dacie.

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

Nazwa rodziny pakietów jest również zgodna z wersją główną zamiast wersji pomocniczej, więc następna wersja obok siebie Zestaw SDK do aplikacji systemu Windows będzie w wersji 3.0.0. W ramach SemVer, zmiany powodujące niezgodność są dozwolone tylko w przypadku aktualizacji głównych wersji (zobacz Architektura wdrażania Zestaw SDK do aplikacji systemu Windows).

Pakiet NuGet Microsoft.WindowsAppSDK.ML został refaktoryzowany, dodając nową zależność podstawową. Funkcjonalność istniejącego pakietu NuGet ML pozostaje taka sama, ale podstawowe funkcje Windows ML zostały refaktoryzowane w pakiecie podstawowym o nazwie Microsoft.Windows.AI.MachineLearning. Ten nowy pakiet zawiera minimalny zestaw zależności, obsługując aplikacje na Windows 10 w wersji 1903. Jeśli potrzebujesz wsparcia dla wersji Windows 10 v1809, kontynuuj korzystanie z istniejącego pakietu Microsoft.WindowsAppSDK.ML.

Środowisko uruchomieniowe ONNX. Wersja środowiska uruchomieniowego ONNX dołączona do Windows ML została zaktualizowana do wersji 1.24.5. Aby uzyskać więcej informacji, zobacz wersje środowiska uruchomieniowego ONNX . Ta wersja zawiera również zmianę interfejsu API ORT polegającą na dodaniu nowych funkcji, aby obsługiwać kompilację modelu przy użyciu grafów tworzonych przez interfejs API OrtModelEditor (brak funkcji w poprzednim interfejsie OrtCompileApi). Zmiana jest nieszkodliwa i została podjęta w celu odblokowania nadchodzących scenariuszy przeglądarki WebNN; Aby uzyskać szczegółowe informacje, zobacz podstawowy wniosek o scalenie środowiska uruchomieniowego ONNX #27332.

Licencjonowanie. Umowa licencyjna Windows ML została uproszczona z jaśniejszymi warunkami dla niezależnych dostawców oprogramowania:

• Przebudowano sekcje Instalacji, Danych i Kodu dystrybucyjnego dla większej przejrzystości.
• Nowa sekcja zawiadomienia o zgodności dostawcy wykonawczego (EP) wyjaśnia obowiązki deweloperów dotyczące dostawców przyspieszonych sprzętowo.
• Bezpośrednie linki do umów licencyjnych dostawcy dla nvidia TensorRT, Intel OpenVINO i Qualcomm QNN (Qualcomm Neural Network SDK).

• Interfejsy API Phi Silica są teraz egzekwowane jako część funkcji ograniczonego dostępu (LAF). Aby uzyskać szczegółowe informacje, zobacz Silica Phi .
• Dodano nowe stany ułatwiające AIFeatureReadyState aplikacjom wyjaśnienie przejściowych i trwałych błędów podczas procesu pozyskiwania modelu sztucznej inteligencji: CapabilityMissing, NotCompatibleWithSystemHardwarei OSUpdateNeeded. Aplikacje mogą używać tych stanów, aby zapewnić użytkownikom wskazówki umożliwiające podejmowanie działań zamiast traktować każdy warunek "nie gotowy" jako ogólny błąd.
• Dodano kontrole różnych błędów sieci i Windows Update podczas instalacji modelu sztucznej inteligencji, flagując trwałe błędy, aby użytkownicy mogli zrozumieć, dlaczego nie można zainstalować pakietów modeli.
• Ulepszona diagnostykowalność API Text Intelligence używanych w scenariuszach sztucznej inteligencji Windows.

Włączona obsługa przeciągania zawartości WebView2 hostowanej w aplikacjach WinUI 3. Ta funkcja była wcześniej nieobsługiwana i jest teraz dostępna bez wprowadzania nowych publicznych interfejsów API. (Upuszczanie kontrolki WebView2 ze źródeł zewnętrznych było już obsługiwane).

Obsługiwane scenariusze:

• Standardowa funkcja drag and drop. Obsługiwane jest przeciąganie tekstu, kodu HTML, obrazów i adresów URL. Przeciągnięcie obrazu poza aplikacją powoduje obecnie wyświetlenie domyślnej nazwy pliku (na przykład download.jpg) po upuszczeniu do Eksploratora plików.
• Przeciągnij anulowanie. Obsługiwane jest anulowanie na żądanie aktywnej operacji przeciągania, dzięki czemu aplikacja może warunkowo blokować operacje przeciągania dla treści z ograniczeniami lub tymczasowej, po zainicjowaniu przeciągania.
• Niestandardowe obrazy przeciągania. Niestandardowy interfejs użytkownika przeciągania, taki jak ikony lub podglądy, jest obsługiwany w celu ułatwienia użytkownikom wyraźnego identyfikowania przeciąganej zawartości.
• Dostosowywalne przeciąganie danych. Edytowanie i dostosowywanie danych przeciągania jest obsługiwane, umożliwiając scenariusze specyficzne dla aplikacji, takie jak przeciąganie komunikatów w aplikacji lub załączanie metadanych kontekstowych (na przykład "Z <nazwa aplikacji>"), które adresat może odczytywać przy upuszczeniu.

Limitations:

• Niektóre dodatkowe typy danych przeciągania nie są obecnie obsługiwane, w tym DownloadURL.

Wymagania:

• Minimalna wersja środowiska uruchomieniowego WebView2 (kanał Beta przeglądarki Edge): 144.0.3719.11.

Interfejs API Microsoft.Windows.Storage.Pickers (wprowadzony w Zestaw SDK do aplikacji systemu Windows 1.8) został rozszerzony w celu usprawnienia wyboru plików i folderów przez umożliwienie deweloperom ustawiania początkowych i trwałych lokalizacji folderów oraz filtrów typów plików grup z przejrzystymi etykietami, aby ułatwić nawigację.

• FileOpenPickerDodaje FileTypeChoices, InitialFileTypeIndex, SettingsIdentifier, SuggestedFolder, SuggestedStartFolder, i Title.
• FileSavePicker dodaje InitialFileTypeIndex, SettingsIdentifier, ShowOverwritePrompt, SuggestedStartFolder i Title.
• FolderPicker dodaje PickMultipleFoldersAsync, SettingsIdentifier, SuggestedFolder, SuggestedStartFolder i Title.

• Względne pozycjonowanie elementu popup. Nowy PopupAnchor interfejs API umożliwia DesktopPopupSiteBridge wspieranie pozycjonowania względnego przez zakotwiczenie do jego własnego okna lub wyspy, rozwiązując ograniczenie, że wyskakujące okienka mogły być umieszczane tylko absolutnie za pomocą współrzędnych ekranu. Nowe DesktopPopupSiteBridge.AnchoringBehavior i DesktopPopupSiteBridge.AnchoringPixelAlignment właściwości sterują działaniem zakotwiczenia.
• Wskazówki dotyczące sygnałów klawiatury. Nowa właściwość InputFocusController.ShouldShowKeyboardCues wskazuje deweloperom, czy wyświetlać podpowiedzi klawiaturowe bezpośrednio po utworzeniu ContentIsland.
• Interfejs API wygody programu PointerPoint. Nowa PointerPoint.GetCurrentPoint metoda umożliwia deweloperom uzyskiwanie aktywnych danych PointerPoint z podanego pointerId elementu.

Nowy Microsoft.UI.Xaml.Controls.SystemBackdropElement to lekki FrameworkElement, który umożliwia aplikacjom umieszczanie systemowego tła, takiego jak Mica lub Akryl, w dowolnym miejscu układu XAML, z właściwością CornerRadius dla obszarów tła o zaokrąglonych kształtach. Zamyka długotrwałą lukę WinUI 3, gdzie efekty akrylowe w aplikacji (wcześniej proste w WinUI 2 przez AcrylicBrush.BackgroundSource) nie miały bezpośredniego odpowiednika.

Przestrzeń nazw Microsoft.Windows.Management.Deployment dodaje framework weryfikacji pakietów i interfejs API PackageVolume do zarządzania woluminami magazynu, na których są umieszczane pakiety.

• Walidatory. Nowy IPackageValidator interfejs oraz trzy wbudowane moduły sprawdzania poprawności (PackageCertificateEkuValidator, PackageFamilyNameValidator, PackageMinimumVersionValidator), do których można dołączyćAddPackageOptions / StagePackageOptionsza pośrednictwem nowej PackageValidators właściwości. PackageValidationEventArgs, PackageValidationEventSource i PackageValidationHandler przeprowadzają zdarzenia weryfikacyjne; IsPackageValidationSupported i GetValidationEventSourceForUri umożliwiają użytkownikom sondowanie wsparcia przed inicjalizacją wdrożenia.
• ObjętośćPaczki Nowy PackageVolume typ z funkcjami GetDefault, GetPackageVolumeByName, GetPackageVolumeByPath, AddAsync, RemoveAsync, GetAvailableSpaceAsync, IsOffline, SetDefault, SetOfflineAsync, SetOnlineAsync i IsFeatureSupported do wykrywania możliwości środowiska uruchomieniowego (PackageVolumeFeature).

Nowy IXamlCondition interfejs umożliwia deweloperom definiowanie warunków niestandardowych, które integrują się ze składnią warunkowej przestrzeni nazw XAML i są oceniane w czasie analizy XAML. Zastępuje to interfejs eksperymentalny IXamlPredicate . Warunki niestandardowe umożliwiają warunkowe scenariusze XAML oparte na czynnikach specyficznych dla aplikacji, takich jak flagi funkcji, możliwości urządzenia, logika biznesowa, ustawienia konfiguracji i inne warunki środowiska uruchomieniowego.

• Rozwiązano problem polegający na tym, że instalator WindowsAppSDK nie pokazywał postępu podczas instalacji, przez co wyglądał na zablokowany. Instalator udostępnia teraz jaśniejszą opinię na temat postępu.
• Ulepszona obsługa błędów w scenariuszach, w których WindowsAppSDKSelfContained jest włączony dla bibliotek klas.
• Naprawiono ostrzeżenia kompilacji MSB8027 i LNK4042 spowodowane przez zduplikowane elementy ClCompile w plikach Zestaw SDK do aplikacji systemu Windows NuGet .targets poprzez przeniesienie definicji preprocesora z bloków <Target> do <ItemDefinitionGroup>. Obejście umożliwiające pominięcie znanego wewnętrznego błędu kompilatora MSVC (WindowsAppSDK_Arm64EcCompilerWorkaround) jest uwzględnione w kompilacjach ARM64EC+LTCG.
• Naprawiono awarię elementu ListView, która mogła wystąpić podczas nawigacji za pomocą klawiatury (Tab/Shift+Tab) po zaktualizowaniu listy elementów.
• Rozwiązano problem polegający na tym, że winUI 3 mógł ulec awarii, jeśli fokus został przeniesiony do CoreWebView2Controller obiektu , gdy kontroler nie był widoczny.
• Ulepszono niezawodność DeleteIndex, dzięki czemu już nie dochodzi do awarii z ERROR_SHARING_VIOLATION w niektórych scenariuszach (wyszukiwanie zawartości aplikacji; pozostaje w kanale eksperymentalnym).
• Naprawiono ramki ograniczające OCR zwracające wartości ujemne w niektórych przypadkach granicznych.
• Usunięto usterkę Windows ML polegającą na tym, że ponowne wywołanie RegisterCertifiedAsync w tym samym procesie niepoprawnie zwracało 0 dostawców realizacji (EP).

Ta wersja obejmuje refaktoryzację przechodnich odwołań NuGet. Aby uaktualnić istniejący projekt języka C++, zalecamy użycie narzędzi (nuget.exe lub Visual Studio), aby usunąć istniejące odwołanie do pakietu Zestaw SDK do aplikacji systemu Windows i dodać nowe odwołanie. Dotyczy to problemów z uaktualnianiem projektów opartych na packages.config.

Uaktualnianie z wersji 2.0 Experimental7. Eksperymentalny pakiet Microsoft.WindowsAppSDK.ML został dostarczony z wyższym numerem poprawki niż w wersji stabilnej 2.0.0, co może pojawić się jako błąd obniżania wersji NuGet (szczególnie w projektach C++). Jeśli korzystasz z narzędzia Experimental7, postępuj zgodnie z przewodnikiem Odinstalowywanie NuGet, aby usunąć pakiet eksperymentalny przed odwołaniem się do wersji 2.0.0.

• Wyszukiwanie zawartości aplikacji pozostaje eksperymentalne. Powierzchnia interfejsu API Microsoft.Windows.Search.AppContentIndex (wyszukiwanie zawartości aplikacji) została usunięta w wersji 2.0-Preview2, aby poprawić podstawy i zapewnić zgodność w przyszłości. Nie jest uwzględniona w stabilnej wersji 2.0.1. Aby eksperymentować z nim, kontynuuj korzystanie z wersji eksperymentalnych. Jeśli wcześniej zainstalowano eksperymentalny pakiet Microsoft.Windows.Search, odinstaluj go za pomocą instrukcji NuGet Uninstall przed przejściem do stabilnej wersji 2.0.1.
• Interfejsy API są już dostarczane w wersji 1.8 serwisowej. Niektóre funkcje eksperymentalne prezentowane podczas cyklu 2.0 zostały promowane do stabilnych interfejsów API w wersjach serwisowych 1.8 i dlatego nie są nowe w wersji 2.0.1. Obejmują ModelCatalog (1.8.3), TextRewriter.RewriteCustomAsync (1.8.4) i SplitMenuFlyoutItem oraz SplitMenuFlyoutItemAutomationPeer (1.8.6). Aby uzyskać szczegółowe informacje, zobacz informacje o wersji 1.8 .

• AICapabilities jest brakujący w wersji 2.0.1. Microsoft.Windows.AI.AICapabilities i AICapabilityCategory.CopilotPlusPCCapable (sprawdzanie możliwości Copilot+ PC) zostały dostarczone w wersji 1.8.7, ale nie znalazły się w wersji 2.0.1. Planujemy je przywrócić w wersji majowej.

Ta wersja zawiera następujące nowe interfejsy API w porównaniu ze stabilną wersją 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

Pakiet NuGet Microsoft.WindowsAppSDK.ML został refaktoryzowany, dodając nową zależność podstawową. Funkcjonalność istniejącego pakietu NuGet ML pozostaje taka sama, ale podstawowe funkcje Windows ML zostały refaktoryzowane w podstawowym pakiecie zależnym o nazwie Microsoft.Windows. AI. MachineLearning. Ten nowy pakiet zawiera minimalny zestaw zależności, ale w języku C#/WinRT lub C++/WinRT obsługuje wersje Windows co najmniej od 10 18362. Jeśli potrzebujesz obsługi Windows 10 17763, użyj istniejącego pakietu Microsoft.WindowsAppSDK.ML.

W przypadku nowych zależności przechodnich zalecamy użycie narzędzi w celu uaktualnienia pakietu (nuget.exe lub VS). Zobacz również: informacje o wersji Zestaw SDK do aplikacji systemu Windows 1.6.

Wersja środowiska uruchomieniowego ONNX została zaktualizowana do wersji 1.24.4. Aby uzyskać więcej informacji, zobacz wersje środowiska uruchomieniowego ONNX .

Wdrożone interfejsy API Phi Silica są częścią funkcji z ograniczonym dostępem.

Dodano kontrole różnych błędów sieci i Windows Update podczas instalacji modelu sztucznej inteligencji, flagując trwałe błędy, aby użytkownicy mogli zrozumieć, dlaczego nie można zainstalować pakietów modeli.

Ulepszona diagnostykowalność API Text Intelligence używanych w scenariuszach sztucznej inteligencji Windows.

Wyszukiwanie zawartości aplikacji zostało usunięte z wersji zapoznawczej 2.0, podczas gdy pracujemy nad ulepszeniem podstaw i zapewnieniem zgodności w przyszłości w miarę zmiany podstawowych modeli sztucznej inteligencji. W międzyczasie kontynuuj korzystanie z kanału eksperymentalnego, aby wypróbować najnowsze zmiany.

Włączona obsługa przeciągania zawartości WebView2 hostowanej w aplikacjach WinUI 3. Ta funkcja była wcześniej nieobsługiwana i jest teraz dostępna bez wprowadzania nowych publicznych interfejsów API. Uwaga: Przeciąganie i upuszczanie do WebView2 ze źródeł zewnętrznych jest już obsługiwane.

Obsługiwane scenariusze

• Standardowe funkcje przeciągania i upuszczania Obsługiwane jest przeciąganie tekstu, kodu HTML, obrazów i adresów URL. Zgodnie z obecnym działaniem przeciągnięcie obrazów poza aplikację skutkuje nadaniem domyślnej nazwy pliku (na przykład download.jpg), gdy zostaną upuszczone do Eksploratora plików. Przykładowy scenariusz: Użytkownik wybiera tekst lub obraz wewnątrz elementu WebView2 i przeciąga go w aplikacji lub do innego miejsca docelowego, takiego jak Eksplorator plików.

• Anulowanie przeciągania Możliwe jest anulowanie aktywnej operacji przeciągania na żądanie. Przykładowy scenariusz: Aplikacja warunkowo blokuje operacje przeciągania dla niektórych typów zawartości (takich jak zawartość ograniczona lub efemeryczna), anulując przeciąganie po zainicjowaniu.

• Niestandardowe wizualizacje przeciągania Niestandardowy interfejs użytkownika przeciągania, taki jak ikony lub podglądy, jest obsługiwany w celu ułatwienia użytkownikom wyraźnego identyfikowania przeciąganej zawartości. Przykładowy scenariusz: Aplikacja wyświetla podgląd miniatury lub ikonę podczas przeciągania zawartości multimedialnej przez użytkownika, co pozwala wyjaśnić, który element jest obecnie przenoszony.

• Dostosowywalne przeciąganie danych Edytowanie i dostosowywanie danych przeciągania jest obsługiwane, umożliwiając scenariusze specyficzne dla aplikacji, takie jak przeciąganie komunikatów w aplikacji (na przykład jako alternatywna interakcja z przekazywaniem komunikatów). Przykładowy scenariusz: Aplikacja dostosowuje przenoszony ładunek, aby uwzględnić metadane kontekstowe, takie jak nazwa aplikacji źródłowej. Gdy zawartość zostanie porzucona, miejsce docelowe może wyświetlać lub przetwarzać informacje, takie jak "Od <nazwy> aplikacji", aby wskazać źródło przeciąganej zawartości.

Ograniczenia

• Obsługa dodatkowych typów danych przeciągania jest ograniczona. Następujące formaty nie są obecnie obsługiwane:
  • DownloadURL

Wymagania

• Minimalna wersja środowiska uruchomieniowego WebView2 (kanał Beta przeglądarki Edge): 144.0.3719.11

Interfejs IXamlCondition umożliwia deweloperom definiowanie warunków niestandardowych, które integrują się ze składnią warunkowej przestrzeni nazw XAML i są oceniane w czasie analizy XAML. Jest to zmiana nazwy i przejście do etapu produkcyjnego interfejsu eksperymentalnego IXamlPredicate. Warunki niestandardowe umożliwiają warunkowe scenariusze XAML oparte na czynnikach specyficznych dla aplikacji, takich jak flagi funkcji, możliwości urządzenia, logika biznesowa, ustawienia konfiguracji i inne warunki środowiska uruchomieniowego.

• Naprawiono ostrzeżenia kompilacji MSB8027 i LNK4042 spowodowane przez zduplikowane elementy ClCompile w plikach .targets NuGet Zestaw SDK do aplikacji systemu Windows, przenosząc definicje preprocesora z bloków <Target> do <ItemDefinitionGroup>. Obejście umożliwiające pominięcie znanego wewnętrznego błędu kompilatora MSVC (WindowsAppSDK_Arm64EcCompilerWorkaround) jest uwzględnione w kompilacjach ARM64EC+LTCG.
• Naprawiono awarię elementu ListView, która mogła wystąpić podczas nawigacji za pomocą klawiatury (Tab/Shift+Tab) po zaktualizowaniu listy elementów.
• Rozwiązano problem polegający na tym, że winUI 3 mógł ulec awarii, jeśli fokus został przeniesiony do kontrolki CoreWebView2Controller, gdy kontroler nie był widoczny.

Ta wersja zawiera następujące nowe i zmodyfikowane interfejsy API w porównaniu do wersji 2.0-Preview1:

Microsoft.UI.Xaml.Markup

    IXamlCondition

• Wersja środowiska uruchomieniowego ONNX w usłudze Windows ML została zaktualizowana do wersji 1.24 RC
• Usunięto usterkę polegającą na tym, że jeśli funkcja RegisterCertifiedAsync jest wywoływana ponownie w tym samym procesie, niepoprawnie zwraca 0 dostawców wykonywania (EP)

• Nowa właściwość InputFocusController.ShouldShowKeyboardCues ma kierować deweloperów, czy wyświetlać wskazówki klawiaturowe bezpośrednio po utworzeniu ContentIsland.
• Nowy wygodny interfejs API PointerPoint.GetCurrentPoint, aby umożliwić programistom pobieranie danych PointerPoint, które są aktywne, z podanego pointerId elementu.

• Zwiększona DeleteIndex niezawodność. Czasami DeleteIndex kończy się błędem ERROR_SHARING_VIOLATION.

• Poprawka dotycząca pól ograniczenia OCR zwracających wartości ujemne w niektórych przypadkach krawędzi.

• Wyszukiwanie zawartości aplikacji stanowi część oddzielnego pakietu Microsoft.Windows.Search zamiast Microsoft.Windows.AI package.

• Poprawka dla wyszukiwania prefiksowego, które nie działa z krótkimi ciągami zapytań.

• Nowe API i zmiany nazw wynikające z oficjalnego przeglądu API.

  • AppContentIndexer
    • PobierzElementyTreściWymagającePonownegoIndeksowania
    • Usuń —> RemoveContentItem
    • UsuńWiele —> UsuńElementyZawartości
    • UsuńWszystkieElementyZawartości
    • GetContentIndexingStatus —> GetContentItemStatus
    • GetMultipleContentIndexingStatus —> GetContentItemStatuses
    • GetContentItems
  • AppContentIndexListener
    • ZmianaStatusuIndeksowania —> ZmianaStatusuElementuZawartości
  • AppIndexTextQuerySession
    • UpdateQuery —> UpdateQueryPhrase
    • MostRecentResult —> GetResult
    • MostRecentResultChanged —> ResultChanged
  • AppIndexImageQuerySession
    • UpdateQuery —> UpdateQueryPhrase
    • MostRecentResult —> GetResult
    • MostRecentResultChanged —> ResultChanged
  • AppManagedImageQueryMatch
    • Podregion —> RegionZainteresowania
  • ContentItemStatusResult
    • ReindexingStatus * ContentItemReindexingStatus
  • WynikSesjiZapytaniaTekstowego
    • IsValid
  • ImageQuerySessionResult
    • IsValid
  • QueryContentItemsFilterFlags

• Rozwiązano problem polegający na tym, że instalator WindowsAppSDK nie pokazywał postępu podczas instalacji, przez co wyglądał na zablokowany. Instalator udostępnia teraz jaśniejszą opinię na temat postępu.
• Ulepszona obsługa błędów scenariuszy, w których dla bibliotek klas jest włączona funkcja WindowsAppSDKSelfContained.

Ta wersja zawiera następujące nowe i zmodyfikowane eksperymentalne interfejsy API w porównaniu do wersji 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

• Nowe interfejsy API AIComputeDevice umożliwiają aplikacjom wybranie domyślnego, procesora CPU lub urządzenia wykonawczego NPU podczas tworzenia elementu TextRecognizer. ContentRegionImageOptions.PreferredTextRecognizerDevice określa to samo ustawienie preferowanego urządzenia dla OCR wykonywanego podczas indeksowania obrazów w ramach App Content Index.
• AI Speech korzysta teraz z SpeechRecognitionModelFactory i SpeechRecognitionModelFactoryOptions do konfigurowania i tworzenia modeli rozpoznawania mowy. Metody wprowadzania dźwięku obsługują teraz 16-bitowe bufory próbek, ciągłe rozpoznawanie jest zatrzymywane asynchronicznie, a zdarzenia rozpoznawania strumieniowego udostępniają właściwości specyficzne dla danego dostawcy.
• LanguageModel.ModelName, LanguageModel.ModelVersion i LanguageModelLowRankAdapterStatus umożliwiają aplikacjom zidentyfikowanie zainstalowanego modelu językowego i sprawdzenie wyniku zgodności podczas ładowania karty o niskiej rangi.
• LanguageModelResponseStatus.BlockedByGameMode i LanguageModelResponseStatus.LowOnVram identyfikują odpowiedzi, których nie można ukończyć, ponieważ tryb gry był aktywny lub ilość dostępnej pamięci wideo była niska.

Nowy eksperymentalny interfejs API FrameworkElement.SetThemeResourceBinding umożliwia aplikacjom tworzenie w kodzie odpowiednika powiązania {ThemeResource}. (RuntimeCompatibilityChange: WinUI_SetThemeResourceBinding)

Nowy eksperymentalny konstruktor DataTemplate akceptuje delegata dostarczonego przez aplikację, który tworzy poddrzewo elementu szablonu. (RuntimeCompatibilityChange: WinUI_DataTemplateFromDelegate)

Eksperymentalna kontrolka TableView jest teraz dostępna w publicznych plikach WinMD. Obsługuje grupowanie z użyciem szablonowych nagłówków grup, sortowanie i filtrowanie za pomocą wskaźników sortowania w nagłówkach kolumn, zmianę rozmiaru kolumn przy użyciu wskaźnika i klawiatury oraz opcjonalne podpowiedzi dla komórek i nagłówków kolumn. (RuntimeCompatibilityChange: TableView_TabularBinaryActivation)

W tej wersji dodano eksperymentalną kontrolkę Wykres WinUI 3 do prezentowania danych kartezjańskich jako serii linii, obszaru i słupków. Kontrolka obsługuje konfigurowalne osie, legendy, etykiety danych i znaczniki danych. (RuntimeCompatibilityChange: Charts_ExperimentalControlApi)

• Dodano elementy InkPresenter.ActivateCustomDrying i InkSynchronizer, które umożliwiają aplikacjom renderowanie zatwierdzonego pisma odręcznego przy użyciu narzędzi BeginDry i EndDry.
• Naprawiono błąd naruszenia zasad dostępu, który mógł wystąpić podczas odczytywania elementu InkPresenter.StrokeContainer, gdy było aktywne niestandardowe osuszanie.
• Naprawiono określanie rozmiaru prezentera InkCanvas przy zastosowaniu RenderTransform.
• Dostosowano eksperymentalny interfejs API InkToolbar do projektu po przeglądzie. Pasek narzędzi jest teraz przeznaczony bezpośrednio dla elementu InkPresenter bez konieczności używania elementu InkCanvas. (RuntimeCompatibilityChange: InkCanvas_InkingSupport)

• Naprawiono problem ze śledzeniem zasobów w WinUI, który mógł powodować wzrost zużycia pamięci, gdy aplikacje wielokrotnie tworzyły scenorysy stanów wizualnych lub odwoływały się do zasobów statycznych albo zasobów motywu. (RuntimeCompatibilityChange: WinUI_ResourceGraphExpiredDependencyPruning)
• Ulepszone czyszczenie nieosiągalnych natywnych obiektów WinUI w aplikacjach .NET po zamknięciu karty lub strony. (RuntimeCompatibilityChange: WinUI_OrphanedObjectGCCollection)

Ta wersja zawiera następujące nowe i zaktualizowane interfejsy API w porównaniu z wersją 2.4 Eksperymentalna :

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

W tej wersji dodano obsługę pisma odręcznego w WinUI 3 za pośrednictwem InkCanvas, InkToolbar i InkPresenter, w tym obsługę wprowadzania za pomocą pióra i dotyku, obsługę schowka, obsługę trybu wysokiego kontrastu, obsługę wprowadzania kresek oraz nieprzetworzonych danych wejściowych. (RuntimeCompatibilityChange: InkCanvas_InkingSupport)

Ta wersja zawiera następujące nowe interfejsy API w porównaniu z wersją 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

Nowe eksperymentalne właściwości Window.Width i Window.Height zapewniają aplikacjom sposób uwzględniający DPI na bezpośrednie pobieranie i ustawianie rozmiaru okna w logicznych pikselach (obszaru klienta) z poziomu kodu lub znaczników, bez odwoływania się do Window.AppWindow i ręcznego przeliczania wartości logicznych na fizyczne z uwzględnieniem DPI. Właściwości Companion Window.MinWidth, Window.MinHeight, Window.MaxWidth i Window.MaxHeight ograniczają rozmiar okna. Z zadowoleniem przyjmujemy Twoją opinię.

Eksperymentalny SpeechAudioProvider (używany do przekazywania dźwięku PCM 16 kHz, 16-bitowego, jednokanałowego na potrzeby rozpoznawania mowy) implementuje teraz interfejs IClosable, dzięki czemu aplikacje mogą w sposób deterministyczny zwolnić dostawcę za pomocą Close/Dispose po zakończeniu przesyłania strumieniowego dźwięku.

Eksperymentalne interfejsy API indeksu zawartości aplikacji dodają nowe możliwości indeksowania oraz znaczne ulepszenia niezawodności i wydajności w tej wersji:

• Szybsze indeksowanie wsadowe. Nowy interfejs API AppContentIndexer.BatchAddOrUpdate umożliwia indeksowanie wielu elementów. Potok indeksujący został również przeprojektowany, aby obsługiwać równoległe wykonywanie etapów i bardziej wydajne przetwarzanie wsadowe.
• Ulepszona wielojęzyczna tokenizacja. Indeks zawartości aplikacji korzysta teraz z opartego na ICU mechanizmu podziału na wyrazy, co zwiększa poprawność tokenizacji w różnych językach i jednocześnie eliminuje zależność od WinRT WordsSegmenter.
• Ulepszona wydajność indeksowania i zapytań. Aktualizacje indeksu eliminują teraz zbędne przebudowy leksykalne, wydajniej wykonują czyszczenie wsadowe oraz przechowują w pamięci podręcznej informacje o możliwościach indeksu między zapytaniami, co znacząco zmniejsza narzut w typowych ścieżkach wykonywania zapytań i indeksowania.
• Bardziej stabilny ranking leksykalny. Punktacja BM25 teraz przechowuje statystyki długości dokumentów niezależnie, co pozwala zachować spójność rankingu w miarę stopniowej aktualizacji lub usuwania treści.
• Automatyczne odzyskiwanie uszkodzeń. Indeks zawartości aplikacji wykrywa uszkodzenie bazy danych i niezgodne zmiany schematu podczas otwierania indeksu i automatycznie odzyskuje je przez zainicjowanie ponownego indeksu, a nie pozostawienie indeksu bezużytecznego. GetOrCreateIndexStatus.RecoveredFromCorruption wskazuje, kiedy nastąpiło odzyskiwanie.
• Zwiększenie klasyfikacji statycznej. Nowe interfejsy API umożliwiają aplikacjom stosowanie podwyższeń klasyfikacji do poszczególnych elementów zawartości lub regionów, co pozwala na stronniczość wyników przy użyciu sygnałów dostarczanych przez aplikację. Użyj podwyższeń statycznych, gdy aplikacja ma wiedzę na temat względnego znaczenia zawartości, która nie jest przechwytywana przez samą zawartość, na przykład, aby ułatwić uwidocznienie dokumentu, który jest szczególnie ważny lub często poszukiwany przez użytkowników.
• Indeksowanie zawartości obrazu. Aplikacje mogą teraz indeksować zawartość mapy bitowej lub strumienia obrazów bezpośrednio, a opcje kontrolują wyodrębnianie OCR i indeksowanie semantyczne wyodrębnionego tekstu. Użyj indeksowania obrazów, gdy istotne informacje z możliwością wyszukiwania znajdują się na obrazie, a nie są już dostępne jako tekst, takie jak zrzuty ekranu, zeskanowane dokumenty lub inna zawartość wizualna.
• Kontrolka indeksowania semantycznego dla tekstu. Nowa właściwość ContentRegionTextOptions.AllowSemanticIndexing umożliwia aplikacjom wybieranie poszczególnych regionów tekstowych poza indeksowaniem semantycznym. Jest to przydatne w przypadku tekstu, który powinien pozostać przeszukiwalny leksykalnie, ale jest mało prawdopodobne, aby korzystać z dopasowania semantycznego, dając aplikacjom większą kontrolę nad tym, która zawartość uczestniczy w semantycznym pobieraniu.

Ta wersja zawiera następujące nowe interfejsy API w porównaniu z wersją 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

Interfejsy API modeli językowych działają teraz także na komputerach PC innych niż Copilot+, wyposażonych w obsługiwany procesor graficzny, udostępniając możliwości lokalnych modeli językowych szerszej gamie urządzeń z systemem Windows 11. Obsługiwany sprzęt obejmuje serię NVIDIA GeForce RTX 30 i nowsze z 6+ GB pamięci vRAM. Wnioskowanie procesora GPU wymaga włączenia trybu dewelopera i kompilacji Windows Insider Experimental Channel.

Model GPU nie jest fabrycznie zainstalowany. Jest on pobierany na żądanie za pośrednictwem EnsureReadyAsync za pośrednictwem Windows Update. Aplikacje powinny sprawdzać GetReadyState i wyświetlać okno dialogowe z prośbą o zgodę przed rozpoczęciem pobierania. Użytkownicy mogą zarządzać modelem w obszarze Ustawienia > Składniki sztucznej inteligencji systemu > .

Wskazówki dotyczące odpowiedzialnej sztucznej inteligencji można znaleźć w nowej nocie dotyczącej przejrzystości: interfejsy API modeli językowych na komputerach PC bez funkcji Copilot+.

Nowe interfejsy API do rozpoznawania mowy na urządzeniu w Microsoft.Windows.AI.Speech umożliwiają zarówno wsadową, jak i strumieniową konwersję mowy na tekst. BatchRecognition rozpoznaje całe źródło dźwięku w jednym wywołaniu, a StreamingRecognition zgłasza zdarzenia Recognizing i Recognized. Dźwięk może być pobierany z urządzenia (AudioConfiguration.FromAudioDevice), pliku (FromFile), strumienia wejściowego (FromStream) lub przesyłany przez wywołującego za pośrednictwem SpeechAudioProvider (16 kHz, 16-bitowy, jednokanałowy format PCM). Model działający na urządzeniu jest zarządzany za pośrednictwem SpeechRecognitionModel.EnsureReadyAsync / TryCreateAsync, a postęp pobierania i ładowania jest raportowany przez SpeechRecognitionModelProgress.

Nowy typ wyliczeniowy Microsoft.Windows.Workloads.NpuType udostępnia klasę NPU na bieżącym urządzeniu (na przykład Qnn, Lnl, Stx, Win365, Unknown, None), dzięki czemu aplikacje i infrastruktura Workloads mogą kierować obciążenia AI do odpowiedniej ścieżki wykonywania.

Ta wersja zawiera następujące nowe interfejsy API w porównaniu z wersją 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 (wprowadzony w wersji 2.0 Experimental 7) zwraca teraz dedykowany typ GenerateStructuredJsonResponseResult z właściwością GenerateStructuredJsonResponseStatus zamiast generycznej pary LanguageModelResponseResult / LanguageModelResponseStatus. Nowa enumeracja statusu jest specyficzna dla generowania ograniczonego schematem: obejmuje wartość ResponseInvalidJson dla przypadku, w którym dane wyjściowe modelu nie spełniły żądanego schematu JSON, odrębną od ogólnych niepowodzeń odpowiedzi modelu językowego.

W ramach tego podziału wartość ResponseInvalidJson została usunięta ze stabilnego LanguageModelResponseStatus enum (do którego została wcześniej dodana w celu obsługi ustrukturyzowanych danych wyjściowych JSON). Aplikacje, które obsługiwały ResponseInvalidJson z LanguageModelResponseStatus, powinny przenieść tę obsługę na nową GenerateStructuredJsonResponseStatus zwracaną przez GenerateStructuredJsonResponseAsync. Inne osoby wywołujące LanguageModelResponseStatus nie muszą już uwzględniać wartości błędu specyficznej dla formatu JSON.

Ta wersja zawiera następujące nowe interfejsy API w porównaniu z wydaniem 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]

Zestaw SDK do aplikacji systemu Windows 2.0.0-experimental7 wprowadza eksperymentalną obsługę narzędzia CMake (w ramach aktywnego programowania), umożliwiając deweloperom języka C++ korzystanie z pakietów NuGet Zestaw SDK do aplikacji systemu Windows z projektów opartych na narzędziu CMake.

Integracja narzędzia CMake jest oparta na pakiecie NuGetCMakePackage, module CMake typu open source, który łączy lukę między zarządzaniem pakietami NuGet i natywnym find_package() przepływem pracy narzędzia CMake. Pakiet NuGetCMakePackage obsługuje pobieranie i przywracanie pakietów NuGet podczas konfigurowania za pomocą add_nuget_packages(), przeszukuje każdy pakiet w poszukiwaniu osadzonej konfiguracji cmake (w lokalizacji build/cmake/<package>-config.cmake) i udostępnia nagłówki pakietu, biblioteki importu, DLL czasu wykonywania oraz metadane WinRT jako standardowe cele CMake.

Każdy składnik NuGet oraz powiązany pakiet zależny Zestaw SDK do aplikacji systemu Windows teraz osadza plik konfiguracji narzędzia CMake w build/cmake/, co przy pomocy biblioteki NuGetCMakePackage umożliwia narzędziu CMake automatyczne odnajdywanie celów, nagłówków, bibliotek oraz bibliotek środowiska uruchomieniowego bez ręcznej konfiguracji ścieżek. Obejmuje to wszystkie pakiety składników, w tym Foundation, InteractiveExperiences, DWrite, Widgets, AI, ML i WinUI, a także zależności, takie jak Base i Runtime.

Aby zapoznać się z omówieniem modelu użycia narzędzia CMake i wskazówkami dotyczącymi rozpoczynania pracy, zobacz stronę docelową narzędzia CMake.

Ta funkcja jest eksperymentalna i jest testowana wcześnie, aby zbierać opinie społeczności. Docelowe konwencje nazewnictwa i wzorce konfiguracji mogą ulec zmianie na podstawie danych wejściowych deweloperów. Ponieważ jest to wczesny lot, istnieje pewna ceremonia i konfiguracja — zapoznaj się z przykładowymi aplikacjami CMake , które ilustrują kompleksową konfigurację i użycie we wszystkich czterech scenariuszach wdrażania (SelfContained|FrameworkDependent x Packaged|Unpackaged).

Chcemy poznać Twoją opinię! Jeśli napotkasz scenariusz, który nie jest obecnie omówiony, masz sugestie dotyczące ulepszania środowiska dewelopera lub napotkasz problemy, prześlij opinię w Issues na karcie Zestaw SDK do aplikacji systemu Windows repozytorium open source lub rozpocznij konwersację w Discussions. Dane wejściowe będą bezpośrednio kształtować aktywny rozwój tej funkcji.

Ta wersja eksperymentalna obejmuje zmiany i poprawki dostarczane w wersji 2.0-Preview1 i 2.0-Preview2. Przedstawione elementy są podsumowane poniżej; aby uzyskać pełne szczegóły, zapoznaj się z odnośnymi uwagami dotyczącymi wersji zapoznawczej.

Z wersji 2.0-Preview1:

• Windows ML: Poprawka dotycząca sytuacji, w której RegisterCertifiedAsync zwraca brak dostawców realizacji, gdy jest ponownie wywoływany w tym samym procesie.
• Microsoft.UI.Content: Nowa właściwość oraz nowe dogodniejsze API InputFocusController.ShouldShowKeyboardCues.
• Microsoft.Windows. Management.Deployment: Nowe interfejsy API PackageVolume dla parzystości+ z Windows.Management.Deployment (w tym AddAsync, GetDefault, GetAvailableSpaceAsync, IsAppxInstallSupported, IsOffline, IsFeatureSupported i nie tylko). Nowy IPackageValidator punkt rozszerzalności w systemach AddPackageOptions i StagePackageOptions, z trzema wbudowanymi walidatorami: PackageCertificateEkuValidator, PackageFamilyNameValidator i PackageMinimumVersionValidator.
• Microsoft.Windows. Storage.Pickers:
  • Nowe właściwości Title dotyczące FileOpenPicker, FileSavePicker i FolderPicker, umożliwiające niestandardowe tytuły okien dialogowych.
  • Nowe SettingsIdentifier właściwości na FileOpenPicker, FileSavePickeri FolderPicker, umożliwiające stan specyficzny dla wystąpienia selektora między sesjami.
  • Nowe InitialFileTypeIndex właściwości w systemach FileOpenPicker i FileSavePickerumożliwiają deweloperom ustawienie domyślnego filtru wybranego typu pliku według indeksu (opartego na 0).
  • Nowa ShowOverwritePrompt właściwość na FileSavePicker. Wartość domyślna to true i określa, czy selektor ostrzega o zastąpieniu, gdy użytkownik wybierze istniejący plik za pomocą polecenia FileSavePicker.
  • Zmieniono domyślne zachowanie elementu FileSavePicker: począwszy od zestawu WindowsAppSDK 2.0, element FileSavePicker NIE utworzy pustego pliku, gdy użytkownik wybierze nieistniejący plik, co pozwoli deweloperom zdecydować, kiedy ma zostać utworzony plik.
  • Nowa PickMultipleFoldersAsync metoda w systemie FolderPickerumożliwia wybór wielu folderów w ramach jednej operacji.
• Poprawki błędów: raportowanie postępu instalatora; ulepszona obsługa błędów dla WindowsAppSDKSelfContained bibliotek klas.

Z wersji 2.0-Preview2:

• Interfejsy API Windows AI: Interfejsy API Phi Silica są stosowane jako funkcja o ograniczonym dostępie; nowe AIFeatureReadyState wartości ujawniają problemy związane z nabywaniem modeli, takie jak brakujące funkcje, niekompatybilny sprzęt i wymagane aktualizacje systemu operacyjnego; trwałe błędy instalacji sieci/Windows Update są teraz oznaczane; ulepszona możliwość diagnostyki interfejsów API inteligentnej analizy tekstu.
• Niestandardowe warunki XAML: IXamlCondition ukończyły fazę eksperymentalną i zmieniły nazwę interfejsu IXamlPredicate, umożliwiając niestandardowe warunki oceniane podczas analizy XAML.
• WebView2 (WinUI 3): obsługa przeciągania zawartości hostowanej w programie WebView2 (tekst, HTML, obrazy, adresy URL), anulowanie przeciągania, niestandardowe wizualizacje przeciągania i dostosowywanie danych przeciągania. Wymaga środowiska WebView2 Runtime 144.0.3719.11 lub nowszego. (DownloadURL jeszcze nie jest obsługiwane).
• Poprawki błędów: Ostrzeżenia kompilacji MSB8027/LNK4042 wynikające z powielonych elementów ClCompile w .targets plikach (z opcjonalnym obejściem WindowsAppSDK_Arm64EcCompilerWorkaround dla ARM64EC+LTCG); awaria ListView podczas nawigacji klawiaturą po aktualizacji listy elementów; awaria WinUI 3 po przeniesieniu fokusu na niewidoczną kontrolkę CoreWebView2Controller.

• Zmiana nazwy interfejsu API dla wyraźności i spójności.
  • ScaleFrameStatus → VideoScalerStatus
  • VideoScalerOptions.RegionOfInterests → VideoScalerOptions.RegionsOfInterest
  • VideoScaler.ScaleFrame → VideoScaler.Scale i VideoScaler.ScaleImageBuffer
• Różne poprawki błędów i ulepszenia jakości w programie VSR.

• Nowy interfejs API LanguageModelExperimental.GenerateStructuredJsonResponseAsync w obszarze Microsoft.Windows.AI.Text.Experimental do generowania ustrukturyzowanych danych wyjściowych JSON z modelu językowego.
• Nowa LanguageModelResponseStatus.ResponseInvalidJson wartość stanu wskazująca, że model zwrócił odpowiedź, która nie została przeanalizowana jako prawidłowy kod JSON.

• Nowe AppContentIndexer.GetExistingIndexes i AppContentIndexer.IsContentKindSupported interfejsy API.
• Nowy typ AppManagedOcrTextQueryMatch i wartość QueryMatchContentKind.AppManagedOcrText do obsługi zapytań dotyczących zawartości aplikacji na podstawie tekstu uzyskanego za pomocą OCR.
• Utwórz GetOrCreateIndexOptions.CreateAlways aby wymusić utworzenie nowego indeksu.
• Nowe ContentItemErrorDetail.InsufficientDiskSpace do wyświetlania błędów niskiego stanu miejsca na dysku podczas indeksowania.

Ta wersja zawiera następujące nowe i zmodyfikowane eksperymentalne interfejsy API w porównaniu do wersji 2.0.0-experimental6:

Microsoft.UI.Input

    InputFocusController
        ShouldShowKeyboardCues

    PointerPoint
        GetCurrentPoint

Microsoft.UI.Xaml.Markup

    IXamlCondition

Microsoft.Windows.AI

    AIFeatureReadyResult
        PackageInstallationFailed

    AIFeatureReadyState
        CapabilityMissing
        NotCompatibleWithSystemHardware
        OSUpdateNeeded

Microsoft.Windows.AI.Text

    LanguageModelResponseStatus
        ResponseInvalidJson

Microsoft.Windows.AI.Text.Experimental

    LanguageModelExperimental
        GenerateStructuredJsonResponseAsync

Microsoft.Windows.AI.Video

    VideoScaler
        Scale
        ScaleImageBuffer

    VideoScalerOptions
        RegionsOfInterest

    VideoScalerStatus

Microsoft.Windows.Management.Deployment

    AddPackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

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

    PackageVolumeFeature
    StagePackageOptions
        GetValidationEventSourceForUri
        IsPackageValidationSupported
        PackageValidators

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetExistingIndexes
        IsContentKindSupported

    AppManagedOcrTextQueryMatch
    ContentItemErrorDetail
        InsufficientDiskSpace

    GetOrCreateIndexOptions
        CreateAlways

    QueryMatchContentKind
        AppManagedOcrText

Microsoft.Windows.Storage.Pickers

    FileOpenPicker
        InitialFileTypeIndex
        SettingsIdentifier
        Title

    FileSavePicker
        InitialFileTypeIndex
        SettingsIdentifier
        ShowOverwritePrompt
        Title

    FolderPicker
        PickMultipleFoldersAsync
        SettingsIdentifier
        Title

Windows ML można teraz używać z poziomu C++ przy użyciu CMake. Aby dowiedzieć się więcej, zobacz stronę Wprowadzenie .

Wersja środowiska uruchomieniowego ONNX została zaktualizowana do wersji 1.24.2. Aby uzyskać więcej informacji, zobacz wersje środowiska uruchomieniowego ONNX .

• NPUPowerMode został wycofany na rzecz nowszych interfejsów API zarządzania energią.
• GetReadyState teraz bezpiecznie zwraca wartość NotSupported , gdy broker sesji jest niedostępny, zamiast zgłaszać wyjątek.

• Dodano obsługę formatu wyjściowego NV12 dla funkcji Video Super Resolution.

• Zwiększona DeleteIndex niezawodność. Czasami DeleteIndex kończy się błędem ERROR_SHARING_VIOLATION.

• Poprawka dotycząca pól ograniczenia OCR zwracających wartości ujemne w niektórych przypadkach krawędzi.

• Wyszukiwanie zawartości aplikacji stanowi część oddzielnego pakietu Microsoft.Windows.Search zamiast Microsoft.Windows.AI package.

• Poprawka dla wyszukiwania prefiksowego, które nie działa z krótkimi ciągami zapytań.

• Nowe API i zmiany nazw wynikające z oficjalnego przeglądu API.

  • AppContentIndexer
    • PobierzElementyTreściWymagającePonownegoIndeksowania
    • Usuń —> RemoveContentItem
    • UsuńWiele —> UsuńElementyZawartości
    • UsuńWszystkieElementyZawartości
    • GetContentIndexingStatus —> GetContentItemStatus
    • GetMultipleContentIndexingStatus —> GetContentItemStatuses
    • GetContentItems
  • AppCOntentIndexListener
    • ZmianaStatusuIndeksowania —> ZmianaStatusuElementuZawartości
  • AppIndexTextQuerySession
    • UpdateQuery —> UpdateQueryPhrase
    • MostRecentResult —> GetResult
    • MostRecentResultChanged —> ResultChanged
  • AppIndexImageQuerySession
    • UpdateQuery —> UpdateQueryPhrase
    • MostRecentResult —> GetResult
    • MostRecentResultChanged —> ResultChanged
  • AppManagedImageQueryMatch
    • Podregion —> RegionZainteresowania
  • ContentItemStatusResult
    • ReindexingStatus * ContentItemReindexingStatus
  • WynikSesjiZapytaniaTekstowego
    • IsValid
  • ImageQuerySessionResult
    • IsValid
  • QueryContentItemsFilterFlags

• Naprawiono ImageDescription.DescribeAsync niepowodzenie z InternalError powodu warunku wyścigu.

Ta wersja zawiera następujące nowe i zmodyfikowane eksperymentalne interfejsy API w porównaniu do wersji 2.0.0-experimental5:

Microsoft.Windows.Search.AppContentIndex

    AppContentIndexer
        GetContentItems
        GetContentItemStatus
        GetContentItemStatuses
        RemoveAllContentItems
        RemoveContentItem
        RemoveContentItems

    AppContentIndexListener
        ContentItemStatusChanged

    AppManagedImageQueryMatch
    ContentItemErrorDetail
        IndexCorruption

    ContentItemReindexingStatus
        Unspecified

    QueryContentItemsFilterFlags

• Uproszczona umowa licencyjna z jaśniejszymi warunkami tworzenia aplikacji przez niezależnych dostawców oprogramowania z Windows ML.
• Zrestrukturyzowane sekcje dotyczące instalacji, danych i kodu dystrybucyjnego o lepszej przejrzystości.
• Sekcja Powiadomienie o zgodności nowego dostawcy wykonywania (EP) wyjaśnia obowiązki deweloperów dotyczące dostawców wykonywania przyspieszonego sprzętowo.
• Bezpośrednie linki do umów licencyjnych dostawcy dla nvidia TensorRT, Intel OpenVINO i Qualcomm QNN (Qualcomm Neural Network SDK).

• Eksperymentalne kompilacje Windows ML są zgodne z główną wersją 1.24 środowiska uruchomieniowego ONNX, co poprawia zgodność i stabilność.
• Dostawcy realizacji stabilnego interfejsu binarnego aplikacji (ABI) są zobligowani do zapewnienia przewidywalnego zachowania między urządzeniami, podczas gdy niestabilni dostawcy realizacji są wykluczani z pozyskiwania.
  • Obsługiwany jest tylko dostawca wykonywania OpenVINO, a dodatkowi dostawcy będą dodawani z czasem, gdy spełnią wymagania dotyczące stabilności.
• Rozmiar Microsoft.Windows.AI.MachineLearning.dll został zmniejszony o około 160 KB.

• Nowe eksperymentalne interfejsy API do wyszukiwania statystyk indeksowanych elementów. Zapewnia to wgląd w to, co dzieje się w indeksie.
• Obsługa anulowania zapytania w celu umożliwienia aplikacjom uruchamiania zapytania i aktualizowania go, jeśli istnieje nowe zapytanie przed ukończeniem bieżącego zapytania. Pozwala to na szybsze odpowiadanie na zapytanie w trakcie wpisywania go przez użytkownika.
• Obsługa dopasowywania prefiksów dla krótkich ciągów w celu poprawy wyników w miarę pisania przez użytkownika.

• Narzędzie VideoScaler jest teraz zbywalne, ulepszając zarządzanie zasobami i kontrolę nad cyklem życia.
• Model vsR jest teraz kompilowany i buforowany w celu zwiększenia wydajności i zmniejszenia powtarzających się kosztów inicjowania.
• Przed użyciem dodano sprawdzanie możliwości w celu zweryfikowania obsługi usługi VSR.
• Jawne inicjowanie WinML nie jest już wymagane w przypadku korzystania z funkcji Super Resolution dla wideo.

• Kontrolka FlowLayout używa teraz terminologii ItemSpacing i LineSpacing zamiast właściwości odstępów poziomych i pionowych. Wyrównane nazewnictwo zwiększa przejrzystość i spójność z nowoczesnymi wzorcami układu w strukturach interfejsu użytkownika.

• Kontrolka WrapPanel używa teraz właściwości ItemSpacing i LineSpacing zamiast poprzednich właściwości odstępów poziomych i pionowych.

• Zaimplementowano interfejs IXamlPredicate, aby zdefiniować niestandardowe predykaty, które bezproblemowo integrują się ze składnią warunkowej przestrzeni nazw XAML i są oceniane podczas analizy XAML.
• Niestandardowe predykaty umożliwiają warunkowe scenariusze XAML oparte na czynnikach specyficznych dla aplikacji, takich jak:
  • Flagi funkcjonalności
  • Możliwości urządzenia
  • Logika biznesowa
  • Ustawienia konfiguracji
  • Inne warunki środowiska uruchomieniowego

• Zaktualizowano pakiety, aby umożliwić użyteczność zewnętrzną, która obejmuje zmiany w następujących elementach:
  • Microsoft.UI.DCPP.Zależności.Minimalne
  • Microsoft.UI.DCPP.Dependencies.Edge
  • ExpPointerPointStatics
• Dodano obsługę kompilacji dla Visual Studio 2026
• Wprowadzono narzędzia i skrypty do użycia przez zewnętrznych deweloperów do tworzenia i testowania interfejsu WinUI.

• [przestarzałe] DependencyObject.Dispatcher
• [przestarzałe] Window.Current
• [wycofany] FocusManager.GetFocusedElement
• [zmieniono nazwę] SystemBackdropHost do elementu SystemBackdropElement

• [zmieniono nazwę] Microsoft.Windows.AI.Search.Experimental.AppContentIndex na Microsoft.Windows.Search.AppContentIndex

• Usunięto błędy "Klasa niezarejestrowana" podczas korzystania z wdrożenia samodzielnego z Windows ML. Deweloperzy korzystający z samodzielnego wdrożenia nie muszą już rejestrować wszystkich klas aktywowalnych pakietu Foundation, które były używane wewnętrznie.
• Naprawiono potencjalne awarie występujące podczas zamykania procesu podczas korzystania z usługi Windows ML.
• Naprawiono ścieżkę routingu interfejsu API, ImageForegroundExtractor aby wywołania dotarły do poprawnego punktu końcowego.
• Upewnij się, że postęp instalacji i pobierania dostawcy wykonywania jest poprawnie przekazywany do aplikacji podczas wdrażania pakietu.
• Naprawiono awarię w SystemBackdrop przy rozłączeniu elementu docelowego, chroniąc przed nieprawidłowymi ścieżkami rozłączenia.
• Rozwiązano problem uniemożliwiający udostępnianie interfejsów API sztucznej inteligencji Windows dla niektórych aplikacji.

Ta wersja zawiera następujące nowe i zmodyfikowane eksperymentalne interfejsy API w porównaniu z 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

• Regresja środowiska uruchomieniowego ONNX powoduje, że funkcja Video Super Resolution kończy się niepowodzeniem na urządzeniach Qualcomm. Planowana aktualizacja dostawcy obsługi wykonawczej Qualcomm NPU rozwiązuje ten problem.

Nowa eksperymentalna kontrolka SplitMenuFlyoutItem została zaprojektowana w celu zapewnienia doświadczenia z przyciskiem podziału w menu wysuwanym. Ta kontrolka umożliwi deweloperom uwidocznienie domyślnej akcji głównej, a jednocześnie oferuje dodatkowe opcje za pośrednictwem podmenu, idealne do redukcji złożonych funkcji do mniejszego rozmiaru, skracając ogólną długość menu.

Wraz z możliwościami menuFlyoutItem i MenuFlyoutSubItem kontrolka jest dostarczana z dwiema innymi właściwościami: SubMenuPresenterStyle i SubMenuItemStyle, która umożliwia dostosowanie podmenu, na przykład przy użyciu kontrolki GridView dla prezentera podmenu.

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

Przemianowane typy

• Zmieniono nazwę WinMLCatalogModel na ModelCatalog
• Zmieniono nazwę CatalogModelSource na ModelCatalogSource

Aktualizacje metody

• CatalogModelInfo: Zmieniono GetInstance nazwę na GetInstanceAsync
• ModelCatalogSource: Zmieniono CreateFromUri nazwę na CreateFromUriAsync
• ModelCatalog: Zmieniono FindModel nazwę na FindModelAsync
• ModelCatalog: Zmieniono FindAllModels nazwę na FindAllModelsAsync

Zmiany właściwości

• Zaktualizowano CatalogModelInfo.Size do CatalogModelInfo.ModelSizeInBytes

Aktualizacje zachowania

• Pobierz wystąpienie z CatalogModelInstanceResult za pomocą .GetInstance()
• CatalogModelStatus Teraz zwraca wartość Ready lub NotReady na podstawie dostępności lokalnej
• Dodano CatalogModelInstanceStatus, aby oddzielić stan wystąpienia od stanu modelu

Ulepszenia CatalogModelInfo

• Zmieniono nazwę Alias na Name
• Zmieniono nazwę Revision na Version
• Dodano Publisher
• Usunięte DisplayName

Zmiany w formacie JSON

• Zmieniono alias nazwę na id.
• Usunięto modelType i description.
• Zmieniono executionProvider nazwę na executionProviders.
• Zaktualizowano executionProviders jako tablicę obiektów JSON zamiast listy rozdzielanej przecinkami.

Dodatkowe zmiany

• ModelCatalog teraz zwraca listę dostawców wykonywania (EPS) podczas tworzenia wystąpienia.
• Dodano obsługę Windows 10 (1809) i nowszych.
• Dodano obsługę plików lokalnych, w tym zarówno zwykłych plików, jak i pakietów MSIX.
• Naprawiono awarie spowodowane nieprawidłowym kodem JSON wykazu.

• Poprzedni AppIndexQuery typ, który obejmował GetNextTextMatches i GetNextImageMatches metody, został podzielony na dwa odrębne typy: AppIndexTextQuery i AppIndexImageQuery. Metoda AppContentIndexer.CreateQuery została zastąpiona przez: CreateTextQuery i CreateImageQuery.

• Te metody teraz zwracają AppIndexTextQuery i AppIndexImageQuery odpowiednio. Aby uprościć użycie, zaktualizowano również typy opcji:

  • Usunięto: AppIndexQueryOptions, TextMatchOptions i ImageMatchOptions
  • Dodano: TextQueryOptions i ImageQueryOptions

• Interfejsy API w AppContentIndex przestrzeni nazw, które wcześniej zwracały tablice, teraz zwracają IVectorView dla lepszej spójności i wydajności.

• Metoda AppContentIndexer.WaitForIndexingIdleAsync została zaktualizowana w celu zaakceptowania parametru TimeSpan zamiast liczby całkowitej, zapewniając jaśniejszą i bardziej elastyczną obsługę limitu czasu.

Interfejs VideoScaler API zapewnia ulepszenia wideo w czasie rzeczywistym dzięki zaawansowanej skalowaniu sztucznej inteligencji zoptymalizowanej pod kątem strumieni z udziałem osób w konwersacji. Dzięki temu deweloperzy mogą udostępniać ostrzejsze, jaśniejsze wizualizacje na platformach konferencji, przesyłania strumieniowego i edytowania, nawet w przypadku słabych warunków sieciowych. Interfejs API obsługuje dostosowywanie rozdzielczości danych wyjściowych, szybkości klatek i regionów zainteresowania, zgodność z wieloma formatami wideo, w tym BGR, RGB i NV12.

Nowe API RewriteCustomAsync pozwala na określenie ciągu wejściowego, który kieruje Phi Silica w przekształcaniu wybranego tekstu. Możesz eksperymentować z nowymi stylami kreatywnymi, takimi jak "Goofy" lub "Pirate", aby natychmiast przekształcić swoją zawartość.

Klasa ImageGenerator wykorzystuje stabilne modele dyfuzji, aby zapewnić zaawansowane możliwości generowania obrazów. Obsługuje scenariusze wielokrotnego generowania:

• Tekst do obrazu: Generowanie obrazów na podstawie opisowych monitów tekstowych.

• Obraz do obrazu: Przekształć istniejące obrazy na podstawie opisów tekstu.

• Wypełnienie magiczne: Wypełnij zamaskowane regiony obrazów zawartością wygenerowaną przez sztuczną inteligencję.

• Styl książki kolorowej: Generowanie obrazów w stylu książki kolorowania.

• Zmiana stylu: Zmień styl artystyczny istniejących obrazów, zachowując strukturę.

Wszystkie wygenerowane obrazy są zwracane w formacie RGB8 za pomocą obiektów ImageBuffer . Interfejs API zawiera wbudowane filtry bezpieczeństwa zawartości i obsługuje dostosowywalne parametry generowania.

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");
    }
}

Ta wersja zawiera następujące nowe i zmodyfikowane eksperymentalne interfejsy API w porównaniu do wersji 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

• Naprawiono obliczenie pola ograniczenia podczas obracania tekstu. W niektórych okolicznościach tekst OCR pasujący do obrazów zgłaszał niedokładne lub puste granice regionu, gdy tekst został obrócony.

Interfejsy API AppContentIndexer umożliwiają deweloperom efektywne indeksowanie zawartości aplikacji, w tym tekstu i obrazów w celu szybkiego i odpowiedniego pobierania. Obsługa wyszukiwania zarówno leksykalnych (opartych na słowach kluczowych) jak i semantycznych (opartych na znaczeniu), te interfejsy API umożliwiają aplikacjom szybkie dostarczanie odpowiednich wyników na podstawie intencji i kontekstu użytkownika, a nie tylko dokładnych słów kluczowych.

Ta funkcja umożliwia odblokowanie następujących zaawansowanych scenariuszy:

• Wyszukiwanie semantyczne
  Aplikacje mogą zwracać wyniki na podstawie intencji i znaczenia, a nie dokładnych dopasowań słów kluczowych.
  Przykład: Zapytanie dotyczące "osi czasu projektu" może zawierać zawartość, która zawiera wzmiankę "schedule" lub "delivery dates" , nawet jeśli te dokładne słowa nie zostały użyte.
• Generowanie wspomagane wyszukiwaniem (RAG)
  Indeksowana zawartość może służyć jako baza wiedzy do generowania modeli sztucznej inteligencji. Gdy użytkownik zadaje pytanie, aplikacja pobiera najbardziej odpowiednie dokumenty lub fragmenty kodu z jego indeksu i przekazuje je do modelu, umożliwiając dokładne odpowiedzi z uwzględnieniem kontekstu uziemione w rzeczywistych danych.

Interfejsy API wykazu modeli Windows ML umożliwiają aplikacji lub bibliotece dynamiczne odnajdywanie i pobieranie dużych plików modelu sztucznej inteligencji z własnych katalogów modeli online, eliminując konieczność tworzenia pakietów tych dużych plików bezpośrednio z aplikacją lub biblioteką. Wykaz modeli pomaga zapewnić zgodność urządzeń, filtrując modele i pobierając tylko te, które mają zastosowanie do określonego urządzenia Windows w użyciu.

Najnowsza aktualizacja Microsoft.Windows.Storage.Pickers usprawnia wybór plików i folderów, umożliwiając deweloperom ustawianie początkowych i trwałych lokalizacji folderów oraz grupowanie filtrów typów plików z przejrzystymi etykietami, aby ułatwić nawigację.

Interfejs PopupAnchor API teraz umożliwia DesktopPopupSiteBridge obsługę pozycjonowania względnego przez zakotwiczenie do własnego okna lub wyspy, co pozwala rozwiązać problem, w którym wyskakujące okienka można było ustawić wyłącznie przy użyciu współrzędnych ekranu.

Interfejs InputUnderlyingWindowController API umożliwia deweloperom wyznaczenie docelowego HWND do odbierania komunikatów wejściowych, które zostały pierwotnie wysłane do obszaru ContentIsland utworzonego na podstawie elementu SystemVisual (zobacz ContentIsland.CreateForSystemVisual).

SystemBackdropHost umożliwia umieszczenie tła systemu (akrylowe/mica) w dowolnym miejscu w drzewie wizualnym aplikacji.

Jest WrapPanel panelem układu XAML WinUI, który rozmieszcza elementy podrzędne w sekwencji od lewej do prawej. Elementy przekraczające długość linii zostaną automatycznie przeniesione do następnego wiersza na końcu panelu, który je zawiera. Jest to przydatne w przypadku układów dynamicznych.

Jest to port istniejącej kontrolki Windows Community Toolkit.

Ta wersja zawiera następujące nowe i zmodyfikowane eksperymentalne interfejsy API w porównaniu do wersji 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 Interfejsy API powinny być wywoływane z wątku w tle. Użycie go w wątku interfejsu użytkownika może powodować zawieszanie się aplikacji lub długie przerwy, wpływając na doświadczenie użytkownika.
• Wyniki zapytania przy użyciu AppIndexQuery.GetNextTextMatches i AppIndexQuery.GetNextImageMatches przyjmą wartość null, jeśli nie ma dopasowań, zamiast pustej listy.
• Dopasowania obrazów za pomocą AppManagedImageQueryMatch.Subregion na podstawie wartości OCR mogą czasami być niedokładne, szczególnie gdy tekst jest obracany lub zniekształcony.
• Dopasowania obrazów przy użyciu AppManagedImageQueryMatch.Subregion mogą czasami zawierać prostokąty o zerowych wymiarach lub bardzo małe prostokąty, co prowadzi do niedokładnych wyników.
• Puste zapytanie z AppContentIndex.CreateQuery może zgłosić wyjątek.

Interfejsy API katalogu modeli Windows ML umożliwiają aplikacji lub bibliotece dynamiczne pobieranie dużych plików modelu sztucznej inteligencji z własnych katalogów modeli online bez konieczności wysyłania tych dużych plików bezpośrednio do aplikacji lub biblioteki. Ponadto katalog modeli pomoże filtrować modele zgodne z urządzeniem Windows, na którym działa, tak aby odpowiedni model został pobrany na urządzenie.

Najważniejsze korzyści:

• Dodawanie wykazów: dodawanie jednego lub wielu wykazów online
• Odnajdywanie zgodnych modeli: automatyczne znajdowanie modeli, które współpracują ze sprzętem użytkownika i dostawcami wykonawczymi
• Pobieranie modeli: pobieranie i przechowywanie modeli z różnych źródeł
• Udostępnianie modeli między aplikacjami: jeśli wiele aplikacji korzysta z tego samego źródła wykazu, modele będą współużytkowane na dysku bez duplikowania plików do pobrania

• Rozwiązano problem w narzędziu DeploymentManager, który powodował, że niepoprawnie zgłaszał polecenie PackageInstallRequired w niektórych przypadkach.

Ta wersja zawiera następujące nowe i zmodyfikowane eksperymentalne interfejsy API:

Microsoft.UI.Composition

    CompositionNotificationDeferral
    CompositionProjectedShadow
        MaxOpacity
        MinOpacity
        OpacityFalloff

    CompositionProjectedShadowCaster
        AncestorClip
        Mask

    CompositionProjectedShadowDrawOrder
    CompositionProjectedShadowReceiver
        DrawOrder
        Mask

Microsoft.UI.Composition.Experimental

    ExpCompositionVisualSurface
    ExpExpressionNotificationProperty
    IExpCompositionPropertyChanged
    IExpCompositionPropertyChangedListener
    IExpCompositor
    IExpVisual

Microsoft.UI.Content

    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