첫 번째 앱 빌드

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

Visual Studio

필수 조건

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

앱 만들기

이 자습서에서는 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. Android SDK - 사용권 계약 창에서 수락 단추를 누릅니다.

   

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

    

11. 라이선스 승인 창에서 수락 단추를 누릅니다.

    

    Visual Studio가 Android SDK 및 Android Emulator 다운로드할 때까지 기다립니다.

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

    

    Visual Studio에서 기본 Android 에뮬레이터를 만들기 시작합니다.

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

    

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

    

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

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

    

16. Visual Studio 도구 모음에서 Pixel 5 - API 34(Android 14.0 - API 33) 단추를 눌러 앱을 빌드하고 실행합니다.

    

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

    Warning

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

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

    

문제 해결

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

6. Visual Studio 도구 모음에서 디버그 대상 드롭다운을 사용하여 프레임워크를 선택한 다음 net8.0-windows 항목을 선택합니다.

   

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

   

   개발자 모드를 사용하도록 설정하지 않은 경우 Visual Studio에서 사용하도록 설정하라는 메시지가 표시됩니다. Windows용 개발자 모드 사용 대화 상자에서 개발자의 설정을 클릭하여 설정 앱을 엽니다.

   

   설정 앱에서 개발자 모드를 켜고 고지 사항을 수락합니다.

   

   설정 앱을 닫은 다음 Windows용 개발자 모드 사용 대화 상자를 닫습니다.

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

   

문제 해결

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

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 앱은 Mac용 Visual Studio 2022를 사용하여 시작 및 디버그할 수 있습니다.

Mac용 Visual Studio

참고 항목

Mac용 Visual Studio 2024 년 8월 31일까지 은퇴할 예정입니다.Microsoft의 최신 수명 주기 정책입니다. Mac용 Visual Studio 17.6은 2024년 8월 31일까지 계속 지원되며, Apple의 보안 문제 및 업데이트된 플랫폼에 대한 서비스 업데이트가 제공됩니다. Mac에서 개발하기 위한 대체 옵션을 비롯한 자세한 내용은 Mac용 Visual Studio 무슨 일이 일어나고 있는지를 참조하세요.

필수 조건

• .NET, .NET MAUI, Android 및 iOS 워크로드가 설치된 Mac용 Visual Studio 2022 17.6. 자세한 내용은 설치를 참조하세요.

Important

.NET 8에서 Mac용 Visual Studio 사용하려면 Visual Studio > 기본 설정 > 기타 > 미리 보기 기능을 > 사용하도록 설정하려면 설치되어 있는 경우 (다시 시작해야 하는) .NET 8 SDK를 검사box를 사용합니다.

앱 만들기

이 자습서에서는 Mac용 Visual Studio 2022에서 첫 번째 .NET MAUI 앱을 만들고 선택한 플랫폼에서 실행합니다.

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

   

2. 새 프로젝트 창에 대한 템플릿 선택 창에서 다중 플랫폼 > 앱을 선택하고 .NET MAUI 앱 템플릿을 선택한 다음 계속 단추를 클릭합니다.

   

3. 새 .NET MAUI 앱 구성 창에서 대상으로 지정할 .NET 버전을 선택하고 계속 단추를 클릭합니다.

   

4. 새 .NET MAUI 앱 구성 창에서 프로젝트 이름으로 MyMauiApp을 입력하고 프로젝트에 적합한 위치를 선택한 다음 만들기 단추를 클릭합니다.

   

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

   

6. Mac용 Visual Studio 2022는 Mac에 Android SDK 구성 요소가 없는 경우 정보 표시줄을 표시합니다. 설치 단추를 클릭하여 Android SDK를 설치합니다.

   

7. Android SDK 창에서 Android 종속성 다운로드 및 설치를 자동으로 검사 상자를 선택하고 다운로드 및 설치 단추를 클릭합니다.

   

8. 라이선스 승인 창에서 수락 단추를 클릭합니다.

   

   Mac용 Visual Studio 2022에서 Android SDK를 다운로드할 때까지 기다립니다.

9. Mac용 Visual Studio 2022 도구 모음에서 디버그 대상을 Android Emulator로 변경합니다.

   

10. Mac용 Visual Studio 2022 도구 모음에서 재생 단추를 눌러 앱을 빌드하고 시작하려고 합니다.

    

    Mac용 Visual Studio 2022는 앱을 빌드한 다음 기본 Android 에뮬레이터를 만듭니다.

11. 새 디바이스 창에서 만들기 단추를 클릭합니다.

    

12. 라이선스 승인 창에서 수락 단추를 클릭합니다.

    

    Mac용 Visual Studio 2022에서 Android 에뮬레이터를 다운로드하고 설치할 때까지 기다립니다.

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

    

14. Mac용 Visual Studio 2022 도구 모음에서 디버그 대상을 Pixel 5 - API 34(API 34)로 변경합니다.

    

15. Mac용 Visual Studio 2022 도구 모음에서 재생 단추를 눌러 Android 에뮬레이터에서 앱을 시작합니다.

    

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

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

    

6. Mac용 Visual Studio 2022 도구 모음에서 디버그 대상이 iOS 시뮬레이터로 설정되어 있는지 확인합니다.

   

7. Mac용 Visual Studio 2022 도구 모음에서 재생 단추를 눌러 선택한 iOS 시뮬레이터에서 앱을 시작합니다.

   

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

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

   

6. Mac용 Visual Studio 2022 도구 모음에서 디버그 대상이 내 Mac(MacCatalyst)으로 설정되어 있는지 확인합니다.

   

7. Mac용 Visual Studio 2022에서 MyMauiApp 프로젝트를 마우스 오른쪽 단추로 클릭하고 프로젝트 파일 편집을 선택합니다. 그런 다음 프로젝트 파일 편집기에서 첫 번째 <ItemGroup>XML 앞에 다음 XML을 삽입합니다.

   <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|net8.0-maccatalyst|AnyCPU'">
       <RuntimeIdentifiers>maccatalyst-x64;maccatalyst-arm64</RuntimeIdentifiers>
   </PropertyGroup>
   

8. Mac용 Visual Studio 2022 도구 모음에서 재생 단추를 눌러 Mac에서 앱을 시작합니다.

   

   Mac용 Visual Studio 2022는 앱을 빌드하고 배포합니다.

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

   

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

Visual Studio Code(미리 보기)

참고 항목

Visual Studio Code의 .NET MAUI 지원은 아직 미리 보기로 제공됩니다. 사용해 보고 피드백을 공유하세요!

확장 설치

지침에 따라 Visual Studio Code용 .NET MAUI 확장을 설정합니다.

앱 만들기

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

1. 탐색기에서 .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 상태 표시줄에 설정을 고정할 수 있습니다.

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

기본적으로 로컬 macOS 또는 Windows 개발 머신에 배포할 수 있습니다. macOS에서 iOS 시뮬레이터에 배포할 수도 있습니다.

Android 에뮬레이터를 사용하려면 다음 단계를 수행합니다.

1. 터미널에서 .로 이동합니다 <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/latest/bin/.
2. sdkmanager --install system-images;android-33;google_apis;x86_64 Windows 또는 ./sdkmanager --install emulator macOS에서 실행 sdkmanager --install emulator 합니다./sdkmanager --install system-images;android-33;google_apis;x86_64.
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" 수 있습니다.

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

앱 디버그

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

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

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

자세한 정보

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

다음 단계

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

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