개발 환경을 설정하고 첫 번째 .NET MAUI(.NET 다중 플랫폼 앱 UI) 앱을 빌드합니다.
Visual Studio 2022의 시스템 요구 사항을 확인하세요.
10분 + 다운로드/설치 시간
Windows 및 Android에서 실행되는 모바일 및 데스크톱 앱으로 Hello, World!
메시지를 표시합니다.
Mac 및 Android에서 실행되는 모바일 및 데스크톱 앱으로 Hello, World!
메시지를 표시합니다.
Visual Studio 2022를 다운로드하여 설치합니다.
설치하는 동안 .NET 다중 플랫폼 앱 UI 개발 워크로드를 선택해야 합니다. 위의 링크를 사용하면 다음 이미지에 표시된 대로 모든 필수 구성 요소를 올바르게 선택해야 합니다.
Visual Studio 2022가 이미 있는 경우 설치를 업데이트하여 .NET MAUI 지원을 추가할 수 있습니다.
Mac용 Visual Studio 2022를 다운로드하여 설치합니다.
설치 중에 다음 워크로드가 선택되었는지 확인하세요.
.NET MAUI를 선택하면 마지막 두 워크로드(Android 및 iOS)가 자동으로 선택됩니다.
이 자습서는 최신 버전의 Mac용 Visual Studio에 최적화되어 있습니다. Mac용 Visual Studio 2022가 이미 있는 경우 업데이트를 확인할 수 있습니다.
.NET MAUI 앱을 빌드하려면 다음도 필요합니다.
Apple ID
Apple ID가 아직 없는 경우 https://appleid.apple.com에서 새 ID를 만들 수 있습니다. Xcode를 설치하고 로그인하려면 Apple ID가 필요합니다.
Xcode를 설치한 후 Xcode를 열고 서비스 약관에 동의하고 메시지가 표시되면 선택적 구성 요소를 설치해야 합니다.
새 .NET MAUI 앱 만들기:
새 프로젝트 만들기 창의 모든 프로젝트 유형 드롭다운에서 MAUI를 선택하고 .NET MAUI 앱 템플릿을 선택한 다음 다음 버튼을 클릭합니다.
새 프로젝트 구성 창에서 프로젝트 이름으로 MyFirstMauiApp을 입력하고 다음 버튼을 클릭합니다.
아직 선택하지 않은 경우 추가 정보 창의 Framework 드롭다운에서 .NET 7.0(표준 기간 지원)을 선택하고 만들기 버튼을 클릭합니다.
Visual Studio는 새 프로젝트를 만듭니다. 일부 기능을 차단하는 방화벽에 대한 Windows 보안 경고가 표시되면 액세스 허용 단추를 선택합니다.
NuGet은 새 앱의 종속성을 가져오는 패키지 관리자입니다.
패키지 복원 프로세스가 자동으로 시작됩니다. 화면 왼쪽 하단의 상태 표시줄에 복원됨 또는 준비됨 메시지가 나타날 때까지 기다립니다.
새 프로젝트의 템플릿 선택 창에서 다중 플랫폼 > 앱을 선택하고 .NET MAUI 앱 템플릿을 선택한 다음 계속 버튼을 클릭합니다.
새 .NET MAUI 앱 구성 창에서 아직 선택하지 않은 경우 대상 프레임워크 드롭다운에서 .NET 7.0을 선택하고 계속 버튼을 클릭합니다.
프로젝트 이름으로 MyFirstMauiApp을 입력하고 만들기 버튼을 클릭합니다.
이 자습서에서는 먼저 로컬 Windows 머신에 .NET MAUI 응용 프로그램을 배포하는 데 중점을 둡니다. 나중에 Android 장치 또는 에뮬레이터를 설정하는 옵션이 제공됩니다.
Visual Studio 도구 모음에서 기본적으로 디버그 대상으로 Windows 컴퓨터가 표시되어야 합니다. Windows 컴퓨터 버튼을 눌러 앱을 빌드하고 실행합니다.
아직 개발자 모드를 활성화하지 않은 경우 Visual Studio에서 활성화하라는 메시지를 표시합니다. Windows용 개발자 모드 사용 대화 상자에서 개발자를 위한 설정 링크를 클릭하여 설정 앱을 엽니다.
개발자 모드에서 토글을 켭니다.
개발자 기능 사용 대화 상자가 표시됩니다. 개발자 모드를 사용하도록 설정하려면 예를 선택합니다.
설정 앱을 닫은 다음 Windows용 개발자 모드 사용 대화 상자를 닫습니다. 앱이 실행되기 시작해야 합니다.
실행 중인 앱에서 클릭하세요 버튼을 몇 번 선택하고 버튼 클릭 수가 증가하는지 확인합니다.
이 자습서에서는 먼저 로컬 Mac 컴퓨터에 .NET MAUI 응용 프로그램을 배포하는 데 중점을 둡니다. 나중에 Android 장치 또는 에뮬레이터를 설정하는 옵션이 제공됩니다.
Visual Studio 도구 모음에서 기본적으로 디버그 대상으로 My Mac이 표시되어야 합니다. 재생 아이콘(▶)을 눌러 앱을 빌드하고 실행합니다.
실행 중인 앱에서 클릭하세요 버튼을 몇 번 선택하고 버튼 클릭 수가 증가하는지 확인합니다.
축하합니다. 첫 번째 .NET MAUI 앱을 빌드하고 실행했습니다! 앱을 계속 실행하고 자습서를 계속 진행합니다.
.NET MAUI를 사용하여 응용 프로그램을 개발할 때 응용 프로그램을 디버깅할 때 XAML 핫 다시 로드를 사용할 수 있습니다. 즉, 응용 프로그램이 실행되는 동안 XAML UI(사용자 인터페이스)를 변경할 수 있으며 UI가 자동으로 업데이트됩니다.
Visual Studio로 돌아가서 앱을 실행 중인 상태로 둡니다. 솔루션 탐색기에서 MyFirstMauiApp
프로젝트 아래의 MainPage.xaml
파일을 두 번 클릭합니다. 솔루션 탐색기 창이 표시되지 않으면 기본 메뉴에서 보기 > 솔루션 탐색기를 선택하세요(또는 CTRL+ALT+L 누름).
Visual Studio로 돌아가서 앱을 실행 중인 상태로 둡니다. 솔루션 창에서 MyFirstMauiApp
프로젝트 아래의 MainPage.xaml
파일을 두 번 클릭합니다. 솔루션 창이 표시되지 않으면 기본 메뉴에서 보기 > 솔루션을 선택하세요.
현재 첫 번째 Label
의 Text
는 다음 코드에 표시된 대로 Hello, World!
(으)로 설정되어 있습니다.:
<Label
Text="Hello, World!"
SemanticProperties.HeadingLevel="Level1"
FontSize="32"
HorizontalOptions="Center" />
Hello, .NET MAUI!
를 읽으려면 텍스트를 업데이트하세요.
<Label
Text="Hello, .NET MAUI!"
SemanticProperties.HeadingLevel="Level1"
FontSize="32"
HorizontalOptions="Center" />
변경할 때 앱 UI가 자동으로 업데이트됩니다.
.NET MAUI로 애플리케이션을 개발할 때 .NET 핫 다시 로드를 사용하여 C# 코드를 다시 로드할 수도 있습니다. 버튼을 클릭할 때 1이 아닌 10으로 카운트를 증가시키도록 애플리케이션의 논리를 수정해 보겠습니다.
MainPage.xaml.cs
(이 파일은 MainPage.xaml 아래에 중첩되어 있거나 마우스 오른쪽 단추를 클릭하고 메뉴에서 [코드 보기]를 선택할 수 있습니다)를 엽니다.
현재 해당 파일의 OnCounterClicked
메서드에 다음 코드가 있습니다.
private void OnCounterClicked(object sender, EventArgs e)
{
count++;
if (count == 1)
CounterBtn.Text = $"Clicked {count} time";
else
CounterBtn.Text = $"Clicked {count} times";
SemanticScreenReader.Announce(CounterBtn.Text);
}
count++;
를 count += 10;
(으)로 변경하여 10씩 증가하도록 업데이트합니다.
private void OnCounterClicked(object sender, EventArgs e)
{
count += 10;
if (count == 1)
CounterBtn.Text = $"Clicked {count} time";
else
CounterBtn.Text = $"Clicked {count} times";
SemanticScreenReader.Announce(CounterBtn.Text);
}
코드 변경 내용을 적용하려면 Visual Studio에서 [핫 다시 로드] 버튼을 선택하거나 ALT+F10을 선택하세요.
클릭하세요 단추를 선택하고 10씩 증가하는 것을 볼 수 있습니다. 잘 했어요! 지금 실행 중인 앱을 닫을 수 있습니다.
개발 환경에 따라 하나 이상의 플랫폼에 배포하도록 결정할 수 있습니다. 방금 실행하여 Windows에 앱을 배포했습니다. 이제 Android 장치 또는 에뮬레이터를 설정하겠습니다.
디버그 대상 드롭다운 메뉴의 프레임워크에서 net7.0-android를 선택합니다.
프로젝트를 빌드하려면 Android SDK의 특정 버전이 필요합니다. Android SDK 라이선스에 동의하지 않은 경우 오류 목록 창에 다음 오류 메시지가 표시됩니다.
라이선스 승인 프로세스를 시작하려면 메시지를 두 번 클릭하십시오. 존재하는 각 라이선스에 대해 허용을 클릭하면 자동 설치가 시작됩니다.
배포할 Android 장치가 없는 경우 다음 단계에 따라 Android 에뮬레이터를 설정할 수 있습니다. 이미 이 작업을 수행했거나 자신의 Android 장치를 사용하려는 경우 이 단계를 건너뛸 수 있습니다.
.NET MAUI 애플리케이션을 처음 빌드하는 경우 디버그 대상 드롭다운 메뉴에서 Android Emulator가 선택된 것을 볼 수 있습니다. 이를 클릭하면 생성 프로세스가 시작됩니다. 라이선스 수락 대화상자가 표시되면 수락를 선택합니다.
그러면 새 장치 창이 나타납니다. 만들기 버튼을 선택하여 기본 설정으로 에뮬레이터를 만듭니다. 그러면 에뮬레이터 이미지가 다운로드되고 Visual Studio에서 사용할 에뮬레이터 생성이 완료됩니다. 이 단계는 시간이 걸릴 수 있습니다.
에뮬레이터가 생성되면 시작이라는 버튼이 표시됩니다. 클릭하세요.
Windows 하이퍼바이저 플랫폼을 활성화하라는 메시지가 나타날 수 있습니다. 문서에 따라 가속을 활성화하여 성능을 향상시키세요(에뮬레이터를 시작하고 실행하는 데 필요).
Android 에뮬레이터가 시작됩니다. 시작이 완료될 때까지 기다리면 Visual Studio 디버그 메뉴에 표시됩니다. 다소 시간이 걸릴 수 있습니다.
현재 Android 에뮬레이터가 만들어졌으며 사용할 준비가 되었습니다. 다음에 Visual Studio를 실행하면 에뮬레이터가 디버그 대상 창에 직접 나타나며 이를 선택하면 시작됩니다. 문제가 발생하거나 에뮬레이터에 성능 문제가 발생하는 경우 전체 설치 설명서 documentation를 검토합니다.
개발 환경에 따라 하나 이상의 플랫폼에 배포하도록 결정할 수 있습니다. 방금 실행하여 Mac에 앱을 배포했습니다. 이제 Android 장치 또는 에뮬레이터를 설정하겠습니다.
.NET MAUI 애플리케이션을 처음 빌드하는 경우 새 Android Emulator를 만들어야 합니다. 디버그 메뉴에 Android Emulator가 표시됩니다. 재생 아이콘(▶)을 눌러 생성 프로세스를 시작합니다.
기본 에뮬레이터에 대한 옵션이 자동으로 채워집니다. 필요한 경우 옵션을 변경한 다음 만들기를 선택합니다.
이 시점에서 Android 에뮬레이터에 대한 라이선스 계약에 동의하라는 메시지가 표시될 수 있습니다. 내용을 읽고 동의를 선택하여 프로세스를 계속하세요. 그러면 에뮬레이터 이미지가 다운로드되고 Visual Studio에서 사용할 에뮬레이터 생성이 완료됩니다.
에뮬레이터가 생성되면 재생이라는 버튼이 표시됩니다. 클릭하세요.
Android 에뮬레이터가 실행됩니다. 시작이 완전히 끝날 때까지 기다리면 Visual Studio 디버그 메뉴에 표시됩니다. 하드웨어 가속을 사용하지 않는 경우 시간이 걸릴 수 있습니다.
현재 Android 에뮬레이터가 만들어졌으며 사용할 준비가 되었습니다. 다음에 Visual Studio를 실행하면 에뮬레이터가 디버그 대상 창에 직접 나타나며 이를 선택하면 시작됩니다. 문제가 발생하거나 에뮬레이터에 성능 문제가 발생하는 경우 전체 설치 설명서 documentation를 검토합니다.
Android 장치로 개발하려면 USB 디버깅을 사용하도록 설정해야 합니다. 디바이스에서 다음 단계를 수행하여 Visual Studio에 연결합니다. Android 디바이스가 없는 경우 이 섹션을 건너뛸 수 있습니다.
개발자 모드 활성화
USB 디버깅 상태 확인
신뢰 장치
이제 장치가 구성되었으며 Visual Studio에 배포 대상으로 표시됩니다.
문제가 있나요? 설명서를 확인하세요.
이제 에뮬레이터 또는 장치가 배포를 위해 구성되어야 합니다!
디바이스 또는 에뮬레이터가 디버그 대상으로 선택되어 있는지 확인하세요.
메뉴에서 디버그 > 디버깅 시작을 선택하거나 F5를 누르세요. 이 옵션을 사용하지 않도록 설정하려면 에뮬레이터 또는 장치가 선택되어 있는지 확인하세요.
메뉴에서 디버그 > 디버깅 시작을 선택합니다. 이 옵션이 비활성화된 경우 에뮬레이터 또는 장치가 선택되어 있는지 확인하세요.
애플리케이션이 선택한 Android 디바이스/에뮬레이터를 빌드하고 배포한 후 실행됩니다.
축하합니다. 첫 번째 .NET MAUI 앱을 빌드하고 실행했습니다!
이제 기본 사항을 확인했으므로 Microsoft Learn 자체 기반 학습 경로를 사용하여 .NET MAUI 앱을 빌드하는 방법을 계속 학습하세요.
James가 전체 .NET MAUI 앱을 처음부터 끝까지 빌드하는 과정을 안내합니다.
귀하는 다음 항목에도 또한 관심이 있을 수 있습니다...