첫 번째 앱 빌드

이 자습서에서는 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 에뮬레이터를 시작하고, 앱을 빌드하고, 에뮬레이터에 앱을 배포합니다.

    경고

    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:
  • C# 개발자 키트에 연결된 Microsoft 계정입니다.
  • 설치된 .NET SDK입니다.
  • 설치된 .NET MAUI SDK입니다.
  • Apple 플랫폼을 대상으로 하는 경우 시뮬레이터 런타임 및 Xcode 명령줄 도구를 포함하여 Mac에 설치된 Xcode입니다.
  • Android를 대상으로 하는 경우 컴퓨터에 설치된 Microsoft OpenJDK, Android SDK 및 Android 에뮬레이터입니다.

자세한 내용은 설치를 참조하세요.

앱 만들기

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

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

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

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

1. Visual Studio Code를 시작합니다. 탐색기에서, .NET 프로젝트 만들기을/를 누릅니다.

   

   또는 Windows에서 Ctrl+Shift+P 를 누르거나 macOS에서 Cmd+Shift+P 를 누른 다음 .NET: 새 프로젝트... 명령을 누릅니다.

2. 명령 팔레트에서 .NET MAUI 앱 템플릿을 선택합니다.

   

3. 프로젝트 위치 대화 상자에서 새 프로젝트를 만들 위치를 선택합니다.

   중요하다

   프로젝트를 빈 폴더에 만들어야 합니다.

4. 명령 팔레트에서 새 프로젝트의 이름을 입력하고 enter누릅니다.

   

5. 명령 팔레트에서 프로젝트 만들기을(를) 누릅니다.

   

   프로젝트가 만들어질 때까지 기다렸다가 필요한 경우 폴더를 신뢰할 수 있는 위치로 허용합니다.

6. 탐색기프로젝트의 루트 노드를 확장한 다음 MainPage.xaml.cs같은 C# 파일을 엽니다.

   

7. Visual Studio Code에서 Windows에서 Ctrl+Shift+P 를 누르거나 macOS에서 Cmd+Shift+P 를 누른 다음 .NET MAUI: Android 구성, Android 환경 새로 고침을 차례로 선택하여 Android 환경이 올바르게 구성되었는지 확인합니다. 검색된 모든 오류를 해결해야 합니다.

8. Visual Studio Code 아래쪽의 상태 표시줄에서 { } 중괄호 기호를 누르고 디버그 대상 특정 Android 에뮬레이터로 설정되어 있는지 확인합니다.

   

   Windows에서 Ctrl+Shift+P 를 누르거나 macOS에서 Cmd+Shift+P 를 누르고 .NET MAUI: 명령 팔레트에서 Android 디바이스를 선택하여 디버그 대상을 설정할 수도 있습니다.

9. F5 누르거나 Visual Studio Code의 오른쪽 위 모서리에 있는 실행 단추를 눌러 Android에서 앱을 빌드하고 실행합니다.

   

   명령 팔레트에서 디버거를 선택하라는 메시지가 표시되면 C# 선택한 다음 프로젝트에 대한 시작 구성을 선택합니다.

10. 선택한 Android 에뮬레이터에서 실행 중인 앱에서 클릭 버튼을 여러 번 누른 후, 버튼 클릭 횟수가 증가하는 것을 관찰하십시오.

    

Android 디바이스에서 앱 디버그

Android 디바이스에서 앱을 디버그하려면 다음을 수행합니다.

1. 디바이스가 배포를 위해 설정되어 있는지 확인합니다. 자세한 내용은 디바이스 설정을 참조하세요.
2. 디바이스를 머신에 연결하고 Visual Studio Code에서 디버그 대상으로 선택합니다.
3. 앱을 실행합니다.

7. Visual Studio Code에서 Cmd+Shift+P 를 누르고 .NET MAUI: Apple 구성, Apple 환경 새로 고침을 선택하여 Apple 환경이 올바르게 구성되었는지 확인합니다. 검색된 모든 오류를 해결해야 합니다.

