첫 번째 앱 빌드

이 자습서에서는 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 앱을 만들고 Android 에뮬레이터에서 실행합니다.

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

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

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

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에서 Command+Shift+P 를 누르고 명령 팔레트에서 .NET MAUI: Android 디바이스 선택을 선택하여 디버그 대상을 설정할 수도 있습니다.

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

   

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

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

    

Android 디바이스에서 앱 디버그

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

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

7. Apple 환경이 올바르게 구성되었는지 확인하려면 Visual Studio Code에서 CMD+SHIFT+P 을 누르고, .NET MAUI: 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. Apple 환경이 올바르게 구성되었는지 확인하려면 Visual Studio Code에서 CMD+SHIFT+P 을 누르고, .NET MAUI: 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. 실행 중인 앱에서 [클릭] 단추를 여러 번 누르고 단추 클릭 횟수가 증가하는지 확인합니다.