Android CLI 개요

Android CLI는 원하는 도구를 사용하여 Android를 더 효율적으로 빌드할 수 있는 명령줄 인터페이스입니다. 에이전트 중심 워크플로의 핵심 개발 역량을 표준화하여 더 효과적으로 개발하는 데 필요한 공식 도구, 기술, 지식에 대한 진입점을 제공합니다. 또한 Android 개발의 분산된 특성을 위해 CI, 유지관리, 기타 스크립트 자동화를 간소화할 수 있습니다.

예를 들어 에이전트나 스크립트는 CLI를 사용하여 다음과 같은 작업을 실행할 수 있습니다.

  • 환경 및 Android SDK 설정 자동화
  • 템플릿에서 새 프로젝트 스캐폴딩
  • 터미널에서 직접 가상 기기를 관리하고, APK를 설치하고, 실시간 기기 화면과 UI 계층 구조를 검사합니다.
  • 실행 중인 Android 스튜디오 인스턴스에 연결하여 시맨틱 코드 분석, Compose 미리보기 렌더링, 종속 항목 버전 조회
  • 탐색 여정으로 앱 테스트

또한 Android CLI를 사용하면 에이전트가 Android 스킬과 전문 Android 기술 자료에 액세스하여 프로젝트에 Android 권장 패턴과 권장사항이 적용되도록 할 수 있습니다.

Android CLI 명령어 및 옵션에 관한 전체 설명은 Android CLI 명령어 참조를 참고하세요.

Android CLI 설치

Android CLI를 설치하려면 다음 단계를 따르세요.

  1. Android CLI 다운로드

  2. 최신 버전을 사용하고 있는지 확인하려면 Android CLI를 업데이트하세요.

    android update

Android CLI가 머신에 이미 설치되어 있는지 확인하려면 which android 또는 command -v android를 실행하세요. 경로가 반환되면 설치된 것입니다.

상담사를 위한 설정

상담사가 Android CLI를 이해하고 사용할 수 있도록 하려면 android init를 실행하여 android-cli 스킬을 설치하세요.

수집되는 데이터

Android CLI는 도구의 기본 사용에 관한 데이터를 수집합니다. Google에서 수집하는 데이터는 다음과 같습니다.

  • android 명령어 및 하위 명령어(예: android run 및 android create)의 호출
  • 사용된 비위치 인수 또는 옵션의 이름입니다(예: --sdk 또는 --version).
  • Android CLI에서 관리하는 고정된 사전 정의 시스템 옵션 집합에 매핑되는 위치 인수 및 플래그 값 예를 들어 medium_phone, large_desktop과 같은 에뮬레이터 템플릿 이름과 GEMINI, CLAUDE, CODEX과 같은 에이전트 이름을 수집합니다.
  • 개인 정보 보호를 위해 수집 전에 식별 정보가 익명 처리된 스택 트레이스 및 예외 메시지

다음은 Google에서 수집하지 않는 데이터의 몇 가지 예입니다.

  • 명령어가 실행될 때 CLI의 응답은 수집되지 않습니다.
  • Google에서는 특정 Maven 좌표, 로컬 파일 경로, 맞춤 프로젝트 이름과 같이 사용자가 만든 입력 또는 CLI에 전달된 외부 식별자를 수집하지 않습니다. 예를 들어 android create --name=com.company.internal.app 명령어가 실행되면 --name 인수를 사용하여 android create가 실행된 것으로 기록되지만 com.company.internal.app 값은 저장되지 않습니다.

데이터 수집을 사용 중지하려면 Android CLI로 명령어를 실행할 때 --no-metrics 플래그를 사용하세요.

의견 및 문제

문제가 발생하거나 의견을 제공하려면 버그를 신고하세요.

알려진 문제

  • Windows용 android emulator 명령어가 현재 사용 중지되어 있습니다.
  • Windows PowerShell에서 Android CLI를 다운로드하는 것은 현재 지원되지 않습니다.

Android CLI 구성

Android CLI를 호출할 때마다 플래그와 옵션을 자동으로 적용하는 .androidrc 파일을 만듭니다. 운영체제에 따라 다음 위치에 파일을 저장합니다.

  • macOS 및 Linux: ~/.androidrc
  • Windows: %USERPROFILE%\.androidrc

파일에 자동으로 적용할 플래그를 한 줄에 하나씩 추가합니다.

예를 들어 Android CLI가 매번 특정 Android SDK를 기본적으로 사용하도록 하려면 파일에 --sdk 플래그를 추가합니다.

--sdk=<path-to-sdk>

전체 옵션

이러한 플래그는 다른 Android CLI 명령어와 함께 사용할 수 있는 선택적 플래그입니다.

-h, --help

사용: android <command> -h

설명: 문제의 도구 또는 특정 명령어에 대한 도움말을 표시합니다.

예:

  • android -h
  • android create -h

--sdk

사용: android --sdk=<path-to-sdk> <command>

설명: 다음에 나오는 명령어에 사용할 Android SDK의 경로입니다. --sdk 설정을 사용하여 전환할 때마다 전역 환경 변수를 변경하는 대신 기본 Android SDK를 일시적으로 재정의할 수 있습니다. 기본적으로 사용 중인 Android SDK를 확인하려면 android info를 실행합니다.

예: android --sdk=<path/to/sdk> sdk list

-v, --verbose

사용: android -v <command>

설명: 상세 출력을 사용 설정합니다. -v 옵션을 여러 개 지정하여 상세 출력을 늘립니다 (예: -v, -vv 또는 -vvv).

-V, --version

사용: android -V

설명: 버전 정보를 출력하고 종료합니다.

명령어

Android CLI 명령어 및 옵션에 관한 전체 설명은 Android CLI 명령어 참조를 참고하세요.