Windows アプリ SDK 1.3 の安定版チャネル リリース ノート

  • [アーティクル]

安定チャネルでは、運用環境のアプリによる使用がサポートされている Windows App SDK のリリースが提供されます。 Windows App SDK の安定リリースが使用されるアプリは、Microsoft Store に発行することもできます。

重要なリンク:

最新の安定版チャネル リリース ノート:

Windows App SDK 用のダウンロード

Note

Windows アプリ SDK Visual Studio 拡張機能（VSIX）は、現在は個別のダウンロードとして配布されていません。 それらは、Visual Studio内のVisual Studio Marketplaceで利用可能です。

バージョン 1.3.3 (1.3.230724000)

これは、1.3 リリースの重大なバグの修正が含まれている Windows App SDK のサービス リリースです。

  • ダイアログ ボックスが閉じられたときにマウスが機能を停止する場合があった問題を修正しました。
  • システム上のパッケージ バージョンの不一致のためにアプリをインストールできなくなっていたデプロイの問題を修正しました。 詳細については、GitHub イシュー #3740 を参照してください。
  • Windows App SDK 1.3 でのコンテキスト メニューの配置に影響を与えている問題を修正しました。
  • XAML による自身のシャットダウンが早すぎるため、アプリが閉じられると (状況によっては) 一部の WinUI3 アプリがクラッシュする問題を修正しました。
  • 右から左に記述する言語でフォント アイコンが正しくミラーリングされなかった問題を修正しました。 詳細については、GitHub イシュー #7661 を参照してください。
  • リソースが不適切な順序で破棄された場合にシャットダウン時にアプリがクラッシュする問題を修正しました。 詳細については、GitHub イシュー #7924 を参照してください。

バージョン 1.3.2 (1.3.230602002)

これは、1.3 リリースの重大なバグの修正が含まれている Windows App SDK のサービス リリースです。

  • 保護されたカーソルを設定するときのクラッシュを修正しました。
  • アプリ起動時の XamlMetadataProvider のパフォーマンスの問題を修正しました。 詳細については、GitHub の issue #8281 を参照してください。
  • RichTextBlock のハイパーリンクとタッチに関する問題を修正しました。 詳細については、GitHub の issue #6513 を参照してください。
  • WebView2 のスクロールとタッチパッドに関する問題を修正しました。 詳細については、GitHub の issue #7772 を参照してください。
  • Windows App SDK の更新で Visual Studio の再起動が必要になることがある問題を修正しました。 詳細については、GitHub の issue #3554 を参照してください。
  • デバッガーで実行するときのシャットダウン時の煩雑な例外を修正しました。

バージョン 1.3.1 (1.3.230502000)

これは、1.3 リリースの重大なバグの修正が含まれている Windows App SDK のサービス リリースです。

  • コンテンツが null の場合に SystemBackdrop を設定すると、アプリがクラッシュする問題を修正しました。 詳細については、GitHub の issue #8416 を参照してください。
  • 1.3.0 で追加された新しい機能である XAML で Window タイトルを設定すると、アプリがクラッシュする問題を修正しました。 詳細については、GitHub の issue #3689 を参照してください。
  • コンテンツが変更されたときに、ウィンドウが適切にフォーカスを取得できない問題を修正しました。
  • WinAppSDK 1.3 プロジェクト テンプレートを使って C++ プロジェクトを作成する際に関する問題を修正しました。
  • Visual Studio Marketplace のテンプレートを更新しました

バージョン 1.3 の新機能と更新された機能および既知の問題

以下のセクションでは、バージョン 1.3 の新機能と更新された機能、既知の問題について説明します。

既存の Windows App SDK 1.2 アプリでは、Nuget パッケージを 1.3.230331000 に更新できます (「NuGet パッケージ マネージャーを使用して Visual Studio にパッケージをインストールして管理する」の「パッケージを更新する」セクションを参照してください)。

更新されたランタイムと MSIX については、「最新の Windows アプリ SDK ダウンロード」を参照してください。

XAML Backdrop API

XAML ウィンドウに組み込まれたプロパティにより、マイカと背景アクリルの背景が WinUI 3 アプリで使いやすくなりました。 Xaml Backdrop プロパティの詳細については、System Backdrop と Mica Backdrop の API ドキュメントを参照してください。

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

数行の定型コードを置き換えることで、Window.AppWindow を介して [ウィンドウ] から直接 AppWindow API を使用できるようになりました。

WinAppSDK 全体の新機能

  • ApplicationModel.DynamicDependency: 非推奨の MddGetGenerationId を置き換える PackageDependency.PackageGraphRevisionId。
  • Environment Manager: Environment Manager の変更をアプリケーションで追跡できるかどうかを通知する 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 をシャットダウンして再起動し、ソリューションを再度読み込むことです。