Windows アプリ SDK 1.2 の試験段階チャネル リリース ノート

  • [アーティクル]

重要

実験的チャネルは、運用環境での使用ではサポートされていません。また、実験的リリースを使用するアプリを Microsoft Store に公開することはできません。

実験的チャネルでは、開発の初期段階にある実験的チャネル機能を含む Windows App SDK のリリースが提供されます。 実験的機能の API には、Experimental 属性があります。 コードで実験的 API を呼び出した場合は、ビルド時の警告が表示されます。 実験的チャネル内のすべての API は、将来のリリースで重要な変更が加えられる可能性がありますが、特に実験的 API が変更されます。 実験的な機能は、次期リリースから削除される場合や、リリースされない場合があります。

重要なリンク:

最新の試験段階チャネル リリース ノート:

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

バージョン 1.2 実験 (1.2.0-experimental2)

これは、実験的チャネルの最新リリースです。 すべての試験段階チャネル機能と、バージョン 1.2 Preview 1 (1.2.0-preview1) の機能がサポートされます。

ダウンロードするには、WinAppSDK NuGet のバージョンを 1.2.220909.2-experimental2 に再ターゲットします。

修正された問題

今後の Windows Insider Preview ビルドでは、Windows アプリ SDK を使用するアプリケーションの起動に 失敗します。

バージョン 1.2 実験 (1.2.0-experimental1)

これは、実験的チャネルの最新リリースです。 すべての実験的チャネル機能がサポートされています。

ダウンロードするには、WinAppSDK NuGet のバージョンを 1.2.220727.1-experimental1 に再ターゲットします。

入力 & 合成

Windows App SDK 0.8 で初めて導入された Microsoft.UI.Input.Experimental 名前空間と Microsoft.UI.Composition.Experimental 名前空間には、いくつかの実験的なクラスがあります。

このリリースの新機能:

  • InputPointerSource には、新しい静的ファクトリ GetforWindowId があります。

コンテンツ

このリリースの新機能として、Microsoft.UI.Content 名前空間の実験的クラスは対話型コンテンツのレポート パーツを提供します。 これらは低レベルのプリミティブであり、エンド ユーザーに対話型エクスペリエンスを提供するためにコンテンツに組み立てることができます。 このコンテンツは、アニメーションを使用した出力の表示、さまざまなターゲットでの入力の処理、アクセシビリティ表明および保証の提供、ホスト状態の変更点の処理という構造を定義します。

注目すべきAPI:

  • ContentIsland - 出力、入力、アクセシビリティをまとめ、対話型コンテンツの要約を提供します。 カスタム ビジュアル ツリーは、これらの API を使用して構築して対話型にコンストラクトすることができます。
  • DesktopChildSiteBridge- を HWND ベースの階層に接続できるようにします。

詳細については、「GitHub のサンプル」を参照してください。

ディスパッチする

DispatcherQueue が再入可能としてディスパッチされるようになりました。 以前は、一度に 1 つのスレッドで 1 つの DispatcherQueueHandler コールバックをアクティブにすることはできませんでした。 ここで、ハンドラーが入れ子になったメッセージ ポンプを開始すると、追加のコールバックが再入可能としてディスパッチされます。 これは、ウィンドウ メッセージと入れ子になったメッセージ ポンプに関する Win32 ビヘイビアーと一致します。

通知

アプリ通知のアプリ表示名とアイコンの登録がサポートされるようになりました。 詳細については、「GitHub の仕様」を参照してください。

WinUI 3

  • WinUI 2.8 リリースでは、コントロールとスタイルが最新の状態になります。
  • 実験的リリースでは、UWP はサポートされなくなりました。

その他の制限事項と既知の問題

  • ABI で破壊的変更が発生したため、Windows アプリ SDK 1.2-experimental1 に更新した後、アプリを再構築する必要があります。
  • WebView2 に依存するパッケージ (Microsoft.Identity.Client など) を参照するアプリはビルドに失敗します。 これは、ビルド時のバイナリの競合が原因です。 詳細については、GitHub の issue 2492 を参照してください。
  • WinAppSDK C# クラス ライブラリ プロジェクトで dotnet build を使うと、ビルド エラー "Microsoft.Build.Packaging.Pri.Tasks.ExpandPriContent タスクを読み込めませんでした" が表示されることがあります。 この問題を解決するには、プロジェクト ファイルで <EnableMsixTooling>true</EnableMsixTooling> を設定します。
  • 既定の WinAppSDK テンプレートでは、MaxVersionTested="10.0.19041.0" ですが、本来は "10.0.22000.0" にする必要があることに注意してください。 一部の機能 (特に UnlockedDEHs) を完全にサポートするには、プロジェクト ファイルの MaxVersionTested を "10.0.22000.0" に更新します。