Windows 應用程式 SDK 0.8 的穩定通道版本資訊

穩定通道提供的 Windows 應用程式 SDK 版本可支援生產環境的應用程式使用。 使用穩定版 Windows 應用程式 SDK 的應用程式也可以發布至 Microsoft Store。

重要連結：

• 如果想要將現有應用程式從舊版的 Windows 應用程式 SDK 升級至較新版本，請參閱將現有專案更新至最新版本的 Windows 應用程式 SDK。

最新穩定通道版本：

• Windows 應用程式 SDK 的最新穩定通道版本資訊

Windows 應用程式 SDK 的下載項目

注意

Windows 應用程式 SDK Visual Studio 延伸模組 (VSIX) 不再以獨立下載的形式發布。 它們改在 Visual Studio 內 的Visual Studio Marketplace 提供。

第 0.8 版

Windows 應用程式 SDK 穩定通道 0.8.x 譜系最新的可用版本是 0.8.12 版。

注意

Windows 應用 SDK 以前是以代號 Project Reunion 來稱呼。 0.8 版和更早版本中的某些 SDK 資產仍使用這個代號。 在參考現有資產或特定舊版時，文件中某些區域仍使用 Project Reunion。

第 0.8.12 版

這是 Windows 應用程式 SDK 的維修版本，其中包含 0.8.0 版的重要錯誤修正。

注意

如果您是 C# 開發人員，您需要下列其中一個 .NET SDK 版本：5.0.213、5.0.407、6.0.104、6.0.202 (或之後的版本)。 若要更新 .NET SDK 版本，請前往 .NET 下載項目或更新至 Visual Studio 最新版。 在沒有所需 .NET SDK 版本的情況下更新 NuGet 套件時，您會看到如下的錯誤：「此版本的 WindowsAppSDK 需要 .NET 6+ 和 WinRT.Runtime.dll 1.6 版或更高的版本。」

錯誤修正 (0.8.12)

• 已修正內含 SwapChainPanel 或 WebView2 的應用程式會因存取違規而意外當機的問題。

第 0.8.11 版

這是 Windows 應用程式 SDK 的維修版本，其中包含 0.8.0 版的重要錯誤修正。

注意

如果您是 C# 開發人員，您需要下列其中一個 .NET SDK 版本：5.0.213、5.0.407、6.0.104、6.0.202 (或之後的版本)。 若要更新 .NET SDK 版本，請前往 .NET 下載項目或更新至 Visual Studio 最新版。 在沒有所需 .NET SDK 版本的情況下更新 NuGet 套件時，您會看到如下的錯誤：「此版本的 WindowsAppSDK 需要 .NET 6+ 和 WinRT.Runtime.dll 1.6 版或更高的版本。」

錯誤修正 (0.8.11)

• 已修正使用滑鼠選取文字時觸發焦點遺失事件的迴歸問題。

第 0.8.10 版

這是 Windows 應用程式 SDK 的維修版本，其中包含 0.8.0 版的重要錯誤修正。

注意

如果您是 C# 開發人員，您需要下列其中一個 .NET SDK 版本：5.0.213、5.0.407、6.0.104、6.0.202 (或之後的版本)。 若要更新 .NET SDK 版本，請前往 .NET 下載項目或更新至 Visual Studio 最新版。 在沒有所需 .NET SDK 版本的情況下更新 NuGet 套件時，您會看到如下的錯誤：「此版本的 WindowsAppSDK 需要 .NET 6+ 和 WinRT.Runtime.dll 1.6 版或更高的版本。」

錯誤修正 (0.8.10)

• 已修正應用程式有時會在拖放操作中當機的問題。

注意

Windows 應用程式 SDK 0.8.9 並未發布。 在 0.8.8 之後直接發布的版本是 0.8.10。

第 0.8.8 版

這是 Windows 應用程式 SDK 的維修版本，其中包含 0.8.0 版的重要錯誤修正。

注意

