Android CLI 개요

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

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

  • 환경 설정 자동화
  • 템플릿에서 새 프로젝트 스캐폴딩
  • 터미널에서 직접 가상 기기 관리
  • 여정으로 앱 테스트

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

Android CLI 설치

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

  1. Android CLI를 다운로드합니다.

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

    android update

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

상담사를 위한 설정

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

android init

수집되는 데이터

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 값은 저장되지 않습니다.

알려진 문제

  • 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

명령어

이 섹션에서는 모든 Android CLI 명령어를 나열하고 그 기능을 설명합니다. 이러한 명령어는 모두 android로 시작해야 합니다(예: android create, android run 등). 선택적 수정자는 괄호 []로 묶여 있고 필수 인수는 그렇지 않습니다.

create

사용: android create [--dry-run] [--verbose] [--name=<application-name>] [--output=<dest-path>] [<template-name>]

설명: 템플릿에서 새 프로젝트를 초기화합니다. 템플릿 옵션을 보려면 android create -h를 실행합니다.

인수 (필수):

  • -o, --output - 대상 프로젝트 디렉터리 경로입니다.

옵션:

  • --dry-run - 실제로 파일을 저장하지 않고 전체 프로젝트 생성 프로세스를 시뮬레이션합니다. 예를 들어 테스트 실행을 통해 다양한 템플릿이 어떤 기능을 하는지 확인한 후 템플릿을 커밋할 수 있습니다.
  • --verbose - 템플릿에서 복사되는 파일과 같은 정보를 포함하여 자세한 출력을 사용 설정합니다.
  • --name=<application-name> - 프로젝트 디렉터리의 이름입니다. 생략하면 출력 디렉터리가 사용됩니다.
  • <template-name> - 새 프로젝트를 만들 템플릿의 이름입니다. 생략하면 empty-activity-agp-9이 사용됩니다.

예: android create --dry-run --verbose empty-activity-agp-9

create list

사용: android create list

설명: 새 프로젝트를 만드는 데 사용할 수 있는 모든 템플릿을 나열합니다.

describe

사용: android describe [--project_dir=<project-directory>]

설명: Android 프로젝트를 분석하여 설명 메타데이터를 생성합니다. 이 명령어는 빌드 타겟과 해당 출력 아티팩트 위치 (예: APK 파일)를 비롯한 프로젝트 구조를 자세히 설명하는 JSON 파일의 경로를 식별하고 출력합니다. 이 정보를 통해 다른 도구와 명령어가 빌드 아티팩트를 효율적으로 찾을 수 있습니다.

옵션:

  • --project_dir - 설명할 프로젝트 디렉터리입니다. 생략하면 현재 디렉터리가 사용됩니다.

예: android describe --project_dir=/path/to/your/project

docs

사용:

  • android docs search <query>
  • android docs fetch <kb-url>

설명: android docs 명령어는 CLI에서 직접 Android 기술 자료에 액세스하는 2단계 프로세스입니다. 먼저 search 명령어를 사용하여 질문과 관련된 문서를 검색합니다. 검색 결과에는 kb://로 시작하는 특수 URL이 포함되며, 이 URL을 fetch 명령어와 함께 사용하여 터미널에 문서 명령어를 출력할 수 있습니다.

예:

  • android docs search 'How do I improve my app performance?'
  • android docs fetch kb://android/topic/performance/overview

emulator create

사용: android emulator create [--list-profiles] [--profile=<profile-name>]

설명: 가상 기기를 만듭니다.

옵션:

  • --list-profiles - 기기를 만드는 데 사용할 수 있는 기기 프로필을 나열합니다.
  • --profile=<profile-name> - 지정된 프로필로 기기를 만듭니다. 생략하면 medium_phone 프로필이 생성됩니다.

emulator list

사용: android emulator list

설명: 사용 가능한 가상 기기를 나열합니다.

emulator start

사용: android emulator start <device-name>

