avdmanager

avdmanager는 명령줄에서 Android Virtual Device(AVD)를 만들고 관리할 수 있는 명령줄 도구입니다. AVD를 사용하면 Android Emulator에서 시뮬레이션할 Android 핸드셋, Wear OS 시계 또는 Android TV 기기의 특성을 정의할 수 있습니다.

Android 스튜디오를 사용하는 경우 이 도구를 사용할 필요가 없으며 대신 IDE에서 AVD를 만들고 관리할 수 있습니다.

avdmanager 도구는 Android SDK 명령줄 도구 패키지에 포함되며 android_sdk/cmdline-tools/version/bin/avdmanager에 있습니다.

구문

avdmanager를 사용하려면 다음 구문을 사용합니다.

avdmanager [global options] command [command options]

전역 옵션

표 1. avdmanager의 전역 옵션 목록.

전역 옵션 설명
-s | --silent 무음 모드: 오류만 출력됩니다.
-h | --help 사용법 도움말.
-v | --verbose 상세 모드: 오류, 경고, 정보 메시지가 출력됩니다.
--clear cache SDK Manager 저장소 매니페스트 캐시를 지웁니다.

명령어 및 명령어 옵션

표 2. avdmanager의 명령어 및 옵션 목록.

명령어 및 옵션 설명
create avd -n name -k "sdk_id" [-c {path|size}] [-f] [-p path]

새 AVD를 만듭니다. AVD에 name을 제공하고 따옴표로 묶인 sdk_id를 사용하여 AVD에 사용할 SDK 패키지의 ID를 지정해야 합니다. 예를 들어 다음 명령어는 API 수준 25용 x86 시스템 이미지를 사용하여 test라는 이름의 AVD를 만듭니다.

avdmanager create avd -n test -k "system-images;android-25;google_apis;x86"
다음은 다른 옵션의 사용법을 설명합니다.
  • -c {path|size}: 이 AVD의 SD 카드 이미지 경로 또는 이 AVD에 만들 새 SD 카드 이미지 크기(KB 또는 MB, K 또는 M으로 표시됨)입니다. 예를 들면 -c path/to/sdcard/ 또는 -c 1000M이 있습니다.
  • -f: AVD를 강제로 만듭니다. 기존 AVD에 같은 이름으로 새 AVD를 덮어써야 할 때 이 옵션을 사용하세요.
  • -p path: 이 AVD 파일의 디렉터리가 만들어질 위치의 경로입니다. 경로를 지정하지 않으면 AVD가 ~/.android/avd/에 생성됩니다.
delete avd -n name AVD를 삭제합니다. AVD는 name으로 지정해야 합니다.
move avd -n name [-p path] [-r new-name] AVD를 이동하거나 이름을 바꿉니다. AVD는 name으로 지정해야 합니다. 다음은 다른 옵션의 사용법을 설명합니다.
  • -p path: 이 AVD의 파일을 이동할 디렉터리를 만들 위치의 절대 경로입니다. 이 인수를 포함하지 않으면 AVD가 이동되지 않습니다. AVD의 이름을 적절히 바꾸려는 경우 이 인수를 포함하지 않을 수 있습니다.
  • -r new-name: 이름을 바꾸려는 AVD의 새 이름입니다.
list [target|device|avd] [-c] 사용 가능한 모든 타겟, 기기 정의 또는 AVD를 나열합니다. target, device 또는 avd를 지정하지 않으면 avdmanager는 세 가지를 모두 나열합니다. 스크립트에 적합한 간단한 출력을 받으려면 -c 인수를 포함하세요. -c 인수는 세 가지 옵션이 모두 함께 나열되어 있으면 사용할 수 없습니다.