Participe do evento ⁠#Android11: apresentação de lançamento da versão Beta no dia 3 de junho.

MonkeyRunner

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

Resumo

Métodos
void 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.
integer 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.
void 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.
void sleep (segundos de float)
Pausa o programa atual durante pelo 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 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. A caixa de diálogo é modal. Assim, o programa é pausado até que o usuário clique no botão dela.

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 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. A caixa de diálogo é modal. Assim, o programa é pausado até que o usuário clique no botão dela.

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 (formato de string)

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 (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 e a retorna para o programa. A caixa de diálogo é modal. Assim, o programa é pausado até que o usuário clique no botão dela.

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

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

Argumentos
seconds 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 de dispositivo e de 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.