Android CLI 출시 노트

Android CLI는 터미널에서 Android 개발을 위한 기본 인터페이스로, 원하는 에이전트와 도구를 사용하여 개발 워크플로를 지원하도록 빌드되었습니다.

이 페이지에는 모든 Android CLI 출시 버전의 새로운 기능이 나열되어 있습니다. Android CLI를 다운로드하려면 다운로드 페이지로 이동하세요. 자세한 내용은 Android CLI 개요를 참고하세요.

버전 1.1.16919734(2026년 11월)

  • 델타 설치에서 위치가 변경된 파일 재사용: android install 및 android run는 APK에서 위치가 변경된 변경되지 않은 파일을 더 이상 다시 전송하지 않습니다. 사용 중지하려면 --use-delta-install-instructions=COPY,DATA를 전달합니다.
  • Compose 추적: android profiler systemtrace는 앱에서 Jetpack Compose가 실행하는 작업을 기록할 수 있습니다. 실행되는 각 컴포저블 함수의 슬라이스를 기록하려면 --enable=compose.composition를 전달하고, 재구성을 유발하는 상태 읽기 및 쓰기도 기록하려면 --enable=compose.recomposition를 전달합니다. 앱에 androidx.compose.runtime:runtime-tracing 1.13 이상이 필요합니다. 트레이스는 Android 스튜디오 프로파일러에서 여는 ZIP 파일로 저장됩니다.
  • Perfetto 힙 덤프: --type=perfetto를 android profiler heapdump capture에 전달하여 힙 덤프를 Perfetto 트레이스로 기록합니다. 객체와 객체 간의 참조가 있지만 값은 없으므로 .hprof 파일보다 작습니다. Android 12(API 수준 31) 이상과 프로파일링 가능하거나 디버그 가능한 앱이 필요합니다.
  • JSON 분석의 라이브러리 DEX 크기 형식: 라이브러리 아티팩트(AAR 및 JAR)의 android analyze --format=json 출력에서 d8CompileResult 및 r8CompileResult의 dexSizeBytes 필드는 이제 숫자가 아닌 문자열로 직렬화된 64비트 정수입니다.
  • JSON으로 결과 입력: android input 하위 명령어는 모든 하위 명령어에 대해 동일한 형식으로 표준 출력에 results 목록이 있는 JSON 객체로 결과를 출력합니다. 일치하는 요소가 없거나 여러 일치 항목이 있는 등의 오류는 표준 오류의 텍스트가 아닌 각 결과의 status 필드에 보고됩니다.
  • 에뮬레이터 종료 코드: android emulator create, start, stop, remove가 이제 실패 시 0이 아닌 코드로 종료되고 표준 오류에 오류를 출력합니다.

버전 1.1.16717390(2026년 10월)

  • 필드 비정상 종료 신호: 새로운 android signals 명령어를 사용하여 Firebase Crashlytics를 통해 앱이 필드에서 어떻게 작동하는지 조사합니다. android auth login로 로그인한 후 android signals context로 프로젝트와 앱을 찾은 다음 android signals crashes list, facets, describe, samples로 비정상 종료, ANR, 심각하지 않은 문제를 나열, 필터링, 분류합니다.
  • 필드 힙 덤프: android signals heaps를 사용하여 Crashlytics가 메모리 부족 비정상 종료 및 메모리 제한 종료 시 수집하는 힙 덤프를 메타데이터, 커스텀 키, 이를 생성한 세션의 로그와 함께 나열, 설명, 다운로드합니다.
  • 앱 프로파일링: 새로운 android profiler 명령어를 사용하여 연결된 기기 또는 에뮬레이터에서 android profiler systemtrace로 시스템 트레이스를 기록하고 android profiler heapdump capture로 JVM 힙 덤프를 캡처합니다. android profiler session list, status, terminate를 사용하여 프로파일링 세션을 관리합니다.
  • 아티팩트 분석: 새로운 android analyze 명령어를 사용하여 하나 이상의 APK, AAB, AAR, JAR을 검사하고 패키지 세부정보, DEX 크기, R8 축소 및 최적화 측정항목, 라이브러리 유지 규칙 및 낮은 최적화에 관한 경고를 보고합니다. 기계 가독형 출력을 위해 --format=json 또는 --format=textproto를 전달합니다.
  • Compose 미리보기: 새로운 android preview list 명령어를 사용하여 타겟에서 Jetpack Compose @Preview 함수를 찾고 android preview render --fqn <name>를 사용하여 Android 스튜디오 없이 머신에서 PNG 이미지와 구성요소 트리 JSON 파일로 렌더링합니다. --output를 전달하여 파일이 작성되는 위치를 선택합니다.
  • 실행 및 설치의 빌드 참조: android run 및 android install는 특정 타겟을 빌드하고 배포하기 위해 위치 빌드 참조를 허용합니다. :app와 같이 변형이 없는 Gradle 타겟은 이제 기본적으로 debug 변형으로 설정됩니다.
  • 기기 미러링 창: 새로운 android device hub 명령어를 사용하여 연결된 실제 Android 기기(android device remote connect를 통해 연결된 원격 기기 포함) 및 Android 에뮬레이터의 실시간 화면 미러링 및 대화형 제어를 위한 데스크톱 창을 엽니다.

