MonkeyRunner
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Một lớp monkeyrunner có chứa các phương thức tiện ích tĩnh.
Tóm tắt
| Phương thức |
|
khoảng trống
|
thông báo
(chuỗi thông báo,
chuỗi tiêu đề
chuỗi okTitle)
Cho thấy hộp thoại cảnh báo quy trình đang chạy chương trình
hiện tại.
|
|
số nguyên
|
choice
(string message,
iterable choices,
string title)
Cho thấy hộp thoại có danh sách lựa chọn đối với quy trình chạy chương trình hiện tại.
|
|
khoảng trống
|
trợ giúp
(chuỗi định dạng)
Hiển thị tài liệu tham khảo API monkeyrunner theo kiểu tương tự như công cụ pydoc của Python, sử dụng định dạng được chỉ định.
|
|
chuỗi
|
dữ liệu đầu vào
(chuỗi thông báo,
chuỗi initialValue,
chuỗi tiêu đề,
chuỗi okTitle,
chuỗi cancelTitle)
Cho thấy hộp thoại chấp nhận dữ liệu đầu vào.
|
|
khoảng trống
|
ngủ
(nổi số giây)
Tạm dừng chương trình hiện tại trong số giây đã chỉ định.
|
MonkeyDevice
|
waitForConnection
(float timeout,
string deviceId)
Cố gắng kết nối giữa phần phụ trợ monkeyrunner và trình mô phỏng hoặc thiết bị đã chỉ định.
|
Phương thức công khai
string
alert
(
string message,
string title,
string okTitle)
Hiển thị hộp thoại cảnh báo quy trình đang chạy chương trình hiện tại. Hộp thoại đã được đặt vào chế độ, vì vậy chương trình sẽ tạm dừng cho đến khi người dùng nhấp vào
nút của hộp thoại.
Đối số
| thông báo |
Nội dung hiển thị trong hộp thoại.
|
| tiêu đề |
Tiêu đề của hộp thoại. Giá trị mặc định là "Cảnh báo".
|
| okTitle |
Văn bản xuất hiện trong nút hộp thoại. Giá trị mặc định là "OK".
|
integer
choice
(string message,
iterable choices,
string title)
Cho thấy hộp thoại có danh sách lựa chọn đối với quy trình chạy chương trình hiện tại. Hộp thoại đã được đặt vào chế độ, vì vậy chương trình sẽ tạm dừng cho đến khi người dùng nhấp vào một trong các
nút của hộp thoại.
Đối số
| thông báo |
Thông báo nhắc xuất hiện trong hộp thoại.
|
| lựa chọn |
Một đối tượng có thể lặp lại (iterable) trong Python chứa một hoặc nhiều đối tượng được hiển thị dưới dạng chuỗi. Biểu mẫu
nên dùng là một mảng chuỗi.
|
|
tiêu đề
|
Tiêu đề của hộp thoại. Lựa chọn mặc định là "Đầu vào".
|
Giá trị trả về
-
Nếu người dùng đưa ra lựa chọn và nhấp vào nút "OK", phương thức này sẽ trả về chỉ mục dựa trên 0 của lựa chọn đó trong đối tượng có thể lặp lại.
Nếu người dùng nhấp vào nút "Huỷ", phương thức sẽ trả về -1.
Hiển thị tài liệu tham khảo API monkeyrunner theo kiểu tương tự như công cụ pydoc của Python, sử dụng định dạng được chỉ định.
Đối số
| định dạng |
Định dạng đánh dấu để sử dụng trong đầu ra. Các giá trị có thể sử dụng là "text" cho văn bản thuần túy hoặc "html" cho HTML.
|
Cho thấy hộp thoại chấp nhận dữ liệu đầu vào và trả lại dữ liệu đó cho chương trình. Hộp thoại
đã được đặt vào chế độ, vì vậy chương trình sẽ tạm dừng cho đến khi người dùng nhấp vào một trong các nút của hộp thoại.
Hộp thoại này có hai nút, một trong số đó hiển thị giá trị okTitle và nút còn lại có giá trị cancelTitle. Nếu người dùng nhấp vào nút okTitle,
thì giá trị hiện tại của hộp dữ liệu đầu vào sẽ được trả về. Nếu người dùng nhấp vào nút cancelTitle, thì một chuỗi trống sẽ được trả về.
Đối số
| thông báo |
Thông báo nhắc xuất hiện trong hộp thoại.
|
| initialValue |
Giá trị ban đầu để xuất hiện trong hộp thoại. Giá trị mặc định là một chuỗi trống.
|
| tiêu đề |
Tiêu đề của hộp thoại. Lựa chọn mặc định là "Đầu vào".
|
| okTitle |
Văn bản xuất hiện trong nút okTitle. Lựa chọn mặc định là "OK".
|
| cancelTitle |
Văn bản xuất hiện trong nút cancelTitle. Lựa chọn mặc định là "Huỷ".
|
Trả về
-
Nếu người dùng nhấp vào nút okTitle, thì phương thức này sẽ trả về giá trị hiện tại của
hộp nhập. Nếu người dùng nhấp vào nút cancelTitle, phương thức sẽ trả về
một chuỗi trống.
void
sleep
(
float seconds
)
Tạm dừng chương trình hiện tại trong số giây đã chỉ định.
Đối số
| giây |
Số giây cần tạm dừng.
|
MonkeyDevice
waitForConnection
(float timeout,
string deviceId)
Cố gắng kết nối giữa phần phụ trợ monkeyrunner và trình mô phỏng hoặc thiết bị đã chỉ định.
Đối số
| thời gian chờ |
Số giây chờ kết nối. Lựa chọn mặc định là phải đợi vĩnh viễn.
|
|
mã thiết bị
|
Biểu thức chính quy chỉ định số sê-ri của thiết bị hoặc trình mô phỏng. Xem chủ đề Cầu gỡ lỗi Android để biết mô tả về số sê-ri của thiết bị và trình mô phỏng.
|
Giá trị trả về
-
Một phiên bản
MonkeyDevice cho thiết bị hoặc trình mô phỏng. Sử dụng đối tượng này để điều khiển và giao tiếp với
thiết bị hoặc trình mô phỏng.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 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."]]
