Skip to content

Most visited

Recently visited

navigation

가상 기기 생성 및 관리

AVD(Android Virtual Device) 정의를 사용하면 Android Emulator에서 시뮬레이션하고자 하는 Android 전화기, 태블릿, Android Wear 또는 Android TV의 특성을 정의할 수 있습니다. AVD Manager를 사용하면 AVD를 손쉽게 만들고 관리할 수 있습니다.

앱을 효율적으로 테스트하려면 앱이 지원하도록 고안된 각 기기 유형을 모델링하는 AVD를 생성해야 합니다. 예를 들어, 사용자의 minSdkVersion에서 지정한 값과 같거나 그보다 큰 값의 API 레벨에 대해 각각 AVD를 생성하도록 권장합니다. 앱에서 필요로 하는 API 레벨보다 높은 수준으로 테스트함으로써, 시스템 업데이트를 다운로드할 때 앱의 상위 버전과의 호환성을 보장할 수 있습니다.

AVD 정보

AVD에는 하드웨어 프로필, 시스템 이미지, 저장소 영역, 스킨 및 기타 속성이 포함됩니다.

하드웨어 프로필은 공장에서 출고된 상태 그대로의 기기 특성을 정의합니다. AVD Manager는 특정 하드웨어(예: Nexus 휴대폰)의 하드웨어 프로필이 미리 로드된 상태로 제공되며, 사용자가 필요에 따라 하드웨어 프로필을 정의하고 가져올 수 있습니다. 필요한 경우 AVD에서 몇 가지 설정을 재정의할 수 있습니다.

AVD Manager를 사용하면 권장 사항을 제공하여 AVD용 시스템 이미지를 선택하는 데 도움이 됩니다. 또한 시스템 이미지를 다운로드할 수도 있으며, 그 중 일부는 앱에서 필요할 수 있는 Google API와 같은 부가기능 라이브러리도 함께 제공합니다. x86 시스템 이미지는 에뮬레이터에서 가장 빨리 실행됩니다.

AVD는 개발 시스템 내에 전용 저장소 영역이 있습니다. 여기에는 에뮬레이션된 SD 카드는 물론 설치된 앱과 설정 등의 기기 사용자 데이터가 저장됩니다.

에뮬레이터 스킨은 기기의 모양을 지정합니다. AVD Manager는 몇 가지 미리 정의된 스킨을 제공합니다. 사용자가 직접 정의할 수도 있고, 타사에서 제공한 스킨을 사용해도 됩니다.

실제 기기와 마찬가지로, 앱이 AVD에서 정의된 특정 기능(예: 카메라)을 사용하려면 앱 매니페스트에 해당 <uses-feature> 설정이 있어야 합니다.

AVD 보기 및 관리

AVD Manager를 사용하면 AVD를 모두 한 곳에서 관리할 수 있습니다.

AVD Manager를 실행하려면:

AVD Manager가 나타납니다.

AVD Manager 기본 창

여기에는 사용자가 이미 정의한 모든 AVD가 표시됩니다. Android Studio를 처음 설치하면 하나의 AVD가 생성됩니다. Android Emulator 24.0.x 이하 버전용으로 AVD를 정의한 경우, 다시 생성해야 합니다.

이 페이지에서 다음과 같은 작업을 할 수 있습니다.

AVD 생성

처음부터 새 AVD를 생성할 수도 있고, AVD를 복제하여 몇 가지 속성을 변경할 수도 있습니다.

