Installer un APK depuis votre Mac et déboguer Android — avec ou sans le terminal

Deux tâches complètement différentes se cachent derrière l'expression « installer un APK depuis un Mac », et la plupart des guides n'en traitent qu'une seule. Cette page répond aux deux, puis aborde ce qui bloque réellement les gens ensuite : lire le logcat, et faire en sorte que macOS voie le téléphone. Toutes les étapes ci-dessous fonctionnent avec de simples commandes adb ; là où une interface graphique fait réellement gagner du travail, nous disons précisément ce qu'elle fait et ce qu'elle ne fait pas. Mis à jour en août 2026.

D'abord : voulez-vous l'application sur votre Mac, ou sur votre téléphone ?

Les résultats de recherche pour cette expression se divisent en deux moitiés, et les premiers ne répondent qu'à l'une d'elles. Les articles qui proposent « installez BlueStacks / NoxPlayer / LDPlayer » répondent à la première question : faire tourner des logiciels Android sur macOS lui-même. Cela demande un émulateur, et sur Apple Silicon vos options réalistes sont l'émulateur d'Android Studio (gratuit, images système arm64) ou des produits du type Google Play Games on PC, pas les anciens émulateurs x86.

Si, à l'inverse, vous avez un téléphone ou une tablette posé sur votre bureau et un fichier .apk dans Téléchargements, vous n'avez besoin d'aucun émulateur. Il vous faut ADB — l'Android Debug Bridge — et un câble. C'est le sujet de tout le reste de cette page.

1. Vous voulez exécuter l'application sur le Mac lui-même → utilisez un émulateur ; rien de ce qui suit ne s'applique.
2. Vous voulez envoyer l'application sur un appareil Android physique connecté au Mac → poursuivez la lecture.

Étape zéro : activer le débogage USB (cette partie se passe sur le téléphone)

Aucune application Mac ne peut actionner cet interrupteur à votre place — Android exige délibérément qu'il soit activé à la main sur l'appareil, et la première connexion doit être confirmée sur l'écran du téléphone. Tout ce qui prétend le contraire est faux.

macOS n'a besoin d'aucun pilote USB, contrairement à Windows. Quand un appareil n'apparaît pas, la cause est presque toujours un câble de charge seule, un hub USB, ou une boîte de dialogue d'autorisation non confirmée.

1. Paramètres → À propos du téléphone → appuyez sept fois sur Numéro de build.
2. Revenez dans Paramètres → Système → Options pour les développeurs → activez le Débogage USB.
3. Reliez le téléphone au Mac avec un câble capable de transférer des données, directement, pas via un hub.
4. Sur le téléphone, acceptez « Autoriser le débogage USB ? » et cochez « Toujours autoriser depuis cet ordinateur ».

La voie du terminal : adb install

C'est la méthode classique, et elle mérite d'être connue même si vous finissez par utiliser une interface graphique. Homebrew installe exactement les mêmes binaires platform-tools que ceux distribués par Google.

Les échecs courants, sans détour : INSTALL_FAILED_UPDATE_INCOMPATIBLE signifie qu'une application portant ce nom de package est déjà installée, mais signée avec une autre clé — désinstallez-la d'abord. INSTALL_FAILED_VERSION_DOWNGRADE se règle en ajoutant -d. « adb: no devices/emulators found » signifie que l'étape d'autorisation ci-dessus n'a pas abouti.

1. brew install --cask android-platform-tools
2. adb devices — le numéro de série doit apparaître avec la mention device, et non unauthorized ou offline.
3. adb install -r ~/Downloads/app.apk (le -r réinstalle par-dessus une copie existante en conservant les données).
4. Guettez Success ; tout ce qui commence par INSTALL_FAILED_ est le vrai message d'erreur.

La voie sans terminal : glisser l'APK sur une fenêtre

Si vous n'avez pas l'intention de vivre dans le terminal, l'installation via Homebrew, les modifications du PATH et la danse du cd platform-tools ne sont que du travail en trop. Super ADB Manager embarque adb et le serveur scrcpy à l'intérieur de l'application : il n'y a donc rien à installer à côté, ni rien à maintenir à jour séparément.

Elle est gratuite, ne demande aucun compte, n'affiche aucune publicité, et la télémétrie est désactivée par défaut. L'application est signée et notarisée par Apple, elle s'ouvre donc normalement, au lieu d'imposer le contournement clic droit → Ouvrir qu'exigent les outils non signés des sites agrégateurs de téléchargements.

1. Téléchargez le DMG, glissez l'application dans Applications, ouvrez-la.
2. Branchez le téléphone et acceptez l'invite de débogage USB (comme ci-dessus).
3. Sélectionnez l'appareil, ouvrez l'onglet Applications, puis appuyez sur Installer l'APK ou déposez le fichier .apk directement sur la fenêtre.
4. Le même onglet liste les paquets installés et permet de les ouvrir, de récupérer l'APK sur le Mac, d'effacer les données ou de désinstaller.

Split APK : base.apk et les fichiers de configuration

Tout ce qui est téléchargé depuis APKMirror sous forme d'App Bundle, ou exporté par SAI, arrive en plusieurs fichiers — base.apk plus split_config.arm64_v8a.apk, split_config.xxhdpi.apk, les variantes de langue, et ainsi de suite. N'installer que base.apk donne une application qui plante au lancement ou qui n'affiche aucune ressource.

Toutes les parties doivent provenir de la même compilation et de la même signature ; mélanger les versions échoue. Si vous avez un conteneur .xapk ou .apks, décompressez-le d'abord — ce sont tous deux des archives ZIP — puis installez ensemble les parties extraites.

