WinUI 3을 사용하여 개발 준비
운영 환경
- 윈도우
-
- 윈도우 11
- 비주얼 스튜디오
-
- Visual Studio 2022 버전 17.9.3
- .그물
-
- .그물 6
- (.NET 8)을 참조하십시오.
- 윈UI
-
- 윈UI 3
- Windows 앱 SDK
-
- 1.4.230913002
필수 구성 요소
경우에 따라 더 낮은 버전도 작동할 수 있습니다.
- 윈도우
-
- 윈도우 10
- 윈도우 11
- 비주얼 스튜디오
-
- Visual Studio 2022 버전 17.9.3 이상
- .그물
-
- .그물 6
- (.NET 8)을 참조하십시오.
- Windows 앱 SDK
-
- 1.4.230913002 이상
Visual Studio 설치 및 WinUI 설정
WinUI 3 개발 프로젝트는 Visual Studio 설치와 함께 추가할 수 있습니다. 이 섹션에서는 Visual Studio 설치 프로세스에 대해 간략하게 설명합니다. 자세한 지침은 다음 팁을 참조하십시오.
인터넷 또는 미디어에서 Visual Studio 2022 설치 프로그램을 시작합니다. Community, Professional 또는 상위 버전을 지원합니다.
워크로드 선택에서 을 선택합니다. NET 데스크톱 개발을 참조하십시오.
「. NET 데스크톱 개발을 선택하고 오른쪽의 설치 세부 정보에서 Windows 앱 SDK C# 템플릿을 확인합니다.
이제 설치를 시작하십시오. 다른 화면이 있지만 프로젝트를 만들 때까지 설명하지 않겠습니다.
설치가 완료되면 새 프로젝트를 만듭니다.
오른쪽 상단의 winui 검색 항목에 가 있으므로 선택하면 WinUI 3 프로젝트 템플릿이 표시되므로 아무 템플릿이나 선택하고 프로젝트를 만듭니다.
이제 WinUI 3을 사용하여 애플리케이션을 개발할 수 있습니다.
"설치되지 않은 .NET 버전 대상"이 표시되는 경우
Visual Studio 2022 버전을 17.9.1 기준으로 WinUI 3용 .NET은 .NET 6을 대상으로 합니다.
Visual Studio 2022에서 추가 런타임을 선택하지 않으면 .NET 8 런타임만 설치되고 아래와 같은 경고가 표시될 수 있습니다.
우려되는 경우 .NET 6 런타임을 설치하거나 경고를 무시할 수 있습니다. 디버그하기 위해 .NET 6 런타임을 설치할 필요가 없습니다.
나중에 WinUI 3 개발 환경을 추가하려는 경우
Visual Studio를 먼저 설치하는 경우 나중에 WinUI 3 개발 환경을 추가할 수 있습니다.
Visual Studio를 시작하고 메뉴에서 도구 > 도구 및 기능 가져오기를 선택합니다.
Visual Studio를 설치할 때와 동일한 화면이 표시되므로 를 사용할 수 있습니다. ".NET 데스크톱 개발"이 선택되어 있는지 확인하고 오른쪽의 "설치 세부 정보"에서 "Windows 앱 SDK C# 템플릿"을 선택합니다.
개발자 모드 사용
WinUI 애플리케이션은 다른 데스크톱 애플리케이션과 달리 보안이 강화된 환경에서 실행됩니다. 따라서 그대로 실행할 수 없습니다. 실행하려고 하면 아래와 같은 대화 상자가 표시되고 "개발자 모드"를 활성화하라는 메시지가 표시됩니다. 링크를 클릭하면 설정 화면이 표시되므로 "개발자 모드"를 활성화하십시오.
Visual Studio를 사용하지 않더라도 설정 화면에서 "개발자 모드"를 활성화하거나 비활성화할 수도 있습니다. 시작 메뉴에서 "설정"을 선택합니다.
System(시스템) 메뉴에서 For Developers(개발자용)를 선택합니다.
"개발자용"에 대한 토글이 있으므로 "켜기"로 설정합니다. 노트가 표시되므로 "예"를 선택하면 활성화됩니다.
.NET 8로 변경하려는 경우
이 템플릿을 사용하여 프로젝트를 만드는 경우 기본적으로 .NET 6으로 설정됩니다. 프로젝트 속성에서 대상 프레임 워크를 .NET 8로 변경하더라도 빌드에는 여전히 오류와 경고가 표시됩니다. 그러나 2024년 3월 13일경에 Windows 앱 SDK가 업데이트되어 .NET 8을 공식적으로 지원합니다.
그러나 템플릿은 여전히 .NET 6에 있으므로 프로젝트를 만든 후에는 .NET 8에서 작업해야 합니다. 향후 버전 업그레이드에서 지원될 가능성이 있을 수 있습니다.
먼저 프로젝트를 만든 다음, NuGet을 사용하여 Windows 앱 SDK 관련 버전을 업데이트합니다.
그렇지 않은 경우가 아니면 모든 것이 최신 상태입니다. Microsoft.WindowsAppSDK 1.5.XXXX 이상이어야 합니다.
프로젝트 속성에서 대상 프레임워크를 .NET 8로 변경합니다.
이 상태에서 빌드하더라도 프로젝트 설정이 오래되었기 때문에 오류가 표시됩니다.
프로젝트 파일을 코드로 엽니다.
RuntimeIdentifiers 매개 변수가 있으므로 다음과 Win10 같이 문자를 10 제거합니다.
수정 전
<RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>
↓
수정 후
<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>
또한 프로그램의 게시 설정을 다시 씁니다.
PublishProfiles 폴더> 속성에서 각 .pubxml 파일을 엽니다.
RuntimeIdentifier 마찬가지로, 의 매개 변수에서 Win10 의 10 문자를 제거합니다.
그런 다음 다시 빌드하고 오류나 경고가 없는지 확인합니다.
.pubxml (파일에 경고가 표시되지만 이 문제와 구문이 다르기 때문에 걱정할 필요가 없습니다.) )
그러나 어떤 이유로 WinUI 클래스 라이브러리는 위와 동일한 작업을 수행하더라도 계속 경고합니다. 당분간은 실행할 수 있으므로 이 문제가 해결될 때까지 기다리자.