Windows 應用程式 SDK 的最新預覽通道版本資訊

發行項
08/24/2024

重要

預覽通道已經不支援使用在生產環境，且使用預覽版本的應用程式無法發布到 Microsoft Store。

預覽通道包含 Windows 應用程式 SDK 版本，其中包括處於開發後期階段的預覽通道功能。預覽版本不包含實驗性功能和 API，但在下一個穩定版本之前仍可能會發生重大變更。

重要連結：

如果想要將現有應用程式從舊版的 Windows 應用程式 SDK 升級至較新版本，請參閱將現有專案更新至最新版本的 Windows 應用程式 SDK。
如需預覽版本相關文件，請參閱 Windows 應用程式 SDK 預覽與實驗通道的安裝工具。

預覽通道版本資訊封存：

1.6 版 Preview 2 （1.6.0-preview2）

這是 1.6 版的預覽通道最新版本。

在現有的 Windows 應用程式 SDK 1.5（從穩定通道）應用程式中，您可以將 Nuget 套件更新為 1.6.0-preview2（請參閱使用 NuGet 封裝管理員在 Visual Studio 中安裝和管理套件一節）。

如需更新的執行階段和 MSIX，請參閱 Windows 應用程式 SDK 的下載項目。

新功能

1.6-preview2 的必要 C# 項目變更

此版本也需要來自 1.6-preview1 的 C# 專案指引。

支援原生 AOT

1.6-preview2 包含更新至發行的 Microsoft.Windows.CsWinRT 2.1.1 版的重大變更，並讓建置更可靠的原生預先編譯。

已更新 Edge WebView2 SDK 整合

此版本現在參考發行的 Microsoft.Web.WebView2 1.0.2651.64 版套件，這應該可修正 1.6-preview1 中所參考發行前版本所遇到的問題。如 1.6-preview1 中所述，應用程式現在可以視需要選擇較新版本的 Microsoft.Web.WebView2 套件。

錯誤修正

1.6-preview2 包含自 1.6-preview1 版本以來的下列新修正：

已修正在 .xaml 中設定 InfoBar.IsOpen 時的當機。如需詳細資訊，請參閱 GitHub 問題 #8391。
修正當滑鼠移至界限外 WebView2 時，HTML 元素會遺失指標擷取的問題。如需詳細資訊，請參閱 GitHub 問題 #8677。
已修正使用拖放到飛出視窗 ShouldConstrainToRootBounds=false 無法運作的問題。如需詳細資訊，請參閱 GitHub 問題 #9276。
已修正啟用時PublishSingleFile參考無法運作的問題ms-appx://。如需詳細資訊，請參閱 GitHub 問題 #9468。
已修正某些二進位檔調試程式符號無法正常運作的問題。如需詳細資訊，請參閱 GitHub 問題 #4633。
已修正使用 /permissive-時的建置中斷。如需詳細資訊，請參閱 GitHub 問題 #4643。
已修正由重新命名參數所造成1.6-preview1中的幾個 API 中斷性變更。如需詳細資訊，請參閱 GitHub 問題 #4645。
已修正 1.6-preview1 中某些項目的類型衝突建置中斷，特別是類型 Windows.UI.Text 。如需詳細資訊，請參閱 GitHub 問題 #4646。
已修正 1.6-preview1 中控件連結庫的資源查閱問題。如需詳細資訊，請參閱 GitHub 問題 #4649。
已修正子類別 NavigationView化時的潛在損毀。
已修正卷動或減少數據表大小時，中的表格框線 RichEditBox 無法正確清除的問題。
已修正來自 MediaTransportControls 的飛出視窗具有完全透明背景的問題。
已修正拖曳至 WebView2 會在 100% 以外的顯示縮放比例或啟用系統文字調整時，於顯示縮放比例錯誤的位置失敗或下降的問題。
已修正當輸入因為限制而封鎖輸入時，不會向輔助功能工具宣告的問題TextBoxRichEditBox/。MaxLength

1.6 版 Preview 1 （1.6.0-preview1）

這是 1.6 版的預覽通道最新版本。

在現有的 Windows 應用程式 SDK 1.5（從穩定通道）應用程式中，您可以將 Nuget 套件更新為 1.6.0-preview1（請參閱使用 NuGet 封裝管理員在 Visual Studio 中安裝和管理套件一節）。

如需更新的執行階段和 MSIX，請參閱 Windows 應用程式 SDK 的下載項目。

新功能

注意

我們在 1.6-experimental1 中發行的新 TitleBar 控件尚未在 1.6 的非實驗性組建中提供，可讓更多時間評估及回應社群意見反應。我們在這裡收到了很多很棒的輸入，並希望確保我們花一點時間解決它。

1.6-preview1 的必要 C# 項目變更

