MonkeyRunner
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Classe do monkeyrunner que contém métodos utilitários estáticos.
Resumo
| Métodos |
|
nulo
|
alert
(mensagem de string,
título de string,
okTitle de string)
Exibe uma caixa de diálogo de alerta para o processo que está executando o programa atual.
|
|
número inteiro
|
choice
(mensagem de string, opções de
iterable,
título de string)
Exibe uma caixa de diálogo com uma lista de opções para o processo que está executando o programa atual.
|
|
nulo
|
help
(formato de string)
Exibe a referência da API monkeyrunner em um estilo semelhante ao da ferramenta pydoc do Python, usando o formato especificado.
|
|
string
|
input
(mensagem de string,
initialValue de string,
título de string, okTitle de string,
cancelTitle de string)
Exibe uma caixa de diálogo que aceita entrada.
|
|
nulo
|
sleep
(segundos de flutuação)
Pausa o programa atual durante o número especificado de segundos.
|
MonkeyDevice
|
waitForConnection
(tempo limite de float,
deviceId de string)
Tenta fazer uma conexão entre o back-end monkeyrunner e o
dispositivo ou emulador especificado.
|
Métodos públicos
string
alerta
(
mensagem de string,
título de string,
okTitle de string)
Exibe uma caixa de diálogo de alerta para o processo que está executando o programa
atual. A caixa de diálogo é modal. Dessa forma, o programa é pausado até que o usuário clique no botão
da caixa de diálogo.
Argumentos
| message |
Mensagem a ser exibida na caixa de diálogo.
|
| title |
Título da caixa de diálogo. O valor padrão é "Alerta".
|
| okTitle |
Texto exibido no botão da caixa de diálogo. O valor padrão é "OK".
|
integer
choice
(mensagem de string,
opções iteráveis,
título de string)
Exibe uma caixa de diálogo com uma lista de opções para o processo que está executando o programa atual. A
caixa de diálogo é modal. Dessa forma, o programa é pausado até que o usuário clique no botão da
caixa de diálogo.
Argumentos
| message |
Mensagem de prompt exibida na caixa de diálogo.
|
| choices |
Um iterável em Python que contém um ou mais objetos exibidos como strings. O
formato recomendado é uma matriz de strings.
|
|
title
|
Título da caixa de diálogo. O padrão é "Entrada".
|
Returns
-
Se o usuário fizer uma seleção e clicar no botão "OK", o método retornará
o índice baseado em 0 da seleção dentro do iterável.
Se o usuário clicar no botão "Cancelar", o método retornará -1.
Exibe a referência da API monkeyrunner em um estilo semelhante ao da ferramenta pydoc do Python, usando o formato especificado.
Argumentos
| format |
Formato de marcação a ser usado na saída. os valores possíveis são "text" para texto simples
ou "html" para HTML.
|
Exibe uma caixa de diálogo que aceita entrada e a retorna para o programa. A caixa de diálogo é
modal. Dessa forma, o programa é pausado até que o usuário clique no botão da caixa de diálogo.
A caixa de diálogo contém dois botões: um deles exibe o valor okTitle
e o outro exibe o valor cancelTitle. Se o usuário clicar no botão "okTitle",
o valor atual da caixa de entrada será retornado. Se ele clicar no botão "cancelTitle",
uma string vazia será retornada.
Argumentos
| message |
Mensagem de prompt exibida na caixa de diálogo.
|
| initialValue |
Valor inicial a ser exibido na caixa de diálogo. O padrão é uma string vazia.
|
| title |
Título da caixa de diálogo. O padrão é "Entrada".
|
| okTitle |
Texto exibido no botão "okTitle". O padrão é "OK".
|
| cancelTitle |
Texto exibido no botão "cancelTitle". O padrão é "Cancelar".
|
Retornos
-
Se o usuário clicar no botão "okTitle", o método retornará o valor atual da caixa de entrada da
caixa de diálogo. Se o usuário clicar no botão "cancelTitle", o método retornará
uma string vazia.
void
sleep
(segundos de flutuação
)
Pausa o programa atual durante o número especificado de segundos.
Argumentos
| segundos |
Número de segundos de pausa.
|
MonkeyDevice
waitForConnection
(tempo limite de float,
deviceId de string)
Tenta fazer uma conexão entre o back-end monkeyrunner e o
dispositivo ou emulador especificado.
Argumentos
| timeout |
O número de segundos para aguardar uma conexão. O padrão é aguardar indeterminadamente
|
|
deviceId
|
Uma expressão regular que especifica o número de série do dispositivo ou emulador. Consulte
o tópico
Android Debug Bridge
para ver uma descrição dos números de série do dispositivo e emulador.
|
Returns
-
Uma instância
MonkeyDevice
para o dispositivo ou emulador. Use esse objeto para controlar e estabelecer comunicação com o
dispositivo ou emulador.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[null,null,["Última atualização 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."]]