설명: 지정된 가상 기기를 실행합니다.

인수 (필수):

  • <device-name> - 시작할 기기 이름입니다 (예: medium_phone). android emulator list를 사용하여 사용 가능한 기기를 확인하세요.

예: android emulator start medium_phone

emulator stop

사용: android emulator stop <device-serial-number>

설명: 지정된 가상 기기를 중지합니다.

인수 (필수):

  • <device-serial-number> - 중지할 기기 일련번호입니다.

예: android emulator stop emulator-5554

info

사용: android info

설명: 사용된 기본 Android SDK의 경로를 표시합니다. 사용되는 Android SDK를 변경하려면 --sdk를 사용하세요.

init

사용: android init

설명: android-cli 기능을 설치하여 에이전트 환경을 설정합니다.

layout

사용: android layout [--pretty] [--output] [--diff]

설명: 활성 Android 앱 (실제 기기 또는 에뮬레이터를 통해 연결됨)의 UI 레이아웃을 JSON 형식으로 반환합니다.

옵션:

  • -p, --pretty - 사람이 읽을 수 있도록 들여쓰기 및 줄바꿈으로 JSON 출력을 서식 지정합니다.
  • -o, --output - 레이아웃 트리를 저장할 파일 위치를 지정합니다. 생략하면 JSON이 stdout에 직접 인쇄됩니다.
  • -d, --diff - 전체 레이아웃 트리 대신 마지막 내부 스냅샷이 생성된 이후 (마지막으로 레이아웃이 실행된 시간) 변경된 레이아웃 요소 목록만 반환합니다.

예: android layout --output=./hierarchy.json

run

사용: android run [--debug] [--activity=<activity-name>] [--device=<serial-number>] [--type=<param>] --apks=<apk-paths>

설명: 연결된 기기나 에뮬레이터에 Android 앱을 배포합니다. 빌드 단계를 실행하지 않습니다. 설치할 APK 파일의 경로를 제공해야 합니다.

인수 (필수):

  • --apks - 설치할 APK 파일의 경로를 쉼표로 구분한 목록입니다. 경로는 파일 시스템의 현재 위치를 기준으로 합니다.

옵션:

  • --activity - APK가 설치된 후 실행할 활동의 이름입니다. 활동이 여러 개인 경우 처음 실행할 활동을 하나 지정해야 합니다.
  • --debug - 디버그 모드에서 앱을 배포합니다. 디버그 모드에서 앱을 실행한 후 Android 스튜디오와 같은 IDE나 명령줄 도구에서 디버거를 연결하여 디버깅을 시작해야 합니다.
  • --device - 대상 기기 또는 에뮬레이터의 일련번호입니다. 여러 기기가 연결된 경우에만 필요합니다. 기기 일련번호를 찾으려면 adb devices을 실행합니다.
  • --type - 시작할 구성요소 유형입니다. UI 활동 대신 백그라운드 서비스를 직접 시작하려는 경우 이를 사용하세요. 지원되는 유형:
    • ACTIVITY
    • WATCH_FACE
    • TILE
    • COMPLICATION
    • DECLARATIVE_WATCH_FACE

예:

  • android run --apks=app/build/outputs/apk/debug/app-debug.apk - 단일 APK를 기본 기기에 배포합니다.
  • android run --apks=base.apk,density-hdpi.apk,lang-en.apk - 기본 기기에 여러 APK를 배포합니다.
  • android run --apks=app-debug.apk --type=SERVICE --activity=.sync.DataSyncService - 활동 없이 서비스를 테스트합니다.
  • android run --apks=app-debug.apk --device=emulator-5554 - 특정 기기에 APK를 배포합니다.

screen capture

사용: android screen capture [--output] [--annotate]

설명: 연결된 기기의 스크린샷을 캡처합니다.

