次の方法で共有

Windows App SDK 1.3 の安定チャネルリリースノート

安定チャネルは、運用環境のアプリで使用するためにサポートされている Windows アプリ SDK のリリースを提供します。 Windows App SDK の安定したリリースを使用するアプリは、Microsoft Store にも公開できます。

重要なリンク:

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

Windows App SDK 用のダウンロード

注

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 でのコンテキスト メニューの配置に影響する問題を修正しました。
  • 一部の WinUI3 アプリが、XAML のシャットダウンが早すぎるため、アプリが閉じられたときにクラッシュする問題を修正しました。
  • 右から左の言語でフォント アイコンが正しくミラーリングされない問題を修正しました。 詳細については、GitHub の問題 #7661を参照してください。
  • リソースが不適切な順序で切断されたときに、シャットダウン時にアプリがクラッシュする問題を修正しました。 詳細については、GitHub の問題 #7924を参照してください。

バージョン 1.3.2 (1.3.230602002)

これは、1.3 リリースの重要なバグ修正を含む Windows App SDK のサービス リリースです。

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

バージョン 1.3.1 (1.3.230502000)

これは、1.3 リリースの重要なバグ修正を含む Windows App SDK のサービス リリースです。

  • コンテンツが null の場合に SystemBackdrop を設定するときにアプリがクラッシュする問題を修正しました。 詳細については、GitHub の問題 #8416を参照してください。
  • 1.3.0 で追加された新機能である XAML でウィンドウ タイトルを設定すると、アプリがクラッシュする問題を修正しました。 詳細については、GitHub の問題 #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 App SDK のダウンロード」を参照してください。

XAML 背景 API

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

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

いくつかの定型コード行を置き換えることで、 Windows から Window.AppWindow まで直接 AppWindow API を使用できるようになりました。

WinAppSDK 全体の新機能

  • ApplicationModel.DynamicDependency: 非推奨の MddGetGenerationId を置き換える PackageDependency.PackageGraphRevisionId。
  • 環境マネージャー: EnvironmentManager.AreChangesTracked、環境マネージャーへの変更をアプリケーションで追跡できるかどうかを通知します。
  • 参照先の Static/ThemeResource 参照を解決できない場合に、新しいイベント DebugSettings.XamlResourceReferenceFailed が発生するようになりました。 このイベントは、静的および ThemeResource 参照エラーをより適切にデバッグできるようにするために、フレームワークがそのキーを検索した場所を詳しく示すトレースへのアクセスを提供します。 詳細については、GitHub 上の API 仕様にある XAML リソース参照エラーのトレース を参照してください。

その他の更新

  • このリリースで対処されるその他の問題については、WinAppSDK GitHub で WinAppSDK 1.3 マイルストーン を参照してください。
  • このリリースで対処されるその他の問題については、microsoft-ui-xaml GitHub の WinAppSDK 1.3 マイルストーン の WinUI 3 を参照してください。
  • 最新の試験段階の VSIX を使用すると、プロジェクト ファイルではなく Visual Studio メニューを使用して、パッケージ化されていないアプリとパッケージ化されたアプリの間でアプリを変換できるようになりました。

既知の問題

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 を使用していますが、上記のエラー テキストに示すように、互換性のない MSBuild ロジックを 1.3 から実行した場合に発生します。 回避策は、Visual Studio をシャットダウンして再起動し、ソリューションを再読み込みすることです。