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

[アーティクル]
03/11/2024

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

安定チャネルの次のリリースが現在使用できます。

バージョン 1.5
バージョン 1.4
バージョン 1.3
バージョン 1.2
バージョン 1.1
バージョン 1.0
バージョン 0.8
バージョン 0.5

既存のアプリを以前のバージョンの Windows App SDK から新しいバージョンにアップグレードする場合は、「既存のプロジェクトを最新リリースの Windows App SDK に更新する」を参照してください。

Windows App SDK 用のダウンロード

注

Windows App Visual Studio Extensions（VSIX）は、現在は別々のダウンロードとして配布されていません。それらは、Visual Studio内のVisual Studio Marketplaceで利用可能です。

バージョン 1.5

バージョン 1.5.2 (1.5.240404000)

これは、Windows アプリ SDK 1.5 リリースの重大なバグ修正とウィジェットフィードプロバイダー向け新機能を含んだ Windows アプリ SDK のサービスリリースです。

フィードプロバイダーは、ウィジェットダッシュボードでアナウンスを表示できるようになりました。
- 新しい FeedManager.TryShowAnnouncement API を使用すると、フィードプロバイダーはウィジェットダッシュボードにアナウンスを表示するよう要求できます。アナウンスを表示するには、FeedAnnouncement オブジェクトを作成して FeedManager.TryShowAnnouncement API を呼び出します。
- [アナウンスのフィード] では、FeedAnnouncement API を使用してカスタマイズできる独自のバッジがタスクバーに表示されます。
フィードプロバイダーは、ユーザーが操作するプロバイダーに関する分析レポートとエラーレポートの情報の受信をオプトインできるようになりました。オプトインするには、プロバイダーにより IFeedProviderAnalytics インターフェイスと IFeedProviderErrors インターフェイスの一方または両方を実装します。

フィードプロバイダーの更新には、次の新しい API が含まれています。

Microsoft.Windows.Widgets.Feeds.Providers
 
    FeedAnalyticsInfoReportedArgs
    FeedErrorInfoReportedArgs
    FeedManager
        SendMessageToContent
        TryShowAnnouncement
 
    FeedMessageReceivedArgs
    FeedResourceRequest
    FeedResourceRequestedArgs
    FeedResourceResponse
    IFeedAnnouncementInvokedTarget
    IFeedManager2
    IFeedProviderAnalytics
    IFeedProviderErrors
    IFeedProviderMessage
    IFeedResourceProvider

Microsoft.Windows.Widgets.Notifications
 
    AnnouncementActionKind
    AnnouncementTextColor
    FeedAnnouncement
    FeedAnnouncementInvokedArgs

バグ修正

プライマリディスプレイが 60 Hz で実行されていない場合に、正しい時刻に DispatcherTimer が起動しない問題を修正しました。
100% 以外のスケールファクターで実行すると、テキストボックス入力メソッドエディター (IME) ウィンドウが正しく配置されない問題を修正しました。詳細については、GitHub の問題 #9382 を参照してください。
別のアプリからドラッグアンドドロップ操作を開始すると、コピー/移動/リンクの正しいドロップ操作が許可されない問題を修正しました。
ListView の ItemsSource がリセットされ、すぐにフォーカスが当てられると発生する可能性のあるクラッシュを修正しました。
継承されたスケール変換に ShouldConstrainToRootBounds="false" ポップアップが適用されない問題を修正しました。詳細については、GitHub の問題 #9118 と #9433 を参照してください。
アニメーションが実行している状態でコンポジションオブジェクトが破棄された場合に発生する可能性があるクラッシュを修正しました。
NavigationView::RevokeNavigationViewItemRevokers でシャットダウン時に発生する可能性のあるクラッシュを修正しました。

バージョン 1.5.1 (1.5.240311000)

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

