첫 번째 앱 빌드

이 자습서에서는 Windows의 Visual Studio 2022 또는 Windows, macOS 또는 Linux의 Visual Studio Code에서 첫 번째 .NET 다중 플랫폼 앱 UI(.NET MAUI) 앱을 만들고 실행하는 방법을 알아봅니다. 이렇게 하면 개발 환경이 올바르게 설정되었는지 확인하는 데 도움이 됩니다.

Visual Studio

필수 조건

• .NET 다중 플랫폼 앱 UI 워크로드가 설치된 Visual Studio 2022 17.12 이상. 자세한 내용은 설치를 참조하세요.

앱 만들기

이 자습서에서는 Visual Studio 2022에서 첫 번째 .NET MAUI 앱을 만들고 Android 에뮬레이터에서 실행합니다.

Windows에서 iOS용 .NET MAUI 앱을 개발하려면 Mac 빌드 호스트가 필요합니다. iOS를 대상으로 지정할 필요가 없고 Mac이 없는 경우 Android 또는 Windows를 시작하는 것이 좋습니다.

이 자습서에서는 Visual Studio에서 첫 번째 .NET MAUI 앱을 만들고 iOS 시뮬레이터에서 실행합니다.

이 자습서에서는 Visual Studio 2022에서 첫 번째 .NET MAUI 앱을 만들고 Windows에서 실행합니다.

1. Visual Studio 2022를 시작합니다. 시작 창에서 새 프로젝트 만들기를 클릭하여 새 프로젝트를 만듭니다.

   

2. 새 프로젝트 만들기 창의 모든 프로젝트 유형 드롭다운에서 MAUI를 선택하고 .NET MAUI 앱 템플릿을 선택한 다음 다음 단추를 클릭합니다.

   

3. 새 프로젝트 구성 창에서 프로젝트의 이름을 지정하고 적절한 위치를 선택한 다음 다음 단추를 클릭합니다.

   

4. 추가 정보 창에서 대상으로 지정할 .NET 버전을 선택하고 만들기 단추를 클릭합니다.

   

5. 프로젝트가 만들어지고 해당 종속성이 복원될 때까지 기다립니다.

   

6. Visual Studio 도구 모음에서 디버그 대상 드롭다운을 사용하여 Android 에뮬레이터 및 Android 에뮬레이터 항목을 선택합니다.

   

7. Visual Studio 도구 모음에서 Android 에뮬레이터 단추를 누릅니다.

   

   Visual Studio는 기본 Android SDK 및 Android Emulator 설치 프로세스를 시작합니다.

8. Android SDK - 사용권 계약 창에서 수락 단추를 누릅니다.

   

9. 사용자 계정 컨트롤 대화 상자에서 예 단추를 누릅니다.

   

   Visual Studio에서 기본 Android SDK 및 Android Emulator를 다운로드할 때까지 기다립니다.

10. 사용자 계정 컨트롤 대화 상자에서 예 단추를 누릅니다.

    

11. Android SDK 플랫폼이 누락된 대화 상자에서 설치 단추를 누릅니다.

    

12. Android SDK - 사용권 계약 창에서 수락 단추를 누릅니다.

    

    Visual Studio에서 Android SDK 구성 요소를 설치할 때까지 기다립니다.

13. 새 디바이스 창에서 만들기 단추를 누릅니다.

    

    Visual Studio가 Android 에뮬레이터를 다운로드, 압축 해제 및 만들 때까지 기다립니다.

14. Android 장치 관리자 창을 닫습니다.

    

15. Visual Studio 도구 모음에서 Pixel 7 - API 35(Android 15.0 - API 35) 단추를 누릅니다.

    

16. Android SDK - 사용권 계약 창에서 수락 단추를 누릅니다.

    

17. 사용자 계정 컨트롤 대화 상자에서 예 단추를 누릅니다.

    

    Visual Studio가 설치되어 Android SDK를 다운로드할 때까지 기다립니다.

