Magisk Manager

Étapes rapides

  1. Téléchargez les SDK Platform-Tools de Google pour votre ordinateur et décompressez-les.
  2. Sur le téléphone, activez le Débogage USB dans les options pour les développeurs.
  3. Ouvrez un terminal dans le dossier platform-tools et exécutez adb devices.
  4. Appuyez sur Autoriser dans la fenêtre Autoriser le débogage USB ? du téléphone.
  5. Pour tester fastboot, exécutez adb reboot bootloader, puis fastboot devices.

Que sont ADB et fastboot ?

ADB (Android Debug Bridge) communique avec votre téléphone pendant qu’Android fonctionne. Il sert à copier des fichiers, à installer des applications et à redémarrer le téléphone dans d’autres modes.

Fastboot communique avec le bootloader du téléphone. Il sert à déverrouiller le bootloader et à flasher des images, comme l’image de démarrage que patche Magisk.

Les deux font partie du paquet gratuit SDK Platform-Tools de Google. Téléchargez-le uniquement depuis le site de Google. Les paquets « Minimal ADB » proposés sur d’autres sites sont souvent obsolètes, et certains ont été fournis avec des logiciels indésirables.

Installer ADB et fastboot sur Windows

  1. Téléchargez les Platform-Tools

    Ouvrez la page Platform-Tools de Google, téléchargez SDK Platform-Tools pour Windows et acceptez les conditions.

  2. Décompressez l’archive

    Extrayez le zip dans un chemin court comme C:\platform-tools. Les chemins longs et les noms de dossiers contenant des caractères spéciaux peuvent provoquer des erreurs.

  3. Ouvrez un terminal dans le dossier

    Ouvrez le dossier dans l’Explorateur de fichiers, cliquez dans la barre d’adresse, tapez cmd et appuyez sur Entrée. Une invite de commandes s’ouvre dans ce dossier. Dans PowerShell ou Windows Terminal, faites précéder chaque commande de .\, par exemple .\adb devices.

  4. Installez le pilote USB

    Windows installe généralement un pilote automatiquement. Sinon, installez le pilote USB Google pour les téléphones Pixel, ou le pilote USB du fabricant de votre téléphone pour les autres marques.

  5. Facultatif : ajoutez-le au PATH

    Pour exécuter adb depuis n’importe quel dossier, recherchez Modifier les variables d’environnement système dans Windows, ouvrez Variables d’environnement, sélectionnez Path, choisissez Modifier et ajoutez C:\platform-tools. Ouvrez ensuite un nouveau terminal.

Installer ADB et fastboot sur macOS

Le plus simple est d’utiliser Homebrew :

brew install --cask android-platform-tools

Sans Homebrew, téléchargez SDK Platform-Tools pour Mac depuis la page Platform-Tools de Google, décompressez l’archive, ouvrez le Terminal dans le dossier platform-tools et faites précéder chaque commande de ./, par exemple ./adb devices. Les Mac n’ont pas besoin de pilote USB.

Installer ADB et fastboot sur Linux

La plupart des distributions proposent les deux outils sous forme de paquets :

DistributionCommande
Debian, Ubuntu, Linux Mintsudo apt install adb fastboot
Fedorasudo dnf install android-tools
Arch Linuxsudo pacman -S android-tools

Ces paquets peuvent être en retard sur les versions de Google. Si fastboot échoue sur un téléphone récent, téléchargez SDK Platform-Tools pour Linux depuis la page Platform-Tools de Google et exécutez ./adb et ./fastboot depuis le dossier décompressé.

Si adb devices indique no permissions, votre utilisateur n’a pas le droit d’accéder au téléphone par USB. Sur Debian et Ubuntu, le paquet android-sdk-platform-tools-common ajoute les règles qui corrigent ce problème. Débranchez puis rebranchez ensuite le téléphone.

