Windows App SDK 的穩定通道版本資訊

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

目前提供下列穩定通道版本:

如果您想要將現有的應用程式從舊版 Windows app sdk 升級為較新的版本,請參閱將現有專案更新為最新版本的 Windows app sdk

注意

Windows 的 App SDK 先前是由程式碼名稱 Project 的留尼旺島 所已知。 某些 SDK 資產(例如 VSIX 擴充功能和 NuGet 套件)仍會使用程式碼名稱,但這些資產將在未來的版本中重新命名。 當您參考現有的資產或指定的先前版本時,檔的某些區域仍會使用 Project 的留尼旺島

版本0。8

穩定通道的最新可用版本是服務版本0.8.2。

0.8.5 版

這是 Windows App SDK 的服務版本,其中包含更多0.8.0 版版本的重大 bug 修正。

錯誤修正

  • 已修正造成 WinUI apps 使用 指標輸入 損毀的問題。
  • 修正導致標題列按鈕 (min、max、close) 在 Windows 11 上沒有圓角的問題。
  • 修正當滑鼠停留在 Windows 11 上的 [最大化/還原] 按鈕時,造成調整大小配置選項不會出現的問題。
  • 修正在建立 PointCollection 物件時造成損毀例外狀況的問題。 如需詳細資訊,請參閱 Github 上的 問題 971

版本0.8 的限制和已知問題也適用于版本0.8.5 版,除非在 下一節中標示為另一個。

0.8.4 版

這是 Windows App SDK 的服務版本,其中包含更多0.8.0 版版本的重大 bug 修正。

錯誤修正

  • 修正自訂標題列,使 ContentDialog 不會涵蓋它,而標題列按鈕則會四捨五入。
  • 修正顯示比例變更時,影像處理損毀的問題。
  • 修正 UI 消失或裁剪錯誤的裁剪錯誤

版本0.8 的限制和已知問題也適用于版本0.8.4,除非在 下一節中標示為另一個。

0.8.3 版

這是 Windows App SDK 的服務版本,其中包含更多0.8.0 版版本的重大 bug 修正。

錯誤修正

當視窗的最小化並已還原時,鍵盤焦點就會遺失,需要按一下滑鼠才能還原焦點。

版本0.8 的限制和已知問題也適用于版本0.8.3,除非在 下一節中標示為另一個。

0.8.2 版

這是 Windows App SDK 的服務版本,其中包含更多0.8.0 版版本的重大 bug 修正。

錯誤修正

  • WindowsVisual Studio 2022 Preview 2 和更新版本現在支援 App SDK 和 WinUI 3。
  • 針對 .NET 應用程式,您可能會在傳入列舉陣列時收到下列錯誤: Object contains non-primitive or non-blittable data.
  • 使用文字方塊內的手寫面板撰寫時,會造成損毀
  • 圖示/影像一律會以其100% 的縮放值載入,而不是根據監視器規模值
  • <T> EventSource 的垃圾收集會導致取消訂閱處理常式的後續失敗 (如需詳細資料,請參閱 GitHub 問題)
  • 安全性修正–如需詳細資訊,請參閱 CVE-2021-34533
  • SwapChainPanel 在變更顯示比例之後,有時會傳回不正確的 CompositionScale 值

版本0.8 的限制和已知問題也適用于版本0.8.2,除非在 下一節中標示為另一個。

0.8.1 版

這是 Windows App SDK 的服務版本,其中包含0.8.0 版版本的一些重大 bug 修正。

錯誤修正

  • WindowsApp SDK 無法在最新的 Windows 測試人員組建上執行
  • 輸入未出現在下拉式清單中的值時,EditableComboBox 損毀
  • WebView2 在獲得焦點之後,不允許使用者 tab 鍵
  • Windows 的完整資格。WinUI 產生的程式碼中的 DefaultOverload 命名空間,以避免命名空間不明確
    • 這會修正 bug #5108
  • 安全性修正–如需詳細資訊,請參閱 CVE-2021-34489

版本0.8 的限制和已知問題也適用于版本0.8.1 版,除非在 下一節中標示為另一個。

0.8.0 版

新功能和更新

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

WinUI 3

此版本包含許多 bug 修正,以及跨 WinUI 3 改善穩定。 這些都是 WinUI 3 中的所有新變更,因為 WinUI 3 Project 的0.5 版:

  • 已將 Pivot 控制項新增回,並且現在可以在任何 WinUI 3 應用程式中使用。

  • 此版本包含 Project 留尼旺島0.5.5、v 0.5.6 和 v 0.5.7 的所有 bug 修正。

  • 新的 bug 修正,包括:

    • 在文字方塊中以滑鼠右鍵按一下滑鼠右鍵時,應用程式會損毀
    • NavigationView 導致 UWP 中的損毀,留尼旺島0.5 預覽
    • ProgressBar 不會顯示已暫停和錯誤選項之間的差異
    • 複製/貼上/變更文字樣式時 RichEditBox 損毀
    • 當未設定 SetTitleBar 或 null 時,視窗標題按鈕會錯置

    如需此版本所解決之 bug 的完整清單,請參閱 我們的 GitHub 存放庫。

  • ColorHelper.ToDisplayNameAPI 已無法使用。

  • 下列是已移除的類型:

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

    請改用 Windows.Graphics.IGeometrySource2DWindows.Graphics.IGeometrySource2DInterop

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

  • AcrylicBrush.BackgroundSource 移除屬性,因為 HostBackdrop BackgroundSource 在 WinUI 3 中不支援做為。