옵션:

  • -o, --output - 스크린샷을 저장할 파일 위치를 지정합니다. 생략하면 원시 PNG 데이터가 stdout에 직접 출력됩니다.
  • -a, --annotate - resolve 명령과 함께 사용할 수 있도록 이미지에서 감지된 모든 UI 요소 주위에 라벨이 지정된 경계 상자를 그립니다.

예: android screen capture --output=ui.png

screen resolve

사용: android screen resolve --screenshot=<path> --string=<string>

설명: screen capture를 사용하여 캡처한 주석이 달린 스크린샷의 시각적 라벨을 실제 화면 좌표 (x, y)로 변환합니다. 요소의 위치를 수동으로 계산하지 않고도 요소 클릭을 스크립팅하는 데 유용합니다.

플래그:

  • --screenshot - 주석이 추가된 스크린샷의 경로입니다.
  • --string - #<number> 형식의 UI 요소 라벨에 해당하는 자리표시자를 하나 이상 포함하는 문자열입니다. #<number> 부분은 화면 좌표로 대체됩니다.

예:

라벨 5가 좌표 (500, 1000)에 있는 경우 다음 명령어를 실행합니다.

android screen resolve --screenshot=ui.png --string="input tap #5"

출력을 반환합니다.

input tap 500 1000

sdk install

사용: android sdk install <package[@version]> [--beta] [--canary] [--force]

설명: 지정된 SDK 패키지를 설치합니다.

인수 (필수):

  • package[@version] - 설치할 패키지의 공백으로 구분된 목록입니다. 버전이 지정되지 않은 경우 채널(기본적으로 안정화 채널)의 최신 버전 패키지가 설치됩니다.

옵션:

  • --beta - 베타 패키지를 포함합니다.
  • --canary - 카나리아 패키지를 포함합니다.
  • --force - 이전 버전으로 강제 다운그레이드

예:

  • android sdk install platforms/android-34 build-tools/34.0.0 - 안정화 채널에서 최신 버전의 Android SDK 플랫폼 34 및 SDK 빌드 도구 34.0.0 패키지를 설치합니다.
  • android sdk install platforms/android-34@2 - Android SDK 플랫폼 34 패키지의 버전 2를 설치합니다.
  • android sdk install --canary system-images/android-35/google_apis/x86_6 - canary 채널에서 최신 버전의 Android 35 시스템 이미지를 설치합니다.
  • android sdk install --force platforms/android-33@1 - 안정화 채널에서 Android SDK 플랫폼 33 패키지의 버전 1로 되돌립니다.

sdk list

사용: android sdk list <package-pattern>

설명: 설치된 SDK 패키지와 사용 가능한 SDK 패키지를 나열합니다.

인수 (필수):

  • <package-pattern> - 패턴별로 패키지를 필터링합니다. 정규 표현식을 지원합니다.

옵션:

  • --all - 설치된 패키지와 사용 가능한 패키지를 모두 표시합니다.
  • --all-versions - 각 패키지의 모든 버전을 표시합니다.
  • --beta - 베타 패키지를 포함합니다.
  • --canary - 카나리아 패키지를 포함합니다.

sdk remove

사용: android sdk remove <package-name>

설명: SDK에서 패키지를 삭제합니다.

인수 (필수):

  • <package-name> - 삭제할 패키지의 이름입니다.

예: android sdk remove build-tools/36.1.0

sdk update

사용: android sdk update [--beta] [--canary] [<package-name>]

설명: 채널 (기본적으로 안정화 채널)에서 하나 또는 모든 패키지를 최신 버전으로 업데이트합니다. 패키지를 지정하지 않으면 모든 패키지가 업데이트됩니다.

옵션:

  • <package-name> - 업데이트할 패키지의 이름입니다.
  • --beta - 베타 패키지를 포함합니다.
  • --canary - 카나리아 패키지를 포함합니다.
  • --force - 이전 버전으로 강제 다운그레이드

