← 소프트웨어 자료실
개발 · 개발 도구

Android SDK Command-line Tools

Android SDK Command-line Tools는 터미널에서 Android 개발 환경을 구성하고 APK를 분석하는 공식 도구 모음입니다. macOS용 Intel·Apple Silicon 패키지가 제공되며, 자동 빌드 환경이나 기존 개발 스크립트 관리에 활용할 수 있습니다. 다만 현재 공식 문서는 포함 도구인 sdkmanager와 avdmanager를 사용 중단 권고 대상으로 표시하고 Android CLI로의 전환을 안내합니다.

공식 사이트로 이동 ↗

누가 사용하는 도구인가

Android 앱 개발자와 CI 환경 관리자가 SDK 구성과 결과물 검사를 터미널에서 처리할 때 사용하는 패키지입니다. Android Studio에도 포함되지만 IDE 없이 별도로 내려받을 수 있습니다. 코드 편집기나 완성된 빌드 환경 전체를 제공하는 제품은 아니므로 프로젝트 빌드에는 Gradle과 필요한 SDK 구성 요소를 함께 준비해야 합니다.

지원 운영체제와 배포 번호

2026-10-11 확인한 공식 다운로드 표에는 Windows, Linux, Mac Intel, Mac ARM 패키지가 있습니다. 따라서 macOS 전용 제품은 아니며, Mac에서는 CPU에 맞는 배포 파일을 선택합니다.

입력 정보의 15859902는 현재 공식 ZIP 파일명에 표시된 번호와 일치합니다. 다만 이를 Android API 레벨이나 Command-line Tools의 내부 버전 번호와 같은 의미로 사용해서는 안 됩니다.

설치와 첫 작업 순서

Mac용 ZIP을 내려받아 압축을 풀고 SDK 루트 아래 cmdline-tools/latest/bin과 cmdline-tools/latest/lib가 놓이도록 정리합니다. 공식 sdkmanager 문서는 NOTICE.txt와 source.properties도 latest 안으로 옮기도록 안내합니다.

ANDROID_HOME을 SDK 루트로 설정하고 사용하는 bin 경로를 PATH에 추가한 뒤 sdkmanager --list로 패키지를 확인합니다. 프로젝트가 요구하는 플랫폼과 Build Tools를 설치하고 sdkmanager --licenses로 미동의 라이선스를 확인합니다. 이후 기존 프로젝트 루트에서 ./gradlew assembleDebug를 실행하는 순서로 첫 빌드를 진행할 수 있습니다.

실무에서 활용하는 예시

앱 업데이트 후 APK 용량이 늘었다면 apkanalyzer apk compare old.apk new.apk로 이전 결과물과 새 결과물을 비교할 수 있습니다. 파일별 증가량을 보고 이미지 리소스나 DEX 중 어느 부분이 커졌는지 좁힌 뒤, manifest permissions 명령으로 배포 APK에 포함된 권한도 확인합니다.

기기 설치와 로그 확인에 쓰는 adb는 별도 Platform Tools에 포함됩니다. 가상 기기를 실제 실행하려면 Emulator와 해당 시스템 이미지도 필요합니다.

무료 이용과 구성상 제약

공식 배포 페이지는 SDK를 별도 구매 없이 내려받도록 제공하며, 라이선스에는 호환되는 Android용 앱 개발을 위한 로열티 없는 사용 권한이 명시되어 있습니다. 확인한 자료에는 이 패키지의 유료 등급이나 무료판 기능 제한이 제시되어 있지 않습니다.

다운로드와 이용에는 SDK 약관 동의가 필요하고 추가 패키지에도 필요한 라이선스 동의를 진행해야 합니다. 이 ZIP만으로 컴파일, 기기 연결, 에뮬레이터 실행에 필요한 모든 구성 요소가 갖춰지지는 않습니다.

문제가 생겼을 때 확인할 순서

명령을 찾지 못하면 먼저 cmdline-tools/latest/bin 구조와 PATH를 확인합니다. SDK 경로가 다르게 잡히면 ANDROID_HOME과 도구가 참조하는 위치를 비교하고, sdkmanager의 --sdk_root 옵션으로 대상을 명시해 확인합니다.

