Android Commands

Android 디바이스 터치·스크롤·텍스트 입력.

Android 명령어는 Android 디바이스를 자동으로 제어하기 위한 명령어 모음입니다. 터치, 입력, 스와이프, 드래그, 스크롤, 텍스트 조회, 스크린샷 등의 작업을 수행할 수 있습니다.

Android 명령어는 디바이스를 ADB로 연결한 상태에서 동작합니다. 연결 절차와 디바이스 별칭(Device alias) 등록 방법은 ADB 연결 페이지에서 자세히 안내합니다.

시작 전 준비

명령어를 사용하기 전에 다음 두 가지가 준비되어 있어야 합니다.

  1. PC와 Android 디바이스가 ADB로 연결되어 adb devices 에서 device 상태로 표시
  2. Aurora 프로젝트에 디바이스 별칭(Device alias)이 등록되어 있어 명령어 첫 번째 인자로 지정 가능

자세한 절차·트러블슈팅은 ADB 연결 가이드를 먼저 확인하세요.

입력 방식

Android 화면 요소는 다음 세 가지 방법으로 식별합니다.

식별 방법사용 예명령어 예시
좌표정확한 픽셀 위치를 알 때Touch in Android
텍스트화면에 보이는 라벨로 식별Touch by text in Android · Touch by text contains in Android
Resource ID앱이 노출한 view ID로 식별 (가장 안정적)Touch by resource-id in Android

주요 동작 분류

분류명령어
터치·클릭Touch in Android · Touch by text in Android · Touch by resource-id in Android
스와이프·드래그Swipe in Android · Drag in Android
스크롤·스크롤 후 터치Scroll in Android · Touch after scroll in Android
텍스트 입력·삭제Input text in Android · Clear text in Android
텍스트·뷰 조회Get focused text in Android · Get resource text in Android · Find text in Android
키 입력Hard key in Android
캡처Capture screenshot in Android
반복Touch text until in Android

좌표 기반 터치는 디바이스 해상도가 바뀌면 동작이 깨집니다. 가능하면 resource-id 기반 명령을 우선 사용하고, 그것이 어려울 때 텍스트, 마지막으로 좌표를 사용하세요.

명령어 (17)