如果您是 C# 開發人員，您需要下列其中一個 .NET SDK 版本：5.0.213、5.0.407、6.0.104、6.0.202 (或之後的版本)。 若要更新 .NET SDK 版本，請前往 .NET 下載項目或更新至 Visual Studio 最新版。 在沒有所需 .NET SDK 版本的情況下更新 NuGet 套件時，您會看到如下的錯誤：「此版本的 WindowsAppSDK 需要 .NET 6+ 和 WinRT.Runtime.dll 1.6 版或更高的版本。」

錯誤修正 (0.8.8)

• 已修正 TextBox 中與軟式鍵盤和一般互動有關的觸控輸入問題。 這些問題也會影響鍵盤捷徑。 如需詳細資訊，請參閱 GitHub 的問題 6291。
• 已修正應用程式視窗有時會在使用中時顯示為非使用中的問題。
• 已修正 UIA (使用者介面自動化) 在外部程序執行造成的效能問題。
• 已修正手寫筆輸入的應用程式穩定性問題。
• 已修正 UIA 造成功能表的 png 圖示轉譯大幅延遲的問題。

第 0.8.7 版

這是 Windows 應用程式 SDK的維修版本，其中包含多項 C#/.NET 應用程式的效能更新。 若要更新至此版本，務必參照最新的 Windows SDK 套件版本。 若要執行此動作，請以您的應用程式從 TargetFramework 屬性指定的 SDK 版本，將屬性 <WindowsSdkPackageVersion>10.0.<sdk_version>.24</WindowsSdkPackageVersion> 新增到 .csproj 檔案。 例如：

<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
       <OutputType>WinExe</OutputType>
       <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
       <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
       <WindowsSdkPackageVersion>10.0.19041.24</WindowsSdkPackageVersion>
   <PropertyGroup>
   ...

這個版本的 Windows SDK 投影將在即將推出的 .NET 6 維修版本中提供。 在該項 .NET SDK 更新可供使用之後，請從專案檔中移除 <WindowsSdkPackageVersion> 屬性。

如果您未設定此屬性，就會看到如下錯誤："Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.6 or greater."

第 0.8.6 版

這是 Windows 應用程式 SDK 的維修版本，其中包含多項 0.8.0 版 C#/.NET 應用程式的效能改良。

若要更新此版本的 Windows 應用程式 SDK，您必須安裝最新的 .NET SDK 12 月更新 (請參閱下載 .NET 和 .NET 5 將於 2022 年 5 月 10 日終止支援)。 如果您沒有安裝 .NET SDK 的最低必要版本，您會看到類似的錯誤 "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.4 or greater."

錯誤修正 (0.8.6)

如需詳細的效能改良清單，請參閱 C#/WinRT 1.4.1 版本資訊。

第 0.8.5 版

這是 Windows 應用程式 SDK 的維修版本，其中包含更多 0.8.0 版的重大錯誤修正。

錯誤修正 (0.8.5)

• 已修正 WinUI 應用程式使用指標輸入時當機的問題。
• 已修正 Windows 11 的標題列按鈕 (最小化、最大化、關閉) 沒有圓角的問題。
• 已修正在 Windows 11 上將滑鼠懸停在最大化/還原按鈕上方時，重設大小的版面配置選項不會顯示的問題。
• 已修正在建立 PointCollection 物件時發生當機例外狀況的問題。 如需詳細資訊，請參閱 GitHub 的問題 971。

除下節另有標註者之外，0.8 版的限制和已知問題也適用於 0.8.5 版。

第 0.8.4 版

這是 Windows 應用程式 SDK 的維修版本，其中包含更多 0.8.0 版的重大錯誤修正。

錯誤修正 (0.8.4)

• 已修正自訂標題列，讓 ContentDialog 不會遮蓋它，且標題列按鈕會有圓角。
• 已修正顯示比例變更時影像處理會當機的問題。
• 已修正 UI 消失或裁剪不正確的裁剪錯誤

除下節另有標註者之外，0.8 版的限制和已知問題也適用於 0.8.4 版。

第 0.8.3 版

這是 Windows 應用程式 SDK 的維修版本，其中包含更多 0.8.0 版的重大錯誤修正。

錯誤修正 (0.8.3)

將視窗最小化然後再還原時，鍵盤焦點會消失，需要點擊滑鼠才能復原焦點。

除下節另有標註者之外，0.8 版的限制和已知問題也適用於 0.8.3 版。

