میمون رانر
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک کلاس monkeyrunner که شامل متدهای سودمند ثابت است.
خلاصه
| روش ها |
|---|
| باطل | هشدار (پیام رشته ، عنوان رشته ، رشته okTitle) یک گفتگوی هشدار را برای فرآیند اجرای برنامه فعلی نمایش می دهد. |
| عدد صحیح | انتخاب (پیام رشته ، انتخاب های تکرارپذیر ، عنوان رشته ) دیالوگی را با لیستی از انتخاب های فرآیند اجرای برنامه جاری نمایش می دهد. |
| باطل | کمک (قالب رشته ) مرجع monkeyrunner API را به سبکی شبیه به ابزار pydoc پایتون با استفاده از فرمت مشخص شده نمایش می دهد. |
| رشته | ورودی (پیام رشته ، مقدار اولیه رشته ، عنوان رشته ، رشته okTitle، رشته لغو عنوان) گفتگویی را نشان می دهد که ورودی را می پذیرد. |
| باطل | خواب (ثانیه شناور ) برنامه فعلی را برای تعداد ثانیه مشخص شده متوقف می کند. |
MonkeyDevice | WaitForConnection (درنگ شناور ، شناسه دستگاه رشته ) سعی می کند بین باطن monkeyrunner و دستگاه یا شبیه ساز مشخص شده ارتباط برقرار کند. |
روش های عمومی
هشدار رشته (پیام رشته ، عنوان رشته ، رشته okTitle)
یک گفتگوی هشدار را برای فرآیند اجرای برنامه فعلی نمایش می دهد. دیالوگ مودال است، بنابراین برنامه تا زمانی که کاربر روی دکمه گفتگو کلیک کند، مکث می کند.
استدلال ها
| پیام | پیامی که در کادر گفتگو نمایش داده می شود. |
|---|
| عنوان | عنوان دیالوگ مقدار پیش فرض "Alert" است. |
|---|
| okTitle | متن نمایش داده شده در دکمه گفتگو. مقدار پیش فرض "OK" است. |
|---|
انتخاب عدد صحیح (پیام رشته ، انتخاب های تکرارپذیر ، عنوان رشته )
دیالوگی را با لیستی از انتخاب های فرآیند اجرای برنامه جاری نمایش می دهد. دیالوگ مودال است، بنابراین برنامه تا زمانی که کاربر یکی از دکمه های گفتگو را کلیک کند، مکث می کند.
استدلال ها
| پیام | پیام اعلان نمایش داده شده در گفتگو. |
|---|
| انتخاب ها | یک تکرار پایتون حاوی یک یا چند شی که به صورت رشته نمایش داده می شوند. فرم پیشنهادی آرایه ای از رشته ها است. |
|---|
| عنوان | عنوان دیالوگ پیش فرض "ورودی" است. |
|---|
برمی گرداند
- اگر کاربر انتخابی را انجام دهد و روی دکمه "OK" کلیک کند، این روش شاخص 0-مبتنی بر انتخاب را در داخل تکرارپذیر برمی‌گرداند. اگر کاربر روی دکمه "لغو" کلیک کند، روش -1 را برمی گرداند.
مرجع monkeyrunner API را به سبکی شبیه به ابزار pydoc پایتون با استفاده از فرمت مشخص شده نمایش می دهد.
استدلال ها
| قالب | قالب نشانه گذاری برای استفاده در خروجی. مقادیر ممکن عبارتند از "text" برای متن ساده یا "html" برای HTML. |
|---|
دیالوگی را نمایش می دهد که ورودی را می پذیرد و آن را به برنامه برمی گرداند. دیالوگ مودال است، بنابراین برنامه تا زمانی که کاربر یکی از دکمه های گفتگو را کلیک کند، مکث می کند.
دیالوگ شامل دو دکمه است که یکی از آنها مقدار okTitle و دیگری مقدار cancelTitle را نشان می دهد. اگر کاربر روی دکمه okTitle کلیک کند، مقدار فعلی کادر ورودی برگردانده می شود. اگر کاربر روی دکمه cancelTitle کلیک کند، یک رشته خالی برگردانده می شود.
استدلال ها
| پیام | پیام اعلان نمایش داده شده در گفتگو. |
|---|
| مقدار اولیه | مقدار اولیه برای نمایش در گفتگو. پیش فرض یک رشته خالی است. |
|---|
| عنوان | عنوان دیالوگ پیش فرض "ورودی" است. |
|---|
| okTitle | متن نمایش داده شده در دکمه okTitle. پیش فرض "OK" است. |
|---|
| لغو عنوان | متن نمایش داده شده در دکمه لغو عنوان. پیش فرض "لغو" است. |
|---|
برمی گرداند
- اگر کاربر روی دکمه okTitle کلیک کند، متد مقدار فعلی کادر ورودی گفتگو را برمی‌گرداند. اگر کاربر روی دکمه cancelTitle کلیک کند، متد یک رشته خالی برمی گرداند.
خواب خالی (ثانیه شناور )
برنامه فعلی را برای تعداد ثانیه مشخص شده متوقف می کند.
استدلال ها
| ثانیه | تعداد ثانیه های مکث. |
|---|
MonkeyDevice waitForConnection (موقعیت شناور ، شناسه دستگاه رشته )
سعی می کند بین باطن monkeyrunner و دستگاه یا شبیه ساز مشخص شده ارتباط برقرار کند.
استدلال ها
| تایم اوت | تعداد ثانیه های انتظار برای اتصال. پیش فرض این است که برای همیشه منتظر بمانید. |
|---|
| شناسه دستگاه | یک عبارت منظم که شماره سریال دستگاه یا شبیه ساز را مشخص می کند. برای توضیح شماره سریال دستگاه و شبیه ساز به مبحث Android Debug Bridge مراجعه کنید. |
|---|
برمی گرداند
- یک نمونه
MonkeyDevice برای دستگاه یا شبیه ساز. از این شی برای کنترل و برقراری ارتباط با دستگاه یا شبیه ساز استفاده کنید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],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."]]
