次の方法で共有

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

  • [アーティクル]

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

重要なリンク:

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

Windows App SDK 用のダウンロード

Note

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

バージョン 0.8

Windows App SDK の安定版チャネルの 0.8.x 系列で使用できる最新リリースはバージョン 0.8.12 です。

注意

Windows App SDK は、以前は Project Reunion というコード ネームで知られていました。 バージョン 0.8 以前の一部の SDK 資産では、引き続きこのコード ネームが使用されます。 ドキュメントの一部では、既存のアセットや指定された旧リリースを参照する際に、Project Reunion が引き続き使用されています。

バージョン 0.8.12

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

注意

C# 開発者の場合は、5.0.213、5.0.407、6.0.104、6.0.202 (またはそれ以降) の .NET SDK バージョン (またはそれ以降) のいずれかが必要です。 .NET SDK バージョンを更新するには、「.NET のダウンロード」を参照するか、Visual Studio の最新バージョンに更新してください。 必要な .NET SDK バージョンがない状態で NuGet パッケージを更新すると、次のようなエラーが表示されます: "このバージョンの WindowsAppSDK には WinRT.Runtime.dll バージョン 1.6 以降が必要です。"。

バグ修正 (0.8.12)

  • SwapChainPanel または WebView2 を使ったアプリが、アクセス違反により予測せずクラッシュする問題を修正しました。

バージョン 0.8.11

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

注意

C# 開発者の場合は、5.0.213、5.0.407、6.0.104、6.0.202 (またはそれ以降) の .NET SDK バージョン (またはそれ以降) のいずれかが必要です。 .NET SDK バージョンを更新するには、「.NET のダウンロード」を参照するか、Visual Studio の最新バージョンに更新してください。 必要な .NET SDK バージョンがない状態で NuGet パッケージを更新すると、次のようなエラーが表示されます: "このバージョンの WindowsAppSDK には WinRT.Runtime.dll バージョン 1.6 以降が必要です。"。

バグ修正 (0.8.11)

  • マウスでテキストを選んだときに、フォーカスの喪失イベントが発生する回帰を修正しました。

バージョン 0.8.10

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

注意

C# 開発者の場合は、5.0.213、5.0.407、6.0.104、6.0.202 (またはそれ以降) の .NET SDK バージョン (またはそれ以降) のいずれかが必要です。 .NET SDK バージョンを更新するには、「.NET のダウンロード」を参照するか、Visual Studio の最新バージョンに更新してください。 必要な .NET SDK バージョンがない状態で NuGet パッケージを更新すると、次のようなエラーが表示されます: "このバージョンの WindowsAppSDK には WinRT.Runtime.dll バージョン 1.6 以降が必要です。"。

バグ修正 (0.8.10)

  • ドラッグ アンド ドロップ操作中にアプリがクラッシュすることがある問題を修正しました。

注意

Windows App SDK 0.8.9 はリリースされませんでした。 0.8.8 の直後にリリースされたバージョンは 0.8.10 です。

バージョン 0.8.8

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

注意

C# 開発者の場合は、6.0.202、6.0.104、5.0.407、5.0.213 の .NET SDK バージョン (またはそれ以降) のいずれかが必要です。 .NET SDK バージョンを更新するには、「.NET のダウンロード」を参照するか、Visual Studio の最新バージョンに更新してください。 必要な .NET SDK バージョンがない状態で NuGet パッケージを更新すると、次のようなエラーが表示されます: "このバージョンの WindowsAppSDK には WinRT.Runtime.dll バージョン 1.6 以降が必要です。"。

バグ修正 (0.8.8)

  • ソフトキー ボードと一般的な相互作用に関する TextBox のタッチ入力の問題を修正しました。 これらの問題は、キーボード ショートカットにも影響していました。 詳細については、GitHub の issue 6291 を参照してください。
  • アプリのウィンドウがアクティブなときに非アクティブと表示されることがある問題を修正しました。
  • UIA (UI オートメーション) が外部プロセスで実行されることで発生するパフォーマンスの問題を修正しました。
  • ペン入力時のアプリの安定性に関する問題を修正しました。
  • UIA の影響により、メニューの png アイコンのレンダリングが大幅に遅延する問題を修正しました。

バージョン 0.8.7

これは、C#/.NET アプリケーションのいくつかのパフォーマンス更新を含む Windows App SDK のサービス リリースです。 このバージョンに更新するには、最新の Windows SDK パッケージのバージョンを参照する必要があります。 そのためには、.csproj ファイルに <WindowsSdkPackageVersion>10.0.<sdk_version>.24</WindowsSdkPackageVersion> プロパティを追加し、TargetFramework プロパティからアプリがターゲットとしている SDK バージョンを指定します。 次に例を示します。

<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
       <OutputType>WinExe</OutputType>
       <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
       <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
       <WindowsSdkPackageVersion>10.0.19041.24</WindowsSdkPackageVersion>
   <PropertyGroup>
   ...

