lerchenflo/claudeskills

Android CLI 전문가

이 스킬은 android CLI 도구 사용에 대한 지침을 제공합니다. 이 도구는 프로젝트 생성, 애플리케이션 실행, 기기와의 상호작용, CLI 환경 관리 등 다양한 명령어를 포함합니다.

설치

android 도구가 경로에 없으면 설치하십시오. 설치하려면 다음 명령어를 실행하십시오: 리눅스: curl -fsSL https://dl.google.com/android/cli/latest/linux_x86_64/install.sh | bash 맥 Arm: curl -fsSL https://dl.google.com/android/cli/latest/darwin_arm64/install.sh | bash 맥 Intel: curl -fsSL https://dl.google.com/android/cli/latest/darwin_x86_64/install.sh | bash 윈도우: curl -fsSL https://dl.google.com/android/cli/latest/windows_x86_64/install.cmd -o "%TEMP%\i.cmd" && "%TEMP%\i.cmd"

SDK 관리

Android SDK 및 도구의 설치를 관리하려면 sdk 명령어를 사용하십시오. 예시:

• android sdk install <package>[@<version>]...: 특정 패키지를 설치합니다. 여러 패키지를 공백으로 구분하여 지정할 수 있습니다. <version>은 기본적으로 최신 버전입니다. 예: android sdk install platforms/android-30@2 platforms/android-34
• android sdk update [<pkg-name>]: 특정 패키지 또는 모든 패키지를 최신 버전으로 업데이트합니다.
• android sdk remove <pkg-name>: 로컬 SDK에서 패키지를 제거합니다.
• android sdk list --all: 설치된 SDK 패키지와 사용 가능한 패키지를 나열합니다.

프로젝트 생성

create 명령어를 사용하여 템플릿에서 프로젝트를 생성합니다.

예: android create empty-activity --name="My App" --output=./my-app

Android 기기와 상호작용

android layout 명령어를 사용하여 Android 애플리케이션의 UI 레이아웃을 JSON 형식으로 검사합니다. android screen 명령어를 사용하여 UI를 시각적으로 검사하고 시각적 영역의 경계 좌표를 얻습니다.

중요: android layout 또는 android screen을 사용하기 전에 반드시 이 참조 문서를 읽으십시오: interact.md 참조 파일 interact.md에는 Android 기기와 올바르게 상호작용하기 위한 지침이 포함되어 있습니다. 해당 지침을 정확히 따르십시오.

저니 테스트 실행

저니 테스트는 기기 상호작용을 포함합니다. 저니를 평가하려면 android layout 및 android screen 명령어를 사용하십시오. 여기서도 기기 상호작용에 대한 지침이 동일하게 적용됩니다.

중요: 저니를 평가하기 전에 반드시 이 참조 문서를 읽으십시오: journeys.md 참조 파일 journeys.md에는 Android 저니를 올바르게 평가하기 위한 지침이 포함되어 있습니다. 해당 지침을 정확히 따르십시오.

문서 검색

docs 명령어는 Android 지식 베이스에서 권위 있는 고품질 Android 개발자 문서를 검색합니다. 몇 가지 키워드를 제공하면 이 도구는 Android API 또는 라이브러리 사용 방법에 대한 예제나 지침이 포함된 고품질 문서를 반환합니다. 이 도구를 사용하여 Android 관련 작업을 수행하는 방법에 대한 추가 정보를 얻거나 Android API, 표면, 라이브러리, 기기에 대해 더 자세히 알아보십시오.

항상 이 도구를 사용하여 Android 개념에 대한 최신 정보를 얻으십시오. 일반적인 사용 사례는 다음과 같습니다:

• API 마이그레이션 가이드 찾기
• API 예제 찾기
• Android API에 대한 최신 정보 찾기
• Android 개념에 대한 모범 사례 찾기

APK 실행

Android 앱을 실행하려면 run 명령어를 사용하십시오.

에뮬레이터 관리

android emulator 명령어를 사용하여 Android 가상 기기(AVD)를 관리합니다.

스크린샷 캡처

android screen 명령어를 사용하여 연결된 Android 기기의 현재 화면 이미지를 캡처하고 파일로 출력합니다.

스킬 관리

