Magisk - Installation

Mise à jour : Magisk 23.0

• Ce document décrit l'installation de Magisk, l'utilisation est décrite dans le document Magisk - Utilisation
  

Références

• Magisk sur Github
• Magisk Documentation
• Magisk Installation
• Forum Magisk xda-developer - Obsolète

Sommaire

1 - Préalable

• Dans ce qui suit, on suppose
  
• que l'on dispose d'un PC sous linux avec Android Debug Bridge installé
• et que, au niveau du périphérique Android,
  
• le chargeur de démarrage a été déverrouillé
• le mode développeur est activé
• la ROM à enraciner est installée
• optionnellement, TWRP est installé dans la partition de récupération

• Aucune application fournissant les droits root ne doit-être présente préalablement à l'installation de Magisk. Pour le vérifier, utiliser
  
• soit la ligne de commande (dans le cas présent, Magisk est présent)

gts210velte:/ $ su --help
MagiskSU
....

• soit une application dédiée telle que Root Checker (com.andreacioccarelli.rootchecker), disponible dans le Play Store
  
• La partition de boot ne doit pas avoir été modifiée. En cas de doute, (magisk, nanodroid patcher modifient la partition de boot), reflasher la partition de boot (ou la ROM complète)

• Dans ce qui suit, on suppose que le périphérique ne dispose pas d'un double système de partition A/B, pour vérifier ce point, vérifier que la commande suivante ne retourne pas "true"
  

$ adb shell getprop ro.build.ab_update

2 - Installation

2.1 - Principe

L'installation comprend deux étapes principales

• l'installation de l'application Magisk, interface opérateur du programme Magisk
  
• l'installation du programme Magisk qui s'effectue en modifiant (patchant) la partition de boot

2.2 - Installation de l'application

• Télécharger depuis https://github.com/topjohnwu/Magisk/releases, la dernière version de l'application, dans le cas présent, la la version V23

$ wget https://github.com/topjohnwu/Magisk/releases/download/v23.0/Magisk-v23.0.apk

et l'installer sur le périphérique

$ adb install Magisk-v23.0.apk

• S'assurer que le périphérique est connecté à internet (nécessaire pour la mise à jour et le téléchargement de Magisk) avant de lancer l'application.
• Sur la page d’accueil de Magisk, dans la section intitulée Application, cliquer sur Installer. L'application est mise à jour (la référence de la version installée doit-être identique à la référence indiquée dans la ligne dernière (version)

2.3 - Préparation de l'image boot patchée

• Vérifier que le périphérique a une Ramdisk d'amorçage - Message Ramdisk Oui. Si ce n'est pas le cas, voir la documentation d'installation officielle Magisk.
• Si le périphérique dispose bien d'une Ramdisk d'amorçage, récupérer le fichier image de la partition de boot. Pour cela, dans le cas d'une ROM LineageOS,
  

• désarchiver le fichier zip lineageos
  

$ unzip lineage-18.1-20210923-nightly-a5y17lte-signed.zip

• le fichier image de la partition de boot est nommé boot.img

$ ls
boot.img  install  META-INF  system.new.dat.br  system.patch.dat  system.transfer.list

• le recopier sur le périphérique, par exemple dans le répertoire Download du stockage interne

$ adb push boot.img /sdcard/Download

• Toujours dans la section Magisk,
  
• cliquer sur Installer
• puis sélectionner l'option"Sélectionner le fichier cible du correctif"
• puis cliquer sur "C'est parti -->" et sélectionner le fichier boot.img
  
• Magisk génère une image boot patchée dans le répertoire /sdcard/Download

$ adb shell ls -l /sdcard/Download |grep magisk_patched
-rw-rw---- 1 root everybody 21585920 2021-09-26 14:41 magisk_patched-23000_cwLk4.img

• Le flashage de la partition de boot avec l'image patchée par magisk peut s'effectuer soit en mode récupération TWRP, soit en mode Bootloader ou Samsung Download)

2.4 - Flashage en mode récupération TWRP

• Redémarrer en mode récupération

$ adb reboot recovery

• Via l'interface TWRP,
  
• choisir l'option Installer, les fichiers .zip du répertoire courant s'affichent
  