8. Visual Studio Code 아래쪽의 상태 표시줄에서 { } 중괄호 기호를 누르고 디버그 대상 특정 iOS 시뮬레이터로 설정되어 있는지 확인합니다.

   

   Cmd+Shift+P를 누르고 .NET MAUI: 명령 팔레트에서 iOS 디바이스를 선택하여 디버그 대상을 설정할 수도 있습니다.

9. F5 누르거나 Visual Studio Code의 오른쪽 위 모서리에 있는 실행 단추를 눌러 iOS에서 앱을 빌드하고 실행합니다.

   

   명령 팔레트에서 디버거를 선택하라는 메시지가 표시되면 C# 선택한 다음 프로젝트에 대한 시작 구성을 선택합니다.

10. 선택한 iOS 시뮬레이터의 실행 중인 앱에서 클릭하세요 버튼을 여러 번 눌러보고 버튼 클릭 수가 증가하는지 관찰합니다.

    

iOS 디바이스에서 앱 디버그

iOS 디바이스에서 앱을 디버그하려면 다음을 수행합니다.

1. Xcode 설정 계정Xcode에 Apple ID를 추가했는지 확인합니다.
2. Apple 개발자 프로그램에 속한 경우 디바이스가 팀에 등록되었는지 확인합니다.
3. 디바이스에서 개발자 모드를 사용하도록 설정합니다. 앱을 처음 실행할 때 디바이스에서 팝업이 표시될 수 있습니다. 허용을 선택해야 합니다. 개발자 모드에 대한 자세한 내용은 developer.apple.com의 디바이스에서 개발자 모드 사용 활성화 섹션을 참조하세요.
4. 디바이스를 머신에 연결하고 Visual Studio Code에서 디버그 대상으로 선택합니다.
5. 앱을 실행합니다.

7. Visual Studio Code에서 Cmd+Shift+P 를 누르고 .NET MAUI: Apple 구성, Apple 환경 새로 고침을 선택하여 Apple 환경이 올바르게 구성되었는지 확인합니다. 검색된 모든 오류를 해결해야 합니다.

8. Visual Studio Code의 하단 상태 표시줄에서 중괄호 기호 { } 를 누른 다음, 디버그 대상 이 Mac으로 설정되어 있는지 확인하세요.

   

   Cmd+Shift+P를 누르고 .NET MAUI: 명령 팔레트에서 macOS 디바이스를 선택하여 디버그 대상을 설정할 수도 있습니다.

9. F5 누르거나 Visual Studio Code의 오른쪽 위 모서리에 있는 실행 단추를 눌러 macOS에서 앱을 빌드하고 실행합니다.

   

   명령 팔레트에서 디버거를 선택하라는 메시지가 표시되면 C# 선택한 다음 프로젝트에 대한 시작 구성을 선택합니다.

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

    

7. Visual Studio Code 아래쪽의 상태 표시줄에서 { } 중괄호 기호를 누르고 디버그 대상 Windows로 설정되어 있는지 확인합니다.

   

   Ctrl+Shift+P를 누르고 .NET MAUI: 명령 팔레트에서 Windows 디바이스를 선택하여 디버그 대상을 설정할 수도 있습니다.

8. F5 누르거나 Visual Studio Code의 오른쪽 위 모서리에 있는 실행 단추를 눌러 Windows에서 앱을 빌드하고 실행합니다.

   

   명령 팔레트에서 디버거를 선택하라는 메시지가 표시되면 C# 선택한 다음 프로젝트에 대한 시작 구성을 선택합니다.

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

   

문제 해결

앱이 빌드 및 배포에 실패하는 경우 의 "알려진 문제 해결"을 검토하십시오. 여기에는 문제에 대한 해결책이 있을 수 있습니다.

다음 단계

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

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