18. Visual Studio 도구 모음에서 Pixel 7 - API 35(Android 15.0 - API 35) 단추를 눌러 앱을 빌드하고 실행합니다.

    

    Visual Studio는 Android 에뮬레이터를 시작하고, 앱을 빌드하고, 에뮬레이터에 앱을 배포합니다.

    Warning

    Android 에뮬레이터 성능을 최대화하려면 하드웨어 가속을 사용하도록 설정해야 합니다. 이렇게 하지 않으면 에뮬레이터가 매우 느리게 실행됩니다. 자세한 내용은 Android 에뮬레이터(Hyper-V 및 AEHD)를 사용하여 하드웨어 가속을 사용하도록 설정하는 방법을 참조하세요.

19. Android 에뮬레이터의 실행 중인 앱에서 클릭 단추를 여러 번 누르고 단추 클릭 횟수가 증가하는지 확인합니다.

    

문제 해결

앱이 컴파일에 실패하면 문제에 대한 해결이 있을 수 있는 알려진 문제 해결을 검토합니다. 문제가 Android 에뮬레이터와 관련된 경우 Android 에뮬레이터 문제 해결을 참조 하세요.

6. Visual Studio 도구 모음에서 Windows 컴퓨터 단추를 눌러 앱을 빌드하고 실행합니다.

   

7. 실행 중인 앱에서 [클릭] 단추를 여러 번 누르고 단추 클릭 횟수가 증가하는지 확인합니다.

   

문제 해결

앱이 컴파일에 실패하면 문제에 대한 해결이 있을 수 있는 알려진 문제 해결을 검토합니다.

6. Visual Studio에서 IDE를 Mac 빌드 호스트에 페어링합니다. 자세한 내용은 iOS 개발을 위해 Mac에 페어링을 참조하세요.

7. Visual Studio 도구 모음에서 디버그 대상 드롭다운을 사용하여 iOS 시뮬레이터 및 특정 iOS 시뮬레이터를 선택합니다.

   

8. Visual Studio 도구 모음에서 선택한 iOS 시뮬레이터의 시작 단추를 눌러 앱을 빌드하고 실행합니다.

   

   Visual Studio는 앱을 빌드하고, Windows용 원격 iOS 시뮬레이터를 시작하고, 원격 시뮬레이터에 앱을 배포합니다. Windows용 원격 iOS 시뮬레이터에 대한 자세한 내용은 Windows용 원격 iOS 시뮬레이터를 참조 하세요.

9. 실행 중인 앱에서 클릭 단추를 여러 번 누르고 단추 클릭 횟수가 증가하는지 확인합니다.

   

문제 해결

앱이 컴파일에 실패하면 문제에 대한 해결이 있을 수 있는 알려진 문제 해결을 검토합니다.

Mac Catalyst를 대상으로 하는 .NET MAUI 앱은 Visual Studio Code를 사용하여 시작 및 디버그할 수 있습니다.

Visual Studio Code

필수 조건

• .NET MAUI 확장이 설치된 Visual Studio Code. 자세한 내용은 설치를 참조하세요.

앱 만들기

새 .NET MAUI 앱을 만들려면 다음을 수행합니다.

1. Visual Studio Code를 시작합니다. 탐색기에서 탐색기에서 .NET 프로젝트 만들기를 클릭합니다. 또는 Ctrl/CMD+Shift+P .NET: 새 프로젝트...를 선택합니다.
2. .NET MAUI 앱 또는 .NET MAUI Blazor 앱을 선택합니다.
3. 빈 폴더를 선택합니다. 파일 탐색기가 다시 열리면 폴더가 비어 있지 않습니다.
4. 프로젝트의 이름을 지정합니다.
5. 프로젝트가 솔루션 탐색기 성공적으로 로드되었는지 확인하고 C# 또는 XAML 파일을 엽니다.

참고 항목

파일 > 열기... 메뉴를 통해 Visual Studio Code에서 기존 .NET MAUI 프로젝트를 열 수도 있습니다.

이제 Visual Studio Code에서 C# Dev Kit의 솔루션 탐색기 앱이 표시됩니다. .NET MAUI 확장은 C# Dev Kit에 따라 달라지므로 .NET MAUI 확장과 함께 모든 기능을 사용할 수 있습니다.

대상 디바이스 선택

대상 디바이스를 선택하려면 Visual Studio Code의 오른쪽 아래 모서리에 있는 중괄호 기호 { } 를 클릭합니다. 이 기호를 사용하여 시작 프로젝트를 변경하고, 디버그 대상을 개발 컴퓨터에서 유효한 항목으로 변경하고, Visual Studio Code 상태 표시줄에 설정을 고정할 수 있습니다.