在 1.6-preview1 中，Windows 應用程式 SDK 受控應用程式需要 Microsoft.Windows.SDK.NET.Ref *.*.*.38，其可透過檔案csproj中的 WindowsSdkPackageVersion 指定。例如：

<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
       <OutputType>WinExe</OutputType>
       <TargetFramework>net8.0-windows10.0.22621.0</TargetFramework>
       <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
       <WindowsSdkPackageVersion>10.0.22621.38</WindowsSdkPackageVersion>
   <PropertyGroup>
   ...

此外，Windows 應用程式 SDK 受控應用程式應該更新為 Microsoft.Windows.CsWinRT 2.1.1 （或更新版本）。

支援原生 AOT

原生預先編譯現在支援 .NET PublishAot 項目屬性。如需原生 AOT 的詳細資訊，請參閱原生 AOT 部署。因為 AOT 是以修剪支援為基礎而建置，因此 1.6-experimental1 版本中先前所述的大部分修剪相關指引也適用於。如需詳細資訊，請參閱原生 AOT 支援。

如上所述，C# 項目應該具有Microsoft.Windows.CsWinRT 2.1.1（或更新版本）的套件參考。此版本包含 AOT 安全ICustomPropertyProvider實作。搭配此支援使用的型別應以 WinRT.GeneratedBindableCustomProperty 屬性標示，並進行 partial。

已變更 Edge WebView2 SDK 整合

Windows 應用程式 SDK 現在會使用Edge WebView2 SDK作為 NuGet 參考，而不是內嵌Edge WebView2 SDK 硬式編碼版本。新的模型可讓應用程式選擇較新版本的Microsoft.Web.WebView2套件，而不是受限於建置 Windows 應用程式 SDK的版本。新的模型也允許應用程式參考也會參考Edge WebView2 SDK的 NuGet 套件。如需詳細資訊，請參閱 GitHub 問題 #5689。

新的套件部署 API

套件管理 API 已收到數個增強功能，包括 Is*ReadyOrNewerAvailable*（）、EnsureReadyOptions.RegisterNewerIfAvailable、Is*Provisioned*（）、IsPackageRegistrationPending（），以及數個錯誤修正。如需詳細資訊，請參閱 PackageManagement.md 和提取要求 #4453 。

改善的 TabView 索引標籤卸除

TabView 支援新的 CanTearOutTabs 模式，提供將索引標籤拖曳到新視窗的增強體驗。啟用這個新選項時，Tab 拖曳非常像是 Edge 和 Chrome 中的索引標籤拖曳體驗，其中會在拖曳期間立即建立新的視窗，讓使用者將其拖曳到螢幕邊緣，以最大化或貼齊視窗的一個平滑動作。此實作也不會使用拖放 API，因此不會受到這些 API 中任何限制的影響。值得注意的是，以系統管理員身分執行的程式支援索引標籤卸除。

其他值得注意的變更

我們新增了新的 ColorHelper.ToDisplayName() API，填補了 UWP 的空白。
已新增類別 Microsoft.Windows.Globalization.ApplicationLanguages ，其中特別包含新功能 PrimaryLanguageOverride 。如需詳細資訊，請參閱 GitHub 問題 #4523。
未密封 ItemsWrapGrid。這應該是回溯相容的變更。
PipsPager 支援可在第一個和清單項目之間換行的新模式。
RatingControl 現在透過將一些硬式編碼樣式屬性移至主題資源，可更自定義。這可讓應用程式覆寫這些值，以更妥善地自定義 RatingControl 的外觀。

已知問題

如果調試程式設定為在所有C++例外狀況上中斷，它會在BCP47 （Windows Globalization）程式代碼的啟動時中斷一對嘈雜的例外狀況。

錯誤修正

