Android 화면 해결

UI 요소를 시각적으로 타겟팅합니다. 주석이 달린 스크린샷의 경계 상자 좌표를 문자열로 대체하여 #N의 모든 인스턴스를 N로 라벨이 지정된 경계 상자의 중심 좌표로 대체합니다.

사용

android screen resolve [-h] [--screenshot=PARAM] [--string=PARAM]

옵션

  • -h,--help - 지정된 명령어의 도움말 메시지를 표시합니다.
  • --screenshot=PARAM - android screen capture --annotate로 캡처한 스크린샷
  • --string=PARAM - 좌표를 대체할 문자열입니다.

android 옵션:

  • --sdk=PARAM - Android SDK의 경로
  • -v,--verbose - 문제 해결을 위해 상세 출력을 사용 설정합니다.
  • -V,--version - 버전 정보를 인쇄하고 종료합니다.

설명

android screen resolve는 주석이 달린 스크린샷 (android screen capture --annotate로 캡처됨)의 시각적 라벨 자리표시자 (#N)를 해당 화면 중앙 좌표 (x y)로 변환합니다.

이를 통해 AI 에이전트와 자동화 스크립트는 픽셀 좌표를 수동으로 계산하는 대신 주석이 추가된 이미지의 번호가 매겨진 라벨을 참조하여 adb shell input 명령 (예: 탭 및 스와이프)을 생성할 수 있습니다.

예

ui.png의 라벨 5이 좌표 (500, 1000)에 중앙에 있는 경우 다음을 실행합니다.

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

input tap 500 1000를 출력합니다.