프로젝트 속성

이 토픽에서는 Visual Studio 프로젝트 파일에서 설정하여 앱 배포 방법을 사용자 지정할 수 있는 프로젝트 속성을 설명합니다.

속성 이름 및 설명	값	자세한 정보
AppxPackage. WinUI 3 앱의 패키지 여부를 지정합니다.	거짓(패키지 해제된 앱의 경우) 또는 부재(패키지된 앱의 경우)	패키지 해제된 WinUI 3 데스크톱 앱을 위한 새 프로젝트 만들기
EnableMsixTooling. 프로젝트에 대해 단일 프로젝트 MSIX 기능을 활성화합니다.	참(활성화) 또는 부재(비활성화)	단일 프로젝트 MSIX를 사용하여 앱 패키지
UseWinUI. 앱에서 WinUI 3 사용자 인터페이스 프레임워크의 사용 여부를 지정합니다.	참 또는 부재(거짓의 경우)	Windows 앱 SDK의 WinUI 3(WinUI 3)
WindowsAppSdkBootstrapInitialize. Windows 앱 SDK 모듈 이니셜라이저를 활용하여 앱 시작 시 부트스트래퍼 API의 자동 호출 여부를 결정합니다.	참(실행 파일의 기본값), 거짓(비실행 파일의 기본값)	자동 모듈 초기화 옵트아웃(또는 옵트인)
WindowsAppSdkSelfContained. 앱의 자체 포함 배포 여부를 결정합니다.	참 또는 부재(거짓의 경우)	자체 포함 앱용 Windows 앱 SDK 배포 가이드
WindowsAppSdkUndockedRegFreeWinRTInitialize. 앱 시작 시 Windows 앱 SDK의 도킹 해제 등록이 필요 없는 Windows 런타임(UndockedRegFreeWinRT) 구현의 자동 사용 설정 여부를 결정합니다.	참(실행 파일의 기본값), 거짓(비실행 파일의 기본값)	자동 UndockedRegFreeWinRT 지원 옵트아웃(또는 옵트인)
WindowsPackageType. 패키지 해제된 앱으로 <WindowsPackageType>None</WindowsPackageType>을(를) 설정하면 자동 이니셜라이저에서 앱에 최적화된 Windows 앱 SDK 버전을 찾아 로드합니다.	없음 또는 부재(자동 이니셜라이저 비활성화)	패키지 해제된 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>
...

관련 항목

• 배포 개요