개요
개요
Android라이브러리는 사용자가 ADB Tool 을 이용하여 Android 기반의 Mobile과 통신 및 제어 작업을 할 수 있습니다.
Android라이브러리에서 사용할 수 있는 기능은 다음과 같습니다.
Touch 기능: AndroidInpuTouch, AndroidInputLongPress, AndroidInputSwipe
Screen Capture 기능: AndroidScreenCapture
Conection 기능: AndroidConnect
객체 제어 기능: AndroidClick, AndroidInputText, AndroidInputKeyEvent
객체 정보 기능: AndroidGetBounds, AndroidGetText, AndroidFind
기본 기능: AndroidShell, AndroidPull, AndroidPush
ADB Tool 설치하기
Android Debug Bridge(통칭 ADB)는 안드로이드 기반 기기의 디버깅에 사용되는 프로그래밍 도구입니다. 상세한 내용은 wiki 를 참고해 주세요.
ADB Tool 압축 해제 후 해당 경로를 Windows의 시스템 환경 변수(Path )에 추가해 주세요.
시스템 환경 변수 설정은 다음을 참고 하세요
시스템 변수 > 새로 만들기에서 다음과 같이 입력합니다.
2. 시스템 변수 > 기존 설정된 “Path” 항목에 위 변수이름을 추가하기 위해 편집 아이콘을 클릭하여 다음과 같이 입력합니다.
3. cmd창에서 “adb –version” 입력하여 Version 정보가 Display되는지 확인합니다.
공통 속성
공통 속성
MORE OPTION
속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|
Device | 문자 | N | - | N | 대상 디바이스명을 입력합니다. |
Timeout | 숫자 | N | sec | N | 객체를 찾는 시간을 설정합니다.(Sec) |
On Error | 콤보박스 | N | - | N | 오류 발생 시 수행할 동작을 지정합니다. - 미지정: 오류를 출력하고 작업을 종료합니다. - Ignore: 해당 오류를 무시합니다. - Retry: 해당 액티비티를 1회 재시도합니다. - Goto: 해당 엑티비티가 실패한 경우 지정한 엑티비티로 이동하여 시나리오를 수행합니다. - Event: 프로젝트에 등록된 이벤트를 호출합니다. |
DESCRIPTION
속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|
Description | 문자 | N | - | N | 해당 액티비티 카드에 대한 설명을 추가합니다. Description이 입력되면 플로차트의 해당 액티비티 설명에 표시되고, Description이 없는 경우에는 대푯값이 해당 액티비티 설명에 표시됩니다. |
AndroidConnect
AndroidConnect
개요
Android 기기에 연결합니다. 안드로이드 단말에 접속하려면 아래와 같이 두가지 방법이 있습니다. 1. USB 접속을 위한 디버깅 모드 활성화하는 것입니다. 이 방법은 자체로 유선 연결이 되기 때문에 별도의 AndroidConnect 카드가 불필요합니다. 2. 무선 연결이 있습니다. 이 방법은 RTL(원격 테스트환경)을 사용하거나 안드로이드 기기를 원격 접속으로 제어하기 위한 방법인데, 이때 AndroidConnect로 접속하시면 됩니다.
사용 절차
Host에 Android에 접속할 IP Address를 입력합니다.
Port에 포트 번호를 입력합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Host | 문자 | Y | - | N | 접속할 안드로이드 기기의 IP Address를 입력합니다. |
N | Port | 숫자 | Y | - | Y | 포트 번호를 입력합니다. |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. |
활용 예시
Android Device에 연결을 시도하고 결과를 메시지 박스에 표시합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Android
사용된 속성
Host = '127.0.0.1'
Port = 9000
연관/유사 액티비티
AndroidShell
AndroidShell
개요
Android 기기에 ADB Shell 명령을 실행합니다.
사용 절차
[Output] RESULT에 실행한 결과를 저장할 변수를 입력합니다.
Arguments에 실행 명령어에 필요한 인자를 입력합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Output | 변수 | N | - | Y | 실행한 결과를 저장할 변수를 지정합니다. |
N | Arguments | 문자 | Y | - | Y | 실행 명령어에 필요한 인자를 입력합니다. |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. |
활용 예시
OpenAI Text Completion API를 호출합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Android
사용된 변수
RESULT = 실행 결과를 저장할 변수
사용된 속성
[Output] Output = RESULT
Arguments = 'ls'
연관/유사 액티비티
AndroidPush
AndroidPush
개요
Android 기기에 파일을 보냅니다.
사용 절차
SrcPath에 Android에 업로드할 파일의 로컬 경로를 입력합니다.
DestPath에 Android에 저장하기 위한 업로드 경로를 입력합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | SrcPath | 문자 | Y | - | N | 안드로이드 기기에 업로드할 대상 파일의 로컬 경로를 입력합니다. |
N | DestPath | 문자 | Y | - | Y | 안드로이드 기기의 업로드 경로를 입력합니다. |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. |
활용 예시
로컬에 생성한 파일을 Android 기기에 보냅니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Android
사용된 변수
RESULT = 응답결과 전체를 저장할 변수 TextRESULT = 응답결과 중 choices내 첫번째 text 결과를 저장할 변수 Global.apiToken = API Token
사용된 속성
SrcPath = 'D:\\AndroidTest.txt'
DestPath = '/sdcard'
연관/유사 액티비티
AndroidPull
AndroidPull
개요
Android 기기에서 파일을 가져옵니다.
사용 절차
SrcPath에 Android에서 가져올 파일의 경로를 입력합니다.
DestPath에 Android에서 가져온 파일을 저장할 로컬 경로를 입력합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | SrcPath | 문자 | Y | - | N | 안드로이드 기기로부터 다운로드할 대상 파일의 경로를 입력합니다. |
N | DestPath | 문자 | Y | - | Y | 대상 파일을 저장할 로컬 경로를 입력합니다. |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. |
활용 예시
Android 기기에서 파일을 가져옵니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Android
사용된 속성
SrcPath = '/sdcard/AndroidTest.txt'
DestPath = 'D:\\Temp\\AndroidTest2.txt'
연관/유사 액티비티
AndroidFind
AndroidFind
개요
지정한 속성과 일치하는 Android 객체 정보를 찾아 메시지 박스로 표시합니다.
사용 절차
[Output] Output에 객체 정보를 저장할 변수를 지정합니다.
Index에 대상 객체가 2개 이상일 경우 식별하기 위한 번호를 입력합니다.
Text에 Android 대상 객체의 Text 속성을 입력합니다.
Refresh에 Android 객체 정보를 다시 로드할 지 여부를 선택합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Output | 변수 | Y | - | N | 실행한 결과를 저장할 변수를 지정합니다. |
N | Index | 숫자 | Y | - | Y | 검색 대상 객체가 2개 이상인 경우 객체를 식별하기 위한 번호를 입력합니다. |
N | Text | 문자 | Y | - | N | 검색 대상 객체의 Text 속성을 입력합니다. |
N | Class | 문자 | Y | - | Y | 검색 대상 객체의 Class 속성을 입력합니다. |
N | ResourceID | 문자 | Y | - | N | 검색 대상 객체의 Resource-id 속성을 입력합니다. |
N | ContentDesc | 문자 | Y | - | Y | 검색 대상 객체의 Content-Desc 속성을 입력합니다. |
N | XPath | 문자 | Y | - | Y | 대상 객체의 XPath 경로를 입력합니다. |
N | Refresh | 토글버튼 | N | - | N | Android 객체 정보를 다시 로드할 지 여부를 선택합니다. |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. |
활용 예시
Android 기기에서 전화 객체의 정보를 가져와 메시지 박스로 표시합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Android
사용된 변수
RESULT = 안드로이드 객체 정보를 저장할 변수
사용된 속성
[Output] Output = RESULT
Index = 1
Text = '전화'
Refresh = On
연관/유사 액티비티
AndroidGetBoundsAndroidGetTextAndroidClick
AndroidGetBounds
AndroidGetBounds
개요
지정한 속성과 일치하는 Android 객체의 영역 정보를 가져옵니다.
사용 절차
[Output] Output에 객체의 영역 정보를 저장할 변수를 지정합니다.
Index에 대상 객체가 2개 이상일 경우 식별하기 위한 번호를 입력합니다.
Text에 Android 대상 객체의 Text 속성을 입력합니다.
Refresh에 Android 객체 정보를 다시 로드할 지 여부를 선택합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Output | 변수 | Y | - | N | 실행한 결과를 저장할 변수를 지정합니다. |
N | Index | 숫자 | Y | - | Y | 검색 대상 객체가 2개 이상인 경우 객체를 식별하기 위한 번호를 입력합니다. |
N | Text | 문자 | Y | - | N | 검색 대상 객체의 Text 속성을 입력합니다. |
N | Class | 문자 | Y | - | Y | 검색 대상 객체의 Class 속성을 입력합니다. |
N | ResourceID | 문자 | Y | - | N | 검색 대상 객체의 Resource-id 속성을 입력합니다. |
N | ContentDesc | 문자 | Y | - | Y | 검색 대상 객체의 Content-Desc 속성을 입력합니다. |
N | XPath | 문자 | Y | - | Y | 대상 객체의 XPath 경로를 입력합니다. |
N | Refresh | 토글버튼 | N | - | N | Android 객체 정보를 다시 로드할 지 여부를 선택합니다. |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. |
활용 예시
Android 기기에서 전화 객체의 영역 정보를 가져와 메시지 박스로 표시합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Android
사용된 변수
RESULT = 안드로이드 객체 영역 정보를 저장할 변수
사용된 속성
[Output] Output = RESULT
Index = 1
Text = '전화'
Refresh = On
연관/유사 액티비티
AndroidFindAndroidGetTextAndroidClick
AndroidGetText
AndroidGetText
개요
지정한 속성과 일치하는 Android 객체의 텍스트 정보를 가져옵니다.
사용 절차
[Output] Output에 객체의 Text 정보를 저장할 변수를 지정합니다.
Index에 대상 객체가 2개 이상일 경우 식별하기 위한 번호를 입력합니다.
XPath에 Android 대상 객체의 XPath를 입력합니다.
Refresh에 Android 객체 정보를 다시 로드할 지 여부를 선택합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Output | 변수 | Y | - | N | 실행한 결과를 저장할 변수를 지정합니다. |
N | Index | 숫자 | Y | - | Y | 검색 대상 객체가 2개 이상인 경우 객체를 식별하기 위한 번호를 입력합니다. |
N | Text | 문자 | Y | - | N | 검색 대상 객체의 Text 속성을 입력합니다. |
N | Class | 문자 | Y | - | Y | 검색 대상 객체의 Class 속성을 입력합니다. |
N | ResourceID | 문자 | Y | - | N | 검색 대상 객체의 Resource-id 속성을 입력합니다. |
N | ContentDesc | 문자 | Y | - | Y | 검색 대상 객체의 Content-Desc 속성을 입력합니다. |
N | XPath | 문자 | Y | - | Y | 대상 객체의 XPath 경로를 입력합니다. |
N | Refresh | 토글버튼 | N | - | N | Android 객체 정보를 다시 로드할 지 여부를 선택합니다. |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. |
활용 예시
Android 기기에서 전화 객체의 텍스트 정보를 가져와 메시지 박스로 표시합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Android
사용된 변수
RESULT = 안드로이드 객체 Text 정보를 저장할 변수
사용된 속성
[Output] Output = RESULT
Index = 1
XPath = '//node[@resource-id="com.sec.android.app.launcher:id/apps_icon"]'
Refresh = On
연관/유사 액티비티
AndroidFindAndroidGetBoundsAndroidClick
AndroidInputTouch
AndroidInputTouch
개요
Android 기기에 지정한 좌표를 터치합니다.
사용 절차
DestPoint에 터치할 포인트를 입력합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | DestPoint | 문자 | Y | - | N | 터치 이벤트의 목적지 포인트를 입력합니다. |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. |
활용 예시
Android 기기에서 연락처 객체의 영역 정보를 가져와 연락처 아이콘을 터치한다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Android
사용된 변수
RESULT = 안드로이드 객체 영역의 중앙값을 저장할 변수
사용된 속성
[Output] Output = RESULT
연관/유사 액티비티
AndroidInputLongPressAndroidInputSwipe
AndroidInputLongPress
AndroidInputLongPress
개요
Android 기기에 지정한 좌표를 길게 누르기를 합니다.
사용 절차
SrcPoint에 터치 이벤트의 시작 포인트를 입력합니다.
Duration에 터치 포인트의 지속 시간을 입력합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | SrcPoint | 문자 | Y | - | N | 터치 이벤트의 시작 포인트를 입력합니다. |
N | Duration | 숫자 | Y | msec | Y | 터치 이벤트의 지속 시간을 입력합니다. |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. |
활용 예시
Android 기기에서 메시지 객체의 위치 정보를 가져와 객체의 중앙을 길게 누르기를 합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Android
사용된 변수
this.var1 = 안드로이드 객체 영역의 중앙값을 저장할 변수
사용된 속성
SrcPoint = this.var1
Duration = 1000
연관/유사 액티비티
AndroidInputTouchAndroidInputSwipe
AndroidInputSwipe
AndroidInputSwipe
개요
Android 기기에 지정한 좌표의 화면 밀기를 합니다.
사용 절차
SrcPoint에 화면 밀기 시작 포인트를 입력합니다.
DestPoint에 화면 밀기 마지막 포인트를 입력합니다.
Duration에 화면 밀기 시작 포인트에서 마지막 포인트로 이동할 시간을 입력합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | SrcPoint | 문자 | Y | - | N | 터치 이벤트의 시작 포인트를 입력합니다. |
N | DestPoint | 문자 | Y | - | N | 터치 이벤트의 마지막 포인트를 입력합니다. |
N | Duration | 숫자 | Y | msec | Y | 터치 이벤트의 지속 시간을 입력합니다. |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. |
활용 예시
Android 기기의 특정 좌표를 화면 밀기를 합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Android
사용된 속성
SrcPoint = '500, 500'
DestPoint = '100, 100'
Duration = 250
연관/유사 액티비티
AndroidInputTouchAndroidInputLongPress
AndroidClick
AndroidClick
개요
지정한 속성과 일치하는 Android 객체를 클릭합니다.
사용 절차
Index에 동일 객체를 식별하기 위한 번호를 입력합니다.
XPath에 대상 객체에 대한 XPath 경로를 입력합니다.
Refresh에 안드로이드 객체 정보를 다시 로드할지 여부를 선택합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Index | 숫자 | Y | - | Y | 검색 대상 객체가 2개 이상인 경우 객체를 식별하기 위한 번호를 입력합니다. |
N | Text | 문자 | Y | - | N | 검색 대상 객체의 Text 속성을 입력합니다. |
N | Class | 문자 | Y | - | Y | 검색 대상 객체의 Class 속성을 입력합니다. |
N | ResourceID | 문자 | Y | - | N | 검색 대상 객체의 Resource-id 속성을 입력합니다. |
N | ContentDesc | 문자 | Y | - | Y | 검색 대상 객체의 Content-Desc 속성을 입력합니다. |
N | Xpath | 문자 | Y | - | Y | 대상 객체의 XPath 경로를 입력합니다. |
N | Refresh | 토글버튼 | N | - | N | Android 객체 정보를 다시 로드할 지 여부를 선택합니다. |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. |
활용 예시
Android 기기에서 xpath로 지정된 카메라 객체를 찾아 클릭합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Android
사용된 속성
Index = 1
XPath = '//node[@text="카메라"]'
Refresh = On
연관/유사 액티비티
AndroidFindAndroidGetBoundsAndroidGetText
AndroidInputKeyEvent
AndroidInputKeyEvent
개요
Android 기기에 키 이벤트를 발생합니다.
사용 절차
KeyEvent에서 키 이벤트를 선택합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | KeyInput | 콤보박스 | Y | - | N | 키 이벤트를 선택합니다. |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. |
활용 예시
Android 기기에 Call 키 이벤트를 발생합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Android
사용된 속성
KeyInput = KEYCODE_CALL
연관/유사 액티비티
AndroidInputText
AndroidInputText
개요
Android 기기에 지정한 문자열(영문만 지원)을 입력합니다.
다른 언어를 사용하기 위해서는 Android기기에 필요한 키보드 앱(ADBKeyboard 등)을 설치 후 AndroidShell 라이브러리를 사용하여 전송할 수 있습니다.
사용 절차
Input Text에 안드로이드에 전송할 문자열을 입력합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Input Text | 문자 | Y | - | N | 텍스트를 입력합니다. |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. |
활용 예시
Android 기기에서 메시지 앱을 열고 검색창에 this.var1에 저장된 문자열을 입력합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Android
사용된 변수
this.var1 = 안드로이드 객체에 입력할 문자열을 저장한 변수
사용된 속성
Input Text = this.var1
연관/유사 액티비티
AndroidScreenCapture
AndroidScreenCapture
개요
Android 기기의 화면을 캡쳐하여 파일로 가져옵니다.
사용 절차
DestPath에 안드로이드 화면을 캡쳐한 파일을 저장할 로컬 경로를 입력합니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | DestPath | 문자 | Y | - | N | 대상 파일을 저장할 로컬 경로를 입력합니다. |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | Android 라이브러리의 공통 속성입니다. |
활용 예시
Android 기기의 현재 화면을 캡쳐하여 로컬파일(D:\\temp\\test.png)로 저장합니다.
AddDateTime1
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Android
사용된 속성
DestPath = 'D:\\temp\\test.png'