Windows アプリ SDK 1.5 のプレビュー チャネルリリース ノート

  • [アーティクル]

重要

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

プレビュー チャネルには、開発の後期段階のプレビュー チャネル機能を備えた Windows アプリ SDK のリリースが含まれています。 プレビュー リリースには試験段階の機能と API は含まれていませんが、次の安定版リリースの前に破壊的変更が発生する可能性は残っています。

重要なリンク:

最新のプレビュー チャネル リリース ノート

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

バージョン 1.5 プレビュー 1 (1.5.0-preview1)

これは、バージョン 1.5 のプレビュー チャネルの最新リリースです。

既存の Windows App SDK 1.4 (安定チャンネルから) アプリケーションでは、Nuget パッケージを 1.5.0-preview1 に更新できます (「NuGet Package Manager を使用して Visual Studio でパッケージをインストールおよび管理する」の「パッケージを更新する」セクションを参照してください)。

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

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

  • 任意のスレッドの最後の Xaml ウィンドウが閉じられた際の、Xaml Islands ベースのアプリにおける WinAppSDK 1.4 と WinAppSDK 1.5 の反応には違いがあります。
    • WinAppSDK 1.4 では、スレッドの最後の Xaml ウィンドウが閉じられると、Xaml ランタイムは常にスレッドのイベント ループを終了します。
    • WinAppSDK 1.5 の場合:
      • アプリが WinUI Desktop アプリの場合、既定の反応は WinAppSDK 1.4 と同じです。
      • DesktopWindowXamlSource (「Xaml Islands」) API に Xaml を使用している場合、現在では既定の反応で Xaml がスレッドのイベント ループを自動的に終了することはありません。
      • 双方のモードで、Application.DispatcherShutdownMode プロパティを設定して、この反応を変更できます。
    • 詳細については、使用可能であれば Application.DispatcherShutdownMode プロパティ用ドキュメンテーションを参照してください。
  • Xaml ランタイムの存続期間中、Xaml Islands ベースのアプリにおいて WinAppSDK 1.4 と WinAppSDK 1.5 には反応に違いがあります。
    • WinAppSDK 1.4 では、Xaml ランタイムは、特定のスレッド上のすべての WindowsXamlManager および DesktopWindowXamlSource オブジェクトが閉じられたりシャットダウンされたり、またはそのスレッドで実行されている DispatcherQueue がシャットダウンされたりした場合に、スレッドでシャットダウンされます (Xaml ランタイムは DispatcherQueue.FrameworkShutdownStarting ステージ中にシャットダウンされます)。
    • WinAppSDK 1.5 では、そのスレッドで実行されている DispatcherQueue がシャットダウンされた場合にのみ、Xaml ランタイムがスレッドでシャットダウンします (Xaml ランタイムは DispatcherQueue.FrameworkShutdownStarting ステージ中にシャットダウンします)。
    • 詳細については、使用可能であれば WindowsXamlManager クラス用ドキュメンテーションを参照してください。

WinUI Maps コントロール

WinUI Maps コントロールの最初のリリースが利用可能になりました。 このコントロールは、WebView2 と Azure Maps を利用し、次の機能を提供します。

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

Note

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

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

WinAppSDK における他の新機能

バグ修正

  • プロジェクション DLL が生成されない 1.5-experimental2 リリースの問題を修正しました。 詳細については、GitHub の問題 #4152 を参照してください。
  • RichEditBox のテキスト書式設定ポップアップ上の 3 点リーダーボタンがアクションの一覧を正しく表示しない問題を修正しました。 詳細については、GitHub の問題 #9140 を参照してください。
  • ListView がキーボード アクセラレーターを正しく扱わない問題を修正しました。 詳細については、GitHub の問題 #8063 を参照してください。
  • AccessKey を使ってウィンドウを閉じる際のアクセス違反問題を修正しました。 詳細については、GitHub の問題 #8648 を参照してください。
  • MenuBar にある MenuFlyoutItem のテキスト配置に影響する問題を修正しました。 詳細については、GitHub の問題 #8755 を参照してください。
  • 強調表示されたテキストが右クリック時に強調表示されたままとならない問題を修正しました。 詳細については、GitHub の問題 #1801 を参照してください。
  • 非アクティブなウィンドウを閉じるとアプリがクラッシュする問題を修正しました。 詳細については、GitHub の問題 #8913 を参照してください。
  • マウスの中央ボタンでスクロールし、直後に左クリックすると、アプリケーションがハングされることがある問題を修正しました。 詳細については、GitHub の問題 #9233 を参照してください。