예:

  • android sdk update - SDK의 모든 항목에 대한 업데이트를 확인하고 설치합니다.
  • android sdk update build-tools/34.0.0 - 안정화 채널의 최신 버전으로 Android SDK 빌드 도구 34.0.0 패키지를 업데이트합니다.
  • android sdk update --canary platforms/android-35 - Android SDK 플랫폼 35 패키지를 카나리아 채널의 최신 버전으로 업데이트합니다.

skills add

Android 스킬은 에이전트가 Android 개발에 관한 권장사항과 안내를 따르는 특정 패턴을 더 잘 이해하고 실행하도록 설계된 특별한 안내입니다. 자세한 내용은 Android 스킬 소개를 참고하세요.

사용: android skills add [--all] [--agent=<agent-name>] [--skill=<skill-name>]

설명: 감지된 모든 에이전트의 기술 디렉터리에 Android 기술을 설치합니다. 기존 에이전트 디렉터리가 없고 특정 에이전트를 지정하지 않으면 Gemini 및 Antigravity용 스킬이 ~/.gemini/antigravity/skills에 설치됩니다. Android 스킬이 이미 설치되어 있으면 skills add에서 스킬을 최신 버전으로 업데이트합니다.

옵션:

  • --all - 모든 Android 스킬을 한 번에 설치하거나 업데이트합니다. 생략되고 --skill이 지정되지 않으면 android-cli 기능만 설치됩니다.
  • --agent - 스킬을 설치하거나 업데이트할 에이전트의 쉼표로 구분된 목록입니다. 생략하면 감지된 모든 에이전트에 기능이 설치됩니다.
  • --skill - 설치하거나 업데이트하려는 기능 이름입니다. 생략되고 --all이 지정되지 않은 경우 android-cli 기능만 설치되거나 업데이트됩니다.

예: android skills add --agent='gemini' edge-to-edge

skills find

사용: android skills find <string>

설명: 지정된 문자열과 일치하는 기술을 찾습니다.

인수 (필수):

  • string - 스킬 설명과 일치하는 문자열입니다.

예: android skills find 'performance'

skills list

사용: android skills list [--long]

설명: 사용 가능한 스킬을 나열합니다.

옵션:

  • --long - 기술 설명, 이미 설치된 에이전트 등 각 기술에 대한 추가 정보를 출력합니다.

skills remove

사용: android skills remove [--agent] --skill=<skill-name>

설명: 기능을 삭제합니다. 특정 상담사를 지정하지 않으면 모든 상담사의 기술이 삭제됩니다.

인수 (필수):

  • --skill - 삭제할 기능의 이름입니다.

옵션:

  • --agent - 기술을 삭제할 상담사의 쉼표로 구분된 목록입니다. 생략하면 모든 상담사의 기술이 삭제됩니다.

예: android skills remove --agent='gemini' --skill=edge-to-edge

studio check

studio 명령어를 사용하면 개발자 또는 AI 에이전트가 활성 Android 스튜디오 인스턴스와 상호작용할 수 있습니다. 실행 중인 인스턴스에 연결하면 IDE의 기능을 사용하여 파일을 분석하고, 심볼 선언과 사용을 찾고, Compose 미리보기를 렌더링하고, 종속 항목 버전을 조회할 수 있습니다.

사용: android studio check

설명: 실행 중인 Android 스튜디오 인스턴스의 상태를 확인하고 열려 있는 프로젝트를 나열합니다. 이 명령어를 먼저 실행하여 CLI와 IDE 간의 연결을 확인하고 연결할 PID와 프로젝트를 선택합니다(여러 개 있는 경우).

출력 예시:

연결된 경우 출력에 실행 중인 Android 스튜디오 인스턴스의 PID, 버전, 열린 프로젝트의 상태가 나열됩니다.

pid: 32942
version: Android Studio Quail
Projects:
    READY     MyApplication /Users/username/AndroidStudioProjects/MyApplication

studio analyze-file

사용: android studio analyze-file [--pid=<pid>] [--project=<project>] <path>