「map.html」をコピーできないために自己完結型アプリのビルドに失敗する場合がある問題を修正しました。
有効なトークンが拒否されることで MapControl が初期化に失敗する問題を修正しました。詳細については、GitHub の問題 #9324 を参照してください。
青い背景で MapControl が読み込まれる問題を修正しました。詳細については、GitHub の問題 #9377 を参照してください。
NavigationViewItem のシェブロンをクリックしても、1 回のクリックで正しく展開または折りたたまれない問題を修正しました。これが原因で、PaneDisplayMode="Top" モードでシェブロンをクリックするとメニューが空白として表示される問題も起きていました。詳細については、GitHub の問題 #9423 と #9426 を参照してください。
タッチまたはペンで NavigationViewItem をタップすると、アイテムがそれ以降の入力に応答しなくなる問題を修正しました。詳細については、GitHub の問題 #9429 を参照してください。
NavigationView.PaneFooter 領域内のアイテムをクリックするとクラッシュする問題を修正しました。詳細については、GitHub の問題 #9396 を参照してください。
メニューのアイコンが間違った場所に表示される場合がある問題を修正しました。詳細については、GitHub の問題 #9409 を参照してください。
ウィンドウから切り替えて戻るまで、アクリルがメニューに表示されない問題を修正しました。詳細については、GitHub の問題 #9406 を参照してください。
TextBox/RichEditBox の初期化中に発生する可能性があるクラッシュを修正しました。詳細については、GitHub の問題 #9216 を参照してください。
NavigationView が破棄時にスローされ、キャッチされるノイズの多い一部の例外を修正しました。
間違った PointerCaptureLost メッセージが発生したことが原因で、「ピンチ操作によるズーム」ジェスチャがパンまたはタップとして表示される場合がある問題を修正しました。

バージョン 1.5

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

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

更新されたランタイムと MSIX については、Windows App SDK 用のダウンロードページを参照してください。

XAML Islands ランタイムおよびシャットダウンの更新

WinAppSDK 1.4とWinAppSDK 1.5では、XAML Islandsベースのアプリケーションで、任意のスレッド上の最後のXAMLウィンドウが閉じられた場合の動作に違いがあります。

WinAppSDK 1.4では、スレッド上の最後のXAMLウィンドウが閉じられると、常にXAMLランタイムはスレッドのイベントループを終了します。
WinAppSDK 1.5 の場合:
- アプリが WinUI Desktop アプリの場合、既定の反応は WinAppSDK 1.4 と同じです。
- デスクトップWindowXamlSource（"XAML Islands"）APIでXAMLを使用している場合、デフォルトの動作は、XAMLが自動的にスレッドのイベントループを終了しないようになりました。
- 双方のモードで、Application.DispatcherShutdownMode プロパティを設定して、この反応を変更できます。

詳細については、使用可能であれば Application.DispatcherShutdownMode プロパティ用ドキュメンテーションを参照してください。 GitHub提案#8492.が完了しました。

WinAppSDK 1.4とWinAppSDK 1.5のXAML Islandsベースのアプリにおいて、XAMLランタイムのライフタイムには動作上の違いがあります。

WinAppSDK 1.4 では、特定のスレッド上のすべての WindowsXamlManager および DesktopWindowXamlSource オブジェクトが閉じられるかシャットダウンされるか、そのスレッドで実行されている DispatcherQueue がシャットダウンされると、XAML ランタイムはスレッド上でシャットダウンします。ダウンします (この場合、XAML ランタイムはDispatcherQueue.FrameworkShutdownStarting段階でシャットダウンします)。
WinAppSDK 1.5 では、XAML ランタイムは、そのスレッド上で実行されている DispatcherQueue がシャットダウンされた場合にのみスレッド上でシャットダウンします (Xaml ランタイムは常に DispatcherQueue.FrameworkShutdownStarting ステージでシャットダウンされます)。

詳細については、使用可能であれば WindowsXamlManager クラス用ドキュメンテーションを参照してください。

WindowsXamlManager.InitializeForCurrentThread()には動作の違いがあります:

WinAppSDK 1.4 では、WindowsXamlManager.InitializeForCurrentThread()は呼び出しごとに WindowsXamlManager オブジェクトの一意のインスタンスを返します。
WinAppSDK 1.5 では、スレッド上に既存のインスタンスが存在する場合、WindowsXamlManager.InitializeForCurrentThread() は既存のインスタンスを返します。 Close/Dispose() は無視されるようになりました。

WinUI Maps コントロール

WinUIMapsコントロールが利用できるようになりました。このコントロールは、WebView2 と Azure Maps を利用し、次の機能を提供します。

マップボタンまたはタッチによるパンとズーム。
マップのスタイルを、サテライト、地形、またはストリートビューに変更。
開発者がカスタマイズ可能なアイコンを含む対話可能なピンをプログラムでマップに追加。
初期読み込みがマップに基づく箇所における開発者によるカスタマイズ。
パン、ズーム、マップスタイルのボタンの非表示または表示に対する開発者によるコントロール。