새 AVD를 생성하려면:

  1. AVD Manager의 Your Virtual Devices 페이지에서 Create Virtual Device를 클릭합니다.
  2. 또는 Android Studio 내에서 앱을 실행합니다. Select Deployment Target 대화상자에서 Create New Emulator를 클릭합니다.

    Select Hardware 페이지가 나타납니다.

    AVD Manager의 하드웨어 프로필 페이지
  3. 하드웨어 프로필을 선택한 다음 Next를 클릭합니다.
  4. 원하는 하드웨어 프로필이 표시되지 않는 경우, 하드웨어 프로필을 직접 생성하거나, 가져올 수 있습니다.

    System Image 페이지가 나타납니다.

    AVD Manager의 시스템 이미지 페이지
  5. 특정 API 레벨에 대한 시스템 이미지를 선택하고, Next를 클릭합니다.
  6. Recommended 탭에 권장 시스템 이미지가 나열됩니다. 다른 탭에 더 완전한 목록이 포함되어 있습니다. 오른쪽 창에 선택한 시스템 이미지가 설명되어 있습니다. x86 이미지는 에뮬레이터에서 가장 빠르게 실행됩니다.

    시스템 이미지 옆에 Download가 표시되는 경우, 이 옵션을 클릭하여 시스템 이미지를 다운로드해야 합니다. 다운로드하려면 인터넷에 연결되어 있어야 합니다.

    대상 기기의 API 레벨은 중요합니다. 앱 매니페스트 파일의 minSdkVersion 특성에 지정된 것처럼, 앱에서 필요로 하는 API 레벨보다 낮은 수준의 시스템 이미지에서는 앱이 실행될 수 없기 때문입니다. 시스템 API 레벨과 minSdkVersion의 관계에 대한 자세한 내용은 앱 버전 지정을 참조하세요.

    앱의 매니페스트 파일에 <uses-library> 요소가 선언되어 있는 경우, 이 앱은 외부 라이브러리가 있는 시스템 이미지가 필요합니다. 앱을 에뮬레이터에서 실행하려면, 필수 라이브러리가 포함된 AVD를 생성합니다. 이렇게 하려면 해당 AVD 플랫폼용 부가기능 구성 요소를 사용해야 할 수도 있습니다. 예를 들어, Google API 부가기능에는 Google 지도 라이브러리가 포함되어 있습니다.

    Verify Configuration 페이지가 나타납니다.

    AVD Manager의 구성 확인 페이지
  7. 필요에 따라 AVD 속성을 변경한 다음 Finish를 클릭합니다.

    Show Advanced Settings를 클릭하면 스킨 등 더 많은 설정이 표시됩니다.

  8. 새 AVD는 Your Virtual Devices 페이지 또는 Select Deployment Target 대화상자에 나타납니다.

복사본부터 시작하여 AVD를 생성하려면:

  1. AVD Manager의 Your Virtual Devices 페이지에서 AVD를 마우스 오른쪽 버튼으로 클릭한 다음 Duplicate를 선택합니다.
  2. 또는 Menu 를 클릭하고 Duplicate를 선택합니다.

    Verify Configuration 페이지가 나타납니다.

  3. System ImageSelect Hardware 페이지에서 변경할 사항이 있으면 Change 또는 Previous를 클릭합니다.
  4. 원하는 사항을 변경한 다음, Finish를 클릭합니다.
  5. AVD가 Your Virtual Devices 페이지에 나타납니다.

하드웨어 프로필 생성

AVD Manager는 일반 기기용의 미리 정의된 하드웨어 프로필을 제공하므로 이를 사용자의 AVD 정의에 손쉽게 추가할 수 있습니다. 다른 기기를 정의해야 하는 경우, 새 하드웨어 프로필을 생성하면 됩니다. 새 하드웨어 프로필을 처음부터 직접 정의하거나, 하드웨어 프로필을 복사하여 시작할 수도 있습니다. 미리 로드된 하드웨어 프로필은 편집할 수 없습니다.

새 하드웨어 프로필을 처음부터 생성하려면:

  1. Select Hardware 페이지에서 New Hardware Profile을 클릭합니다.
  2. Configure Hardware Profile 페이지에서 필요에 따라 하드웨어 프로필 속성을 변경합니다.
  3. Finish를 클릭합니다.
  4. 새 하드웨어 프로필이 Select Hardware 페이지에 나타납니다. 선택적으로 Next를 클릭하여 하드웨어 프로필을 사용하는 AVD를 생성할 수 있습니다. 또는 Cancel을 클릭하여 Your Virtual Devices 페이지 또는 Select Deployment Target 대화상자로 돌아갑니다.