1. Terminal : adb install-multiple -r base.apk split_config.arm64_v8a.apk split_config.xxhdpi.apk
2. Interface graphique : sélectionnez toutes les parties d'un coup dans le sélecteur de fichiers, ou faites-les glisser ensemble sur la fenêtre — l'application lance install-multiple pour vous et affiche le nombre de parties pendant l'installation.

Lire le logcat sur un Mac sans Android Studio

adb logcat fonctionne très bien tout seul, et pour une chasse rapide au plantage la ligne de commande suffit souvent. Le problème, c'est la lecture prolongée : un logcat brut, ce sont des milliers de lignes par minute, pour tous les processus de l'appareil.

Le paysage des interfaces graphiques est ici maigre et, pour l'essentiel, figé. Les visionneuses logcat les plus connues sur macOS sont un projet Objective-C vieux de dix ans et ses forks, un outil en Tcl/Tk, et deux ou trois utilitaires plus récents en Rust au style terminal ; il existe une option commerciale payante. Toutes attendent que vous installiez et mainteniez platform-tools vous-même, et la plupart ne sont pas signées, ce qui sur macOS 13 et plus signifie batailler avec Gatekeeper avant de voir la moindre ligne.

Dans Super ADB Manager, l'onglet Logcat diffuse en direct depuis l'appareil sélectionné, avec un filtre de priorité (Tout / Info+ / Avertissement+ / Erreur / Fatal), des filtres prédéfinis pour Plantage, Réseau, Système et l'application au premier plan, une recherche en texte libre, un code couleur, le défilement automatique et l'effacement. Une limite assumée : la vue conserve les 2000 dernières lignes en mémoire ; c'est donc une fenêtre de débogage en direct, pas une archive de longue session — pour une capture complète, redirigez adb logcat vers un fichier.

1. adb logcat -v time — des horodatages lisibles.
2. adb logcat *:E — uniquement les erreurs et les erreurs fatales.
3. adb logcat --pid=$(adb shell pidof -s com.example.app) — la sortie d'une seule application.
4. adb logcat -c — vider le tampon avant de reproduire un bug.
5. adb logcat -v time > ~/Desktop/session.log — tout capturer dans un fichier.

Quand le Mac ne voit pas l'appareil

Il n'existe pas de page de dépannage macOS de qualité et à jour sur ce sujet, alors voici la liste de vérifications dans l'ordre qui règle réellement le problème. Sur certains modèles Samsung, Xiaomi et Honor, il faut aussi faire passer le mode USB de « Recharge uniquement » à « Transfert de fichiers » dans le volet des notifications avant qu'ADB ne s'attache.

Si adb devices affiche le numéro de série accompagné du mot unauthorized, le téléphone est connecté et en bonne santé — il manque seulement la boîte de dialogue de confirmation, ou elle a été refusée auparavant. Révoquer les autorisations la fait réapparaître.

1. Changez de câble. Les câbles USB-C de charge seule sont de loin la cause la plus fréquente.
2. Branchez directement sur le Mac ; évitez les hubs, les stations d'accueil et les ports des écrans.
3. adb kill-server puis adb devices pour relancer le démon.
4. Options pour les développeurs → Révoquer les autorisations de débogage USB, puis débranchez et rebranchez.
5. system_profiler SPUSBDataType | grep -i -A4 android — si rien n'apparaît ici, c'est un problème de matériel ou de câble, pas un problème d'ADB.

Débogage sans fil et appareils qui ne parlent pas ADB

Android 11 et versions ultérieures gèrent l'association en Wi-Fi avec un code à six chiffres, ce qui est vraiment utile quand le port USB est occupé ou que l'appareil est dans un banc de test. Le port d'association affiché sur le téléphone est temporaire et différent du port de connexion. Les deux machines doivent être sur le même sous-réseau — un Wi-Fi d'entreprise avec isolation des clients le bloque totalement. Dans l'application, le panneau Sans fil analyse le réseau via mDNS et accepte le code d'association ; et tant qu'un appareil est en USB, Raccourcis → Passer en sans fil effectue tout le basculement en un clic.

Par ailleurs, tous les appareils ne parlent pas ADB. Les Kindle et beaucoup d'appareils photo ou de lecteurs multimédias n'exposent leur stockage qu'en MTP, et Google a abandonné Android File Transfer, encore recommandé partout sur le web. Super ADB Manager comprend une section Appareils MTP qui parcourt et transfère les fichiers sur ces appareils sans ADB. Réserve : la session MTP peut se couper si l'appareil est débranché ou éjecté en cours de transfert, et il faut se reconnecter pour reprendre.

Prérequis et limites, dits clairement : version 0.6.0, Apple Silicon uniquement, macOS 13 Ventura ou plus récent, environ 27 MB, notarisée. L'enregistrement de l'écran repose sur le screenrecord d'Android et ne fonctionne pas sur certains appareils HONOR et Huawei. C'est un outil de gestion d'appareils et de journaux, pas un remplaçant du débogueur d'Android Studio — il n'y a ici ni points d'arrêt ni inspection de variables.

1. Téléphone : Options pour les développeurs → Débogage sans fil → Associer l'appareil à l'aide d'un code d'association.
2. Mac : adb pair 192.168.1.20:41234 puis saisissez le code à six chiffres.
3. adb connect 192.168.1.20:5555 pour vous attacher et travailler normalement avec ADB.
4. Ou utilisez le panneau Sans fil de l'application : lancez l'analyse, touchez l'appareil, tapez le code.

FAQ

Plus de guides