명령줄 도구

Android SDK는 앱 개발에 필요한 여러 패키지로 구성됩니다. 이 페이지에서는 사용 가능한 가장 중요한 명령줄 도구를 제공되는 패키지별로 정리해 보여줍니다.

Android 스튜디오의 SDK Manager 또는 sdkmanager 명령줄 도구를 사용하여 각 패키지를 설치하고 업데이트할 수 있습니다. 모든 패키지는 Android SDK 디렉터리에 다운로드되며, 이 디렉터리는 다음 방법을 통해 찾을 수 있습니다.

  1. Android 스튜디오에서 File > Project Structure를 클릭합니다.
  2. 왼쪽 창에서 SDK Location을 선택합니다. 경로가 Android SDK location 아래 표시됩니다.

환경 변수 설정

명령줄을 사용할 때는 ANDROID_HOME 환경 변수를 설정하는 것이 좋습니다. 또한 ANDROID_HOME/tools, ANDROID_HOME/tools/bin, ANDROID_HOME/platform-tools를 포함하도록 명령어 검색 경로를 설정하여 가장 일반적인 도구를 찾습니다. 이 단계는 OS에 따라 다르지만, 일반적인 안내는 환경 변수 설정 방법을 참고하세요.

Android SDK 명령줄 도구

위치: android_sdk/cmdline-tools/version/bin/

참고: cmdline-tools에 있는 Android SDK 명령줄 도구 패키지가 tools에 있는 SDK 도구 패키지를 대체합니다. 새 패키지를 사용하면 설치하려는 명령줄 도구의 버전을 선택할 수 있고 한 번에 여러 버전을 설치할 수 있습니다. 이전 패키지를 사용하면 최신 버전의 도구만 설치할 수 있습니다. 따라서 새 패키지를 사용하면 새 버전이 출시될 때 코드 중단 없이 명령줄 도구의 특정 버전을 사용할 수 있습니다. 지원 중단된 SDK 도구 패키지에 관한 자세한 내용은 SDK 도구 출시 노트를 참고하세요.

Android 스튜디오를 사용하지 않는 경우 여기에서 명령줄 도구 패키지를 다운로드할 수 있습니다.

apkanalyzer
빌드 프로세스가 완료된 후 APK의 구성에 관한 유용한 정보를 제공합니다.
avdmanager
명령줄에서 Android Virtual Device(AVD)를 만들고 관리할 수 있습니다.
lint
코드를 스캔하여 코드의 구조적 품질 문제를 식별하고 수정할 수 있도록 지원합니다.
retrace
R8로 컴파일된 애플리케이션의 경우 retrace는 원래 소스 코드에 다시 매핑되는 난독화된 스택 트레이스를 디코딩합니다.
sdkmanager
Android SDK용 패키지를 보고 설치하고 업데이트하고 제거할 수 있습니다.

Android SDK 빌드 도구

위치: android_sdk/build-tools/version/
자세한 내용은 SDK 빌드 도구 출시 노트를 참고하세요.

이 패키지는 Android 앱을 빌드하기 위해 필요합니다. 이 패키지의 도구는 대부분 빌드 도구에서 호출하며 개발자를 위한 것이 아닙니다. 하지만 다음과 같은 명령줄 도구가 유용할 수도 있습니다.

AAPT2
Android 리소스를 Android 플랫폼에 최적화된 바이너리 형식으로 파싱하고 색인을 생성하며 컴파일한 후 컴파일된 리소스를 단일 출력으로 패키징합니다.
apksigner
APK에 서명하고 APK 서명이 지정된 APK가 지원하는 모든 플랫폼 버전에서 성공적으로 인증되는지 확인합니다.
zipalign
압축되지 않은 모든 데이터가 파일 시작 부분을 기준으로 특정 정렬이 적용된 상태로 시작되도록 하여 APK 파일을 최적화합니다.

참고: 여러 버전의 빌드 도구를 사용하여 다양한 Android 버전용 앱을 빌드할 수 있습니다.

Android SDK 플랫폼 도구

위치: android_sdk/platform-tools/
자세한 내용은 SDK 플랫폼 도구 출시 노트를 참고하세요.

이러한 도구는 Android 플랫폼의 새 버전이 출시될 때마다 업데이트되어 새로운 기능을 지원하고 도구를 수정하거나 개선하며 각 업데이트는 이전 플랫폼 버전과 호환됩니다.

여기에서 SDK 플랫폼 도구를 다운로드할 수도 있고 SDK Manager에서 다운로드할 수도 있습니다.

adb
adb(Android 디버그 브리지)는 에뮬레이터 인스턴스 또는 Android 지원 기기의 상태를 관리할 수 있는 다목적 도구입니다. adb를 사용하여 기기에 APK를 설치할 수도 있습니다.
etc1tool
PNG 이미지를 ETC1 압축 표준으로 인코딩하고 압축된 ETC1 이미지를 PNG로 다시 디코딩할 수 있는 명령줄 유틸리티입니다.
fastboot
기기를 플랫폼 및 기타 시스템 이미지로 플래시합니다. 플래시 안내는 Nexus 및 Pixel 기기용 공장 출고 시 이미지를 참고하세요.
logcat
앱 및 시스템 로그를 보기 위해 adb에서 호출합니다.

Android Emulator

위치: android_sdk/emulator/
자세한 내용은 Android Emulator 출시 노트를 참고하세요.

Android Emulator를 사용하려면 이 패키지가 있어야 합니다. 이 패키지에는 다음 도구가 포함되어 있습니다.

emulator
실제 Android 런타임 환경에서 애플리케이션의 디버그 및 테스트에 사용할 수 있는 QEMU 기반 기기 에뮬레이션 도구입니다.
mksdcard
SD 카드와 같은 외부 메모리 카드의 존재를 시뮬레이션하기 위해 에뮬레이터와 함께 사용할 디스크 이미지를 만들 수 있습니다.

참고: 25.3.0 버전 이전에는 에뮬레이터 도구가 SDK 도구 패키지에 포함되었습니다.

Jetifier

Jetifier는 지원 라이브러리 클래스를 사용하는 라이브러리를 읽고 최신 AndroidX 클래스를 사용하는 동등한 라이브러리를 출력합니다.