android skills 명령어를 사용하여 Android용 에이전트 스킬을 관리합니다.

CLI 업데이트

android update 명령어를 사용하여 Android CLI를 업데이트합니다.

android help 출력

Usage: android [-Vhv] [--sdk=PARAM] [COMMAND] -h, --help 도움말 메시지 표시 --sdk=PARAM Android SDK 경로 -v, --verbose 문제 해결을 위한 자세한 출력 활성화 -V, --version 버전 정보 출력 후 종료 Commands: completion 현재 사용자 프로필에 Android CLI용 셸 자동 완성 구성 설치 create 사용 가능한 템플릿에서 새 Android 프로젝트 생성. 프로젝트 이름, 출력 디렉터리, minSdk, dry-run 실행 지정 가능 describe Android 프로젝트를 분석하여 설명 메타데이터 생성. 빌드 대상과 해당 출력 아티팩트 위치(예: APK)를 상세히 설명하는 JSON 파일 경로를 식별하고 출력. 다른 도구와 명령어가 빌드 아티팩트를 효율적으로 찾을 수 있도록 함 docs 공식 지식 베이스에서 개발자 문서를 검색하고 가져오는 Android 문서 명령어 emulator Android 가상 기기(AVD) 관리. 에뮬레이터 시작, 중지, 목록 조회, 세부 정보 보기 명령어 포함 help 모든 명령어의 도움말 표시 info SDK 위치, 연결된 기기, 구성 변수를 포함한 환경 정보 출력. 특정 필드를 지정하여 출력 범위 축소 가능 init Android CLI 환경 초기화. 필요한 구성, 디렉터리, 기본 스킬 설정 install 연결된 기기나 에뮬레이터에 Android 애플리케이션(하나 이상의 APK)을 구성 요소 활성화 없이 증분 최적화를 사용하여 adb보다 빠르게 배포 layout 애플리케이션의 레이아웃 트리 반환 run 연결된 기기나 에뮬레이터에서 Android 애플리케이션 빌드, 배포, 실행 screen 기기 화면을 보기 위한 명령어 sdk Android SDK 설치 관리. SDK 패키지 설치, 업데이트, 제거, 나열 명령어 포함 skills Android CLI 스킬 관리. 스킬 설치, 제거, 목록 조회, 키워드 검색 명령어 포함 studio Android Studio 명령어 update Android CLI를 최신 버전으로 업데이트

completion Usage: android completion [-h] [] 현재 사용자 프로필에 Android CLI용 셸 자동 완성 구성 설치

      Options:
        -h, --help       도움말 메시지 표시
      
      android options:
            --sdk=PARAM  Android SDK 경로
        -v, --verbose    문제 해결을 위한 자세한 출력 활성화
        -V, --version    버전 정보 출력 후 종료
      
      Positional Parameters:
        <shell>  제공된 경우 설치하지 않고 해당 셸 완성 출력. 지원: bash, zsh

create Usage: android create [-h] [--application-id=PARAM] [--list] [--min-sdk=PARAM] [--name=PARAM] [--namespace=PARAM] [--output=PARAM] [] 사용 가능한 템플릿에서 새 Android 프로젝트 생성. 프로젝트 이름, 출력 디렉터리, minSdk, dry-run 실행 지정 가능

      Options:
            --application-id=PARAM  애플리케이션 ID (예: 'com.example.myapp')
        -h, --help                  도움말 메시지 표시
            --list                  사용 가능한 모든 템플릿 나열
            --min-sdk=PARAM         애플리케이션이 지원하는 'minSdk' (기본값은 템플릿에 정의됨)
            --name=PARAM            애플리케이션 이름 (예: 'My Application')
            --namespace=PARAM       리소스의 네임스페이스 및 Kotlin 소스 파일의 패키지 이름
        -o, --output=PARAM          대상 프로젝트 디렉터리 경로 (기본값은 '.')
      
      android options:
            --sdk=PARAM             Android SDK 경로
        -v, --verbose               문제 해결을 위한 자세한 출력 활성화
        -V, --version               버전 정보 출력 후 종료
      
      Positional Parameters:
        <template-name>  템플릿 이름

