MonkeyRunner
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Classe monkeyrunner contenant des méthodes utilitaires statiques
Résumé
Méthodes |
void
|
alert
(message de string,
titre de string,
okTitle de string)
Affiche une boîte de dialogue d'alerte sur le processus exécutant le programme en cours.
|
entier
|
choice
(message de string,
choix de iterable,
titre de string)
Affiche une boîte de dialogue avec une liste de choix pour le processus exécutant le programme en cours.
|
void
|
help
(format de string)
Affiche la référence de l'API monkeyrunner dans un style semblable à celui de l'outil pydoc de Python, au format spécifié.
|
chaîne
|
input
(message de string,
initialValue de string,
titre de string,
okTitle de string,
cancelTitle de string)
Affiche une boîte de dialogue qui accepte la saisie.
|
void
|
sleep
(secondes de float)
Met en veille le programme en cours pendant le nombre de secondes spécifié.
|
MonkeyDevice
|
waitForConnection
(délai avant expiration de float,
deviceId de string)
Essaie d'établir une connexion entre le backend monkeyrunner et l'appareil ou l'émulateur spécifié.
|
Méthodes publiques
string
alert
(
message de string,
titre de string,
okTitle de string)
Affiche une boîte de dialogue d'alerte sur le processus exécutant le programme en cours. La boîte de dialogue étant modale, le programme se met en veille jusqu'à ce que l'utilisateur clique sur le bouton de la boîte de dialogue.
Arguments
message |
Message à afficher dans la boîte de dialogue.
|
title |
Titre de la boîte de dialogue. La valeur par défaut est "Alerte".
|
okTitle |
Texte affiché dans le bouton de la boîte de dialogue. La valeur par défaut est "OK".
|
integer
choice
(message de string,
choix de iterable,
titre de string)
Affiche une boîte de dialogue avec une liste de choix pour le processus exécutant le programme en cours. La boîte de dialogue étant modale, le programme se met en veille jusqu'à ce que l'utilisateur clique sur l'un des boutons de la boîte de dialogue.
Arguments
message |
Message d'invite affiché dans la boîte de dialogue.
|
choices |
Itérable Python contenant un ou plusieurs objets affichés sous forme de chaînes. La forme recommandée est un tableau de chaînes.
|
title
|
Titre de la boîte de dialogue. La valeur par défaut est "Saisie".
|
Renvoie
-
Si l'utilisateur effectue une sélection et clique sur le bouton "OK", la méthode renvoie l'index de base 0 de la sélection dans l'itérable.
Si l'utilisateur clique sur le bouton "Annuler", la méthode renvoie "-1".
Affiche la référence de l'API monkeyrunner dans un style semblable à celui de l'outil pydoc
de Python, au format spécifié.
Arguments
format |
Format de balisage à utiliser dans la sortie. Les valeurs possibles sont "text" (texte brut) ou "html" (HTML).
|
Affiche une boîte de dialogue qui accepte la saisie et la renvoie au programme. La boîte de dialogue étant modale, le programme se met en veille jusqu'à ce que l'utilisateur clique sur l'un des boutons de la boîte de dialogue.
La boîte de dialogue contient deux boutons, l'un affichant la valeur "okTitle" et l'autre la valeur "cancelTitle". Si l'utilisateur clique sur le bouton "okTitle", la valeur actuelle de la zone de saisie est renvoyée. Si l'utilisateur clique sur le bouton "cancelTitle", une chaîne vide est renvoyée.
Arguments
message |
Message d'invite affiché dans la boîte de dialogue.
|
initialValue |
Valeur initiale à afficher dans la boîte de dialogue. La valeur par défaut est une chaîne vide.
|
title |
Titre de la boîte de dialogue. La valeur par défaut est "Saisie".
|
okTitle |
Texte affiché dans le bouton "okTitle". La valeur par défaut est "OK".
|
cancelTitle |
Texte affiché dans le bouton "cancelTitle". La valeur par défaut est "Annuler".
|
Renvoie
-
Si l'utilisateur clique sur le bouton "okTitle", la méthode renvoie la valeur actuelle de la zone de saisie de la boîte de dialogue. Si l'utilisateur clique sur le bouton "cancelTitle", la méthode renvoie une chaîne vide.
void
sleep
(
secondes de float
)
Met en veille le programme en cours pendant le nombre de secondes spécifié.
Arguments
secondes |
Durée (en secondes) de la mise en veille.
|
MonkeyDevice
waitForConnection
(délai avant expiration de float,
deviceId de string)
Essaie d'établir une connexion entre le backend monkeyrunner
et l'appareil ou l'émulateur spécifié.
Arguments
timeout |
Nombre de secondes d'attente de connexion. Par défaut, le système attend indéfiniment.
|
ID de l'appareil
|
Expression régulière qui indique le numéro de série de l'appareil ou de l'émulateur. Consultez la rubrique Android Debug Bridge pour obtenir une description des numéros de série des appareils et des émulateurs.
|
Renvoie
-
Une instance
MonkeyDevice
pour l'appareil ou l'émulateur. Utilisez cet objet pour contrôler l'appareil ou l'émulateur et communiquer avec lui.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]