Android CLI 출시 노트

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

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

버전 1.0.16406183 (2026년 9월)

  • 더 빠른 시작: 네이티브 다운로더 라이브러리는 사용될 때만 로드되고 더 이상 호출될 때마다 임시 디렉터리로 압축 해제되지 않으므로 Android CLI가 약 2배 더 빠르게 시작됩니다.
  • 종료 코드 수정: 이제 명령어는 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 아키텍처 전반에서 구성요소를 검사, 해결, 설치합니다.
  • Skills CLI 개선사항: --help 문서가 포함된 android skills 하위 명령어 (add, remove, list, find) 확장, 스킬이 누락된 경우 명확한 피드백, 자동 롤백을 통한 더 안전한 원자 다운로드 스테이징

버전 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월)

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