修正了處理自定義標題欄案例的幾個問題。如需詳細資訊，請參閱 GitHub 問題 #7629、 #9670、 #9709 和 #8431。
已修正無法看見圖示的問題 InfoBadge 。如需詳細資訊，請參閱 GitHub 問題 #8176。
已修正圖示有時會在中的 CommandBarFlyout錯誤位置顯示的問題。關於更多資訊，請參閱 GitHub 問題 #9409。
已修正在功能表開啟或關閉子功能表時鍵盤焦點的問題。如需詳細資訊，請參閱 GitHub 問題 #9519。
已修正回收專案時使用不正確IsExpanded狀態的問題TreeView。如需詳細資訊，請參閱 GitHub 問題 #9549。
已修正在中使用 ItemsRepeater.ItemTemplateElementName 系結時的問題。如需詳細資訊，請參閱 GitHub 問題 #9715。
已修正有時位置不正確時，第一個項目 ItemsRepeater 的問題。如需詳細資訊，請參閱 GitHub 問題 #9743。
已修正有時中斷輸入到min/max/close 按鈕的問題 InputNonClientPointerSource 。如需詳細資訊，請參閱 GitHub 問題 #9749。
已修正搭配 clang-cl 使用 Microsoft.UI.Interop.h 時的編譯錯誤。如需詳細資訊，請參閱 GitHub 問題 #9771。
已修正事件無法在中ComboBox/TextBox運作的問題。CharacterReceived 如需詳細資訊，請參閱 GitHub 問題 #9786。
修正了 1.6 實驗性組建中的問題，其中的指標輸入行為 CanTearOutTabs 在與 100% 不同的縮放比例的監視器上不正確。如需詳細資訊，請參閱 GitHub 問題 #9791。
修正了 1.6-experimental2 組建中的問題，其中某些語言翻譯有字元編碼問題 ColorHelper.ToDisplayName()。
已修正 1.6-experimental1 NumberBox 中未使用正確前景和背景色彩的問題。如需詳細資訊，請參閱 GitHub 問題 #9714。
已修正箭號鍵和索引標籤索引鍵引發重複 KeyUp 事件的問題。如需詳細資訊，請參閱 GitHub 問題 #9399。
已修正無法取得 SystemSuspendStatus事件的問題PowerManager.SystemSuspendStatusChanged。如需詳細資訊，請參閱 GitHub 問題 #2833。
已修正當這是視窗唯一控制件時，未正確指定 WebView2 初始鍵盤焦點的問題。
已修正當使用 ExtendsContentIntoTitleBar=true Min/Max/Close 按鈕未正確出現在使用者介面自動化時的問題，導致語音存取無法顯示這些按鈕的數位。
已修正應用程式因非預期重新進入而在鎖定檢查中當機的問題。
修正切換至高對比度主題時，色彩未正確更新的問題 Hyperlink 。
已修正在背景視窗中變更的集合 ListView 可能會不正確地將該視窗移至前景並取得焦點的問題。
已修正 1.6-experimental1 的問題：類別庫專案中的 .xaml 設定 AcrylicBrush.TintLuminosityOpacity 會當機，並出現類型轉換錯誤。
已修正呼叫 ItemsRepeater.StartBringIntoView 有時可能會導致專案消失的問題。
已修正在中ButtonScrollViewer觸控和拖曳會讓其處於已按下狀態的問題。
已更新 IntelliSense，其中遺漏許多較新類型和成員的資訊。
已修正在空白區域中 ScrollViewer 按兩下時，一律會將焦點移至中的 ScrollViewer 第一個可設定焦點控制件，並將該控件捲動到檢視中的問題。如需詳細資訊，請參閱 GitHub 問題 #597。
已修正事件有時會引發多次的問題 Window.Activated 。如需詳細資訊，請參閱 GitHub 問題 #7343。
已修正設定 NavigationViewItem.IsSelected 屬性以防止 true 其子系在展開時顯示的問題。如需詳細資訊，請參閱 GitHub 問題 #7930。
已修正無法正確顯示具有 None 或 DropShadow 邊緣效果的標題的問題MediaPlayerElement。如需詳細資訊，請參閱 GitHub 問題 #7981。
已修正顯示飛出視窗時未使用屬性的問題 Flyout.ShowMode 。如需詳細資訊，請參閱 GitHub 問題 #7987。
已修正有時會有四捨五入錯誤的問題 NumberBox 。如需詳細資訊，請參閱 GitHub 問題 #8780。
已修正使用針對舊版 WinAppSDK 編譯的連結庫可能會發生嘗試尋找類型或屬性時發生錯誤的問題。如需詳細資訊，請參閱 GitHub 問題 #8810。
已修正啟動視窗時未設定初始鍵盤焦點的問題。如需詳細資訊，請參閱 GitHub 問題 #8816。
修正了第一次顯示之後無法運作的問題 FlyoutShowMode.TransientWithDismissOnPointerMoveAway 。如需詳細資訊，請參閱 GitHub 問題 #8896。
已修正某些控制件未正確範本系結 Foreground 和 Background 屬性的問題。如需詳細資訊，請參閱 GitHub 問題 #7070、 #9020、 #9029、 #9083 和 #9102。
修正了 setter 中VisualStateManager所使用的不會在主題變更時更新的問題ThemeResource。這在飛出視窗中通常受影響的控件。如需詳細資訊，請參閱 GitHub 問題 #9198。
WebView已修正會失去主要焦點的問題，導致額外的模糊/焦點事件和其他問題。如需詳細資訊，請參閱 GitHub 問題 #9288。
已修正在偵錯輸出中顯示系結錯誤的問題 NavigationView 。如需詳細資訊，請參閱 GitHub 問題 #9384。
修正了定義負面檢視框的SVG檔案不再轉譯的問題。如需詳細資訊，請參閱 GitHub 問題 #9415。
已修正變更 ItemsView.Layout 方向導致移除項目的問題。如需詳細資訊，請參閱 GitHub 問題 #9422。
已修正捲 ScrollView 動產生大量偵錯輸出的問題。如需詳細資訊，請參閱 GitHub 問題 #9434。
已修正無法正常運作的問題 MapContorl.InteractiveControlsVisible 。如需詳細資訊，請參閱 GitHub 問題 #9486。
已修正事件未正確引發的問題 MapControl.MapElementClick 。如需詳細資訊，請參閱 GitHub 問題 #9487。
已修正在使用弱式參考之前，x：Bind 未檢查 Null 的問題，這可能會導致當機。如需詳細資訊，請參閱 GitHub 問題 #9551。
已修正變更 TeachingTip.Target 屬性未正確更新其位置的問題。如需詳細資訊，請參閱 GitHub 問題 #9553。
已修正下拉式清單未在 WebView2 中回應的問題。如需詳細資訊，請參閱 GitHub 問題 #9566。
已修正使用 GeometryGroup時的記憶體流失。如需詳細資訊，請參閱 GitHub 問題 #9578。
修正在中捲動大量專案ItemRepeaterScrollView可能會導致空白轉譯畫面的問題。如需詳細資訊，請參閱 GitHub 問題 #9643。
已修正無法運作的問題 SceneVisual 。