Connecter votre téléphone

  1. Activez le débogage USB

    Activez les options pour les développeurs (appuyez sept fois sur Numéro de build dans Paramètres → À propos du téléphone), puis activez le Débogage USB dans les options pour les développeurs.

  2. Connectez le téléphone et autorisez l’ordinateur

    Connectez le téléphone avec un câble USB qui transfère les données. Certains câbles bon marché ne font que charger. Exécutez :

    adb devices
    

    Le téléphone affiche Autoriser le débogage USB ?. Cochez Toujours autoriser sur cet ordinateur et appuyez sur Autoriser.

  3. Vérifiez le résultat

    Exécutez à nouveau adb devices. Le numéro de série de votre téléphone doit apparaître avec le mot device. S’il indique unauthorized, déverrouillez l’écran du téléphone et acceptez la demande.

  4. Testez fastboot

    Redémarrez dans le bootloader et vérifiez que fastboot détecte le téléphone :

    adb reboot bootloader
    
    fastboot devices
    

    Exécutez fastboot reboot pour revenir à Android.

Les commandes que vous utiliserez avec Magisk

CommandeCe qu’elle fait
adb devicesListe les téléphones connectés
adb reboot bootloaderRedémarre le téléphone dans le bootloader (mode fastboot)
adb pull /sdcard/Download/file.imgCopie un fichier du téléphone vers l’ordinateur
adb push file.img /sdcard/Download/Copie un fichier de l’ordinateur vers le téléphone
fastboot devicesListe les téléphones en mode fastboot
fastboot flash init_boot file.imgFlashe une image sur une partition, ici init_boot
fastboot rebootRedémarre le téléphone sous Android

Les étapes complètes pour rooter se trouvent dans le guide principal : comment rooter votre téléphone avec Magisk.

Erreurs ADB et fastboot courantes

adb devices n’affiche rien. Essayez un autre câble et un autre port USB, de préférence directement sur l’ordinateur plutôt que sur un hub. Sur le téléphone, réglez le mode USB sur Transfert de fichiers. Sous Windows, réinstallez le pilote USB.

L’appareil apparaît comme « unauthorized ». Déverrouillez le téléphone et acceptez la fenêtre Autoriser le débogage USB ?. Si elle n’apparaît pas, appuyez sur Annuler les autorisations de débogage USB dans les options pour les développeurs, puis reconnectez le téléphone.

« 'adb' n’est pas reconnu en tant que commande interne ou externe ». Windows ne trouve pas adb. Ouvrez le terminal dans le dossier platform-tools, ou ajoutez ce dossier au PATH. Dans PowerShell, tapez .\adb.

« command not found: adb » sur Mac ou Linux. Exécutez ./adb dans le dossier platform-tools, ou installez les outils avec Homebrew ou votre gestionnaire de paquets.

ADB fonctionne, mais fastboot n’affiche rien ou indique « waiting for any device ». Vérifiez que le téléphone affiche l’écran du bootloader. Sous Windows, ouvrez le Gestionnaire de périphériques pendant que le téléphone est dans le bootloader : si un appareil porte une icône d’avertissement, mettez à jour son pilote et choisissez Android Bootloader Interface.

« Flashing is not allowed in Lock State ». Le bootloader est toujours verrouillé. Déverrouillez-le d’abord.

Questions fréquentes

Ai-je besoin d’Android Studio pour utiliser ADB ?

Non. Les SDK Platform-Tools de Google sont un petit téléchargement séparé qui contient adb et fastboot. Vous n’avez besoin ni d’Android Studio ni du SDK Android complet.

Est-il sûr d’utiliser ADB ?

Oui. ADB et fastboot sont les outils officiels de Google. Le débogage USB permet à un ordinateur que vous avez autorisé de contrôler votre téléphone : n’autorisez donc que des ordinateurs de confiance, et désactivez le débogage USB une fois que vous avez terminé.

Puis-je utiliser ADB en Wi-Fi ?

Oui. Android 11 et les versions ultérieures proposent le Débogage sans fil dans les options pour les développeurs. Fastboot nécessite toutefois un câble USB sur presque tous les téléphones : utilisez donc un câble pour installer Magisk.

Pourquoi utiliser la dernière version des Platform-Tools ?

Les anciennes versions de fastboot peuvent échouer sur les téléphones récents. Google met régulièrement à jour les Platform-Tools : téléchargez donc la dernière version plutôt qu’une copie trouvée sur un autre site.