Pour installer un APK avec ADB, branchez le téléphone avec le débogage USB activé, vérifiez qu’il apparaît avec adb devices, puis tapez adb install chemin\vers\appli.apk. Après quelques secondes, le message Success confirme l’installation. Pour mettre à jour une application en gardant ses données, ajoutez -r ; pour revenir à une version antérieure, -d ; pour accorder toutes les permissions d’un coup, -g. Les applications découpées en plusieurs fichiers (APKS, XAPK) s’installent avec adb install-multiple. Les erreurs INSTALL_FAILED ont presque toutes une cause simple, détaillée plus bas.
Prérequis
- Les Platform-Tools de Google installés sur le PC, disponibles sur developer.android.com. Méthode complète dans notre guide ADB.
- Les options pour les développeurs et le débogage USB activés sur le téléphone.
- Le téléphone reconnu :
adb devices
List of devices attached
R58M12ABCDE device
Si la liste est vide ou affiche « unauthorized », suivez adb devices vide ou unauthorized.
La commande adb install pas à pas
- Placez l’APK dans un dossier simple, par exemple
C:\apk\. - Ouvrez une invite de commandes dans le dossier
platform-tools(ou n’importe où si adb est dans le PATH, voir driver ADB Windows). - Tapez :
adb install C:\apk\appli.apk
- Attendez « Performing Streamed Install » puis Success.
- L’application apparaît dans le tiroir d’applications.
Astuce : vous pouvez glisser le fichier APK dans la fenêtre de commande après avoir tapé adb install (avec l’espace) ; Windows colle le chemin complet. Si le chemin contient des espaces, mettez-le entre guillemets.
Les options utiles de adb install
| Option | Rôle | Exemple |
|---|---|---|
| -r | Réinstaller en conservant les données | adb install -r appli.apk |
| -d | Autoriser une version plus ancienne (downgrade) | adb install -r -d appli.apk |
| -g | Accorder toutes les permissions déclarées | adb install -g appli.apk |
| -t | Autoriser un APK de test (testOnly) | adb install -t appli.apk |
| —user 0 | Installer pour l’utilisateur principal | adb install --user 0 appli.apk |
| -s | Choisir un appareil quand plusieurs sont branchés | adb -s R58M12ABCDE install appli.apk |
Le downgrade avec -d fonctionne surtout pour les applications installées par vous. Pour les applications système, Android le refuse généralement.
Installer un APKS, XAPK ou des splits : install-multiple
Beaucoup d’applications du Play Store sont livrées en plusieurs morceaux : un APK de base et des APK de configuration (processeur, langue, densité d’écran). Un fichier .apks ou .xapk est une archive qui les regroupe.
- Renommez l’archive en
.zipet décompressez-la. - Repérez
base.apket les fichierssplit_config...apk. - Installez tout en une seule commande :
adb install-multiple base.apk split_config.arm64_v8a.apk split_config.fr.apk split_config.xxhdpi.apk
Installer seulement base.apk provoque souvent une application qui plante au démarrage. Si cela vous arrive, lisez aussi que faire si mon application se ferme toute seule.
Les erreurs adb install et leurs solutions
| Erreur | Cause | Solution |
|---|---|---|
| INSTALL_FAILED_ALREADY_EXISTS | L’application est déjà installée | Ajouter -r |
| INSTALL_FAILED_VERSION_DOWNGRADE | L’APK est plus ancien que la version installée | Ajouter -r -d, ou désinstaller d’abord |
| INSTALL_FAILED_UPDATE_INCOMPATIBLE | Signature différente de l’application installée | Désinstaller l’ancienne (données perdues), puis installer |
| INSTALL_FAILED_NO_MATCHING_ABIS | APK compilé pour un autre processeur (x86 au lieu d’ARM) | Récupérer la version arm64-v8a ou armeabi-v7a |
| INSTALL_FAILED_OLDER_SDK | Version d’Android trop ancienne pour l’application | Trouver une version compatible de l’APK |
| INSTALL_FAILED_INSUFFICIENT_STORAGE | Pas assez d’espace | Libérer du stockage |
| INSTALL_FAILED_TEST_ONLY | APK de test | Ajouter -t |
| INSTALL_PARSE_FAILED_NO_CERTIFICATES | APK non signé ou abîmé | Retélécharger un APK complet et signé |
| INSTALL_FAILED_USER_RESTRICTED | Installation par USB bloquée par le téléphone | Activer « Installer via USB » dans les options développeur (Xiaomi) |
Sur les Xiaomi, Redmi et POCO, l’option « Installer via USB » des options pour les développeurs est souvent désactivée par défaut et demande un compte Xiaomi connecté. Sur certains Oppo et Realme, une confirmation s’affiche à l’écran : acceptez-la pendant que la commande attend.
Cas particuliers : plusieurs appareils, émulateur, Android TV, Wi-Fi
Plusieurs appareils branchés. Adb refuse d’installer et affiche « more than one device/emulator ». Listez les appareils avec adb devices puis ciblez le bon numéro de série :
adb -s R58M12ABCDE install appli.apk
Émulateur Android Studio. L’émulateur apparaît comme emulator-5554. L’option -e vise l’émulateur, -d (placée avant install) vise l’appareil USB : adb -e install appli.apk.
Android TV, box et Fire TV. Ces appareils n’ont pas toujours de port USB accessible. Activez le débogage réseau dans les options pour les développeurs, notez l’adresse IP, puis :
adb connect 192.168.1.20:5555
adb install appli.apk
Débogage sans fil (Android 11 et plus). Sur téléphone, le débogage sans fil demande un appairage avec adb pair et le code affiché, puis adb connect. L’installation se fait ensuite exactement comme en USB, un peu plus lentement pour les gros fichiers.
Copier l’APK sans l’installer. Si vous préférez installer à la main depuis le gestionnaire de fichiers du téléphone, envoyez simplement le fichier : adb push appli.apk /sdcard/Download/.
Désinstaller une application avec adb
Il faut le nom du paquet, pas le nom affiché.
adb shell pm list packages | findstr nomappli
adb uninstall com.exemple.appli
Sous macOS et Linux, remplacez findstr par grep. L’option -k (adb uninstall -k) conserve les données et le cache, mais elle n’est plus prise en charge sur toutes les versions d’Android.
Bonnes pratiques de sécurité
- N’installez que des APK de sources fiables : un APK modifié peut contenir un logiciel malveillant.
- Gardez Google Play Protect actif : il analyse aussi les applications installées par adb.
- Désactivez le débogage USB une fois terminé.
Pour aller plus loin avec adb, consultez nos 20 commandes ADB essentielles et, pour installer une mise à jour système complète, adb sideload.
Photo d’en-tête : Ka Kit & Google, Wikimedia Commons (CC BY 2.5).
Questions fréquentes.
Comment installer un APK avec ADB ?
Activez le débogage USB, branchez le téléphone, vérifiez qu'il apparaît avec adb devices, puis tapez adb install suivi du chemin du fichier, par exemple adb install C:\apk\appli.apk. Le message Success confirme l'installation.
Comment mettre à jour une application déjà installée avec adb ?
Utilisez adb install -r appli.apk. L'option -r remplace l'application en conservant ses données, à condition que le nouvel APK soit signé avec la même clé.
Que faire en cas d'erreur INSTALL_FAILED_UPDATE_INCOMPATIBLE ?
L'APK n'est pas signé avec la même clé que l'application installée. Il faut désinstaller l'ancienne version (adb uninstall nom.du.paquet), ce qui efface ses données, puis installer la nouvelle.
Comment installer un fichier APKS ou XAPK avec adb ?
Ces formats regroupent plusieurs APK (splits). Décompressez l'archive et installez tous les APK en une fois avec adb install-multiple base.apk split_config.arm64_v8a.apk split_config.fr.apk.
Commentaires
Chargement…