1.6.0-preview1 中的新 API

1.6-preview1 版包含下列與穩定 1.5 版相比的新 API：

Microsoft.UI

    ColorHelper
        ToDisplayName

Microsoft.UI.Input

    EnteredMoveSizeEventArgs
    EnteringMoveSizeEventArgs
    ExitedMoveSizeEventArgs
    InputNonClientPointerSource
        EnteredMoveSize
        EnteringMoveSize
        ExitedMoveSize
        WindowRectChanged
        WindowRectChanging

    MoveSizeOperation
    WindowRectChangedEventArgs
    WindowRectChangingEventArgs

Microsoft.UI.Xaml

    XamlRoot
        CoordinateConverter

Microsoft.UI.Xaml.Automation.Peers

    ScrollPresenterAutomationPeer

Microsoft.UI.Xaml.Controls

    PipsPager
        WrapMode
        WrapModeProperty

    PipsPagerWrapMode
    TabView
        CanTearOutTabs
        CanTearOutTabsProperty
        ExternalTornOutTabsDropped
        ExternalTornOutTabsDropping
        TabTearOutRequested
        TabTearOutWindowRequested

    TabViewExternalTornOutTabsDroppedEventArgs
    TabViewExternalTornOutTabsDroppingEventArgs
    TabViewTabTearOutRequestedEventArgs
    TabViewTabTearOutWindowRequestedEventArgs

Microsoft.Windows.Globalization

    ApplicationLanguages

Microsoft.Windows.Management.Deployment

    EnsureReadyOptions
        RegisterNewerIfAvailable

    PackageDeploymentFeature
    PackageDeploymentManager
        IsPackageDeploymentFeatureSupported
        IsPackageProvisioned
        IsPackageProvisionedByUri
        IsPackageReadyOrNewerAvailable
        IsPackageReadyOrNewerAvailableByUri
        IsPackageSetProvisioned
        IsPackageSetReadyOrNewerAvailable

    PackageReadyOrNewerAvailableStatus

Microsoft.Windows.Storage

    ApplicationData
    ApplicationDataContainer
    ApplicationDataContract
    ApplicationDataCreateDisposition
    ApplicationDataLocality

共用方式為

Windows 應用程式 SDK 的最新預覽通道版本資訊

1.6 版 Preview 2 （1.6.0-preview2）

新功能

1.6-preview2 的必要 C# 項目變更

支援原生 AOT

已更新 Edge WebView2 SDK 整合

錯誤修正

1.6 版 Preview 1 （1.6.0-preview1）

新功能

1.6-preview1 的必要 C# 項目變更

支援原生 AOT

已變更 Edge WebView2 SDK 整合

新的套件部署 API

改善的 TabView 索引標籤卸除

其他值得注意的變更

已知問題

錯誤修正

1.6.0-preview1 中的新 API

其他資源

共用方式為

Windows 應用程式 SDK 的最新預覽通道版本資訊

1.6 版 Preview 2 （1.6.0-preview2）

新功能

1.6-preview2 的必要 C# 項目變更

支援原生 AOT

已更新 Edge WebView2 SDK 整合

錯誤修正

1.6 版 Preview 1 （1.6.0-preview1）

新功能

1.6-preview1 的必要 C# 項目變更

支援原生 AOT

已變更 Edge WebView2 SDK 整合

新的套件部署 API

改善的 TabView 索引標籤卸除

其他值得注意的變更

已知問題

錯誤修正

1.6.0-preview1 中的新 API

相關主題

其他資源