WinUI 3 Maps コントロール

Note

Maps コントロールを使用するには、Azure Maps キーが必要です。キーを作成するには、Web アプリ作成用 Azure Maps ドキュメンテーションページを参照してください。

Maps コントロールは全く新しい機能であり、今後の方向性の評価のため皆様のフィードバックをお待ちしております。

新しい SelectorBar コントロール

バージョン 1.5 では、ユーザーが複数のデータビューを切り替えられるようにする新しいコントロールSelectorBarを追加しました。このコントロールは、1.5 ロードマップでは以前は「SegmentedControl」と呼ばれていました。

WinUI 3 SelectorBar コントロール

CommandBarFlyout の基本コマンドのラベル

CommandBarFlyoutのビジュアルが更新され、Label プロパティが AppBarButton() に設定されている場合に、プライマリコマンド領域の項目のテキストラベルが表示されるようになりました。以前は、CommandBarFlyoutエリアの主なコマンドはアイコンのみを表示していましたが、使いやすさを向上させるためにアイコンとラベルの両方を表示できるようになりました。

WinUI 3 CommandBarFlyout ラベル

カスタム環境/オプションの WebView2 サポート

WinUI WebView2 コントロールは、カスタム CoreWebView2およびCoreWebView2Environmentを使用して基になる () オブジェクトをカスタマイズする機能を公開するようになりました。これにより、アプリ作成者は、WebView2Runtime の読み込み元となる代替パスを指定したり、別の UserDataFolder の使用を選択したり、IsPrivateModeEnabled()ScriptLocaleなどのオプションを設定したりすることができます。

.NET 8のサポート

最近の 1.4 サービスリリースで .NET 8 のサポートを追加しましたが、プラットフォーム固有の RID の使用に対する警告は依然として残りました。 1.5 ではその作業が完了し、警告が表示されなくなりました。

デバッグとソースの可用性の向上

現在、microsoft-ui-xaml リポジトリ内のコードの Github ソースサーバー情報がパブリックシンボルに挿入され、デバッガーがソースコードを自動的にダウンロードできるようになりました。また、デバッグエクスペリエンスを向上させるために、WinAppSDK 全体のシンボルにその他の修正と改善も加えました。

レイアウトサイクルのデバッグ機能の改善

WinUI アプリでのレイアウトサイクルのデバッグは困難な場合があるため、1.5 ではDebugSettings オブジェクトで、レイアウトプロセスのログ記録とブレークポイントの改善を有効にするオプションが公開され、アプリでのレイアウトサイクルのデバッグと修正が容易になります

WinAppSDK における他の新機能

PublishSingleFile デプロイモデルのサポートが追加されました。 PublishSingleFile について詳しくは、単一ファイルのデプロイに関するドキュメンテーションをご覧ください。
スクリーンリーダーのサポート、テキストスケーリングのサポート、その他のアクセシビリティ機能に改善が追加されました。
優先順位の高い GitHub バグバックログに基づいて、さまざまな安定性とパフォーマンスが向上しました。

新機能は個別にリリースされます

C# および C++ 用の WinAppSDK Visual Studio テンプレートの新しいバージョンが Visual Studio Marketplace を通じてリリースされており、1.5 のリリースから数週間後に表示されます。新しいバージョンでは、テンプレートを WinAppSDK リリースとは独立してリリースできるようになり、顧客に更新情報を提供する際の柔軟性が大幅に向上しました。

以前に計画されていたその他の機能

1.5 では、ロードマップで発表した次の機能について進展がありましたが、完了していませんでした。これらは 1.6 タイムフレームまで継続されます。

タブ付きウィンドウ
WebView2 のドラッグアンドドロップのサポート
テーブルビューとインクコントロールの調査

ダイナミックライティングは当面ロードマップから削除されました。

既知の問題

.xaml ファイルなどのリソースを含むライブラリを使用すると、実行時にそれらのリソースが見つからないことを示すエラーメッセージが表示されることがあります。この場合、それらのリソースが確実に含まれるように、プロジェクトファイルに <ShouldComputeInputPris>true</ShouldComputeInputPris>を挿入することが必要になる場合があります。
NavigationViewItemの山形をクリックしても、1 回のクリックで正しく展開または折りたたまれなくなりました。ダブルクリックは引き続き機能し、NavigationViewItem の他の場所をクリックしても機能します。