• dans le menu qui s'affiche, cliquer sur l'option Installer l'image afin de faire apparaître les fichiers .img du répertoire courant
• naviguer vers le répertoire /sdcard/Download dans lequel est stocké l'image patchée par Magisk
• cliquer sur Installer l'Image pour faire apparaître la liste des fichiers .img
• sélectionner le fichier créé par Magisk
• dans le menu qui s'affiche "Installer l'image", sélectionner la partition où écrire l'image : Amorçage (ou boot en anglais)
• glisser pour confirmer le flash
• Redémarrer en mode système
  

2.5 - Flashage en mode Download

• Recopier l'image boot patchée sur le PC

$ adb pull /sdcard/Download/magisk_patched-23000_cwlk4.img

• Noter le numéro et le nom de la partition de boot,
  
• dans l'exemple ci-dessous, samsung A5 (2017), partition 10, nom BOOT
  

$ adb root
$ adb shell "find /dev/block -iname boot -exec ls -l {} \;"
lrwxrwxrwx 1 root root 21 2021-09-28 23:01 /dev/block/by-name/BOOT -> /dev/block/mmcblk0p10
lrwxrwxrwx 1 root root 21 2021-09-28 23:01 /dev/block/platform/13540000.dwmmc0/by-name/BOOT -> /dev/block/mmcblk0p10

• dans cet autre exemple, samsung Tab S2 9.7, partition 18, nom boot
  

$ adb shell "find /dev/block -iname boot -exec ls -l {} \;"
lrwxrwxrwx 1 root root 21 2017-02-21 07:37 /dev/block/by-name/boot -> /dev/block/mmcblk0p18
lrwxrwxrwx 1 root root 21 2017-02-21 07:37 /dev/block/platform/soc.0/7824900.sdhci/by-name/boot -> /dev/block/mmcblk0p18

• Redémarrer en mode download

$ adb reboot download

• Utiliser fastboot ou heimdall pour flasher la partition boot.
  
• Dans le cas du périphérique Samsung A5 ci-dessus

$ heimdall flash --BOOT magisk_patched-xxxxxxxxx.img

• Dans le cas du périphérique Samsung Tab S2 ci-dessus
  

$ heimdall flash --boot magisk_patched-yyyyyyyy.img

• Redémarrer en mode système
  

2.6 - Vérification

Ouvrir l'application Magisk, la connexion internet étant active, dans la zone Magisk, un numéro de version doit-apparaître en face de Installé. Ce numéro de version est identique à celui indiqué dans la zone Application

3 - Mises à jour et suppression

3.1 - Mise à jour de Magisk

Les mises à jour de Magisk sont automatiquement détectées et proposées.

• Pour mettre à jour l'application, simplement cliquer sur Installer dans la zone "Application"
  
• Pour mettre à jour Magisk,
  
• cliquer sur Installer
• cliquer sur Installation directe (recommandée)
• cliquer sur "C'est parti"
• cliquer sur Redémarrer
  

3.2 - Mise à jour de la ROM

A chaque mise à jour de la ROM ou de la partition de boot, il est nécessaire de réinstaller "manuellement" l'image patchée par Magisk de la partition de boot. Ceci peut s'effectuer directement sur le périphérique, sans le raccorder à un PC

• En mode Système
• Identifier l'emplacement de stockage du fichier (.zip) de la ROM. Dans le cas des mises à jour de lineageOS, depuis le menue Paramètre > Système >Préférences avancées > Système >Gestionnaire de mise à jour : Sélectionner la version installée de LineageOS et l'option Exporter, le fichier est copié dans le répertoire /sdcard/ LineageOS updates
• Puis désarchiver l'image, par exemple au moyen d'un explorateur de fichier compatible, le fichier boot.img devient disponible
  
• Lancer Magisk et créer le fichier boot patché comme décrit précédemment lors de l'Installation
  
• Redémarrer en mode récupération et flasher l'image comme indique précédemment pour le flashage en mode Récupération

3.3 - Suppression

Pour supprimer Magisk, cliquer sur la page d'accueil de Magisk, sur l'option Désinstaller Magisk. Noter que la désinstallation, supprime le gestionnaire de l'application, le programme et tous les modules Magisk éventuellement installés