Android Device Manager를 사용하여 가상 디바이스 관리

이 문서에서는 Android Device Manager를 사용하여 물리적 Android 디바이스를 에뮬레이트하는 AVD(Android 가상 디바이스)를 만들고 구성하는 방법을 설명합니다. 물리적 디바이스에 의존하지 않고도 이러한 가상 디바이스를 사용하여 앱을 실행하고 테스트할 수 있습니다.

(에뮬레이터 성능에 대한 하드웨어 가속에 설명된 대로) 하드웨어 가속이 활성화된 것을 확인한 후에 다음 단계는 Android Device Manager(Xamarin Android Device Manager라고도 함)를 사용하여 앱을 테스트하고 디버깅하는 데 사용할 수 있는 가상 디바이스를 만드는 것입니다.

Windows의 Android Device Manager

이 문서에서는 Android Device Manager를 사용하여 Android 가상 디바이스를 만들고, 복제하고, 사용자 지정하고, 실행하는 방법을 설명합니다.

Screenshot of the Android Device Manager in the Devices tab

Android Device Manager를 사용하여 Android Emulator에서 실행되는 AVD(Android 가상 디바이스)를 만들고 구성합니다. 각 AVD는 실제 Android 디바이스를 시뮬레이션하는 에뮬레이터 구성입니다. 이를 통해 여러 실제 Android 디바이스를 시뮬레이션하는 다양한 구성에서 앱을 실행하고 테스트할 수 있습니다.

요구 사항

Android Device Manager를 사용하려면 다음 항목이 필요합니다.

  • Visual Studio 2019 Community, Professional 또는 Enterprise.

  • 또는 Visual Studio 2017 버전 15.8 이상이 필요합니다. Visual Studio Community, Professional 및 Enterprise 버전이 지원됩니다.

  • Visual Studio Tools for Xamarin 버전 4.9 이상

  • Android SDK를 설치해야 합니다(Xamarin.Android에 대한 Android SDK 설정 참조). 아직 설치되지 않은 경우 기본 위치에 Android SDK를 설치 해야 합니다. C:\Program Files (x86)\Android\android-sdk.

  • Android SDK Manager를 통해 다음 패키지를 설치해야 합니다.

    • Android SDK Tools 버전 26.1.1 이상
    • Android SDK 플랫폼 도구 27.0.1 이상
    • Android SDK 빌드 도구 27.0.3 이상
    • Android Emulator 27.2.7 이상.

    이러한 패키지는 다음 스크린샷에 표시된 대로 설치됨 상태로 표시됩니다.

    Installing Android SDK Tools

디바이스 관리자 실행

도구 Android Android 장치 관리자 클릭하여 >도구 메뉴에서 Android > 장치 관리자 시작합니다.

Launching the Device manager from the Tools menu

시작 시 다음 오류 대화 상자가 표시되면 문제 해결 섹션에서 해결 방법 지침을 참조하세요.

Android SDK instance error dialog

주 화면

Android 디바이스 관리자를 처음 실행하면 현재 구성된 모든 가상 디바이스가 화면에 표시됩니다. 각 가상 디바이스에 대해 이름, OS(Android 버전), 프로세서, 메모리 크기 및 화면 해상도가 표시됩니다.

List of installed devices and their parameters

목록에서 디바이스를 선택하면 시작 단추가 오른쪽에 나타납니다. 시작 단추를 클릭하면 이 가상 디바이스로 에뮬레이터를 시작할 수 있습니다.

Start button for a device image

선택한 가상 디바이스로 에뮬레이터가 시작되면 시작 단추가 에뮬레이터를 중지하는 데 사용할 수 있는 중지 단추로 변경됩니다.

Stop button for the running device

새 디바이스

새 디바이스를 만들려면 새로 만들기 단추(화면의 오른쪽 상단에 있음)를 클릭합니다.

New button for creating a new device

새로 만들기를 클릭하면 새 디바이스 화면이 열립니다.

New Device screen of the Device Manager