버전 1.0.16625370(2026년 10월)

  • UI 상호작용: 새로운 android input 명령어를 사용하여 연결된 기기나 에뮬레이터에서 탭, 스크롤, 스와이프, 텍스트 입력, 키 누르기를 실행합니다. text=Submit 또는 id=email,class=EditText와 같은 선택기로 UI 요소를 타겟팅하고 android layout와 결합하여 상호작용할 요소를 찾습니다.

버전 1.0.16500706(2026년 10월)

  • 예약 시 연결: 이제 android device remote create가 새 예약을 adb에 자동으로 연결합니다. --connect=false를 전달하여 예약만 만들고 나중에 android device remote connect로 연결합니다.

버전 1.0.16457483(2026년 9월)

  • Google 서비스에 로그인: android auth login를 사용하여 Android CLI를 Google 계정에 로그인하면 인증이 필요한 Google 서비스를 호출할 수 있습니다.
  • 원격 기기 카탈로그: android device remote projects를 사용하여 기기를 스트리밍할 수 있는 Google Cloud 프로젝트를 찾고 android device remote models를 사용하여 사용 가능한 실제 기기를 탐색합니다.
  • 원격 기기 예약: android device remote create를 사용하여 원격 실제 기기를 예약한 다음 list, extend --duration <minutes>, remove를 사용하여 예약을 관리합니다.
  • 원격 기기에 연결: android device remote connect를 사용하여 백그라운드 연결을 통해 예약된 기기를 adb에 연결하면 android run, android install, 기타 기기 명령어와 함께 로컬 기기처럼 작동합니다. android device remote disconnect를 사용하여 분리합니다.

버전 1.0.16406183(2026년 9월)

  • 더 빠른 시작: 네이티브 다운로더 라이브러리가 사용될 때만 로드되고 더 이상 호출할 때마다 임시 디렉터리에 압축 해제되지 않으므로 Android CLI가 약 두 배 더 빠르게 시작됩니다.
  • 종료 코드 수정: 이제 create, run, install, describe, layout, docs, info, skills, update를 포함하여 명령어가 실패하면 0이 아닌 종료 코드를 반환하므로 스크립팅과 CI의 안정성이 향상됩니다.
  • 화면 주석 조정: android screen --annotate는 --help에 설명된 대로 에지 감지 기준점, 도형 필터링, 클러스터링 전략을 포함하여 기능 감지를 위한 조정 매개변수를 노출합니다.
  • 프로젝트 생성 옵션: android create는 --application-id 및 --namespace 플래그와 하이픈으로 연결된 옵션 이름(예: --min-sdk)을 지원합니다. 이제 Compose 템플릿은 src/main/kotlin 소스 세트와 Material 3 테마를 사용합니다.
  • 헤드리스 에뮬레이터: android emulator start --headless를 사용하여 창 없이 에뮬레이터를 시작합니다.
  • SDK 안정성: android sdk 명령어는 동시 호출이 충돌하지 않도록 프로세스 간 잠금을 사용하고, 설치된 패키지의 경로와 버전을 확인하고, 필요한 경우에만 기존 XML 파일을 업데이트하고, 더 명확한 오류를 보고합니다.
  • Compose 미리보기 출력: android studio render-compose-preview는 렌더링된 이미지의 절대 경로를 출력하고 --print-semantics가 사용되는 경우에도 쓰기를 확인합니다.
  • 이전 API 수준 지원: API 수준 32 이하를 실행하는 기기에서 android layout와 같은 기기 상호작용 실패를 수정했습니다.

버전 1.0.16261425(2026년 9월)

  • 레이아웃 수정: 일부 시나리오에서 레이아웃 명령어가 작동하지 않는 문제가 해결되었습니다. 이전 레이아웃 동작으로 일시적으로 되돌리려면 export ANDROID_CLI_LAYOUT_V1=1를 사용하세요.

버전 1.0.16251017(2026년 9월)

  • 레이아웃 덤프: 이제 android layout에서 --no-idle 플래그를 지원하여 유휴 상태를 기다리지 않고 레이아웃을 가져옵니다. android layout는 필터링 없이 전체 레이아웃 트리를 반환하는 --full 플래그도 지원합니다. 기본적으로 layout는 상호작용 요소만 반환합니다.
  • 셸 완성: 새 android completion 명령어를 사용하여 Bash 및 Zsh용 셸 자동 완성 스크립트를 생성하고 설치합니다.
  • 스킬 업데이트: 새 android skills update 명령어를 사용하여 스킬을 최신 상태로 유지하고 단일 호출(예: android skills install <skill1> <skill2>)로 여러 스킬을 설치하거나 삭제합니다.
  • 에이전트별 스킬 나열: 이제 android skills list가 기본적으로 스킬 설명과 스킬이 설치된 에이전트를 포함한 상세 표시로 설정됩니다. android skills list는 에이전트에 설치된 모든 기술을 나열하는 --agent <agent> 플래그도 지원합니다.
  • 델타 설치 성능: 제로 카피 커널 시스템 호출을 사용하여 android install에서 증분 APK 패치를 가속화했습니다.
  • 화면 가장자리 감지: Canny 가장자리 감지 알고리즘을 사용하여 android screen의 기능 및 가장자리 감지를 개선했습니다.