복사본부터 시작하여 하드웨어 프로필을 생성하려면:

  1. Select Hardware 페이지에서 하드웨어 프로필을 선택한 다음 Clone Device를 클릭합니다.
  2. 또는 하드웨어 프로필을 마우스 오른쪽 버튼으로 클릭한 다음 Clone을 선택합니다.

  3. Configure Hardware Profile 페이지에서 필요에 따라 하드웨어 프로필 속성을 변경합니다.
  4. Finish를 클릭합니다.
  5. 새 하드웨어 프로필이 Select Hardware 페이지에 나타납니다. 선택적으로 Next를 클릭하여 하드웨어 프로필을 사용하는 AVD를 생성할 수 있습니다. 또는 Cancel을 클릭하여 Your Virtual Devices 페이지 또는 Select Deployment Target 대화상자로 돌아갑니다.

기존 AVD 사용

Your Virtual Devices 페이지에서 기존 AVD에서 다음과 같은 작업을 수행할 수 있습니다.

기존 하드웨어 프로필 사용

Select Hardware 페이지에서, 기존 하드웨어 프로필에서 다음과 같은 작업을 수행할 수 있습니다.

미리 정의된 하드웨어 프로필은 편집하거나 삭제할 수 없습니다.

에뮬레이터 실행 및 중지, 데이터 지우기

Your Virtual Devices 페이지에서, 에뮬레이터에서 다음과 같은 작업을 수행할 수 있습니다.

하드웨어 프로필 가져오기 및 내보내기

Select Hardware 페이지에서 하드웨어 프로필을 가져오거나 내보낼 수 있습니다.

하드웨어 프로필 속성

Configure Hardware Profile 페이지에서 다음과 같은 하드웨어 프로필 속성을 지정할 수 있습니다. AVD 구성 속성은 하드웨어 프로필 속성을 재정의하고, 에뮬레이터가 실행 중일 때 사용자가 설정한 에뮬레이터 속성은 두 가지 모두 재정의합니다.

AVD Manager에 포함된 미리 정의된 하드웨어 프로필은 편집할 수 없습니다. 다만, 이들을 복사하여 사본을 편집할 수는 있습니다.

하드웨어 프로필 속성 설명
기기 이름 하드웨어 프로필의 이름. 이름에는 대문자 또는 소문자로 된 글자, 0 ~ 9까지의 숫자, 마침표(.), 밑줄(_) 및 괄호( () ) 등이 포함될 수 있습니다. 하드웨어 프로필을 저장하는 파일 이름은 하드웨어 프로필 이름에서 파생됩니다.
기기 유형 다음 중 하나를 선택합니다.
  • 휴대폰/태블릿
  • Android Wear
  • Android TV
화면 크기 화면의 실제 크기를 대각선으로 측정하여 인치 단위로 나타낸 것입니다. 이 크기가 사용자의 컴퓨터 화면보다 크면, 시작 시 크기가 줄어듭니다.
화면 해상도 너비와 높이를 픽셀 단위로 입력하여 시뮬레이션된 화면의 총 픽셀 수를 지정합니다.
원형 기기 화면이 원형인 경우(예: Android Wear 기기) 이 옵션을 선택합니다.
메모리: RAM 기기의 RAM 크기를 입력하고 B(바이트), KB(킬로바이트), MB(메가바이트), GB(기가바이트) 또는 TB(테라바이트) 중에서 단위를 선택합니다.
입력: 하드웨어 버튼 있음(뒤로/홈/메뉴) 기기에 하드웨어 탐색 버튼이 있는 경우 이 옵션을 선택합니다. 이러한 버튼이 소프트웨어에서만 구현되는 경우 선택을 취소합니다. 이 옵션을 선택하면 버튼이 화면에 나타나지 않습니다. 어떤 경우이든 에뮬레이터 측면 패널을 사용하여 버튼을 "누를"' 수 있습니다.
Input: 하드웨어 키보드 있음 기기에 하드웨어 키보드가 있는 경우 이 옵션을 선택합니다. 없으면 이 속성의 선택을 취소합니다. 이 옵션을 선택하면 키보드가 화면에 나타나지 않습니다. 어떤 경우이든 컴퓨터 키보드를 사용하여 키 스트로크를 에뮬레이터로 보낼 수 있습니다.
탐색 스타일