このバージョンの Windows SDK プロジェクションは、今後の .NET 6 サービス リリースで使用できるようになる予定です。 その .NET SDK の更新プログラムがリリースされたら、プロジェクト ファイルから <WindowsSdkPackageVersion> プロパティを削除する必要があります。

このプロパティを設定しない場合、次のようなエラーが表示されます: "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.6 or greater."

バージョン 0.8.6

これは、0.8.0 リリースの C#/.NET アプリケーションのいくつかのパフォーマンス向上を含む Windows App SDK のサービス リリースです。

このバージョンの Windows App SDK に更新するには、最新の .NET SDK December 更新プログラムをインストールしておく必要があります (「.NET のダウンロード」と「.NET 5 は 2022 年 5 月 10 日にサポートが終了します」を参照してください)。 .NET SDK の最低限必要なバージョンがインストールされていない場合は、次のようなエラーが表示されます。 "Error: This version of Project Reunion requires WinRT.Runtime.dll version 1.4 or greater."

バグの修正 (0.8.6)

パフォーマンスの向上の詳細な一覧については、C#/WinRT 1.4.1 リリース ノートを参照してください。

バージョン 0.8.5

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

バグ修正 (0.8.5)

  • ポインター入力を使用する WinUI アプリがクラッシュする原因となっている問題を修正しました。
  • Windows 11 でタイトル バー ボタン (最小、最大、閉じる) の角が丸くなっていない問題を修正しました。
  • Windows 11 の最大化/復元ボタンにマウス ポインターを合わせたときにレイアウトのサイズ変更オプションが表示されない問題を修正しました。
  • PointCollection オブジェクトを作成する際のクラッシュ例外の原因となる問題を修正しました。 詳細については、Github の問題 971 を参照してください。

バージョン 0.8 の制限事項と既知の問題は、以下のセクションで特にマークされていない限り、バージョン 0.8.5 にも適用されます。

バージョン 0.8.4

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

バグ修正 (0.8.4)

  • ContentDialog によって隠されず、タイトル バーのボタンを丸くした、カスタム タイトル バーの修正。
  • 表示スケールが変更された場合の画像処理におけるクラッシュの修正。
  • UI が表示されない、または正しくクリップされないクリッピング バグの修正。

バージョン 0.8 の制限事項と既知の問題は、以下のセクションで特にマークされていない限り、バージョン 0.8.4 にも適用されます。

バージョン 0.8.3

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

バグ修正 (0.8.3)

ウィンドウを最小化してから復元するときにキーボード フォーカスが失われ、フォーカスを復元するためにマウス クリックが必要でした。

バージョン 0.8 の制限事項と既知の問題は、以下のセクションで特にマークされていない限り、バージョン 0.8.3 にも適用されます。

バージョン 0.8.2

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

バグ修正 (0.8.2)

  • Windows App SDK と WinUI 3 は、Visual Studio 2022 プレビュー 2 以降でサポートされるようになりました。
  • .NET アプリの場合、列挙型の配列を渡す際に次のエラーが発生する場合があります。Object contains non-primitive or non-blittable data.
  • テキスト ボックス内で手書きパネルを使用して書き込むと、クラッシュが発生します
  • アイコン/画像が、モニターのスケール値に基づくのではなく、常に 100% のスケール値で読み込まれます
  • EventSource<T> のガベージ コレクションにより、後続のハンドラーの登録を解除するためのエラーが発生します (詳細については、GitHub の問題ページを参照してください)
  • セキュリティ修正 – 詳細は、CVE-2021-34533 を参照してください。
  • 表示スケールを変更した後、SwapChainPanel.CompositionScaleChanged が正しくない CompositionScale 値を返す場合があります

バージョン 0.8 の制限事項と既知の問題は、以下のセクションで特にマークされていない限り、バージョン 0.8.2 にも適用されます。

バージョン 0.8.1

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

バグ修正 (0.8.1)

  • Windows App SDK が最新の Windows Insider ビルドで実行できない
  • ドロップダウンに表示されない値を入力すると、EditableComboBox でクラッシュする
  • WebView2 では、フォーカスを受け取った後、ユーザーが Tab キーを押して移動できない
  • 名前空間のあいまいさを回避するために、WinUI で生成されたコードの Windows.Foundation.Metadata.DefaultOverload 名前空間を完全修飾する
    • これにより、バグ #5108 が修正されました。
  • セキュリティ修正 – 詳細は、CVE-2021-34489 を参照してください。

バージョン 0.8 の制限事項と既知の問題は、以下のセクションで特にマークされていない限り、バージョン 0.8.1 にも適用されます。

バージョン 0.8.0 安定版

新機能と更新プログラム

このリリースでは、すべての安定チャネル機能がサポートされます。

WinUI 3:

このリリースには、WinUI 3 全体での多くのバグ修正と強化された安定化が含まれています。 これらは、WinUI 3 - Project Reunion 0.5 のリリース以降の WinUI 3 での新しいすべての変更点です。

  • ピボット コントロールが再度追加され、任意の WinUI 3 アプリで使用できます。

  • このリリースには、Project Reunion v0.5.5、v0.5.6、v0.5.7 のすべてのバグ修正が含まれています。

  • 次を含む新しいバグ修正。

    • TextBox 内でマウスを右クリックすると、アプリケーションがクラッシュする
    • NavigationView により、UWP でクラッシュが発生する (Reunion 0.5 Preview)
    • ProgressBar で一時停止とエラー オプションの違いが表示されない
    • テキスト スタイルのコピー/貼り付け/変更時に RichEditBox でクラッシュする
    • SetTitleBar が設定されていない場合、または null の場合、ウィンドウのキャプション ボタンが誤って配置される

    このリリースで解決されたすべてのバグの一覧については、GitHub リポジトリを参照してください。

  • ColorHelper.ToDisplayName API は使用できなくなりました。

  • 次の型が削除されました。

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

    代わりに、Windows.Graphics.IGeometrySource2D および Windows.Graphics.IGeometrySource2DInterop を使用してください。

  • Microsoft.System 名前空間内のすべての型が、DispatcherQueue クラスを含めて Microsoft.UI.Dispatching 名前空間に移動されました。

  • HostBackdrop は WinUI 3 では BackgroundSource としてサポートされないため、 AcrylicBrush.BackgroundSource プロパティが削除されました。

WinUI の詳細については、「WinUI」を参照してください。

WinUI 3 のコントロールと機能の動作を確認するには、GitHub から WinUI 3 ギャラリー アプリを複製してビルドするか、Microsoft Store からアプリをダウンロードします。

WinUI を使用して開発を開始するには、次の記事を参照してください。

DWriteCore:

DWriteCore のこのリリースには、次の新機能と更新された機能が含まれています。 DWriteCore の紹介と説明については、「DWriteCore の概要」を参照してください。

注意

DWriteCoreCreateFactory は、DirectWrite のシステム バージョンによってエクスポートされる DWriteCreateFactory 関数と機能的に同じです。 DWriteCore.lib と DWrite.lib の両方をリンクした場合のあいまいさ回避するために、DWriteCore には異なる名前が付いています。

DWriteCore と DirectWrite API リファレンスについては、「DWriteCore API リファレンス」と「DirectWrite API リファレンス」を参照してください。

MRTCore:

  • リソースをプロジェクトに追加すると、リソースのビルド アクションが自動的に設定されるため、プロジェクトを手動で構成する必要性が少なくなります。

制限事項

  • このリリースは、Windows Insider Program の Dev チャネルでは現在サポートされていません。 これはバージョン 0.8.1 で修正されています。

  • デスクトップ アプリ (C# または C++ デスクトップ): このリリースは、MSIX を使用してパッケージ化されたデスクトップ アプリ (C++ または C#) でのみ使用できます。 非パッケージ デスクトップ アプリで Windows App SDK を使用するには、試験的リリース チャネルを使用する必要があります。

重要

UWP アプリで作業している場合は、「UWP から Windows App SDK に移行する」を参照してください。

既知の問題

  • ライブ ビジュアル ツリー、ライブ プロパティ エクスプローラー、ホット リロードのバージョン 0.8 以降などの WinUI 3 ツールでは、Visual Studio 2019 16.11 プレビュー 3 以降が必要です。

  • 現在 WinUI 3 と Windows App SDK 0.8 を使用しているアプリでは、Project Reunion 0.5 を使用するクラス ライブラリを使用できません。 Windows App SDK 0.8 を使用するようにクラス ライブラリを更新してください。

  • .NET アプリはビルド 18362 以降をターゲットにする必要がある: TFM は、net6.0-windows10.0.18362 以降に設定する必要があり、パッケージ プロジェクトは 18362 以降に設定する必要があります。 詳細については、GitHub の問題 #921 を参照してください。

  • ライト モードとダーク モードの切り替えを頻繁に行うと、クラッシュが発生する可能性があります。

  • .NET アプリの場合、列挙型の配列を渡すと、次のエラーが表示されることがあります。 Object contains non-primitive or non-blittable data. これはバージョン 0.8.2 で修正。

  • .NET アプリの場合、現在、Visual Studio UI を使用してアプリ リソースとしてインデックスが取得されるイメージをオプトアウトする方法はありません。 この問題を回避するには、Directory.Build.targets をプロジェクトに追加し (手順については「ビルドをカスタマイズする- Visual Studio」を参照してください)、次のようにしてイメージを削除します。

    • 特定のイメージを削除するには (相対パスが必要であることに注意してください):

      <Project>
<ItemGroup>
    <Content Remove="..\Bitmap1.bmp" />
</ItemGroup>
</Project>
      • メタデータに基づいてイメージを削除するには:
      <Project>
<ItemGroup>
    <Content Remove="@(None->WithMetadataValue('Pack','true'))" />
</ItemGroup>
</Project>

      この問題の修正は、今後のリリースで予定されており、その時点で上記の回避策は不要になります。