설명: IDE의 내장 검사 엔진을 사용하여 Android 스튜디오에서 오류, 경고, 린트를 위해 파일을 분석합니다.

인수 (필수):

  • <path> - 분석할 Kotlin 또는 Java 파일의 경로입니다.

옵션:

  • --pid=<pid> - 연결할 특정 Android 스튜디오 인스턴스의 PID입니다(여러 개 있는 경우).
  • --project=<project> - 쿼리할 Android 스튜디오에서 열린 프로젝트의 이름입니다(여러 개 있는 경우). 프로젝트 디렉터리 내에서 analyze-file 명령어를 실행하면 해당 프로젝트가 기본적으로 사용됩니다.

예:

android studio analyze-file \
  --project=MyApplication \
  /Users/username/AndroidStudioProjects/MyApplication/app/src/main/java/com/example/myapp/MainActivity.kt

studio find-declaration

사용: android studio find-declaration [--short] [--context-file=<path>] [--pid=<pid>] [--project=<project>] <symbol>

설명: 시맨틱 해결을 사용하여 프로젝트 전체에서 심볼 (클래스, 메서드, 변수, 필드, 상수 또는 Android 리소스)의 정확한 선언 사이트를 찾습니다.

인수 (필수):

  • <symbol> - 선언을 찾을 코드 심볼의 이름입니다.

옵션:

  • --context-file=<path> - 기호 참조가 포함된 파일의 선택적 경로입니다. 컨텍스트 파일을 제공하면 가져오기 및 범위를 제공하여 모호하거나 과부하된 심볼을 해결할 수 있습니다.
  • --short - 파일 위치와 줄 일치 항목만 표시하도록 출력을 간소화합니다.
  • --pid=<pid> - 연결할 특정 Android 스튜디오 인스턴스의 PID입니다(여러 개 있는 경우).
  • --project=<project> - 쿼리할 Android 스튜디오에서 열린 프로젝트의 이름입니다(여러 개 있는 경우). 프로젝트 디렉터리 내에서 find-declaration 명령어를 실행하면 해당 프로젝트가 기본적으로 사용됩니다.

예:

android studio find-declaration --short HotelDetailScreen

studio find-usages

사용: android studio find-usages [--short] [--pid=<pid>] [--project=<project>] <symbol>

설명: 시맨틱 분석을 사용하여 전체 프로젝트에서 기호의 모든 참조와 사용을 찾습니다.

인수 (필수):

  • <symbol> - 사용 사례를 찾을 심볼의 이름입니다.

옵션:

  • --short - 일치하는 파일 위치만 표시하도록 출력을 간소화합니다.
  • --pid=<pid> - 연결할 특정 Android 스튜디오 인스턴스의 PID입니다(여러 개 있는 경우).
  • --project=<project> - 쿼리할 Android 스튜디오에서 열린 프로젝트의 이름입니다(여러 개 있는 경우). 프로젝트 디렉터리 내에서 이 명령어를 실행하면 해당 프로젝트가 기본적으로 사용됩니다.

예:

android studio find-usages --short HotelDetailScreen

studio open-file

사용: android studio open-file [--pid=<pid>] [--project=<project>] <path>

설명: Android 스튜디오의 활성 편집기 창에서 파일을 직접 엽니다.

인수 (필수):

  • <path> - 열 파일의 경로입니다. 프로젝트 루트 디렉터리를 기준으로 지정하거나 절대 경로로 지정할 수 있습니다.

옵션:

  • --pid=<pid> - 연결할 특정 Android 스튜디오 인스턴스의 PID입니다(여러 개 있는 경우).
  • --project=<project> - 쿼리할 Android 스튜디오에서 열린 프로젝트의 이름입니다(여러 개 있는 경우). 프로젝트 디렉터리 내에서 open-file 명령어를 실행하면 해당 프로젝트가 기본적으로 사용됩니다.

예:

android studio open-file app/src/main/java/com/example/myapp/ui/DetailScreen.kt