다음 중 하나를 선택합니다.

  • 없음 - 하드웨어 컨트롤이 없습니다. 탐색은 소프트웨어를 통해 진행합니다.
  • D-패드 - 방향 패드 지원.
  • 트랙볼

이들 옵션은 기기 자체의 실제 하드웨어 컨트롤에 해당됩니다. 하지만, 외부 컨트롤러가 기기로 보내는 이벤트는 동일합니다.

지원되는 기기 상태

다음 옵션 중 하나 또는 모두를 선택합니다.

  • 세로 모드 - 세로 방향으로 배치됩니다.
  • 가로 모드 - 가로 방향으로 배치됩니다.

두 옵션을 모두 선택하면 에뮬레이터에서 방향을 전환할 수 있습니다. 계속하려면 적어도 하나의 옵션을 선택해야 합니다.

카메라

다음 옵션 중 하나 또는 모두를 선택합니다.

  • 후방 카메라 - 렌즈가 사용자 반대편을 향합니다.
  • 전방 카메라 - 렌즈가 사용자 쪽을 향합니다.

나중에 웹캠을 사용하거나 에뮬레이터가 제공하는 사진을 사용하여 이 카메라로 사진 촬영을 시뮬레이션할 수 있습니다.

센서: 가속도계 기기에 기기의 방향을 결정하는 데 도움이 되는 하드웨어가 있는 경우 이 옵션을 선택합니다.
Sensors: 자이로스코프 기기에 기기 회전 또는 비틀기를 감지하는 하드웨어가 있는 경우 이 옵션을 선택합니다. 이 옵션은 가속도계와 함께 사용되어 더욱 매끄러운 방향 감지를 제공할 수 있으며 6축 방향 시스템을 지원합니다.
Sensors: GPS 기기에 GPS(Global Positioning System) 위성 기반 내비게이션 시스템을 지원하는 하드웨어가 있는 경우 이 옵션을 선택합니다.
Sensors: 근접 센서 기기에 기기가 통화 중에 얼굴에 가까워지면 이를 감지하여 화면에서 입력을 사용 안 함으로 설정하게 하는 하드웨어가 있는 경우 이 옵션을 선택합니다.
기본 스킨 기기가 에뮬레이터에 표시될 때의 모양을 제어하는 스킨을 선택합니다. 해상도보다 지나치게 작은 화면 크기를 지정하면 화면이 잘려서 전체 화면을 볼 수 없게 될 수도 있습니다. 자세한 내용은 에뮬레이터 스킨 생성을 참조하세요.

AVD 속성

Verify Configuration 페이지에서 다음과 같은 AVD 구성 속성을 지정할 수 있습니다. AVD 구성은 개발용 컴퓨터와 에뮬레이터 사이의 상호작용을 지정하며, 하드웨어 프로필에서 사용자가 재정의하고자 하는 속성도 지정합니다.

AVD 구성 속성은 하드웨어 프로필 속성을 재정의하고, 에뮬레이터가 실행 중일 때 사용자가 설정한 에뮬레이터 속성은 두 가지 모두 재정의합니다.

