共用方式為

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

  • 發行項

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

重要連結：

最新穩定通道版本：

Windows 應用程式 SDK 的下載項目

注意

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

版本 1.3.3 (1.3.230724000)

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

  • 已修正當對話方塊關閉時，滑鼠有時會停止運作的問題。
  • 已修正系統的套件版本不相符而導致應用程式無法安裝的部署問題。 如需詳細資訊，請參閱 GitHub 問題 #3740。
  • 已修正 Windows 應用程式 SDK 1.3 的操作功能表位置受到影響的問題。
  • 已修正部分 WinUI3 應用程式在某些情況下會因 XAML 過早自動關閉而跟著關閉時造成當機的問題。
  • 已修正字型圖示並未正確將由右至左的語言鏡像處理的問題。 如需詳細資訊，請參閱 GitHub 問題 #7661。
  • 已修正資源因順序不良而中斷時，應用程式會當機的問題。 如需詳細資訊，請參閱 GitHub 問題 #7924。

版本 1.3.2 (1.3.230602002)

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

  • 已修正設定受保護的指標時會當機的問題。
  • 已修正應用程式啟動期間的 XamlMetadataProvider 效能問題。 如需詳細資訊，請參閱 GitHub 問題 #8281。
  • 已修正 RichTextBlock 的超連結和觸控問題。 如需詳細資訊，請參閱 GitHub 問題 #6513。
  • 已修正 WebView2 的捲動和觸控板問題。 如需詳細資訊，請參閱 GitHub 問題 #7772。
  • 已修正 Windows 應用程式 SDK 的更新有時需要重新啟動 Visual Studio 的問題。 如需詳細資訊，請參閱 GitHub 問題 #3554。
  • 已修正執行偵錯工具時，關機會產生有雜訊的例外狀況的問題。

版本 1.3.1 (1.3.230502000)

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

  • 已修正內容為 Null 時，設定 SystemBackdrop 會導致應用程式當機的問題。 如需詳細資訊，請參閱 GitHub 問題 #8416。
  • 已修正以 1.3.0 中的新功能設定 XAML 的視窗標題時會導致應用程式當機的問題。 如需詳細資訊，請參閱 GitHub 問題 #3689。
  • 已修正視窗內容變更時焦點錯誤的問題。
  • 已修正使用 WinAppSDK 1.3 專案範本建立 C++ 專案的問題。
  • Visual Studio Marketplace 的已更新範本

版本 1.3 的新功能和更新功能以及已知問題

下列各節說明 1.3 版的新功能、更新功能和已知問題。

在現有的 Windows 應用程式 SDK 1.2 應用程式中，您可以將 Nuget 套件更新為 1.3.230331000 (請參閱使用 NuGet 套件管理員 在 Visual Studio 安裝和管理套件中的更新套件一節)。

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

XAML 背景 API

透過 XAML 視窗中內建的屬性，Mica & Background Acrylic 背景現在可以更輕鬆地在 WinUI 3 應用程式中使用。 如需 Xaml 背景屬性的詳細資訊，請參閱系統背景和雲母背景 API 文件。

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

更換數行重複使用程式碼後，您現在已可直接透過 Window.AppWindow 從視窗使用 AppWindow API。

來自 WinAppSDK 的新功能

  • ApplicationModel.DynamicDependency：PackageDependency.PackageGraphRevisionId 替換已棄用的 MddGetGenerationId。
  • 環境管理員：EnvironmentManager.AreChangesTracked 告知您是否能夠在應用程式中追蹤環境管理員的變更。
  • 參照的 Static/ThemeResource 查詢無法解析時，會引發新事件 DebugSettings.XamlResourceReferenceFailed。 此事件允許存取詳細說明架構在何處搜尋該金鑰的追蹤，以便您更好地調試 Static & ThemeResource 查找失敗。 如需詳細資訊，請參閱 GitHub 的追蹤 XAML 資源參照查詢失敗 API 規格。

其他更新

已知問題

由於 Xaml 編譯器最近的變更，升級至 1.3 的現有專案可能會在 Visual Studio 當中遇到類似如下的組建錯誤：

> C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.3.230331000**\buildTransitive\Microsoft.UI.Xaml.Markup.Compiler.interop.targets(537,17): error MSB4064: The "PrecompiledHeaderFile" parameter is not supported by the "CompileXaml" task loaded from assembly: Microsoft.UI.Xaml.Markup.Compiler, Version=1.0.0.0, Culture=neutral, PublicKeyToken=de31ebe4ad15742b from the path: C:\Users\user\\.nuget\packages\microsoft.windowsappsdk\\**1.2.230118.102**\tools\net472\Microsoft.UI.Xaml.Markup.Compiler.dll. Verify that the parameter exists on the task, the <UsingTask> points to the correct assembly, and it is a settable public instance property.

這個問題會發生，是因為 Visual Studio 使用 1.2 的快取 Xaml 編譯器工作 dll，但使用 1.3 的不相容 MSBuild 邏輯來驅動，如上述錯誤文字所示。 解決辦法是關閉 Visual Studio 再重新啟動，然後重新載入解決方案。