독립 실행형 EXE 형식으로 실행할 수 있도록 WinUI 3으로 만든 앱을 출력합니다

페이지 업데이트 : 2025년 2월 26일 수요일

페이지 생성 날짜 : 2024년 12월 31일 화요일

운영 환경

윈도우

윈도우 11

비주얼 스튜디오

Visual Studio 2022 버전 17.12.3

.그물

.그물 8

윈UI

윈UI 3

Windows 앱 SDK

1.6.3 (1.6.241114003)

필수 구성 요소

경우에 따라 더 낮은 버전도 작동할 수 있습니다.

윈도우

윈도우 10
윈도우 11

비주얼 스튜디오

Visual Studio 2022 버전 17.12 이상

.그물

.NET 8 이상

Windows 앱 SDK

1.6.0 이상

처음에

WinUI 3으로 만든 애플리케이션은 일반적으로 특별한 상황에서만 실행할 수 있는 패키지된 애플리케이션입니다. 실행하려면 Microsoft Store에서 다운로드하여 설치해야 합니다. 파일을 직접 배포하는 방법도 있지만, 다소 복잡한 절차와 설정이 필요하고, 불특정 다수에게 배포하는 것에는 적합하지 않습니다. 대신 매우 안전한 환경에서 응용 프로그램을 실행할 수 있습니다.

이번에 소개하는 방법은 unpackaged 방식으로 EXE 파일을 만들 수 있기 때문에 EXE 파일을 그대로 사용자에게 배포하고 실행할 수 있습니다. WindowsForm 또는 WPF로 작성된 응용 프로그램을 배포하려는 것과 동일한 방식으로 보이게 하려면 이 방법을 사용하는 것이 좋습니다.

주의

WinUI 3 관련 제품은 지속적으로 업데이트되고 있으므로 버전이 다르기 때문에 제대로 작동하지 않을 수 있습니다. 이 순서는 IDE와 SDK 버전이 맞으면 효과가 있다고 생각 합니다만, 잘 작동하지 않는 경우에는 다양한 버전에주의하시기 바랍니다.

또한 패키지화되지 않은 프로그램으로 작성된 프로그램은 패키지화된 프로그램에 비해 기능이 제한되어 있습니다. 자세한 내용은 설명하기 어렵기 때문에 작성한 프로그램에 따라 작동하는지 확인하십시오.

전제 조건

"WinUI 3을 사용하여 개발 준비" 팁에 따라 환경이 설정되었다고 가정합니다.

Visual Studio 2022 업데이트

기본적으로 최신 버전이 있으면 문제가 없습니다. 적어도이 기사의 시작 부분에 있는 버전입니다. Visual Studio 메뉴에서 실행하거나 시작 메뉴에서 "Visual Studio 설치 관리자"를 시작하여 업데이트하십시오.

Windows 앱 SDK 설치(Windows 앱 SDK)

Visual Studio 설치에 포함된 Windows 앱 SDK는 오래되었으며 최신 상태여야 합니다. 다음 사이트에서 다운로드하여 설치하십시오.

최신 Windows 앱 SDK 다운로드

실행되면 배치가 질문 없이 시작되고 업데이트됩니다.

프로젝트 만들기

그런 다음 만들려는 프로그램을 만듭니다. 이 섹션에서는 새 프로젝트의 상태에 대해 설명합니다.

NuGet을 사용하여 패키지 버전을 최신 상태로 유지

"Microsoft.WindowsAppSDK"의 버전이 이 문서의 시작 부분에 있는 버전 이상인지 확인합니다. 포함 된 "Microsoft.Windows.SDK.BuildTools"가 최신 상태 인 데는 문제가 없습니다.

업데이트하려면 NuGet 관리 패키지에서 업데이트할 수 있습니다.

패키지 비활성화

프로젝트 속성을 엽니다.

"애플리케이션 > 패키징" 범주에는 "이 프로젝트에 대해 MSIX 패키징 사용"이라는 항목이 있으므로 선택을 취소합니다.

사용해 보기

툴바의 디버그 실행을 보면 "XXXX (패키지)"라고 생각합니다. 선택에서 "XXXX (패키지화되지 않음)"로 변경할 수 있으므로 패키지화되지 않음으로 변경합니다.

변경했으면 실행해 보십시오. 오류 없이 실행할 수 있다면 문제가 없습니다.

EXE 파일 생성

빌드 후 생성된 EXE 파일은 배포할 수 있습니다만, 이번에는 「공개」메뉴에서 실행 파일을 출력합니다.

그건 그렇고, unpackaged에서 "publish" 프로세스를 성공적으로 수행하려면 "를 사용해야 합니다. NET 데스크톱 개발을 참조하십시오.

프로젝트를 마우스 오른쪽 버튼으로 클릭하고 게시를 선택합니다.

새 프로젝트로 시작하는 경우 처음부터 세 개의 프로필이 생성되므로 배포할 환경을 선택할 수 있습니다. 프로젝트 등을 업데이트하는 경우 프로필이 없을 수 있으므로 이 경우 새 프로필을 만듭니다.

More Actions(추가 작업)에서 Edit(편집)를 선택합니다.

왠지 초기 설정 등 프로필과 설정이 다르기 때문에 다음과 같이 프로필을 일치시킵니다.

파라미터 이름,	설정값, 비고
구성	xXX 출시	프로필에 맞게 변경해 주세요. win-x64인 경우 릴리스 x64입니다.
Target 프레임워크	현재 프로젝트에 맞게 조정
배포 모드	독립형	현재 사양에서는 "자체 포함"만 작동합니다.
타겟 런타임	승리 - xXX	프로필에 맞게 변경해 주세요. win-x64인 경우 win-x64로 만듭니다.
타겟 위치	기본값을 그대로 둡니다.
단일 파일 만들기	끄기	현재 사양에서는 단일 파일로 생성되어도 실행할 수 없습니다.
실행 준비 완료	자의적	성능을 향상시키고 싶다면 확인하십시오.
사용되지 않는 코드 트리밍	자의적	파일 크기를 줄이려면 확인하십시오. 프로그램 생성에 따라 작동하지 않습니다.

완료되면 "제출" 버튼을 클릭합니다.

게시가 오류 없이 성공적으로 이루어졌는지 확인합니다.

Target Location(대상 위치) 링크를 클릭하여 게시된 파일을 열 수 있습니다.

EXE 파일을 실행하고 시작할 수 있으면 계속 진행할 수 있습니다. 배포하려면 이 폴더의 전체 파일 세트를 가져와야 합니다. 「. ".pdb" 파일과 같이 실행에 필요하지 않은 파일은 삭제해도 괜찮습니다.

WinUI 3을 사용하여 개발 준비