MonkeyRunner
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
정적 유틸리티 메서드를 포함하는 monkeyrunner 클래스입니다.
요약
메서드 |
void
|
알림
(string message,
string 제목,
string okTitle)
현재 프로그램을 실행하는 프로세스에 알림 대화상자를 표시합니다.
|
정수
|
choice
(string 메시지,
반복 가능한 옵션,
string 제목)
선택 목록이 있는 대화상자를 현재 프로그램을 실행하는 프로세스에 표시합니다.
|
void
|
도움말
(문자열 형식)
Python의 pydoc 도구와 유사한 스타일로 monkeyrunner API 참조를 지정된 형식을 사용하여 표시합니다.
|
문자열
|
입력
(string message,
string initialValue,
string 제목,
string okTitle,
string cancelTitle)
입력을 수락하는 대화상자를 표시합니다.
|
void
|
절전 모드
(부동 소수점 수 초)
지정된 시간(초) 동안 현재 프로그램을 일시중지합니다.
|
MonkeyDevice
|
waitForConnection
(float 시간 제한,
string deviceId)
monkeyrunner 백엔드와 지정된 기기 또는 에뮬레이터를 연결하려고 합니다.
|
공개 메서드
string
알림
(
string message,
string 제목,
string okTitle)
현재 프로그램을 실행하는 프로세스에 알림 대화상자를 표시합니다. 대화상자는 모달이므로 사용자가 대화상자의 버튼을 클릭할 때까지 프로그램이 일시중지됩니다.
인수
message |
대화상자에 표시할 메시지입니다.
|
title |
대화상자의 제목입니다. 기본값은 '알림'입니다.
|
okTitle |
대화상자 버튼에 표시되는 텍스트입니다. 기본값은 '확인'입니다.
|
정수
choice
(문자열 메시지,
반복 가능 선택 항목,
문자열 제목)
선택 목록이 있는 대화상자를 현재 프로그램을 실행하는 프로세스에 표시합니다. 대화상자는 모달이므로 사용자가 대화상자의 버튼 중 하나를 클릭할 때까지 프로그램이 일시중지됩니다.
인수
message |
대화상자에 표시되는 프롬프트 메시지입니다.
|
choices |
문자열로 표시되는 하나 이상의 객체를 포함하는 Python iterable입니다. 추천 형식은 문자열 배열입니다.
|
제목
|
대화상자의 제목입니다. 기본값은 '입력'입니다.
|
반환 값
-
사용자가 선택하고 '확인' 버튼을 클릭하면 메서드가 iterable 내에서 0 기반 선택 색인을 반환합니다.
사용자가 '취소' 버튼을 클릭하면 메서드는 -1을 반환합니다.
Python의 pydoc
도구와 유사한 스타일로 monkeyrunner API 참조를 지정된 형식을 사용하여 표시합니다.
인수
형식 |
출력에 사용할 마크업 형식입니다. 가능한 값은 일반 텍스트의 경우 '텍스트'이거나 HTML의 경우 'html'입니다.
|
입력을 수락하고 프로그램에 반환하는 대화상자를 표시합니다. 대화상자는 모달이므로 사용자가 대화상자의 버튼 중 하나를 클릭할 때까지 프로그램이 일시중지됩니다.
대화상자에는 버튼이 두 개 있으며 하나는 okTitle 값을, 다른 하나는 cancelTitle 값을 표시합니다. 사용자가 okTitle 버튼을 클릭하면 입력 상자의 현재 값이 반환됩니다. 사용자가 cancelTitle 버튼을 클릭하면 빈 문자열이 반환됩니다.
인수
message |
대화상자에 표시되는 프롬프트 메시지입니다.
|
initialValue |
대화상자에 표시할 초기값입니다. 기본값은 빈 문자열입니다.
|
title |
대화상자의 제목입니다. 기본값은 '입력'입니다.
|
okTitle |
okTitle 버튼에 표시되는 텍스트입니다. 기본값은 '확인'입니다.
|
cancelTitle |
cancelTitle 버튼에 표시되는 텍스트입니다. 기본값은 '취소'입니다.
|
반환 값
-
사용자가 okTitle 버튼을 클릭하면 메서드가 대화상자 입력 상자의 현재 값을 반환합니다. 사용자가 cancelTitle 버튼을 클릭하면 메서드가 빈 문자열을 반환합니다.
void
절전 모드
(
float 초)
지정된 시간(초) 동안 현재 프로그램을 일시중지합니다.
MonkeyDevice
waitForConnection
(float 시간 제한,
string deviceId)
monkeyrunner
백엔드와 지정된 기기 또는 에뮬레이터를 연결하려고 합니다.
인수
시간 제한 |
연결을 기다리는 시간(초)입니다. 기본값은 영원히 기다리는 것입니다.
|
deviceId
|
기기 또는 에뮬레이터의 일련번호를 지정하는 정규 표현식입니다. 기기 및 에뮬레이터 일련번호에 관한 설명은 Android 디버그 브리지 항목을 참조하세요.
|
반환 값
-
기기 또는 에뮬레이터의
MonkeyDevice
인스턴스입니다. 이 객체를 사용하여 기기나 에뮬레이터를 제어하고 통신합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[null,null,["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# MonkeyRunner\n\nA monkeyrunner class that contains static utility methods.\n\nSummary\n-------\n\n| Methods ||||||||||||\n|------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|---|---|---|---|---|---|---|---|---|\n| void | [alert](#alert) (*string* message, *string* title, *string* okTitle) Displays an alert dialog to the process running the current program. |\n| *integer* | [choice](#choice) (*string* message, *iterable* choices, *string* title) Displays a dialog with a list of choices to the process running the current program. |\n| void | [help](#help) (*string* format) Displays the monkeyrunner API reference in a style similar to that of Python's `pydoc` tool, using the specified format. |\n| *string* | [input](#input) (*string* message, *string* initialValue, *string* title, *string* okTitle, *string* cancelTitle) Displays a dialog that accepts input. |\n| void | [sleep](#sleep) (*float* seconds) Pauses the current program for the specified number of seconds. |\n| ` `[MonkeyDevice](/tools/help/MonkeyDevice)` ` | [waitForConnection](#waitForConnection) (*float* timeout, *string* deviceId) Tries to make a connection between the `monkeyrunner` backend and the specified device or emulator. |\n\nPublic methods\n--------------\n\n#### *string*\nalert\n( *string* message, *string* title, *string* okTitle)\n\n\nDisplays an alert dialog to the process running the current\nprogram. The dialog is modal, so the program pauses until the user clicks the dialog's\nbutton. \n\n##### Arguments\n\n| message | The message to display in the dialog. |\n| title | The dialog's title. The default value is \"Alert\". |\n| okTitle | The text displayed in the dialog button. The default value is \"OK\". |\n|---------|---------------------------------------------------------------------|\n\n#### *integer*\nchoice\n(*string* message, *iterable* choices, *string* title)\n\n\nDisplays a dialog with a list of choices to the process running the current program. The\ndialog is modal, so the program pauses until the user clicks one of the dialog's\nbuttons. \n\n##### Arguments\n\n| message | The prompt message displayed in the dialog. |\n| choices | A Python iterable containing one or more objects that are displayed as strings. The recommended form is an array of strings. |\n| title | The dialog's title. The default is \"Input\". |\n|---------|------------------------------------------------------------------------------------------------------------------------------|\n\n##### Returns\n\n- If the user makes a selection and clicks the \"OK\" button, the method returns the 0-based index of the selection within the iterable. If the user clicks the \"Cancel\" button, the method returns -1. \n\n#### void\nhelp\n(*string* format)\n\n\nDisplays the monkeyrunner API reference in a style similar to that of Python's\n`pydoc` tool, using the specified format. \n\n##### Arguments\n\n| format | The markup format to use in the output. The possible values are \"text\" for plain text or \"html\" for HTML. |\n|--------|-----------------------------------------------------------------------------------------------------------|\n\n#### *string*\ninput\n(*string* message *string* initialValue, *string* title, *string* okTitle, *string* cancelTitle)\n\n\nDisplays a dialog that accepts input and returns it to the program. The dialog is\nmodal, so the program pauses until the user clicks one of the dialog's buttons.\n\n\nThe dialog contains two buttons, one of which displays the okTitle value\nand the other the cancelTitle value. If the user clicks the okTitle button,\nthe current value of the input box is returned. If the user clicks the cancelTitle\nbutton, an empty string is returned. \n\n##### Arguments\n\n| message | The prompt message displayed in the dialog. |\n| initialValue | The initial value to display in the dialog. The default is an empty string. |\n| title | The dialog's title. The default is \"Input\". |\n| okTitle | The text displayed in the okTitle button. The default is \"OK\". |\n| cancelTitle | The text displayed in the cancelTitle button. The default is \"Cancel\". |\n|--------------|-----------------------------------------------------------------------------|\n\n##### Returns\n\n- If the user clicks the okTitle button, then the method returns the current value of the dialog's input box. If the user clicks the cancelTitle button, the method returns an empty string. \n\n#### void\nsleep\n( *float* seconds )\n\n\nPauses the current program for the specified number of seconds. \n\n##### Arguments\n\n| seconds | The number of seconds to pause. |\n|---------|---------------------------------|\n\n#### `\n`[MonkeyDevice](/tools/help/MonkeyDevice)`\n`\nwaitForConnection\n(*float* timeout, *string* deviceId)\n\n\nTries to make a connection between the `monkeyrunner` backend and the\nspecified device or emulator. \n\n##### Arguments\n\n| timeout | The number of seconds to wait for a connection. The default is to wait forever. |\n| deviceId | A regular expression that specifies the serial number of the device or emulator. See the topic [Android Debug Bridge](/tools/help/adb) for a description of device and emulator serial numbers. |\n|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n\n##### Returns\n\n- A [MonkeyDevice](/tools/help/MonkeyDevice) instance for the device or emulator. Use this object to control and communicate with the device or emulator."]]