ADB / Android Debug Bridge
Incluse avec Macro DeckPilotez un téléphone ou une tablette Android en USB ou en Wi-Fi : réveillez-le, lancez des applications, touchez l'écran, saisissez du texte et faites des captures d'écran.
L'onglet Aperçu de l'intégration ADB / Android Debug Bridge, avec un avertissement invitant à activer ADB dans les Paramètres
- Réveillez, verrouillez et redémarrez un appareil Android connecté
- Lancez ou forcez l'arrêt d'applications et ouvrez des liens sur l'appareil
- Envoyez des touches, des appuis, des balayages et du texte
- Enregistrez des captures de l'écran de l'appareil dans un dossier
- Événements et variables pour la batterie, l'écran et l'application au premier plan
L'intégration ADB pilote les téléphones et tablettes Android via l'Android Debug Bridge (ADB), l'outil qu'utilisent les développeurs Android. Macro Deck trouve le programme adb, lance le serveur ADB et suit les appareils branchés en USB ou connectés en Wi-Fi. Il peut aussi télécharger pour vous les platform-tools Android officiels.
Chaque action agit sur l'appareil choisi dans l'action, ou sur l'appareil par défaut si vous laissez Appareil vide. L'appareil par défaut est celui que vous avez choisi avec Définir par défaut dans Paramètres > ADB, ou le seul appareil branché si vous n'en avez choisi aucun.
Ce que vous pouvez faire
- Écran et alimentation : réveiller l'appareil, éteindre l'écran (c'est ainsi qu'Android verrouille l'appareil) ou le redémarrer sous Android, en mode recovery ou dans le bootloader.
- Applications et liens : lancer une application ou forcer son arrêt par son nom de package, comme
com.spotify.music, et ouvrir un lien avec l'application que l'appareil choisit pour lui. - Saisie : envoyer une touche comme Home, Back, Volume Up ou Media Play Pause, toucher un point de l'écran, balayer d'un point à un autre, ou saisir du texte dans le champ actif.
- Captures d'écran : capturer l'écran dans un fichier PNG enregistré dans un dossier de votre ordinateur, et écrire si vous le souhaitez le chemin du fichier dans une variable.
Quelques exemples de configuration :
- Un bouton qui réveille une tablette posée sur votre bureau et lance votre application de musique.
- Un bouton qui envoie Media Play Pause à votre téléphone.
- Une automatisation sur Appareil connecté qui ouvre une page de tableau de bord sur une tablette dès que vous la branchez.
État en direct
L'intégration signale quand un appareil est connecté, déconnecté, autorisé, n'est plus autorisé, passe hors ligne ou revient en ligne, pour que flux et boutons puissent réagir. Des variables indiquent le nombre d'appareils connectés et autorisés et, pour l'appareil par défaut, son modèle, son fabricant, son niveau de batterie, si l'écran est allumé, si l'écran de verrouillage s'affiche et quelle application est au premier plan. Chaque appareil autorisé reçoit aussi ses propres variables, nommées d'après son modèle. Tant que l'intégration est active, la batterie de chaque appareil Android apparaît aussi dans le widget Batterie.
Les actions de base (touches, appuis, balayages, texte, applications, liens, redémarrages et captures d'écran) continuent de fonctionner quand Macro Deck est verrouillé : un bouton qui en utilise une fonctionne donc aussi sur un ordinateur verrouillé.
Ce qu'il vous faut
- Macro Deck 3 sous Windows, macOS ou Linux
- Un appareil Android avec le débogage USB activé dans ses options pour les développeurs
- Un câble USB qui transmet les données, ou le débogage sans fil pour une connexion en Wi-Fi
- Les platform-tools Android (adb) ; Macro Deck peut les télécharger dans Paramètres > ADB
- Sous Linux, l'autorisation pour votre utilisateur d'accéder au périphérique USB, généralement via une règle udev
Configuration
Étape 1: Activez l'intégration ADB
Dans la barre latérale, cliquez sur Intégrations, puis sur ADB / Android Debug Bridge. L'intégration reste désactivée tant que vous n'activez pas l'interrupteur en haut à droite. Une fois activée, la page affiche ADB est désactivé jusqu'à ce que vous activiez ADB à l'étape suivante.
Étape 2: Activez ADB dans Macro Deck
Ouvrez Paramètres > ADB et activez Activer ADB. Si Programme ADB affiche Introuvable, cliquez sur Télécharger platform-tools. Un Android SDK existant ou un
adbprésent dans votrePATHest détecté automatiquement, et Chemin de l'exécutable vous permet d'en indiquer un autre.Étape 3: Activez le débogage USB sur l'appareil
Sur le téléphone ou la tablette, ouvrez Paramètres > À propos du téléphone et touchez sept fois Numéro de build pour activer les Options pour les développeurs. Activez ensuite Débogage USB dans Paramètres > Options pour les développeurs. L'emplacement exact varie un peu selon les fabricants.
Étape 4: Connectez et autorisez l'appareil
Branchez l'appareil avec un câble USB et confirmez Autoriser le débogage USB ? sur son écran. Cochez Toujours autoriser cet ordinateur pour ne plus avoir à le confirmer. L'appareil apparaît alors sous Appareils dans Paramètres > ADB avec l'état Prêt. Pour vous connecter plutôt en Wi-Fi, saisissez l'adresse IP et le port de l'appareil sous Connecter via Wi-Fi, par exemple
192.168.1.20:5555.Étape 5: Choisissez un appareil par défaut
Si plusieurs appareils sont branchés, cliquez sur Définir par défaut à côté de celui que vos actions doivent utiliser quand Appareil est vide. Avec un seul appareil, celui-ci est utilisé automatiquement.
Étape 6: Ajoutez une action ADB à un bouton
Sur la page Deck, vérifiez que le deck est déverrouillé (le bouton en haut à droite indique Verrouiller) et cliquez sur un bouton. L'éditeur s'ouvre avec Appui court sélectionné. Cliquez sur + Ajouter une action, choisissez ADB / Android Debug Bridge à gauche de la boîte de dialogue Ajouter une action et sélectionnez une action, par exemple Réveiller l'appareil ou Démarrer l'application. Remplissez ses champs, comme Package pour Démarrer l'application, et laissez Appareil vide pour utiliser l'appareil par défaut. La catégorie n'apparaît que lorsque l'intégration est activée.
Étape 7: Appuyez sur le bouton
Cliquez sur Enregistrer et appuyez sur le bouton de votre deck. Si rien ne se passe, cherchez un avertissement dans Intégrations, comme Aucun appareil connecté ou un appareil qui doit être autorisé.
Actions11
Placez-les sur un bouton ou exécutez-les depuis un flux.
- Réveiller l'appareil
- Réveille l'écran de l'appareil.
- Veille / Verrouiller l'écran
- Éteint l'écran de l'appareil, c'est ainsi qu'Android verrouille un appareil.
- Démarrer l'application
- Lance une application par son nom de package, ou la fait passer au premier plan.
- Forcer l'arrêt de l'application
- Force l'arrêt d'une application par son nom de package.
- Ouvrir le lien
- Ouvre une URI sur l'appareil, comme si vous touchiez un lien.
- Saisir du texte
- Saisit du texte dans le champ actif de l'appareil.
- Envoyer une touche
- Envoie un événement de touche Android, comme Home, Back, Volume Up ou Media Next.
- Appuyer
- Touche l'écran aux coordonnées X et Y indiquées.
- Balayer
- Balaie l'écran d'un point à un autre sur une durée définie.
- Redémarrer l'appareil
- Redémarre l'appareil en mode Normal, Recovery ou Bootloader.
- Prendre une capture d'écran
- Capture l'écran de l'appareil et l'enregistre en PNG dans un dossier, en écrivant si vous le souhaitez son chemin dans une variable.
Déclencheurs6
Un bouton ou un flux peut réagir à ces événements.
- Appareil connecté
- Un appareil Android a été branché, ou Macro Deck l'a détecté pour la première fois.
- Appareil déconnecté
- Un appareil Android a été débranché, ou Macro Deck ne le détecte plus.
- Appareil autorisé
- La demande d'autorisation a été acceptée sur l'appareil.
- Appareil devenu non autorisé
- Un appareil autorisé auparavant doit de nouveau accepter la demande d'autorisation.
- Appareil en ligne
- Un appareil autorisé est de nouveau joignable.
- Appareil hors ligne
- Un appareil qui était joignable ne l'est plus.
Variables11
Affichez ces valeurs sur des boutons et des widgets, ou utilisez-les dans des conditions.
adb_connected_device_count- Le nombre d'appareils Android branchés.
adb_authorized_device_count- Le nombre d'appareils en ligne et autorisés.
adb_device_connected- Indique si l'appareil par défaut est connecté.
adb_device_authorized- Indique si l'appareil par défaut a autorisé cet ordinateur.
adb_device_model- Le modèle de l'appareil par défaut.
adb_device_manufacturer- Le fabricant de l'appareil par défaut.
adb_device_battery_level- Le niveau de batterie de l'appareil par défaut, en pourcentage.
adb_device_screen_on- Indique si l'écran de l'appareil par défaut est allumé.
adb_device_locked- Indique si l'appareil par défaut affiche son écran de verrouillage.
adb_device_foreground_app- Le nom de package de l'application au premier plan sur l'appareil par défaut.
adb_device_<device>_connected,adb_device_<device>_authorized,adb_device_<device>_model,adb_device_<device>_battery_level- Connexion, autorisation, modèle et niveau de batterie de chaque appareil autorisé.
<device>est le modèle de l'appareil en lettres minuscules, chiffres et tirets bas, suivi de_2,_3, etc. pour les autres appareils du même modèle.
Questions fréquentes
Ai-je besoin d'Android Studio ou de l'Android SDK ?
Non. Macro Deck n'a besoin que du programme adb des platform-tools Android. Cliquez sur Télécharger platform-tools dans Paramètres > ADB et Macro Deck télécharge le paquet officiel de Google, environ 15 Mo, pour son propre usage. Une installation existante est détectée automatiquement.
Puis-je piloter un appareil en Wi-Fi ?
Oui. Activez le débogage sans fil sur l'appareil et saisissez son adresse IP et son port sous Connecter via Wi-Fi dans Paramètres > ADB. Macro Deck n'associe pas lui-même les appareils : sous Android 11 et versions ultérieures, associez d'abord l'appareil à cet ordinateur, ou passez-le en débogage réseau via USB avec adb tcpip. Sinon, l'appareil refuse la connexion.
Pourquoi une action échoue-t-elle sans trouver d'appareil ?
Quand vous laissez Appareil vide, l'action utilise l'appareil par défaut. Si vous n'en avez choisi aucun et que plusieurs appareils sont branchés, il n'y a pas d'appareil par défaut : choisissez un appareil dans l'action ou cliquez sur Définir par défaut dans Paramètres > ADB. Vérifiez aussi que l'appareil affiche Prêt et non Non autorisé.
Existe-t-il une action de verrouillage distincte ?
Non. Android n'a pas de commande de verrouillage distincte. Veille / Verrouiller l'écran éteint l'écran, ce qui verrouille l'appareil de la même façon que le bouton marche/arrêt.
L'intégration ADB affecte-t-elle d'autres programmes qui utilisent ADB ?
Macro Deck utilise le serveur ADB habituel, que des programmes comme Android Studio partagent donc avec lui. Redémarrer le serveur ADB dans Paramètres > ADB déconnecte aussi brièvement leurs appareils. Macro Deck laisse le serveur tourner à sa fermeture, sauf si vous activez Arrêter le serveur ADB à la fermeture de Macro Deck.
Pourquoi l'appareil affiche-t-il « Aucune autorisation d'accès à cet appareil » ?
L'ordinateur n'a pas l'autorisation de communiquer avec l'appareil en USB. Sous Linux, installez les règles udev des platform-tools ; sous Windows, installez le pilote USB du fabricant de l'appareil.
Plus dans Votre ordinateur
Système
Incluse avec Macro DeckPilotez votre ordinateur depuis votre deck : applications, volume, commandes, notifications, veille et arrêt.
Clavier
Incluse avec Macro DeckDéclenchez des raccourcis, saisissez du texte et exécutez des séquences de touches sur votre ordinateur depuis un bouton.
Souris
Incluse avec Macro DeckCliquez, déplacez le pointeur, faites glisser et défilez sur votre ordinateur depuis un bouton.
Steam
Incluse avec Macro DeckLancez et fermez des jeux Steam, et affichez sur votre deck ce à quoi vous jouez, vos amis et votre bibliothèque.