studio render-compose-preview

사용: android studio render-compose-preview [--print-semantics] [--output-image-file=<filename>] [--pid=<pid>] [--project=<project>] <path> <composable>

설명: Jetpack Compose UI 미리보기를 렌더링하고 선택적으로 레이아웃 시맨틱 트리도 반환합니다. 이는 시각적 테스트에 유용하거나 AI 에이전트가 UI 레이아웃과 함께 작동하도록 지원하는 데 유용합니다.

인수 (필수):

  • <path> - Compose 미리보기가 포함된 Kotlin 파일의 경로입니다.
  • <composable> - 컴포저블 미리보기 함수의 이름입니다 (@Preview로 표시됨).

옵션:

  • --output-image-file=<filename> - 렌더링된 결과 PNG 이미지를 쓸 파일 이름을 지정합니다. 생략하면 임시 파일이 생성됩니다.
  • --print-semantics - true인 경우 렌더링된 Compose 미리보기의 접근성 시맨틱 트리(JSON 형식)를 출력합니다. 이를 통해 에이전트는 UI의 구조와 상호작용 요소를 파싱할 수 있습니다.
  • --pid=<pid> - 연결할 특정 Android 스튜디오 인스턴스의 PID입니다(여러 개 있는 경우).
  • --project=<project> - 쿼리할 Android 스튜디오에서 열린 프로젝트의 이름입니다(여러 개 있는 경우). 프로젝트 디렉터리 내에서 render-compose-preview 명령어를 실행하면 해당 프로젝트가 기본적으로 사용됩니다.

예:

android studio render-compose-preview \
  --output-image-file=preview_hotel.png \
  --print-semantics \
  app/src/main/java/com/example/myapp/ui/DetailScreen.kt \
  HotelDetailScreenPreview

studio version-lookup

사용: android studio version-lookup [--pid=<pid>] [--project=<project>] <artifacts...>

설명: Google Maven과 같은 저장소에서 사용 가능한 최신 버전의 일반적인 종속 항목, Android 플랫폼, SDK 도구를 조회합니다. 이를 통해 수동 종속 항목 버전 확인에 대한 프로그래매틱 대안을 제공합니다.

인수 (필수):

  • <artifacts...> - 공백으로 구분된 식별자 목록입니다. 단일 명령어로 여러 아티팩트를 쿼리할 수 있습니다. 지원되는 식별자는 다음과 같습니다.
    • Maven 라이브러리: groupId:artifactId 표기법 (예: androidx.window:window)
    • Gradle 플러그인: 플러그인 ID (예: com.android.application)
    • 키워드:
      • gradle (Gradle 빌드 도구)
      • studio (Android 스튜디오)
      • agp (Android Gradle 플러그인)
      • ndk (Android NDK)
      • sdk (Android SDK)
      • emulator (Android 에뮬레이터)
      • adb (Android 디버그 브리지)
      • compose (Jetpack Compose BOM)
      • kotlin (Kotlin 런타임 및 컴파일러)
      • android (Android OS 버전)
      • platform-tools (Android SDK 플랫폼 도구)
      • cmdline-tools (Android SDK 명령줄 도구)
      • build-tools (Android SDK 빌드 도구)

옵션:

  • --pid=<pid> - 연결할 특정 Android 스튜디오 인스턴스의 PID입니다(여러 개 있는 경우).
  • --project=<project> - 쿼리할 Android 스튜디오에서 열린 프로젝트의 이름입니다(여러 개 있는 경우). 프로젝트 디렉터리 내에서 version-lookup 명령어를 실행하면 해당 프로젝트가 기본적으로 사용됩니다.

예:

android studio version-lookup \
  androidx.compose.ui:ui \
  com.android.application \
  agp \
  kotlin

update

사용: android update

설명: Android CLI를 업데이트합니다.

-V, --version

설명: Android CLI의 현재 버전을 표시합니다.