버전 1.0.15985488(2026년 7월)

  • 전용 설치 명령어: 증분 APK 푸시를 특징으로 하는 독립형 android install 명령어를 사용하여 APK를 설치합니다. 이 명령어는 증분 설치를 adb보다 훨씬 빠르게 만듭니다.
  • 증분 설치 실행: 마찬가지로 android run에서 새로운 --use-delta-install 플래그를 사용하여 기기에 더 빠르게 증분 APK를 배포합니다.
  • 교차 플랫폼 SDK 관리: android sdk 명령어(install, update, materialize)의 새로운 --platform <os_arch> 플래그를 사용하여 비호스트 플랫폼을 타겟팅하여 OS 및 CPU 아키텍처 전반에서 구성요소를 검사, 해결, 설치합니다.
  • 기술 CLI 개선사항: android skills 하위 명령어(add, remove, list, find)를 --help 문서로 확장하고, 기술이 누락된 경우 명확한 피드백을 제공하며, 자동 롤백을 통해 더 안전한 원자적 다운로드 스테이징을 지원합니다.

버전 1.0.15857036(2026년 7월)

  • 더 광범위한 에이전트 기술 지원: android skills install를 사용하여 수십 개의 에이전트 환경(Claude Code, Cursor, Cline, OpenHands, Windsurf, Zed, Devin 포함)에 기술을 설치합니다.
  • 프록시 지원이 포함된 네이티브 다운로더: 기업 프록시를 즉시 지원하는 네이티브 HTTP 다운로더를 사용하여 네트워크 리소스를 안정적으로 다운로드합니다.
  • SDK 패키지 관리: android sdk remove의 다중 패키지 삭제 및 android sdk resolve의 SHA 기반 해결을 통해 SDK 패키지를 관리합니다.
  • 설명 및 화면 개선: android describe의 표준 출력에서 직접 Gradle 빌드 오류를 확인하고 android screen에서 --device 플래그를 사용하여 특정 기기를 타겟팅합니다.
  • CLI 사용성 및 오류 보고: 알 수 없는 명령어 또는 잘못된 프로젝트 생성 타겟을 입력할 때 더 명확한 오류 메시지, 대소문자를 구분하지 않는 android emulator 명령어

버전 1.0.15498356(2026년 5월)

  • 동적 SDK 템플릿 로드: 이제 android create의 프로젝트 템플릿이 CLI 바이너리에 번들로 포함되는 대신 Android SDK 패키지에서 동적으로 다운로드되므로 새 프로젝트에서 항상 최신 템플릿을 사용할 수 있습니다.
  • SDK 라이선스 호환성: android sdk에서 저장한 허용된 SDK 라이선스가 이제 이전 Android SDK 도구 및 Gradle 플러그인에서 예상하는 파일 형식과 일치합니다.
  • 심볼릭 링크 지원: CLI 명령어 및 파일 작업 전반에 심볼릭 링크 지원이 추가되었습니다.
  • 원자 바이너리 추출: 바이너리를 임시 디렉터리에 압축 해제한 후 원자적으로 제자리에 이동하여 동시 멀티 프로세스 CLI 호출 중에 추출 경합 상태를 방지합니다.
  • Windows 안정성: Windows 11에서 Windows 호환성 및 성능이 개선되었으며 홈 디렉터리 경로 확인 문제가 해결되었습니다.

버전 1.0.15433482(2026년 5월)

  • Antigravity 통합: Android CLI와 스킬이 이제 Google Antigravity 2.0에 공식적으로 통합되어 에이전트 기반 개발을 간소화하는 선택적 리소스 번들로 제공됩니다.
  • Android 스튜디오 명령어: 새로운 android studio 명령어를 사용하여 에이전트가 코드 분석, 시맨틱 조회, Compose 렌더링을 비롯한 Android 스튜디오의 심층적인 문맥 기능을 활용할 수 있도록 합니다.
  • 여정 지원: 에이전트가 터미널 또는 CI/CD에서 실행할 수 있는 사용자 플로우의 자연어 설명인 여정을 사용하여 중요한 사용자 환경을 검증합니다.
  • 새로운 Android 기술: CameraX 이전, 적응형 UI, AppFunctions, Compose 스타일을 위한 기술을 포함한 새로운 Android 기술 라이브러리에 액세스합니다.
  • 추가 설치 옵션: apt-get, winget, homebrew를 비롯한 인기 패키지 관리자를 사용하여 Android CLI를 설치하고 업데이트합니다. 자세한 내용은 다운로드 옵션을 참고하세요.

버전 0.7(2026년 4월)

첫 번째 버전이 출시되었습니다.