새 디바이스 화면에서 새 디바이스를 구성하려면 다음 단계를 따르세요.

  1. 디바이스에 새 이름을 지정합니다. 다음 예제에서는 새 디바이스에 Pixel_API_27이라는 이름을 지정합니다.

    Naming the new device

  2. 기본 디바이스 풀 다운 메뉴를 클릭하여 에뮬레이트할 실제 디바이스를 선택합니다.

    Selecting the physical device to emulate

  3. 프로세서 풀 다운 메뉴를 클릭하여 이 가상 디바이스의 프로세서 유형을 선택합니다. x86을 선택하면 에뮬레이터가 하드웨어 가속을 활용할 수 있으므로 최상의 성능을 제공합니다. x86_64 옵션도 하드웨어 가속을 사용하지만 x86보다 약간 느리게 실행됩니다(x86_64는 일반적으로 64비트 응용 프로그램 테스트를 위해 사용).

    Selecting the processor type

  4. OS 풀 다운 메뉴를 클릭하여 Android 버전(API 수준)을 선택합니다. 예를 들어 Oreo 8.1 - API 27을 선택하여 API 레벨 27에 대한 가상 디바이스를 만듭니다.

    Selecting the Android version

    아직 설치되지 않은 Android API 수준을 선택하면 장치 관리자 화면 아래쪽에 새 디바이스가 다운로드되는 메시지가 표시됩니다. 새 가상 디바이스를 만들 때 필요한 파일을 다운로드하고 설치합니다.

    A new device image will be downloaded

  5. 가상 디바이스에 Google Play Services API를 포함하려면 Google API 옵션을 사용하도록 설정합니다. Google Play 스토어 앱을 포함하려면 Google Play 스토어 옵션을 사용하도록 설정합니다.

    Selecting Google Play Services and Google Play Store

    Google Play 스토어 이미지는 픽셀, 픽셀 2, Nexus 5 및 Nexus 5X와 같은 몇 가지 기본 디바이스 유형에만 사용할 수 있습니다.

  6. 수정해야 하는 모든 속성을 편집합니다. 속성을 변경하려면 Android 가상 디바이스 속성 편집을 참조하세요.

  7. 명시적으로 설정해야 하는 추가 속성을 추가합니다. 새 디바이스 화면에는 가장 일반적으로 수정되는 속성만 나열되지만 속성 추가 풀 다운 메뉴(하단에서)를 클릭하여 추가 속성을 추가할 수 있습니다.

    Add Property pull-down menu

    속성 목록 맨 위에 있는 사용자 지정... 을 선택하여 사용자 지정 속성을 정의할 수도 있습니다.

  8. 만들기 단추(오른쪽 하단)를 클릭하여 새 디바이스를 만듭니다.

    Create button

  9. 라이선스 승인 화면이 표시될 수 있습니다. 사용 조건에 동의하면 동의를 클릭합니다.

    License Acceptance screen

  10. Android Device Manager는 디바이스 생성 중 만드는 중 진행률 표시기를 표시하는 동안 설치된 가상 디바이스 목록에 새 디바이스를 추가합니다.

    Creation progress Indicator

  11. 만들기 프로세스가 완료되면 설치된 가상 디바이스 목록에 실행할 준비가 된 새 디바이스와 시작 단추가 표시됩니다.

    Newly-created device ready to launch

디바이스 편집

기존 가상 디바이스를 편집하려면 디바이스를 선택하고 (화면 오른쪽 상단에 있는) 편집 단추를 클릭합니다.

Edit button for modifying a device

편집을 클릭하면 선택된 가상 디바이스에 대한 디바이스 편집기가 실행됩니다.

Device Editor screen

디바이스 편집기 화면에는 가상 디바이스의 속성이 열에 각 속성의 해당 값과 함께 속성 열 아래에 나열됩니다. 속성을 선택하면 속성에 대한 자세한 설명이 오른쪽에 표시됩니다.

