Ton premier script en 10 minutes

À la fin de cette page, tu auras lancé un script sur ton téléphone, lu sa sortie, et fait toucher à AppsMobs un bouton dont tu as pris la capture. ⏱ 10 minutes.

1. 1

   Ouvre le Playground

   Clique sur Playground dans la barre latérale, sous Créer. C'est l'endroit où tu écris tes scripts.

   1

   Un écran d'accueil te demande Qu'est-ce que tu veux automatiser ? et propose quatre choix : Partir d'un exemple, Construire avec des blocs, Le décrire à l'IA, Ouvrir un script. Pour ce tutoriel, clique sur Ou partir d'une page blanche.

   Tu vois alors l'éditeur de code, avec en haut le nom du script (Nouveau script, repère 1), le mode Code / Blocs (repère 2), le sélecteur Lancer sur (repère 3) et les boutons Lancer (repère 4), Arrêter (repère 5), Enregistrer (repère 6).

   123456

2. 2

   Écris un premier script sans image

   Vérifie que le mode Code est actif (en haut, à côté de Blocs). Clique dans la zone de code et recopie ceci :

   log("Début du script")
   press_home()
   wait(2)
   log("Retour à l'accueil fait")
   

   Ce que font ces lignes :

   • log("...") écrit un message dans le panneau Sortie. C'est ton moyen de voir ce que fait le script.
   • press_home() appuie sur le bouton Accueil du téléphone.
   • wait(2) attend 2 secondes. Le nombre est en secondes.

   Il n'y a rien à importer : les fonctions comme log ou press_home sont déjà connues du Playground. Tout est expliqué dans la référence des fonctions.

3. 3

   Choisis l'appareil

   Clique sur Lancer sur (le sélecteur d'appareil, au milieu de la barre du haut). Une fenêtre Lancer le script sur s'ouvre avec la liste de tes appareils.

   Coche ton téléphone. Ton choix est retenu pour les prochains lancements. Si tu ne coches rien, AppsMobs te demandera l'appareil à chaque lancement.

   Si la liste est vide, le message est Aucun appareil branché. Branche un téléphone en USB (débogage USB activé) ou démarre un émulateur. : retourne à Brancher un téléphone ou un émulateur.

4. 4

   Lance le script

   Clique sur Lancer (ou appuie sur F5).

   Ce qui se passe : le panneau Sortie s'ouvre en bas. Tu y vois d'abord Lancement sur suivi du nom de ton appareil, puis tes messages, chacun précédé de l'heure. Sur le téléphone, l'écran d'accueil s'affiche.

   Comment savoir que ça a marché : l'état passe de Démarrage… à En cours sur puis Terminé en suivi de la durée. Pendant l'exécution, tu peux cliquer sur Arrêter (Maj + F5) pour interrompre.

   Le détail complet reste disponible dans la Console : le bouton Ouvrir la Console de l'application du panneau Sortie y mène.

   Tu peux lire la sortie même après

   Le bouton Copier la sortie copie le texte, Effacer vide le panneau. Au lancement suivant, un trait sépare les anciennes lignes des nouvelles.

5. 5

   Enregistre le script

   Appuie sur Ctrl + S (ou clique sur Enregistrer). Une fenêtre Sauvegarder le script AppsMobs s'ouvre, déjà placée dans ton dossier de scripts : Documents\AppsMobs\Scripts.

   Donne-lui un nom, par exemple mon_premier_script.py, et valide. Sous le nom du script, le texte Pas encore enregistré est remplacé par le chemin du fichier.

   Garde ce dossier en tête : c'est là que tu poseras l'image du bouton à l'étape suivante.

6. 6

   Capture l'écran du téléphone

   Pour toucher un bouton, le script a besoin d'une petite image de ce bouton. Sur ton téléphone, affiche l'écran où se trouve le bouton que tu veux toucher (n'importe quel bouton bien visible, par exemple une icône de l'écran d'accueil).

   Dans le Playground, clique sur le bouton ⋯ (Plus d'actions) à droite de la barre du haut, puis, dans le groupe Outils, sur Capture de l'appareil. Le raccourci est F9.

   Si plusieurs appareils sont branchés, une fenêtre te demande lequel capturer. Sinon la capture part directement.

   Une fenêtre Capture enregistrée apparaît avec le nom du fichier et la question Ouvrir la capture dans Paint pour la couper ?. Clique sur Oui.

   La capture est enregistrée en entier dans ton dossier de captures (Documents\AppsMobs\Screenshots), sous un nom du type identifiant-appareil_date.png.

7. 7

   Découpe le bouton et enregistre-le à côté du script

   Dans Paint :

   1. Clique sur l'outil Sélectionner, puis dessine un rectangle qui entoure uniquement le bouton, au plus près.
   2. Clique sur Rogner. Il ne reste que le bouton.
   3. Choisis Fichier, Enregistrer sous, Image PNG.
   4. Va dans Documents\AppsMobs\Scripts (le dossier de ton script) et nomme le fichier bouton.png.

   Une bonne image

   • Prends le bouton seul, sans le fond autour. Un petit morceau très reconnaissable marche mieux qu'une grande zone.
   • Évite les parties qui changent (un compteur, une date).
   • Fais la capture sur un appareil de même résolution que celui qui lancera le script.
   • Le nom doit finir par .png et tu l'écris tel quel dans le script (majuscules comprises).

   Où poser le fichier : AppsMobs cherche l'image d'abord dans le dossier du script, puis dans Documents\AppsMobs\Scripts\img. L'un ou l'autre convient. Si tu ne l'enregistres dans aucun des deux, le script s'arrête avec un message d'erreur (voir plus bas).

8. 8

   Fais-lui toucher le bouton

   Reviens dans le Playground. Remplace le contenu du script par :

   log("Je cherche le bouton")
   if tap_image("bouton.png", timeout=15):
       log("Bouton touché")
   else:
       log("Bouton introuvable au bout de 15 secondes")
   

   • tap_image("bouton.png", timeout=15) attend jusqu'à 15 secondes que l'image apparaisse, puis la touche. Elle répond vrai si le bouton a été touché, faux sinon.
   • if ... else ... choisit quoi faire selon la réponse. Les lignes décalées de 4 espaces sous if et else sont celles qui s'exécutent dans chaque cas.

   Appuie sur Ctrl + S, puis sur Lancer.

   Comment savoir que ça a marché : sur le téléphone, le bouton est touché, et la Sortie affiche Bouton touché.

Le même script avec un texte plutôt qu'une image

Si le bouton porte un texte lisible par Android, tu n'as pas besoin d'image :

log("J'attends le texte")
if wait_text("Paramètres", timeout=15):
    tap_text("Paramètres")
    log("Texte touché")
else:
    log("Texte introuvable")

wait_text attend qu'un élément affiche ce texte, tap_text le touche. Les textes dessinés dans une image (cas fréquent dans les jeux) ne sont pas lisibles ainsi : utilise alors tap_image.

Répéter une action

Ajoute une boucle pour recommencer. Cet exemple est celui du Playground (écran d'accueil, Partir d'un exemple), avec ton image :

for i in range(10):
    log(f"Tour {i + 1}/10")
    tap_image("bouton.png")
    wait(2)

log("Terminé !")

for i in range(10) répète dix fois les lignes décalées en dessous. Ici tap_image attend l'image (30 secondes par défaut) avant de passer au tour suivant.

Ça ne marche pas ?

Et ensuite

• Créer sans coder : l'éditeur en blocs : la même chose en glissant des blocs.
• Écrire un script en Python : les règles, les images, les bonnes habitudes.
• Référence des fonctions : les 87 fonctions disponibles.