如需有關 WinUI 的詳細資訊,請參閱Windows UI 3 程式庫 (WinUI)

若要查看作用中的 WinUI 3 控制項和功能,您可以從 GitHub複製並建立 WinUI 3 控制項資源庫應用程式,或從 Microsoft Store下載應用程式。

若要開始使用 WinUI 進行開發,請參閱下列文章:

DWriteCore

此版本的 DWriteCore 包含下列新功能和更新功能。 DWriteCore 會在 DWriteCore 總覽中引進和描述。

注意

DWriteCoreCreateFactory的功能與系統版 DirectWrite 所匯出的 DWriteCreateFactory函式相同。 DWriteCore 函式具有不同的名稱,以避免在您同時連結和時出現不明確的情況 DWriteCore.lib DWrite.lib

如需 DWriteCore 和 DirectWrite api 參考,請參閱DWriteCore api 參考DirectWrite api 參考

MRTCore

  • 當您將資源新增至專案時,會自動設定資源的 組建動作 ,以減少手動專案設定的需求。

限制

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

  • 傳統型應用程式 (c # .NET 5 或 c + + desktop) :此版本僅支援在桌面應用程式中使用, (c + + 或 c # 搭配使用 MSIX 封裝的 .NET 5) 。 若要在未封裝的桌面應用程式中使用 Windows App SDK,您必須使用實驗性釋放通道

  • UWP 應用程式:在生產環境中使用的 UWP 應用程式不支援此版本。 若要在 UWP 應用程式中使用 Windows App SDK,您必須使用實驗性釋放通道

已知問題

  • WinUI 3 工具(例如,即時視覺化樹狀結構、即時屬性瀏覽器,以及0.8 版和更新版本中的熱重新載入)需要 Visual Studio 2019 16.11 Preview 3 或更新版本。

  • 目前使用 WinUI 3 和 Windows App SDK 0.8 的應用程式無法使用使用 Project 留尼旺島0.5 的類別庫。 更新類別庫以使用 Windows App SDK 0.8。

  • .NET 應用程式必須以組建18362或更高版本為目標:您的 TFM 必須設為 NET 5.0-windows 10.0.18362 或更高版本,而且您的封裝專案必須設定為18362或更高版本。 如需詳細資訊,請參閱#921 GitHub 問題

  • 在淺色與深色模式之間切換時,您可能會遇到損毀。

  • 針對 .NET 應用程式,當您傳入列舉陣列時,可能會收到下列錯誤: Object contains non-primitive or non-blittable data. 0.8.2 版本已修正此 問題。

  • 針對 .NET 應用程式,目前沒有任何方法可以選擇不使用 Visual Studio UI 將索引編制為應用程式資源的映射。 若要解決這個問題,請新增一個目錄, (請參閱自訂您的組建-Visual Studio以取得專案) 的指示,並移除 () s 的影像,如下所示:

    • 若要移除特定的映射 (請注意,需要相對路徑) :

      <Project> 
      <ItemGroup> 
          <Content Remove="..\Bitmap1.bmp" />
      </ItemGroup>
      </Project>
      
    • 若要移除以中繼資料為基礎的影像:

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

    此問題的修正計畫在即將推出的版本中,將不再需要上述的因應措施。

版本0。5

最新的可用服務版本為 0.5.7

新功能和更新

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

已知的問題及限制

此版本具有下列限制和已知問題:

  • 傳統型 應用程式 (c # .net 5 或 c + + Desktop):此版本僅支援在桌面應用程式中使用, (c + + 或 c # 搭配使用 MSIX 封裝的 .net 5) 。 若要在未封裝的桌面應用程式中使用 Windows App SDK,您必須使用實驗性釋放通道
  • Uwp 應用程式:在生產環境中使用的 uwp 應用程式不支援此版本。 若要在 UWP 應用程式中使用 Windows App SDK,您必須使用實驗性發行通道中的版本。
  • .Net 應用程式必須以組建18362或更高 版本為目標:您的 TFM 必須設定為 net5.0-windows10.0.18362 或更高版本,而且您的封裝專案 <TargetPlatformVersion> 必須設定為18362或更高版本。 如需詳細資訊,請參閱GitHub 的已知問題