AVD 속성 설명
AVD 이름 AVD의 이름. 이름에는 대문자 또는 소문자로 된 글자, 0 ~ 9까지의 숫자, 마침표(.), 밑줄(_) 및 괄호( () ) 등이 포함될 수 있습니다. AVD 구성을 저장하는 파일의 이름은 AVD 이름에서 파생됩니다.
AVD ID(고급) AVD 파일 이름은 ID에서 파생되며, 이 ID를 사용하여 명령줄에서 AVD를 참조할 수 있습니다.
하드웨어 프로필 Change를 클릭하여 Select Hardware 페이지에서 다른 하드웨어 프로필을 선택합니다.
시스템 이미지 Change를 클릭하여 System Image 페이지에서 다른 시스템 이미지를 선택합니다. 새 이미지를 다운로드하려면 인터넷에 연결되어 있어야 합니다.
시작: 스케일 에뮬레이터가 시작될 때 사용할 처음 크기를 선택합니다. 이 크기가 컴퓨터 화면보다 큰 경우 이보다 작은 크기로 조정할 수 있습니다. 기본값은 자동입니다.
Startup: 방향

초기 에뮬레이터 방향으로 하나의 옵션을 선택합니다.

  • 세로 모드 - 세로 방향으로 배치됩니다.
  • 가로 모드 - 가로 방향으로 배치됩니다.

하드웨어 프로필에서 옵션을 선택해야 활성화됩니다. AVD를 에뮬레이터에서 실행할 때, 하드웨어 프로필에서 세로 모드 및 가로 모드를 지원하는 경우 방향을 바꿀 수 있습니다.

카메라(고급)

다음 옵션 중 하나 또는 모두를 선택합니다.

  • 전방 - 렌즈가 사용자 반대편을 향합니다.
  • 후방 - 렌즈가 사용자 쪽을 향합니다.

이 옵션은 하드웨어 프로필에서 선택된 경우에만 이용할 수 있습니다. Android Wear 및 Android TV에서는 이용할 수 없습니다.

네트워크: 속도(고급)

데이터 전송 속도를 결정하는 네트워크 프로토콜을 선택합니다.

  • GSM - Global System for Mobile Communications
  • HSCSD - High-Speed Circuit-Switched Data
  • GPRS - Generic Packet Radio Service
  • EDGE - Enhanced Data rates for GSM Evolution
  • UMTS - Universal Mobile Telecommunications System
  • HSPDA - High-Speed Downlink Packet Access
  • Full (default) - 컴퓨터가 허용하는 한 가장 빠른 속도로 데이터를 전송합니다.
Network: 지연 시간(고급) 네트워크 프로토콜을 선택하여 해당 프로토콜이 데이터 패킷을 한 지점에서 다른 지점으로 전송하는 데 걸리는 시간(지연 시간)을 설정합니다.
에뮬레이션 성능: 그래픽

에뮬레이터에서 그래픽 렌더링 방법을 선택합니다.

  • 하드웨어 - 컴퓨터 그래픽 카드를 사용하여 렌더링 속도를 높입니다.
  • 소프트웨어 - 그래픽을 소프트웨어에서 에뮬레이션합니다. 그래픽 카드에서 렌더링에 문제가 있는 경우 유용합니다.
  • 자동 - 사용자의 그래픽 카드에 따라 에뮬레이터가 최선의 옵션을 자동으로 결정합니다.