第 0.8.2 版

這是 Windows 應用程式 SDK 的維修版本，其中包含更多 0.8.0 版的重大錯誤修正。

錯誤修正 (0.8.2)

• Visual Studio 2022 Preview 2 和之後的版本現在已支援 Windows 應用程式 SDK 和 WinUI 3。
• 使用 .NET 應用程式時，您可能會在傳入列舉陣列時收到以下錯誤：Object contains non-primitive or non-blittable data.
• 在文字方塊內使用手寫面板來書寫會導致當機
• 圖示/影像始終以 100% 的比例值載入，而不是以監視器比例值為依據
• EventSource<T> 的垃圾集合會導致後續無法取消訂閱處理常式 (如需詳細資訊，請參閱 GitHub 問題)
• 安全性修正 – 如需詳細資訊，請參閱 CVE-2021-34533。
• SwapChainPanel.CompositionScaleChanged 有時會在變更顯示比例之後傳回不正確的 CompositionScale 值

除下節另有標註者之外，0.8 版的限制和已知問題也適用於 0.8.2 版。

0.8.1 版

這是 Windows 應用程式 SDK 的維修版本，其中包含少數 0.8.0 版的重大錯誤修正。

錯誤修正 (0.8.1)

• Windows 應用程式 SDK 無法在最新的 Windows 測試人員版本執行
• 輸入下拉式清單未顯示的值時，EditableComboBox 會當機
• WebView2 不允許使用者在收到焦點之後跳離
• 在 WinUI 產生的程式碼中完整限定 Windows.Foundation.Metadata.DefaultOverload 命名空間，避免命名空間不明確
  • 這會修正 Bug #5108。
• 安全性修正 – 如需詳細資訊，請參閱 CVE-2021-34489。

除下節另有標註者之外，0.8 版的限制和已知問題也適用於 0.8.1 版。

0.8.0 Stable 版

新增和更新功能

此版本支援所有穩定通道功能。

WinUI 3：

此版本包含許多 WinUI 3 的錯誤修正，並改善穩定性。 以下是 WinUI 3 - Project Reunion 0.5 發行以來，WinUI 3 的所有變更：

• 樞紐控制項已再度新增，現在已可用於任何 WinUI 3 應用程式。

• 此版本包含 Project Reunion v0.5.5、v0.5.6 和 v0.5.7 的所有錯誤修正。

• 新的錯誤修正包括：

  • 在文字方塊中按滑鼠右鍵，會導致應用程式損毀
  • NavigationView 會導致 UWP、Reunion 0.5 預覽版當機
  • ProgressBar 不會顯示 Paused 與 Error 選項之間的差異
  • 複製/貼上/變更文字樣式時 RichEditBox 當機
  • SetTitleBar 未設定或設為 Null 時，視窗標題按鈕會錯置

  如需此版本已解決的錯誤完整清單，請參閱我們的 GitHub 存放庫。

• ColorHelper.ToDisplayName API 已不再提供。

• 下列樣式已移除：

  • Microsoft.Graphics.IGeometrySource2D
  • Microsoft.Graphics.IGeometrySource2DInterop

  請改用 Windows.Graphics.IGeometrySource2D 和 Windows.Graphics.IGeometrySource2DInterop。

• 命名空間中的所有 Microsoft.System 類型都已移到 Microsoft.UI.Dispatching 命名空間，包括 DispatcherQueue 類別。

• 已移除 AcrylicBrush.BackgroundSource 屬性，因為 WinUI 3 不支援將 HostBackdrop 當作 BackgroundSource 使用。

如需 WinUI 詳細資訊，請參閱 WinUI。

若要查看執行中的 WinUI 3 控制項和功能，您可以從 GitHub 複製並組建 WinUI 3 程式庫應用程式，或從 Microsoft Store 下載應用程式。

如要開始使用 WinUI 進行開發，請參閱下列文章：

• Visual Studio 中的 WinUI 3 範本
• 建立您的第一個 WinUI 3 (Windows 應用程式 SDK) 專案
• 使用 WinUI 3 與 Win32 Interop 建置 C# .NET 應用程式 (機器翻譯)
• WinUI 3 API 參考資料