describe Usage: android describe [-h] [--project_dir=PARAM] Android 프로젝트를 분석하여 설명 메타데이터 생성. 빌드 대상과 해당 출력 아티팩트 위치(예: APK)를 상세히 설명하는 JSON 파일 경로를 식별하고 출력. 다른 도구와 명령어가 빌드 아티팩트를 효율적으로 찾을 수 있도록 함

      Options:
        -h, --help               도움말 메시지 표시
            --project_dir=PARAM  설명할 프로젝트 디렉터리
      
      android options:
            --sdk=PARAM          Android SDK 경로
        -v, --verbose            문제 해결을 위한 자세한 출력 활성화
        -V, --version            버전 정보 출력 후 종료

docs Usage: android docs [-h] [COMMAND] 공식 지식 베이스에서 개발자 문서를 검색하고 가져오는 Android 문서 명령어

      Options:
        -h, --help       도움말 메시지 표시
      
      android options:
            --sdk=PARAM  Android SDK 경로
        -v, --verbose    문제 해결을 위한 자세한 출력 활성화
        -V, --version    버전 정보 출력 후 종료
      Commands:
        fetch   URL(kb://...)에서 Android 문서 문서 가져오기
        search  Android 문서 검색. 키워드를 따옴표로 묶음

emulator Usage: android emulator [-h] [COMMAND] Android 가상 기기(AVD) 관리. 에뮬레이터 시작, 중지, 목록 조회, 세부 정보 보기 명령어 포함

      Options:
        -h, --help       도움말 메시지 표시
      
      android options:
            --sdk=PARAM  Android SDK 경로
        -v, --verbose    문제 해결을 위한 자세한 출력 활성화
        -V, --version    버전 정보 출력 후 종료
      Commands:
        create  가상 기기 생성
        list    사용 가능한 가상 기기 목록 조회
        remove  가상 기기 삭제
        start   지정된 가상 기기 실행. 에뮬레이터가 완전히 시작되어 사용할 준비가 되면 반환됨
        stop    지정된 가상 기기 중지

help Usage: android help [-h] [COMMAND] 모든 명령어의 도움말 표시

      Options:
        -h, --help       도움말 메시지 표시
      
      android options:
            --sdk=PARAM  Android SDK 경로
        -v, --verbose    문제 해결을 위한 자세한 출력 활성화
        -V, --version    버전 정보 출력 후 종료
      
      Positional Parameters:
        COMMAND  도움말을 표시할 명령어

info Usage: android info [-h] [] SDK 위치, 연결된 기기, 구성 변수를 포함한 환경 정보 출력. 특정 필드를 지정하여 출력 범위 축소 가능

      Options:
        -h, --help       도움말 메시지 표시
      
      android options:
            --sdk=PARAM  Android SDK 경로
        -v, --verbose    문제 해결을 위한 자세한 출력 활성화
        -V, --version    버전 정보 출력 후 종료
      
      Positional Parameters:
        <field>  값을 출력할 특정 필드. 생략 시 전체 출력

init Usage: android init [-h] Android CLI 환경 초기화. 필요한 구성, 디렉터리, 기본 스킬 설정

      Options:
        -h, --help       도움말 메시지 표시
      
      android options:
            --sdk=PARAM  Android SDK 경로
        -v, --verbose    문제 해결을 위한 자세한 출력 활성화
        -V, --version    버전 정보 출력 후 종료

install Usage: android install [-h] [--apks=PARAM] [--device=PARAM] [--install-options=PARAM] [--use-delta-install] 연결된 기기나 에뮬레이터에 Android 애플리케이션(하나 이상의 APK)을 구성 요소 활성화 없이 증분 최적화를 사용하여 adb보다 빠르게 배포

      Options:
            --apks=PARAM             APK 경로, 쉼표로 구분
            --device=PARAM           기기 일련 번호
        -h, --help                   도움말 메시지 표시
            --install-options=PARAM  패키지 관리자 설치에 전달할 추가 옵션/플래그 (예: -g, -d)
            --use-delta-install      빠른 델타 설치 사용 (수정된 코드와 리소스만 전송하여 증분 업데이트 속도 향상; 기본값: true)
      
      android options:
            --sdk=PARAM              Android SDK 경로
        -v, --verbose                문제 해결을 위한 자세한 출력 활성화
        -V, --version                버전 정보 출력 후 종료