Ctrl/CMD+Shift+P를 사용하고 ".NET MAUI"를 검색하여 명령 팔레트에서 시작 프로젝트 및 디버그 대상을 설정할 수도 있습니다.

추가 단계 없이 로컬 개발 머신(Xcode를 사용하는 Windows 데스크톱 또는 macOS)에 배포할 수 있습니다.

대상 Android

Android 에뮬레이터를 사용하려면 다음 단계에 따라 에뮬레이터를 설치하고 만듭니다.

1. 터미널에서 .로 이동합니다 <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/11.0/bin/.

2. 에뮬레이터를 설치하는 데 사용합니다 sdkmanager .

   Windows에서 터미널에서 다음 명령을 실행합니다.

   sdkmanager --install emulator
   sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   macOS에서 터미널에서 다음 명령을 실행합니다.

   ./sdkmanager --install emulator
   ./sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   참고 항목

   명령줄 인수의 sdkmanager 따옴표는 중요합니다.

3. 그런 다음 Android의 avdmanager를 사용하여 명령줄에 새 에뮬레이터를 만들 수 있습니다.

   Windows에서 터미널에서 다음 명령을 실행합니다.

   avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   macOS에서 터미널에서 다음 명령을 실행합니다.

   ./avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   참고 항목

   명령줄 인수의 avdmanager 따옴표는 중요합니다.

물리적 Android 디바이스에서 디버그할 수도 있습니다.

대상 iOS

iOS 시뮬레이터는 Xcode에 기본 제공됩니다. 시뮬레이터를 다운로드하려면 Xcode가 처음 시작될 때 설치할 옵션이 선택되어 있는지 확인하거나 Xcode > 설정 > 플랫폼으로 이동하여 설치할 시뮬레이터 런타임을 선택합니다.

iOS 디바이스를 사용하여 디버그하려면 디버그하기 전에 다음 단계를 수행합니다.

1. Xcode > 설정 계정에서 Apple ID를 > 지정합니다.
2. Apple 개발자 프로그램에 속한 경우 팀에 디바이스를 등록합니다.
3. 디바이스에서 개발자 모드 사용 설정에 설명된 대로 디바이스에서 개발자 모드를 사용하도록 설정합니다. 앱을 처음 실행할 때 디바이스에서 팝업이 표시될 수 있습니다. 허용을 선택해야 합니다.

앱 디버그

앱을 디버그하려면 Visual Studio Code의 실행 및 디버그 메뉴로 이동하고 실행 및 디버그 단추를 선택합니다. 또는 F5 키를 사용하여 디버그 세션을 시작할 수 있습니다. Visual Studio Code에서 디버거를 선택하라는 메시지가 표시되면 C#을 선택해야 합니다.

참고 항목

확장의 미리 보기 버전에서 디버거는 .NET MAUI로 나열되었습니다. 안정적인 릴리스에서 이 구성은 C#으로 대체되었습니다.

디버거는 중괄호 { } 메뉴에서 설정한 디버그 대상 및 시작 프로젝트를 자동으로 선택합니다. 아무것도 선택하지 않은 경우 디버그 대상을 선택하라는 메시지가 표시됩니다.

앱이 디버깅을 시작하면 기본 제공 Visual Studio Code 디버깅 도구를 사용하여 중단점을 설정하고 코드 전체에서 단계별로 실행할 수 있습니다.

자세한 정보

확장에 문제가 발생하는 경우 문제 해결 단계를 수행하거나 알려진 문제를 참조하거나 피드백을 제공할 수 있습니다.

다음 단계

이 자습서에서는 첫 번째 .NET 다중 플랫폼 앱 UI(.NET MAUI) 앱을 만들고 실행하는 방법을 알아보았습니다.

.NET MAUI를 사용하여 앱을 빌드하는 기본 사항을 알아보려면 .NET MAUI 앱 만들기를 참조 하세요. 또는 전체 .NET MAUI 교육 과정을 보려면 .NET MAUI를 사용하여 모바일 및 데스크톱 앱 빌드를 참조하세요.