패키지 설치가 실패하면 --list에 표시된 정확한 패키지 경로, 따옴표, 라이선스 동의 상태를 차례로 점검합니다. 다운로드 문제는 네트워크와 프록시 설정을 확인합니다. 빌드 실패는 SDK 설치 문제와 Gradle·JDK 호환성 문제를 나누어 조사해야 합니다.

선택 기준과 지원 상태 검토

화면에서 SDK와 가상 기기를 관리하고 코드 편집까지 하려면 Android Studio가 편리합니다. 기존 sdkmanager·avdmanager 스크립트를 유지하거나 APK 검사 명령을 자동화하려면 이 패키지의 역할이 분명합니다.

현재 공식 문서는 sdkmanager와 avdmanager를 deprecated로 표시하며 각각 Android CLI의 android sdk와 android emulator 명령을 대안으로 안내합니다. 신규 자동화는 이 전환 안내를 검토해야 합니다. 다만 두 도구의 사용 중단 권고를 패키지 전체의 지원 종료로 해석할 근거는 확인되지 않았습니다.

공식 안내

주요 기능

  • sdkmanager로 Android SDK 패키지 목록을 확인하고 필요한 플랫폼·Build Tools 등을 설치, 업데이트, 제거합니다.
  • avdmanager로 Android 가상 기기 구성을 생성하고 목록 조회, 이름 변경, 이동, 삭제를 수행합니다.
  • apkanalyzer로 APK의 파일 구성, 매니페스트, 권한, DEX 및 리소스를 확인하고 두 APK의 크기 차이를 비교합니다.
  • lint로 코드의 구조적 품질 문제를 검사합니다.
  • retrace로 R8이 난독화한 오류 스택을 원래 소스 코드에 대응하는 형태로 복원합니다.
  • 명령줄 도구의 여러 버전을 함께 설치해 프로젝트와 자동화 스크립트별로 사용할 버전을 선택할 수 있습니다.
광고

관련 프로그램

Lens

lenshq.io

Lens는 Kubernetes 클러스터의 리소스, 로그, 메트릭을 데스크톱 화면에서 확인하고 관리하는 IDE다. 여러 개발·운영 환경을 오가는 개발자와 DevOps·SRE 담당자에게 적합하며, macOS 외에 Windows와 Linux도 지원한다.

개발macOS

Tuist

tuist.io

Tuist는 Swift로 Xcode 프로젝트 구조를 정의하고 생성하며, 빌드 캐시와 테스트 분석을 연계해 개발팀의 반복 작업을 줄이는 개발 도구다.

개발macOS

GitHub Copilot CLI

docs.github.com

GitHub Copilot CLI는 터미널에서 자연어로 코드 분석·수정·디버깅과 GitHub 작업을 요청하는 AI 코딩 에이전트입니다. macOS, Linux, Windows를 지원합니다.

개발macOS

Git Credential Manager

aka.ms

Git Credential Manager(GCM)는 Git의 HTTPS 인증을 처리하고 자격 증명을 보관하는 무료 오픈소스 도구다. macOS에서는 기본적으로 키체인을 사용하며, GitHub·Azure Repos·Bitbucket·GitLab 등 여러 호스팅 서비스의 인증을 지원한다. Git 명령을 실행할 때 필요한 로그인과 다중 인증을 연결해 준다.

개발macOS

.NET SDK

microsoft.com

.NET SDK는 C#, F#, Visual Basic으로 앱과 라이브러리를 만들고 빌드·테스트·배포 파일을 생성하는 Microsoft의 무료 오픈소스 개발 도구입니다. macOS에서는 Apple Silicon용 Arm64와 Intel용 x64를 제공하며, 터미널과 원하는 편집기를 함께 사용해 콘솔 도구와 웹 서비스를 개발할 수 있습니다.

개발macOS

MongoDB Compass

mongodb.com

MongoDB Compass는 MongoDB 데이터를 화면에서 조회·편집하고, 스키마와 쿼리 성능을 분석하는 무료 데스크톱 도구입니다.

개발macOS