1.5.0-preview1 の新しい API

バージョン1.5-preview1 には、安定版 1.4 リリースと比較して、次の新しい API が含まれています。

Microsoft.Graphics.DirectX
 
    DirectXPixelFormat
        A4B4G4R4

Microsoft.UI.Input
 
    FocusNavigationReason
    FocusNavigationRequest
    FocusNavigationRequestEventArgs
    FocusNavigationResult
    InputFocusController
        DepartFocus
        NavigateFocusRequested
 
    InputFocusNavigationHost

Microsoft.UI.Xaml
 
    Application
        DispatcherShutdownMode

    DebugSettings
        LayoutCycleDebugBreakLevel
        LayoutCycleTracingLevel

    DispatcherShutdownMode
    LayoutCycleDebugBreakLevel
    LayoutCycleTracingLevel

Microsoft.UI.Xaml.Controls
 
    MapControl
    MapControlMapServiceErrorOccurredEventArgs
    MapElement
    MapElementClickEventArgs
    MapElementsLayer
    MapIcon
    MapLayer
    SelectorBar
    SelectorBarItem
    SelectorBarSelectionChangedEventArgs
    WebView2
        EnsureCoreWebView2Async
        EnsureCoreWebView2Async

Microsoft.UI.Xaml.Hosting
 
    WindowsXamlManager
        GetForCurrentThread
        XamlShutdownCompletedOnThread
 
    XamlShutdownCompletedOnThreadEventArgs

Microsoft.Web.WebView2.Core
 
    CoreWebView2
        FrameId

    CoreWebView2AcceleratorKeyPressedEventArgs
        IsBrowserAcceleratorKeyEnabled

    CoreWebView2BrowserExtension
    CoreWebView2BrowsingDataKinds
        ServiceWorkers

    CoreWebView2CustomSchemeRegistration
        CoreWebView2CustomSchemeRegistration (String)
        AllowedOrigins
        SchemeName

    CoreWebView2Environment
        GetProcessExtendedInfosAsync

    CoreWebView2EnvironmentOptions
        AreBrowserExtensionsEnabled
        CustomSchemeRegistrations

    CoreWebView2Frame
        FrameId

    CoreWebView2FrameInfo
        FrameId
        FrameKind
        ParentFrameInfo

    CoreWebView2FrameKind
    CoreWebView2MouseEventKind
        NonClientRightButtonDown
        NonClientRightButtonUp

    CoreWebView2NavigationKind
    CoreWebView2NavigationStartingEventArgs
        NavigationKind

    CoreWebView2NewWindowRequestedEventArgs
        OriginalSourceFrameInfo

    CoreWebView2ProcessExtendedInfo
    CoreWebView2Profile
        AddBrowserExtensionAsync
        Delete
        Deleted

Microsoft.Windows.Management.Deployment
 
    AddPackageOptions
    EnsureReadyOptions
    PackageDeploymentContract
    PackageDeploymentManager
    PackageDeploymentProgress
    PackageDeploymentProgressStatus
    PackageDeploymentResult
    PackageDeploymentStatus
    PackageRuntimeManager
    PackageSet
    PackageSetItem
    PackageSetItemRuntimeDisposition
    PackageSetRuntimeDisposition
    PackageVolume
    ProvisionPackageOptions
    RegisterPackageOptions
    RemovePackageOptions
    StagePackageOptions
    StubPackageOption

Microsoft.Windows.Widgets.Feeds.Providers
 
    CustomQueryParametersRequestedArgs
    CustomQueryParametersUpdateOptions
    FeedDisabledArgs
    FeedEnabledArgs
    FeedManager
    FeedProviderDisabledArgs
    FeedProviderEnabledArgs
    FeedProviderInfo
    IFeedManager
    IFeedProvider