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" 드림
다음은 다른 옵션의 사용법을 설명합니다.
<ph type="x-smartling-placeholder"></ph>
-
-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를 삭제합니다. name으로 AVD를 지정해야 합니다. |
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 인수는 세 가지 옵션이 모두 함께 나열되어 있으면 사용할 수 없습니다.
|
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# avdmanager\n\nThe `avdmanager` is a command-line tool that lets you create and manage\nAndroid Virtual Devices (AVDs) from the command line. An AVD lets you define the\ncharacteristics of an Android handset, Wear OS watch, or Android TV device\nthat you want to simulate in the Android Emulator.\n\nIf you're using Android Studio, then you don't need to use this tool and you\ncan instead\n[create and manage AVDs from the IDE](/studio/run/managing-avds).\n\nThe `avdmanager` tool is included in the Android SDK Command-Line Tools package\nat\n\u003cvar translate=\"no\"\u003eandroid_sdk\u003c/var\u003e`/cmdline-tools/`\u003cvar translate=\"no\"\u003eversion\u003c/var\u003e`/bin/avdmanager`.\n\nSyntax\n------\n\nTo use `avdmanager`, use the following syntax: \n\n```\navdmanager [global options] command [command options]\n```\n\n### Global options\n\n**Table 1.** List of global options for\navdmanager.\n\n| Global option | Description |\n|---------------------|-------------------------------------------------------------------------|\n| `-s` \\| `--silent` | Silent mode: only errors are printed out. |\n| `-h` \\| `--help` | Usage help. |\n| `-v` \\| `--verbose` | Verbose mode: errors, warnings, and informational messages are printed. |\n| `--clear cache` | Clear the SDK Manager repository manifest cache. |\n\n### Commands and command options\n\n**Table 2.** List of commands and options\nfor avdmanager.\n\n| Command and options | Description |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `create avd -n `\u003cvar translate=\"no\"\u003ename\u003c/var\u003e` -k \"`\u003cvar translate=\"no\"\u003esdk_id\u003c/var\u003e`\" [-c {`\u003cvar translate=\"no\"\u003epath\u003c/var\u003e`|`\u003cvar translate=\"no\"\u003esize\u003c/var\u003e`}] [-f] [-p `\u003cvar translate=\"no\"\u003epath\u003c/var\u003e`]` | Create a new AVD. You must provide a \u003cvar translate=\"no\"\u003ename\u003c/var\u003e for the AVD and specify the ID of the SDK package to use for the AVD using \u003cvar translate=\"no\"\u003esdk_id\u003c/var\u003e wrapped in quotes. For example, the following command creates an AVD named `test` using the x86 system image for API level 25: ``` avdmanager create avd -n test -k \"system-images;android-25;google_apis;x86\" ``` The following describes the usages for the other options: - `-c {`\u003cvar translate=\"no\"\u003epath\u003c/var\u003e`|`\u003cvar translate=\"no\"\u003esize\u003c/var\u003e`}`: The path to the SD card image for this AVD or the size of a new SD card image to create for this AVD in KB or MB, denoted with `K` or `M`. For example, `-c path/to/sdcard/` or `-c 1000M`. - `-f`: Force creation of the AVD. Use this option if you need to overwrite an existing AVD with a new AVD using the same name. - `-p `\u003cvar translate=\"no\"\u003epath\u003c/var\u003e: Path to the location where the directory for this AVD's files will be created. If you don't specify a path, the AVD is created in `~/.android/avd/`. |\n| `delete avd -n `\u003cvar translate=\"no\"\u003ename\u003c/var\u003e | Delete an AVD. You must specify the AVD with \u003cvar translate=\"no\"\u003ename\u003c/var\u003e. |\n| `move avd -n `\u003cvar translate=\"no\"\u003ename\u003c/var\u003e` [-p `\u003cvar translate=\"no\"\u003epath\u003c/var\u003e`] [-r `\u003cvar translate=\"no\"\u003enew-name\u003c/var\u003e`]` | Move or rename an AVD. You must specify the AVD with \u003cvar translate=\"no\"\u003ename\u003c/var\u003e. The following describes the usages for the other options: - `-p `\u003cvar translate=\"no\"\u003epath\u003c/var\u003e: The absolute path to the location at which to create the directory where this AVD's files will be moved. If you don't include this argument, the AVD won't be moved. You might choose not to include this argument if you want to rename the AVD in place. - `-r `\u003cvar translate=\"no\"\u003enew-name\u003c/var\u003e: The new name of the AVD being renamed. |\n| `list [target|device|avd] [-c]` | List all available targets, device definitions, or AVDs. If you don't specify `target`, `device`, or `avd`, `avdmanager` lists all three. Include the `-c` argument to receive a compact output suitable for scripts. The `-c` argument is not available when listing all three options together. |"]]