adb install : installer un APK avec ADB depuis le PC
· 5 min de lecture · how to

adb install : installer un APK avec ADB depuis le PC

Tapez adb install chemin/appli.apk. Options -r, -d et -g, installation des splits avec install-multiple et solutions aux erreurs INSTALL_FAILED.

adb install : installer un APK avec ADB depuis le PC

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

  1. Les Platform-Tools de Google installés sur le PC, disponibles sur developer.android.com. Méthode complète dans notre guide ADB.
  2. Les options pour les développeurs et le débogage USB activés sur le téléphone.
  3. 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

  1. Placez l’APK dans un dossier simple, par exemple C:\apk\.
  2. Ouvrez une invite de commandes dans le dossier platform-tools (ou n’importe où si adb est dans le PATH, voir driver ADB Windows).
  3. Tapez :
adb install C:\apk\appli.apk
  1. Attendez « Performing Streamed Install » puis Success.
  2. 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.

Smartphone Android Blackview A60 et son étui
Smartphone Android Blackview A60 et son étui. Photo : Acabashi, Wikimedia Commons (CC BY-SA 4.0)

Les options utiles de adb install

OptionRôleExemple
-rRéinstaller en conservant les donnéesadb install -r appli.apk
-dAutoriser une version plus ancienne (downgrade)adb install -r -d appli.apk
-gAccorder toutes les permissions déclaréesadb install -g appli.apk
-tAutoriser un APK de test (testOnly)adb install -t appli.apk
—user 0Installer pour l’utilisateur principaladb install --user 0 appli.apk
-sChoisir un appareil quand plusieurs sont branchésadb -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.

  1. Renommez l’archive en .zip et décompressez-la.
  2. Repérez base.apk et les fichiers split_config...apk.
  3. 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.

Google Pixel 8 Pro et Pixel 7 Pro, sur lesquels adb install s'utilise de la même façon
Google Pixel 8 Pro et Pixel 7 Pro, sur lesquels adb install s'utilise de la même façon. Photo : SimonWaldherr, Wikimedia Commons (CC BY-SA 4.0)

Les erreurs adb install et leurs solutions

ErreurCauseSolution
INSTALL_FAILED_ALREADY_EXISTSL’application est déjà installéeAjouter -r
INSTALL_FAILED_VERSION_DOWNGRADEL’APK est plus ancien que la version installéeAjouter -r -d, ou désinstaller d’abord
INSTALL_FAILED_UPDATE_INCOMPATIBLESignature différente de l’application installéeDésinstaller l’ancienne (données perdues), puis installer
INSTALL_FAILED_NO_MATCHING_ABISAPK compilé pour un autre processeur (x86 au lieu d’ARM)Récupérer la version arm64-v8a ou armeabi-v7a
INSTALL_FAILED_OLDER_SDKVersion d’Android trop ancienne pour l’applicationTrouver une version compatible de l’APK
INSTALL_FAILED_INSUFFICIENT_STORAGEPas assez d’espaceLibérer du stockage
INSTALL_FAILED_TEST_ONLYAPK de testAjouter -t
INSTALL_PARSE_FAILED_NO_CERTIFICATESAPK non signé ou abîméRetélécharger un APK complet et signé
INSTALL_FAILED_USER_RESTRICTEDInstallation par USB bloquée par le téléphoneActiver « 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).

FAQ

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.

Issues de secours Si cette procédure n’a pas suffi

  1. 01outils-logicielsLes 21 procédures de cette rubrique, de la plus sûre à la plus invasive.→
  2. 02Comparer les méthodes de récupérationGratuit ou non, root nécessaire ou non, téléphone éteint ou non : le tableau des critères qui décident.→
  3. 03Application qui se ferme toute seule sur Android : solutionsLe dossier le plus complet de cette rubrique.→
À lire aussi

Continuer la lecture.

Commentaires

Chargement…

Modération manuelle. Aucun lien autorisé.