MonkeyRunner

Classe do monkeyrunner que contém métodos utilitários estáticos.

Resumo

Métodos
void alert (string message, string title, string okTitle)
Exibe uma caixa de diálogo de alerta para o processo que está executando o programa atual.
integer choice (string message, iterable choices, string title)
Exibe uma caixa de diálogo com uma lista de opções para o processo que está executando o programa atual.
void help (string format)
Exibe a referência da API monkeyrunner em um estilo semelhante ao da ferramenta pydoc do Python, usando o formato especificado.
string input (string message, string initialValue, string title, string okTitle, string cancelTitle)
Exibe uma caixa de diálogo que aceita entrada.
void sleep (float seconds)
Pausa o programa atual durante o número especificado de segundos.
MonkeyDevice waitForConnection (float timeout, string deviceId)
Tenta fazer uma conexão entre o back-end monkeyrunner e o dispositivo ou emulador especificado.

Métodos públicos

string alert ( string message, string title, string okTitle)

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 (string message, iterable choices, string title)

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".
Retornos
  • 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.

void help (string format)

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.

string input (string message string initialValue, string title, string okTitle, string cancelTitle)

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 ( float seconds )

Pausa o programa atual durante o número especificado de segundos.

Argumentos
seconds Número de segundos de pausa.

MonkeyDevice waitForConnection (float timeout, string deviceId)

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.
Retornos
  • Uma instância MonkeyDevice para o dispositivo ou emulador. Use esse objeto para controlar e estabelecer comunicação com o dispositivo ou emulador.