プロジェクトのプロパティ

  • [アーティクル]

このトピックでは、アプリの展開方法をカスタマイズするために Visual Studio プロジェクト ファイルで設定できるプロジェクト プロパティについて説明します。

プロパティ名と説明 値 詳細についてはこちらです
AppxPackage。 WinUI 3 アプリをパッケージ化するかどうかを指定します。 false (パッケージ化されていないアプリの場合)、または存在しない (パッケージ化アプリの場合) パッケージ化されていな WinUI 3 デスクトップ アプリに対して新しいプロジェクトを作成する
EnableMsixTooling。 プロジェクトの単一プロジェクト MSIX 機能を有効にします。 true (有効にする場合)、または存在しない (無効にする場合) 単一プロジェクト MSIX を使用してアプリをパッケージ化する
UseWinUI。 アプリで WinUI 3 ユーザー インターフェイス フレームワークを使用するかどうかを指定します。 true、または absent (false の場合) Windows App SDK (WinUI 3) の WinUI
WindowsAppSdkBootstrapInitialize。 Windows App SDK がモジュール初期化子を利用して、アプリの起動時に bootstrapper API を自動的に呼び出すかどうかを判断します。 true (実行可能ファイルの既定値) 、false (非実行可能ファイルの既定値) モジュールの自動初期化のオプトアウト (またはオプトイン)
WindowsAppSdkSelfContained。 アプリが自己完結型で展開されるかどうかを決定します。 true、または absent (false の場合) 自己完結型アプリの Windows アプリ SDK 展開ガイド
WindowsAppSdkUndockedRegFreeWinRTInitialize。 ドッキングされていない登録不要の Windows Runtime (UndockedRegFreeWinRT) の Windows App SDK の実装をアプリの起動時に自動的に有効化するかどうかを判断します。 true (実行可能ファイルの既定値) 、false (非実行可能ファイルの既定値) UndockedRegFreeWinRT 自動サポートをオプトアウト (またはオプトアウト) する
WindowsPackageType。 パッケージ化されていなアプリに対して <WindowsPackageType>None</WindowsPackageType> を設定すると、auto-initializer が、アプリに最も適した Windows App SDK バージョンのバージョンを見つけて読み込みます。 None、または absent (auto-initializer を無効化) パッケージ化されていな WinUI 3 デスクトップ アプリに対して新しいプロジェクトを作成する

バックグラウンドでのモジュールの自動初期化のオプトアウト

例

C# WinUI 3 プロジェクトの一般的な .csproj ファイルからの抜粋を次に示します。上の表のプロジェクト プロパティの一部が使用されています。

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