멀티코어 CPU(고급) 에뮬레이터에서 사용할 컴퓨터의 프로세서 코어 수를 선택합니다. 프로세서 코어를 많이 사용할수록 에뮬레이터 속도가 빨라집니다.
메모리 및 저장소: RAM 기기 RAM 크기. 이 값은 하드웨어 제조업체에서 설정하지만 필요한 경우 사용자가 재정의할 수 있습니다(예를 들어, 에뮬레이터 작동 속도를 높이기 위해). 크기를 늘릴수록 컴퓨터 리소스를 더 많이 사용합니다. RAM 크기를 입력하고 B(바이트), KB(킬로바이트), MB(메가바이트), GB(기가바이트) 또는 TB(테라바이트) 중에서 단위를 선택합니다.
Memory and Storage: VM 힙 VM 힙 크기. 이 값은 하드웨어 제조업체에서 설정하지만 필요한 경우 사용자가 재정의할 수 있습니다. 힙 크기를 입력하고 B(바이트), KB(킬로바이트), MB(메가바이트), GB(기가바이트) 또는 TB(테라바이트) 중에서 단위를 선택합니다. Android VM에 대한 자세한 내용은 다양한 가상 머신의 메모리 관리를 참조하세요.
Memory and Storage: 내부 저장소 기기에서 이용 가능한, 제거할 수 없는 메모리 공간입니다. 이 값은 하드웨어 제조업체에서 설정하지만 필요한 경우 사용자가 재정의할 수 있습니다. 크기를 입력하고 B(바이트), KB(킬로바이트), MB(메가바이트), GB(기가바이트) 또는 TB(테라바이트) 중에서 단위를 선택합니다.
Memory and Storage: SD 카드 기기에서 데이터를 저장하는 데 이용할 수 있는, 제거 가능한 메모리 공간입니다. Android Studio에서 관리하는 가상 SD 카드를 사용하려면 Studio를 선택하고 크기를 입력한 다음, B(바이트), KB(킬로바이트), MB(메가바이트), GB(기가바이트) 또는 TB(테라바이트) 중에서 단위를 선택합니다. 카메라를 사용하려면 최소 100MB를 권장합니다. 파일의 공간을 관리하려면 External File을 선택하고 ...을 클릭하여 해당 파일과 위치를 지정합니다. 자세한 내용은 mksdcard를 참조하세요.
기기 프레임: 기기 프레임 사용 이 옵션을 선택하면 실제 기기의 모양을 흉내내는 에뮬레이터 창 주변의 프레임이 활성화됩니다.
사용자 지정 스킨 정의(고급) 기기가 에뮬레이터에 표시될 때의 모양을 제어하는 스킨을 선택합니다. 해상도보다 지나치게 작은 화면 크기를 지정하면 화면이 잘려서 전체 화면을 볼 수 없게 될 수도 있습니다. 자세한 내용은 에뮬레이터 스킨 생성을 참조하세요.
키보드: 키보드 입력 사용(고급) 하드웨어 키보드를 사용하여 에뮬레이터와 상호작용하려면 이 옵션을 선택합니다. 이 옵션은 Android Wear 및 Android TV에서 비활성화됩니다.

에뮬레이터 스킨 생성

Android Emulator 스킨은 에뮬레이터 디스플레이의 시각 및 컨트롤 요소를 정의하는 일련의 파일입니다. AVD 설정에서 이용할 수 있는 스킨 정의가 사용자의 요구사항에 맞지 않는 경우, 사용자 지정 스킨 정의를 생성하여 AVD에 적용할 수 있습니다.

각 에뮬레이터 스킨에는 다음 항목이 포함됩니다.

사용자 지정 스킨을 생성하고 사용하려면:

  1. 스킨 구성 파일을 저장할 새 디렉터리를 만듭니다.
  2. 스킨의 시각적 모습을 layout이라는 텍스트 파일에 정의합니다. 이 파일은 크기, 특정 버튼의 이미지 자산 등과 같은 스킨의 다양한 특성을 정의합니다. 예:
    parts {
        device {
            display {
                width   320
                height  480
                x       0
                y       0
            }
        }
    
        portrait {
            background {
                image background_port.png
            }
    
            buttons {
                power {
                    image  button_vertical.png
                    x 1229
                    y 616
                }
            }
        }
        ...
    }
    
  3. 동일한 디렉터리에 기기 이미지의 비트맵 파일을 추가합니다.
  4. 기기 설정용 hardware.ini 파일에 추가적인 하드웨어별 기기 구성을 지정합니다(hw.keyboardhw.lcd.density 등).
  5. 해당 파일을 스킨 폴더에 보관한 다음 해당 보관 파일을 사용자 지정 스킨으로 선택합니다.

에뮬레이터 스킨 생성에 대한 자세한 내용은 도구 소스 코드에서 Android Emulator Skin File Specification을 참조하세요.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)