Android CLI 개요

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

Android CLI는 프로젝트를 만들고 기기에서 테스트하는 것부터 성능을 프로파일링하고 현장에서 어떻게 작동하는지 조사하는 것까지 전체 개발 수명 주기를 다룹니다. 예를 들어 에이전트 또는 스크립트는 CLI를 사용하여 다음과 같은 작업을 수행할 수 있습니다.

또한 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의 응답을 수집하지 않습니다.
  • 특정 Maven 좌표, 로컬 파일 경로, 맞춤 프로젝트 이름과 같이 CLI에 전달된 사용자 생성 입력이나 외부 식별자는 수집하지 않습니다. 예를 들어 android create --name=com.company.internal.app 명령어가 실행되면 --name 인수를 사용하여 android create가 실행되었다고 기록하지만 com.company.internal.app 값은 저장하지 않습니다.

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

의견 및 문제

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

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 명령어 참조를 확인하세요.