속성을 변경하려면 열에서 해당 값을 편집합니다. 예를 들어 다음 스크린샷에서 hw.lcd.density 속성은 480에서 240으로 변경됩니다.

Device Editing example

필요한 구성을 변경했으면 저장 단추를 클릭합니다. 가상 디바이스 속성을 변경하는 방법에 대한 자세한 내용은 Android 가상 디바이스 속성 편집을 참조하세요.

추가 옵션

디바이스 작업에 대한 추가 옵션은 오른쪽 위 모서리에 있는 추가 옵션 (...) 풀다운 메뉴에서 사용할 수 있습니다.

Location of additional options menu

추가 옵션 메뉴에는 다음 항목이 포함되어 있습니다.

  • 복제 및 편집 – 현재 선택한 디바이스를 복제하고 다른 고유한 이름으로 새 디바이스 화면에서 엽니다. 예를 들어 Pixel_API_27을 선택하고 복제 및 편집을 클릭하면 이름에 카운터가 추가됩니다.

    Duplicate and Edit screen

  • 탐색기 에서 표시 – 가상 디바이스에 대한 파일을 보관하는 폴더에서 Windows 탐색기 창을 엽니다. 예를 들어 Pixel_API_27을 선택하고 탐색기에 표시를 클릭하면 다음 예제와 같은 창이 열립니다.

    Results of clicking Reveal in Explorer

  • 공장 재설정 – 선택한 디바이스를 기본 설정으로 다시 설정하여 실행 중인 디바이스의 내부 상태에 대한 사용자 변경 내용을 지웁니다(현재 빠른 부팅 스냅샷 지웁니다(있는 경우). 생성 및 편집 중에 가상 디바이스에서 수정된 내용은 이러한 변경의 영향을 받지 않습니다. 이러한 재설정을 수행할 수 없음을 알리는 대화 상자가 표시됩니다. 공장 재설정을 클릭하여 재설정을 확인합니다.

    Factory Reset dialog

  • 삭제 – 선택한 가상 디바이스를 영구적으로 삭제합니다. 디바이스 삭제는 실행 취소할 수 없음을 알리는 대화 상자가 표시됩니다. 디바이스를 삭제하려는 것이 확실한 경우 삭제를 클릭합니다.

    Delete device dialog

참고 항목

M1과 같은 Apple 칩으로 Mac을 사용하는 경우 GitHub에서 M1 미리 보기용 Android Emulator를 설치해야 합니다.

macOS의 Android Device Manager

이 문서에서는 Android Device Manager를 사용하여 Android 가상 디바이스를 만들고, 복제하고, 사용자 지정하고, 실행하는 방법을 설명합니다.

Screenshot of the Android Device Manager in the Devices tab

Android Device Manager를 사용하여 Android Emulator에서 실행되는 AVD(Android 가상 디바이스)를 만들고 구성합니다. 각 AVD는 실제 Android 디바이스를 시뮬레이션하는 에뮬레이터 구성입니다. 이를 통해 여러 실제 Android 디바이스를 시뮬레이션하는 다양한 구성에서 앱을 실행하고 테스트할 수 있습니다.

요구 사항

Android Device Manager를 사용하려면 다음 항목이 필요합니다.

  • Mac용 Visual Studio 7.6 이상.

  • Android SDK를 설치해야 합니다(Xamarin.Android에 대한 Android SDK 설정 참조).

  • Android SDK Manager를 통해 다음 패키지를 설치해야 합니다.

    • SDK 도구 버전 26.1.1 이상
    • Android SDK 플랫폼 도구 28.0.1 이상
    • Android SDK 빌드 도구 26.0.3 이상

    이러한 패키지는 다음 스크린샷에 표시된 대로 설치됨 상태로 표시됩니다.

    Installing Android SDK Tools

디바이스 관리자 실행

도구 > 장치 관리자 클릭하여 Android 장치 관리자 시작합니다.

Launching the Device manager from the Tools menu

시작 시 다음 오류 대화 상자가 표시되면 문제 해결 섹션에서 해결 방법 지침을 참조하세요.

Screenshot shows the Android SDK instance error dialog box for troubleshooting information.

주 화면

Android 디바이스 관리자를 처음 실행하면 현재 구성된 모든 가상 디바이스가 화면에 표시됩니다. 각 가상 디바이스에 대해 이름, OS(Android 버전), 프로세서, 메모리 크기 및 화면 해상도가 표시됩니다.

List of installed devices and their parameters

목록에서 디바이스를 선택하면 재생 단추가 오른쪽에 나타납니다. 재생 단추를 클릭하면 이 가상 디바이스로 에뮬레이터를 시작할 수 있습니다.

Play button for a device image

선택한 가상 디바이스로 에뮬레이터가 시작되면 재생 단추가 에뮬레이터를 중지하는 데 사용할 수 있는 중지 단추로 변경됩니다.

Stop button for the running device

에뮬레이터를 중지하면 다음 빠른 부팅을 위해 현재 상태를 저장할지 묻는 메시지가 표시될 수 있습니다.

Save current state for Quick Boot dialog

현재 상태를 저장하면 이 가상 디바이스를 다시 시작할 때 에뮬레이터가 더 빨리 부팅됩니다. 빠른 부팅에 대한 자세한 내용은 빠른 부팅을 참조하세요.

새 디바이스

새 디바이스를 만들려면 새 디바이스 단추(화면의 왼쪽 상단에 있음)를 클릭합니다.

New button for creating a new device

새 디바이스를 클릭하면 새 디바이스 화면이 열립니다.

New Device screen of the Device Manager

새 디바이스 화면에서 새 디바이스를 구성하려면 다음 단계를 따르세요.

  1. 디바이스에 새 이름을 지정합니다. 다음 예제에서는 새 디바이스에 Pixel_API_27이라는 이름을 지정합니다.

    Naming the new device

  2. 기본 디바이스 풀 다운 메뉴를 클릭하여 에뮬레이트할 실제 디바이스를 선택합니다.

    Selecting the physical device to emulate

  3. 프로세서 풀 다운 메뉴를 클릭하여 이 가상 디바이스의 프로세서 유형을 선택합니다. x86을 선택하면 에뮬레이터가 하드웨어 가속을 활용할 수 있으므로 최상의 성능을 제공합니다. x86_64 옵션도 하드웨어 가속을 사용하지만 x86보다 약간 느리게 실행됩니다(x86_64는 일반적으로 64비트 응용 프로그램 테스트를 위해 사용).

    Selecting the processor type

  4. OS 풀 다운 메뉴를 클릭하여 Android 버전(API 수준)을 선택합니다. 예를 들어 Oreo 8.1 - API 27을 선택하여 API 레벨 27에 대한 가상 디바이스를 만듭니다.

    Selecting the Android version

    아직 설치되지 않은 Android API 수준을 선택하면 장치 관리자 화면 아래쪽에 새 디바이스가 다운로드되는 메시지가 표시됩니다. 새 가상 디바이스를 만들 때 필요한 파일을 다운로드하고 설치합니다.

    A new device image will be downloaded

  5. 가상 디바이스에 Google Play Services API를 포함하려면 Google API 옵션을 사용하도록 설정합니다. Google Play 스토어 앱을 포함하려면 Google Play 스토어 옵션을 사용하도록 설정합니다.

    Selecting Google Play Services and Google Play Store

    Google Play 스토어 이미지는 픽셀, 픽셀 2, Nexus 5 및 Nexus 5X와 같은 몇 가지 기본 디바이스 유형에만 사용할 수 있습니다.

  6. 수정해야 하는 모든 속성을 편집합니다. 속성을 변경하려면 Android 가상 디바이스 속성 편집을 참조하세요.

  7. 명시적으로 설정해야 하는 추가 속성을 추가합니다. 새 디바이스 화면에는 가장 일반적으로 수정되는 속성만 나열되지만 속성 추가 풀 다운 메뉴(하단에서)를 클릭하여 추가 속성을 추가할 수 있습니다.

    Add Property pull-down menu

    이 속성 목록 맨 위에 있는 사용자 지정... 을 클릭하여 사용자 지정 속성을 정의할 수도 있습니다.

  8. 만들기 단추(오른쪽 하단)를 클릭하여 새 디바이스를 만듭니다.

    Create button

  9. Android Device Manager는 디바이스 생성 중 만드는 중 진행률 표시기를 표시하는 동안 설치된 가상 디바이스 목록에 새 디바이스를 추가합니다.

    Creation progress indicator

  10. 만들기 프로세스가 완료되면 설치된 가상 디바이스 목록에 실행할 준비가 된 새 디바이스와 시작 단추가 표시됩니다.

    Newly-created device ready to launch

디바이스 편집

기존 가상 디바이스를 편집하려면 추가 옵션 풀 다운 메뉴(기어 아이콘)을 선택하고 편집을 선택합니다.

Edit menu selection for modifying a new device

편집을 클릭하면 선택된 가상 디바이스에 대한 디바이스 편집기가 실행됩니다.

Device Editor screen

디바이스 편집기 화면에는 가상 디바이스의 속성이 열에 각 속성의 해당 값과 함께 속성 열 아래에 나열됩니다. 속성을 선택하면 속성에 대한 자세한 설명이 오른쪽에 표시됩니다.

속성을 변경하려면 열에서 해당 값을 편집합니다. 예를 들어 다음 스크린샷에서 hw.lcd.density 속성은 480에서 240으로 변경됩니다.

Device Editing example

필요한 구성을 변경했으면 저장 단추를 클릭합니다. 가상 디바이스 속성을 변경하는 방법에 대한 자세한 내용은 Android 가상 디바이스 속성 편집을 참조하세요.

추가 옵션

디바이스를 사용하기 위한 추가 옵션은 재생 단추의 왼쪽에 있는 풀 다운 메뉴에서 사용할 수 있습니다.

Location of additional options menu

추가 옵션 메뉴에는 다음 항목이 포함되어 있습니다.

  • 편집 – 앞에서 설명한 대로 디바이스 편집기에서 현재 선택한 디바이스를 엽니다.

  • 복제 및 편집 – 현재 선택한 디바이스를 복제하고 다른 고유한 이름으로 새 디바이스 화면에서 엽니다. 예를 들어 Pixel 2 API 28을 선택하고 복제 및 편집을 클릭하면 이름에 카운터가 추가됩니다.

    Duplicate and Edit screen

  • Finder 에서 표시 – 가상 디바이스에 대한 파일을 보관하는 폴더에서 macOS Finder 창을 엽니다. 예를 들어 Pixel 2 API 28을 선택하고 Finder에 표시를 클릭하면 다음 예제와 같은 창이 열립니다.

    Results of clicking Reveal in Finder

  • 공장 재설정 – 선택한 디바이스를 기본 설정으로 다시 설정하여 실행 중인 디바이스의 내부 상태에 대한 사용자 변경 내용을 지웁니다(현재 빠른 부팅 스냅샷 지웁니다(있는 경우). 생성 및 편집 중에 가상 디바이스에서 수정된 내용은 이러한 변경의 영향을 받지 않습니다. 이러한 재설정을 수행할 수 없음을 알리는 대화 상자가 표시됩니다. 공장 재설정을 클릭하여 재설정을 확인합니다.

    Factory reset dialog

  • 삭제 – 선택한 가상 디바이스를 영구적으로 삭제합니다. 디바이스 삭제는 실행 취소할 수 없음을 알리는 대화 상자가 표시됩니다. 디바이스를 삭제하려는 것이 확실한 경우 삭제를 클릭합니다.

    Delete device dialog


문제 해결

다음 섹션에서는 Android Device Manager를 사용하여 가상 디바이스를 구성할 때 발생할 수 있는 문제를 진단하고 해결하는 방법을 설명합니다.

표준이 아닌 위치의 Android SDK

일반적으로 Android SDK는 다음 위치에 설치됩니다.

C:\Program Files (x86)\Android\android-sdk

이 위치에 SDK가 설치되지 않은 경우 Android Device Manager를 실행할 때 이 오류가 나타날 수 있습니다.

Android SDK instance error

이 문제를 해결하려면 다음 단계를 수행합니다.

  1. Windows 데스크톱에서 C:\Users\username\AppData\Roaming\XamarinDeviceManager로 이동합니다.

    Android Device Manager log file location

  2. 로그 파일 중 하나를 두 번 클릭하여 열고 구성 파일 경로를 찾습니다. 예시:

    Config file path in log file

  3. 이 위치로 이동하고 user.config를 두 번 클릭하여 엽니다.

  4. user.config에서 <UserSettings> 요소를 찾아 AndroidSdkPath 특성을 추가합니다. 컴퓨터에서 Android SDK를 설치한 경로에 이 특성을 저장하고 파일을 저장합니다. 예를 들어 <UserSettings> Android SDK가 C:\Programs\Android\SDK설치된 경우 다음과 같습니다.

    <UserSettings SdkLibLastWriteTimeUtcTicks="636409365200000000" AndroidSdkPath="C:ProgramsAndroidSDK" />
    

user.config를 이와 같이 변경한 후에는 Android Device Manager를 실행할 수 있어야 합니다.

Android SDK Tools의 잘못된 버전

Android SDK Tools 26.1.1 이상이 설치되어 있지 않으면 실행 시 이러한 오류 대화 상자가 표시됩니다.

Screenshot shows the Android SDK instance error dialog box.

이 오류 대화 상자가 나타나면 SDK Manager 열기를 클릭하여 Android SDK Manager를 엽니다. Android SDK Manager에서 도구 탭을 클릭하고 다음 패키지를 설치합니다.

  • Android SDK Tools 26.1.1 이상
  • Android SDK 플랫폼 도구 27.0.1 이상
  • Android SDK 빌드 도구 27.0.3 이상

스냅샷이 Android Oreo에서 WiFi를 사용하지 않음

시뮬레이션된 Wi-Fi 액세스를 통해 Android Oreo용 AVD가 구성되어 있는 경우 스냅샷을 만든 후 AVD를 다시 시작하면 Wi-Fi 액세스가 비활성화될 수 있습니다.

이 문제를 해결하려면 다음과 같이 합니다.

  1. Android Device Manager에서 AVD를 선택합니다.

  2. 추가 옵션 메뉴에서 탐색기에 표시를 클릭합니다.

  3. 스냅샷 default_boot >이동합니다.

  4. snapshot.pb 파일을 삭제합니다.

    Location of the snapshot.pb file

  5. AVD를 다시 시작합니다.

이러한 변경 사항이 적용되면 Wi-Fi를 다시 작동하도록 하는 상태로 AVD가 다시 시작됩니다.

버그 보고서 생성

위의 문제 해결 팁을 사용하여 해결할 수 없는 Android Device Manager 관련 문제를 발견할 경우 제목 표시줄을 마우스 오른쪽 단추로 클릭하고 버그 보고서 생성을 선택하여 버그 보고서를 제출하세요.

Location of menu item for filing a bug report

요약

이 가이드에서는 Xamarin용 Visual Studio Tools 및 Mac용 Visual Studio에서 사용할 수 있는 Android Device Manager를 소개했습니다. Android 에뮬레이터를 시작 및 중지하고, 실행할 AVD(Android 가상 디바이스)를 선택하고, 새 가상 디바이스를 만드는 기능과 같은 필수 기능과 가상 디바이스를 편집하는 방법을 설명했습니다. 추가 사용자 지정에 대한 프로필 하드웨어 속성을 편집하는 방법을 설명하고 일반적인 문제에 대한 문제 해결 팁을 제공했습니다.

Channel 9YouTube에서 더 많은 Xamarin 비디오를 확인하세요.