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

重要

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

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

重要なリンク:

• 既存のアプリを以前のバージョンの Windows App SDK から新しいバージョンにアップグレードする場合は、「既存のプロジェクトを最新リリースの Windows App SDK に更新する」を参照してください。
• 実験的リリースに関するドキュメントについては、「Windows App SDK のプレビューおよび試験的チャンネル用ツールをインストールする」を参照してください。

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

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

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

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

バージョン 1.3 実験 (1.3.0-experimental1)

これは、実験的チャネルの最新リリースです。 ダウンロードするには、WinAppSDK NuGet のバージョンを 1.3.230202101-experimental1 に再ターゲットします。

XAML Backdrop API

XAML ウィンドウに組み込まれたプロパティにより、マイカと背景アクリルの背景が WinUI 3 アプリで使いやすくなりました。

Window.SystemBackdrop プロパティの詳しい情報は、GitHub の Xaml 背景 API 仕様 を参照してください。

このリリースのノートでは、次のようにコードビハインドでのみ背景を設定できます。 マークアップで <Window.SystemBackdrop> を設定すると、コンパイル エラーが発生します。

さらに、Xaml 背景 API には現在、開発中の「試験段階」タグがありません。

public MainWindow()
{
    this.InitializeComponent();

    this.SystemBackdrop = new MicaBackdrop();
}

Window.AppWindow

複数行の定型コードを置き換えることで、Window から Window.AppWindow まで AppWindow API を直接使用できるようになりました。 その他の背景と使用に関する情報については、「GitHub の Window.AppWindow API 仕様」を参照してださい。

WinAppSDK 全体の新機能

• ApplicationModel.DynamicDependency: 非推奨の MddGetGenerationId を置き換える PackageDependency.PackageGraphRevisionId。
• Environment Manager: Environment Manager の変更をアプリケーションで追跡できるかどうかを通知する EnvironmentManager.AreChangesTracked。 詳細については、GitHub の「環境マネージャー API 仕様」を参照してください。
• MRT Core: 新しいイベント、Application.ResourceManagerInitializing はアプリが独自の IResourceManager インターフェイスの実装を提供し、WinUI がリソース URI の解決に使用する ResourceManager にアクセスできるようにします。
• 最新の実験的な VSIX を使うと、プロジェクト ファイルではなく、Visual Studio のメニューから、パッケージ化されていないアプリとパッケージ アプリの間で変換できるようになりました。
• 参照された Static/ThemeResource の LOOKUP を解決できないときに、新しいイベント、DebugSettings.XamlResourceReferenceFailed が発生するようになりました。 このイベントは、Static & ThemeResource ルックアップの失敗をより適切にデバッグできるようにするために、フレームワークがそのキーを検索した場所の詳細を示すトレースへのアクセスを提供します。 詳細については、GitHub の issue 4972、2350、6073 を参照してください。

バグ修正

• テキスト ボックスにソフト キーボードが表示されないタッチ入力の問題を修正しました。 詳細については、GitHub の issue 6291 を参照してください。
• IElementFactory を ItemTemplate として持つ ItemsRepeater が ArgumentException をスローする問題を修正しました。 詳細については、GitHub の issue 4705 を参照してください。

その他の実験的 API

このリリースには、初期の開発段階にあるいくつかの API も含まれています。

以下の一覧では、1.3.0 安定版リリースで出荷する予定のない、この実験的リリースで導入された API について詳しく説明します。

**Microsoft.UI.Content**

    DesktopSiteBridge
        GetInputEnabledToRoot
        GetVisibleToRoot
        InputEnabled

**Microsoft.UI.Dispatching**

    DispatcherQueue
        FrameworkShutdownStarting

**Microsoft.UI.Input**

    InputLightDismissAction
        GetForIsland

    InputNonClientPointerSource
    InputPointerActivationBehavior
    InputPointerSource
        ActivationBehavior

    NonClientRegionCaptionTappedEventArgs
    NonClientRegionHoverEventArgs
    NonClientRegionKind

**Microsoft.UI.Input.DragDrop**

    DragDropManager
    DragDropModifiers
    DragInfo
    DragOperation
    DragUIContentMode
    DragUIOverride
    DropOperationTargetRequestedEventArgs
    IDropOperationTarget

**Microsoft.UI.Xaml.Automation.Peers**

    ItemContainerAutomationPeer
    ItemsViewAutomationPeer

**Microsoft.UI.Xaml.Controls**

    AnnotatedScrollBar
    AnnotatedScrollBarLabel
    AnnotatedScrollBarScrollEventArgs
    AnnotatedScrollBarScrollEventType
    AnnotatedScrollBarScrollOffsetRequestedEventArgs
    AnnotatedScrollBarSubLabelRequestedEventArgs
    AnnotatedScrollBarValueRequestedEventArgs
    ElementFactory
        GetElement
        GetElementCore
        RecycleElement
        RecycleElementCore

    IndexBasedLayoutOrientation
    ItemContainer
    ItemContainerInteractionTrigger
    ItemContainerInvokedEventArgs
    ItemContainerMultiSelectMode
    ItemContainerUserInvokeMode
    ItemContainerUserSelectMode
    ItemsView
    ItemsViewItemInvokedEventArgs
    ItemsViewItemInvokeMode
    ItemsViewSelectionMode
    Layout
        IndexBasedLayoutOrientation

    NonVirtualizingLayout
        IndexBasedLayoutOrientationCore

    RiverFlowLayout
    RiverFlowLayoutItemsInfoRequestedEventArgs
    RiverFlowLayoutItemsJustification
    RiverFlowLayoutItemsStretch
    VirtualizingLayout
        IndexBasedLayoutOrientationCore

    VirtualizingLayoutContext
        VisibleRect
        VisibleRectCore

**Microsoft.Graphics.Display**

    DisplayInformation
        AngularOffsetFromNativeOrientation
        DpiChanged
        OrientationChanged
        RawDpi
        RawPixelsPerViewPixel

    DisplayOrientation

**Microsoft.UI.Xaml.Hosting**

    DesktopWindowXamlSource
        CreateSiteBridge
        SiteBridge
        SystemBackdrop

関連トピック

• Windows アプリ SDK の最新の安定版チャネル リリース ノート
• Windows アプリ SDK の最新のプレビュー チャネル リリース ノート
• Windows App SDK 用のツールをインストールする
• WinUI 3 (Windows App SDK) プロジェクトを初めて作成する
• 既存のプロジェクトで Windows App SDK を使用する
• デプロイの概要