DWriteCore：

此版本的 DWriteCore 包含下列新功能和更新功能。 DWriteCore 概觀會介紹並說明 DWriteCore。

• DWriteCore 現在已支援使用底線—請參閱 IDWriteTextLayout::GetUnderline 和 IDWriteTextLayout::SetUnderline。
• 支援使用刪除線 — 請參閱 IDWriteTextLayout::GetStrikethrough 和 IDWriteTextLayout::SetStrikethrough。
• 支援透過 IDWriteTextLayout 使用垂直文字—請參閱垂直文字。
• 所有 IDWriteTextAnalyzer 和 IDWriteTextAnalyzer1 介面的方法都會實作。
• DWriteCoreCreateFactory 自由函式會建立 Factory 物件，可用於後續建立個別 DWriteCore 物件。

注意

DWriteCoreCreateFactory 的功能與 DirectWrite 系統版本匯出的 DWriteCreateFactory 函式相同。 DWriteCore 函式有不同的名稱，可避免在同時連結 DWriteCore.lib 和 DWrite.lib 時的模糊問題。

如需 DWriteCore 和 DirectWrite API 參考資料，請參閱 DWriteCore API 參考資料 和 DirectWrite API 參考資料。

MRT 核心：

• 將資源新增至專案時，資源的組建動作會自動設定，減少手動設定專案的必要。

限制

• Windows 測試人員計畫的開發人員通道目前不支援此版本。 此問題已在 0.8.1 版修正。

• 桌面應用程式 (C# 或 C++ 桌面)：此版本僅支援在使用 MSIX 封裝的桌面應用程式 (C++ 或 C#) 中使用。 若要在未封裝的桌面應用程式使用 Windows 應用程式 SDK，您必須使用實驗版發行通道。

重要

如果您正在處理 UWP 應用程式，請參閱從 UWP 移轉至 Windows 應用程式 SDK (機器翻譯)。

已知問題

• 即時視覺化樹狀結構、即時屬性總管和熱重新載入 0.8 版和之後的版本等 WinUI 3 工具需要 Visual Studio 2019 16.11 Preview 3 和之後的版本。

• 目前使用 WinUI 3 和 Windows 應用程式 SDK 0.8 的應用程式無法使用 Project Reunion 0.5 的類別庫。 請更新類別庫，以便使用 Windows 應用程式 SDK 0.8。

• .NET 應用程式必須指定 18362 版或之後的版本：您的 TFM 必須設定為 net6.0-windows10.0.18362 或之後的版本，且您的封裝專案必須設定為 18362 或之後的版本。 如需更多資訊，請參閱 GitHub 問題 #921。

• 如果頻繁在淺色和深色模式之間切換，您可能會遭遇當機。

• 針對 .NET 應用程式，您可能會在傳入列舉陣列時收到下列錯誤： Object contains non-primitive or non-blittable data. 這是在 0.8.2 版中修正的。

• 使用 .NET 應用程式時，目前沒有辦法選擇不讓系統將影像編入索引成為使用 Visual Studio UI 的應用程式資源。 若要解決此問題，請將 Directory.Build.targets 新增至專案 (請參閱 自訂您的組建 - Visual Studio 了解操作說明)，並移除影像，如下所示：

  • 若要移除特定影像 (請留意相對路徑為必要)：

    <Project>
    <ItemGroup>
        <Content Remove="..\Bitmap1.bmp" />
    </ItemGroup>
    </Project>
    

    • 若要根據中繼資料移除影像：

    <Project>
    <ItemGroup>
        <Content Remove="@(None->WithMetadataValue('Pack','true'))" />
    </ItemGroup>
    </Project>
    

    即將推出的版本預計會修正此問題 ，屆時上述解決辦法已不再需要。

相關主題

• Windows 應用程式 SDK 的最新預覽通道版本資訊
• Windows 應用程式 SDK 最新實驗通道版本資訊
• 安裝 Windows 應用程式 SDK 的工具 (機器翻譯)
• 建立您的第一個 WinUI 3 (Windows 應用程式 SDK) 專案
• 在現有的專案中使用 Windows 應用程式 SDK
• 部署概觀