Flaz's Hotline

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Installation de LineageOS sur Honor 5x ======
===== Discussion =====
Le développement de CyanogenMod (CM) a été arrêté. LineageOS en prend la suite. Techniquement parlant, il en est la continuation((Fork.)).
==== Pourquoi ? ====
Les arguments en faveur du remplacement du système propriétaire d'origine par un système open source sont les mêmes que pour un ordi. LineageOS présente les mêmes avantages que ceux que présentait CM, en son temps.

Pour les personnes ayant déjà installé CM, il est impératif de le remplacer par LineagesOS. Pour des raisons élémentaires de sécurité, on ne peut pas se reposer sur un système qui n'est plus maintenu! De plus, LineageOS permettra de bénéficier de versions récentes d'Android.

==== Migration de CM à LineageOS ====
Certains androphones bénéficient d'une [[http://www.cyanogenmods.org/forums/topic/update-lineage-os-13-14-1-on-cyanogenmod-13-14-1-rom/|procédure de migration]] de CM à LineageOS qui permet de changer le système sans perdre ses données((EXPERIMENTAL build.)). Ce n'est pas le cas du Honor 5x. On doit donc réaliser une installation complète qui entraînera l'effacement de toutes les données internes.
===== Préparation de l'installation =====
La cas d'utilisation décrit ci-après est celui d'une installation de LineageOS en remplacement de la dernière mise à jour disponible de CM13 disponible pour le Honor 5x.

On peut tout faire depuis son androphone mais nous allons partir du principe qu'on utilise un ordi.
  - [[https://download.lineageos.org/kiwi|Télécharger]] la dernière version((Au moment de la rédaction, il s'agissait de la version 14.1 qui incorpore Android 7.1.1 Nougat.)) officielle de LineageOS pour Honor 5x (≈ 480 Mo)
  - [[https://download.lineageos.org/extras|Télécharger]] l'extension SU((Par défaut, LineageOS est rootable mais n'est pas rooté. Cette extension active le mode rooté. Une extension similaire permet de dé-rooté.)) correspondant à la version du système installée
  - [[http://opengapps.org/|Télécharger]] la dernière version d'OpenGapps pour la version de LineageOS choisie à l'étape précédente((Au moment de la rédaction, pour Honor 5x : arm64, 7.1, nano.)).
  - Vérifier les sommes de contrôle (md5) des fichiers
  - Copier les fichiers sur la carte SD (Ordi -> SD)
  - Vérifier les md5 des fichiers copiés sur la carte (voir alternatives)
    - Copier les fichiers en sens inverse (SD -> Ordi)
    - Vérifier les md5 des fichiers ainsi recopiés
<note important>À la différence de CyanogenMod, LineageOS ne s'utilise pas conjointement à l'app SuperSU. Il faut utiliser l'extension système SU indiquée précédemment.L'installation de SuperSU risque d'entraîner des dysfonctionnement ((Allant jusqu'à rendre le démarrage impossible (boot loop) !)).</note>

==== Vérification des md5 sur la carte SD ====
La vérification des md5 peut s'effectuer directement sur l'androphone.
=== Vérification manuelle ===
Si votre androphone est équipé d'une App (par exemple [[https://play.google.com/store/apps/details?id=com.estrongs.android.pop&hl=en|ES File Explorer]]) permettant de calculer la somme de contrôle (md5) des fichier copiés, Cette option est intéressante si l'on télécharge directement sur l'androphone, sans passer par un ordi.
=== Vérification automatique ===
Une fois le fichier téléchargé sur l'ordi, on peut enregistrer la somme de contrôle dans un fichier texte. Dans un terminal, on tapera la commande suivante :
<code>
$ md5sum mon_fichier_téléchargé.zip > mon_fichier_téléchargé.zip.md5
</code>
On procède ainsi pour les trois fichiers téléchargés. On dispose alors de trois fichiers //zip// et de trois fichiers //md5//. On copie ces six fichiers sur la carte SD.

Lorsqu'on demandera au Recovery d'installer un fichier //zip// présent sur la carte SD, il trouvera lui-même le fichier //md5// associé et vérifiera automatiquement que la somme de contrôle est correcte, c'est-à-dire que le fichier n'a pas été altéré lors de l'enregistrement sur la carte SD.
===== Installation =====
==== Pré-requis ====
Les pré-requis sont les mêmes que pour installer n'importe quelle ROM custom sur le Honor 5x :
  * bootloader déverouillé
  * custom recovey [[phone:full-control-honor-5x#installer_un_custom_recovery|installé]]
  * batterie chargée

==== Procédure ====
<note warning>Effectuer une sauvegarde sur la carte SD((Alternativement, on peut [[http://www.titaniumtrack.com/kb/titanium-backup-kb/titanium-backup-howtos.html#backup-without-root|le faire sur l'ordi]], via l'application adb et un câble USB.)) des applications et données (Titanium Backup). Cette sauvegarde permet de restaurer les données dans le nouveau système.</note>
  - Démarrer le Honor 5x en mode recovery
    - Faire une sauvegarde du système. Cette sauvegarde permet une restauration intégrale en cas d'échec de d'installation.
    - Faire une remise à zéro des réglages du système : Wipe (le wipe proposé par défaut par TWRP)
    - Installer la ROM
    - Installer les Gapps
    - Installer l'extension SU
  - Redémarrer le Honor 5x
  - Activer le mode Développeur((Tapoter 7 fois sur ne n° de //build//.))
  - Entrer dans Paramètres > Options pour les développeurs
    - [[http://www.cyanogenmods.org/forums/topic/how-to-root-lineage-os-13-14-1-marshmallow-nougat-rom/|activer le mode Root]] (Root access)
    - autoriser le debug Android (ex-debug USB)
  - Dans les paramètres de sécurité
    - autoriser les sources inconnues (Titanium Backup restore)
===== Mise à jour =====
**Le premier [re]démarrage après une mise à jour est inhabituellement long. Ne pas s'alarmer.**
==== Mise à jour OTA ====
LineageOS signale automatiquement l'existence de mises à jour que l'on peut télécharger via le réseau(("Over The Air", d'où le sigle "OTA".)). Vu la taille des fichiers à télécharger, faites la mise jour à travers une connexion WiFi. Ces mises à jour apportent des améliorations et des correctifs à la version déjà installée. Elles ne permettent pas de passer de la version 13 (Android 6) à la version 14 (Android 7).

Lorsqu'une mise à jour est signalée, il suffit de la lancer. Tout se fera automatiquement jusqu'au moment où le Recovery présentera un écran permettant de rebooter l'androphone.
<note tip>À la différence de CM, ces mises à jour ne demandent pas la réinstallation de //SU//.</note>
==== Mise à jour manuelle ====
À la date de la rédaction, je n'ai réalisé aucune mise à jour manuelle. Dans ce cas, le surcoût de reflashage de l'extension //SU// étant minime j'aurais tendance à l'effectuer…
===== Montée de version de LineageOS 14.1 vers 15.1 (upgrade) =====
sources :
  * [[https://wiki.lineageos.org/upgrading.html|Upgrading LineageOS]] (en) (lineageos.org)
  * [[phone:full-control-honor-5x#installer_le_nouveau_systeme|Installer un nouveau système]] sur un Honor 5X

==== Avertissements ====
<note important>La marche à suivre diffère selon que vous utilisiez ou non les Open GApps((Version open source des Google Apps.)), sur votre version actuelle de LineageOS.</note>

<note>Cette procédure a été validée pour une montée de version de Lineage0S 14.1 vers 15.1, sur un Honor-5X KIW-21 utilisant les Open Gapps (1er janvier 2019).
</note>

<note important>Utilisant le recovery TWRP3.0.2-0, l'installation de la mise à jour officielle, téléchargée depuis le serveur de LineageOS échoue((Le script d'installation intégré dans la mise à jour vérifie que la mise à jour est bien celle qui convient pour le Honor 5X (kiwi). Or TWRP n'est pas capable de fournir au script le type d'appareil. Le script compare donc la chaîne de caractères "kiwi" à "" (chaîne vide) et, concluant que ce n'est pas le même appareil,  bloque proprement l'installation, sans créer le moindre dommage.)). J'ai utilisé une solution de contournement qui fonctionne parfaitement((Je n'ai pas pris le temps d'analyser plus avant les solutions plus élégantes. Je ne serais très surprise que le problème persiste si on flashe une version plus récente de //TWRP// ou le //recovery// maison de LineageOS.)).</note>

<note warning>Comme c'était à craindre, le contournement évoqué dans la note précédente ne fonctionne que pour la mise à jour manuelle. Les mises à jour OTA suivantes échoueront systématiquement. Le passage à une version plus évoluée de TWRP((Au 2 janvier 2019, la dernière version est la 3.2.3-0.)) ou d'un recovery permettant une exécution correcte du script d'installation natif est donc indispensable. Je recommande donc de commencer par ça. La procédure décrite ci-dessous restera valable. Il suffira de sauter les étapes concernant le patch de la mise à jour.</note>

L'application de mise à jour OTA signale la montée de version mais ne permet pas de l'effectuer. Il faut procéder à une installation manuelle. Tout peut se faire depuis votre androphone mais il est préférable((Si vous êtes à l'aise pour faire toutes les opérations nécessaires avec votre seul androphone, vous savez ce que vous faites ;-) )) d'utiliser un ordi relié à l'androphone.
==== Procédure ====
<note warning>Cette procédure n'a pas conduit à un système durablement stable. L'upgrade de LOS 14 à LOS 15 kiwi s'est avéré être un échec cuisant. Une procédure de //première installation// a été nécessaire pour obtenir un système stable.</note>
Pour ce type d'opération, il est vivement conseillé de lire l'intégralité de la prcédure avant de commencer à l'éxécuter.
  - sur le Honor 5X, faire des captures d'écran de l'écran d'accueil et des écrans satellites
  - sur l'ordi
    - télécharger :
      * [[https://download.lineageos.org/kiwi|la dernière mise à jour de la version de LineageOS]] vers laquelle on souhaite monter
      * la somme de contrôle sha256 correspondante
      * le [[https://download.lineageos.org/extras|LineageOS su add-on]] correspondant à la version téléchargée
      * la somme de contrôle sha256 correspondante
      * les [[https://opengapps.org/|Open GApps]]
      * le somme de contrôle md5 correspondante
    - **vérifier les sommes de contrôles** des trois fichiers téléchargés (ne jamais sauter cette étape !)
  - patcher la sauvegarde (contournement des limites de TWRP 3.0.2-0)
    - dezipper la mise à jour de LineageOS dans un répertoire vierge, créé à cet effet
    - éditer le fichier META-INF/com/google/android/updater-script((Les amatrices de //sed// feront cette opération et les deux suivantes d'un seul coup, avec une fiabilité accrue : sed -i '/assert/d' ./META-INF/com/google/android/updater-script))
    - supprimer les deux premières lignes, celles qui font appel à la fonction //assert//
    - enregistrer le fichier modifié en écrasant le fichier d'origine
    - recomposez l'archive zip en respectant la structure du zip initial (ne pas enregistrer la racine !)
    - mettre de côté le zip initial et renommer le zip modifié du même nom
  - générer les sommes de contrôle md5 pour les fichiers de mise à jour de //LineageOS//(modifié) et //su add-on//
  - si besoin, charger le Honor 5X à 60%
  - relier le Honor 5X à l'ordi par un câble USB
  - effectuer une sauvegarde intégrale des vos applications et de vos données (Titanium Backup)
  - activer le Débogage Android : Paramètres > Options pour les développeurs > Débogage Android
  - vérifier la connectivité ordi-androphone (adb devices)
  - depuis l'ordi, transférer (adb push vers /sdcard/) vers le Honor 5X,les deux fichiers précédemment téléchargés et le fichier patché ainsi que les trois fichiers de somme de contrôle md5
    * les fichiers se trouvent alors à la racine de la mémoire interne du Honor 5x. Vous pouvez le vérifier à l'aide du navigateur de fichiers
      * par anticipation de ce qui pourrait se produire dans un futur plus ou moins éloigné, copier ces fichiers sur la carte SD, via le navigateur de fichier de l'androphone
  - **déconnecter le câble USB**, éteindre votre Honor 5X
  - le démarrer en mode //recovery// (//Vol+// puis simultanément //Power//)
    - **faire une sauvegarde intégrale de votre système sur la carte SD** (Backup)
    - installer (Install) dans l'ordre suivant :
      - la mise à jour de LineageOS
      - les //Open GApps//
      - le //su ad-on//
    - redémarrer le Honor 5X sur son nouveau système (Reboot > System)

==== Traces d'exécution ====
Les traces d'exécution donnent une idée des temps de transfert. Commencer par un md5 permet de s'assurer que le transfert est instantané.
<code>
$ adb devices
List of devices attached 
IMTP1F2JDYJK02051        device
$adb push lineage-15.1-20190101-nightly-kiwi-signed.zip.md5 /sdcard/
20 KB/s (80 bytes in 0.003s)
$ adb push lineage-15.1-20190101-nightly-kiwi-signed.zip /sdcard/
6067 KB/s (508181146 bytes in 81.791s)
[...]
$ adb push addonsu-15.1-arm64-signed.zip /sdcard/
5451 KB/s (1019556 bytes in 0.182s)
$ adb push addonsu-15.1-arm64-signed.zip.md5 /sdcard/
7 KB/s (64 bytes in 0.008s)
</code>
==== Premiers constats post-installation ====
  * Les données ont été préservées (contact, agenda…)
  * L'écran d'accueil et ses satellites ont été réinitialisés
  * la configuration de l'application de l'app E-mail est perdue (nouvelle application)
  * la reconnaissance d'empreinte digitale est plus lente que sous LineageOS 14.1
==== Bilan après deux mois d'utilisation ====
=== Instabilité ===
Après la première mise à jour de montée de version (décrite ci-avant) satisfaisante, mon Honor 5X a mal supporté la première mise à jour :-( Il restait utilisable mais avec une forte instabilité après chaque redémarrage (freeze, reboot intempestif, apps bloquées…).

<note important>J'ai du me résoudre à effectuer une première installation qui a enfin donné un système stable et acceptant parfaitement les mises à jours OTA (après passage en TWRP 3.2.3.0). Ce type d'installation entraîne l'effacement de toutes les données stockées dans la mémoire de l'androphone, d'où l'importance de les sauvegarder.</note>

=== Avantages ===
**Aucun !!!** Les fonctionnalités d'économie d'énergie intégrées à Oréo n'atteignent pas l'efficacité de Greenify. On perd un lanceur d'application qui permettait de construire des écrans complémentaires à gauche et droite de l'écran d'accueil((Quel débile à pu penser que c'était une amélioration ergonomique ?)).

L'unique "bénéfice" est de disposer de mises à jour régulières. Le passage à LOS 15 n'est pas un choix mais une contrainte puisque LOS 14 n'est plus maintenue.

=== Régressions ===
  * Perte d'OTG ! Un grand pas en avant… En furetant sur les forums il se pourrait ce cette perte soit limitée aux périphérique USB-3((Certains évoquent une version buggée de libusb, conservée près de 3 mois après la sortie de LOS 15…)) mais je n'ai plus de périphérique USB-2 pour confirmer ou infirmer. Heureusement, c'est LOS 15 (et lui seul) qui est défaillant, par le Honor 5X ! TWRP accède sans problème à une clé-USB externe (sauvegarde, restauration, source d'installation…).
  * Titanium backup n'est que l'ombre de lui-même :
    * les actions planifiées ne se déclenchent pas
    * le déclenchement manuel d'un tâche planifiée plante l'application.
      * il reste possible de sauvegarder les applications une à une
      * si on efface le contenu du répertoire de sauvegarde, le déclenchement manuel d'une tâche planifiée fonctionne.
  * Accupedo podometer inutilisable : l'application ne détecte plus les pas (une autre bibliothèque pourrie, comme l'USB ?)
  * Compass de PixelProse inutilisable : la boussole ne bouge pas (passage forcé à Compass Galaxy)

Pour en avoir le cœur net, j'ai rejoué une première installation de LOS 14((Suivant la même procédure officielle que pour LOS 15.)) et tout refonctionnait parfaitement. C'est donc bien LOS 15 qui est merdique sur Honor 5X !
=== Conclusion ===
Une mise à jour dont je me serais bien passée : aucun avantage fonctionnel et une pile d'emmerdements.
=== Épilogue ===
Après encore quelques mois d'utilisation et de mises à jour regulières, certaines fonctionnalités sont revenues :
  * les sauvegardes planifiées sous TitaniumBackup
  * OTG avec une clé USB-3

Je n'ai pas tenté de réinstaller les autres application défaillantes sous LOS 15.1
===== Upgrade de LineageOS 15.1 vers 16.0 =====

==== Préparation ====
=== Téléchargement, contrôles et génération de signatures ===
  * LOS 16.0 wiki
  * addonsu 16.0 ARM64
  * addonsu-remove 16.0 ARM64
  * OpenGapps ARM64, android 9.0, nano
==== Sauvegardes ====
  * LOS 15, Sauvegarde captures d'écran d'accueil et satellites sur carte-SD
  * LOS 15, Sauvegarde TitaniumBackup sur carte-SD
  * LOS 15, Photos sur clé-USB externe OTG
  * LOS 15, synchro réseau agenda et contacts
  * TWRP, Sauvegarde système sur clé-USB externe OTG
==== Installation ====
La [[https://wiki.lineageos.org/devices/kiwi/upgrade|procédure officielle]] pour le Honor 5X (kiwi) a été suivie avec succès, après y avoir apporté quelques adaptations. L'androphone de test utilisant les GApps sous LOS 15.1, il en a été tenu compte, comme l'indique la procédure.
=== Principe ===
Cette procédure utilise une connexion par câble USB entre l'ordi et l'androphone. En théorie, une fois les deux appareils connectés, l'installation s'effectue exclusivement depuis l'ordi (en ligne de commande, depuis un terminal). On n'est pas censées toucher à l'androphone. Les fichiers à installer ayant été récupérés sur l'ordi, on n'aura pas besoin de les recopier sur l'androphone, ni sur la mémoire interne, ni sur la carte-SD. Les commandes d'installation lancées depuis l'ordi effectuent à la fois le transfert et le flashage du système et des applications.
=== Prérequis ===
source : [[https://twrp.me/faq/ADBSideload.html|What is ADB Sideload and how can I use it ?]] (twrp.me) (en)

Le prérequis absolu est donc de disposer d'une connexion ADB((Android Debug Bridge.)) fiable et fonctionnelle entre l'ordi et l'androphone. Cette connexion peut emprunter plusieurs canaux. Le canal le mieux documenté et le plus couramment utilisé est une liaison par câble USB. C'est celui qui a été utilisé dans le cas décrit ci-après. 

L'établissement d'une connexion ordi-androphone a déjà été décris dans une [[phone:full-control-honor-5x#etablir_une_connexion_ordi-smartphone|fiche précédente]].

De plus, il faut vérifier que la version de l'application //adb// installée sur l'ordi est **au minimum  1.0.32** :
<code>$ adb version
Android Debug Bridge version 1.0.32</code>
Si tel n'est pas le cas, la procédure décrite ici n'est pas applicable.
=== Adaptations ===
Dans le cas relaté, la procédure officielle n'a pas pu être déroulée telle quelle. En effet, elle suppose :
  - qu'il est possible, via //ADB//, de forcer le redémarrage de l'androphone en mode //sideload//,
  - que l'androphone reste dans en mode //sideload// après chaque installation-flashage.
Le fait que la première condition ne soit pas remplie((Il faut préciser que dans les "Options pour les développeurs", l'accès //root// est autorisé pour ADB, sinon ce ne serait pas drôle…)) s'observe dès la toute première commande de la procédure :
<code>$ adb reboot sideload
'adb root' is required for 'adb reboot sideload'.</code>

Dans le cas testé, les deux conditions n'étaient pas vérifiées. Les configurations étaient les suivantes :
  * ordi
    * linux-Mint 18.3
    * adb 1.0.32
  * androphone
    * LOS 15.1, build du 22 juin 2019
    * TWRP 3.2.3-0

En conséquence, l'androphone a dû être placé en mode //sideload// depuis TWRP, avant chaque commande d'installation.

L'essentiel du mode d'installation a cependant été préservé dans la mesure où les commandes d'installation qui ont été utilisées (adb sideload <fichier>) sont exactement celles que préconise la procédure officielle((Le mode d'installation est donc validé même si la procédure complète a été adaptée.))
=== Procédure ===
  - préparer l'androphone
    - débrancher tout cable USB
    - éteindre
    - redémarrer en mode recovery (//Vol+// et //Power// simultanément)
    - activer le mode //sideload//
  - relier l'ordi et l'androphone par un câble USB
  - sur l'ordi
    - vérfier la connexion
    - installer LOS 16
      * remettre l'androphone en mode //sideload//
    - installer les GApps
      * remettre l'androphone en mode //sideload//
    - installer //addonsu//
    - redémarrer l'androphone

Avant chaque commande d'installation, on s'assure que l'androphone est bien en mode //sideload//

<code>$ adb devices
List of devices attached 
IMTP1F2JDYJK02051	sideload</code>
le mot //sideload// atteste que l'androphone est bien mon de //sideload//((Si ce n'est pas le cas, inutile d'aller plus loin, l'installation ne fonctionnera pas.)) et non en mode //recovery//.

Ce qui donne la séquence d'opérations suivante (les lignes commençant par "@" désignent des actions sur l'androphone, les lignes commençant par "$" désignent des commandes saisies sur l'ordi) :
<code>
@ Advanced > ADB sideload > swipe
$ adb devices
$ adb sideload lineage-16.0-20190712-nightly-kiwi-signed.zip
@ Back > Advanced > ADB sideload > swipe
$ adb devices
$ adb sideload open_gapps-arm64-9.0-nano-20190712.zip
@ Back > Advanced > ADB sideload > swipe
$ adb devices
$ adb sideload addonsu-16.0-arm64-signed.zip
$ adb reboot                       
</code>
Le premier redémarrage est toujours long…
=== Premières impressions ===
Toutes les données applicatives, les comptes et autres configurations des applications sont conservées. Seul l'écran d'accueil (et les écrans satellites) se retrouve fatalement en vrac, d'où l'intérêt d'avoir fait des captures d'écran.

À première vue, aucune des applications tierces installées n'a cessé de fonctionner. TitaniumBackup répond présent et OTG n'a pas disparu. La mise à jour OTA fonctionne.

L'affichage des applications est plus lent sans qu'il soit possible de dire si c'est dû aux effets graphiques inutiles et pénibles ou à un ralentissement plus profond. Une fois l'application chargée, la réactivité semble identique à celle observée sous LOS 15.1. Heureusement, on n'observe pas le ralentissement très net qui avait accompagné le passage de LOS 14 à 15.

LOS 15 n'a été qu'une version de transition qui aura vécu à peine quelques mois. Elle ne m'aura laissé aucun bon souvenir, bien que //Pie// annonce quelques <del>améliorations</del> régressions, tel l'affichage de l'historique en mode exclusif "pas trop d'informations, il me reste 3 neurones"…
===== Upgrade de LineageOS 16.1 vers 17.1 =====
<note warning>Si la réception FM est une fonctionnalité **nécessaire**, ne pas effectuer cette mise à jour car elle entraîne sa disparition.</note>
Cette mise à jour est censée conserver les données et les comptes enregistrés sur le Honor 5X. C'est effectivement ce que j'ai constaté après une installation qui s'est déroulée sans problème. Comme toujours avant ce type d'opération, il est plus que recommandé d'effectuer une sauvegarde aussi ample que possible.
==== Mise à jour officielle ====
Tant que l'information est en ligne sur le site de LineageOS, je reproduis et documente les informations disponibles.

Sources :
  * [[https://wiki.lineageos.org/devices/kiwi/|Huawei Honor 5X (kiwi)]]
  * [[https://wiki.lineageos.org/devices/kiwi/upgrade/|Upgrade LineageOS on Huawei Honor 5X (kiwi)]]. Cette page ne précise pas à quelles versions elle s'applique mais elle est pointée par un lien officiel dénommé "//Upgrade to a higher version of LineageOS (e.g. __lineage-16.0 -> lineage-17.1__)//"
=== Prérequis et limites ===
La procédure officielle suppose que la mise à jour se fait en utilisant la dernière version du recovery de LineageOS pour Honor 5X. S'il n'est pas déjà installé, la procédure officielle stipule qu'il faut [[https://wiki.lineageos.org/devices/kiwi/install/#installing-a-custom-recovery-using-fastboot|l'installer]]((Comme on le ferait pour une première installation de LOS.)).

La procédure de mise à jour((Pas plus que la procédure d'installation :-\))ne traite pas du rootage du système. C'est d'autant plus regrettable que la technique utilisée jusqu'ici (LOS 16) est inopérante((En raison de l'évolution du schéma de sécurité d'Android 10 qui est au cœur de LOS 17.)).

=== Se procurer LOS 17 pour kiwi ===

Le Honor 5X n'étant plus maintenu par LineageOS, aucun paquetage officiel d'installation n'est proposé au téléchargement. On peut toutefois se procurer un paquetage de deux manières :

  * Générer soi-même (build) un tel paquetage. C'est l'unique moyen préconisé officiellement. Autant dire que ce n'est pas à la portée d'une bricoleuse de base :-D
  * Récupérer un paquetage d'installation près à l'emploi.  Il peut s'agir d'un ancien paquetage officiel((Que l'on aura pris la précaution de télécharger avant qu'il disparaisse ! (Par exemple : lineage-17.1-20210311-nightly-kiwi-signed.zip))) ou d'un paquetage plus récent généré par une personne de confiance((Que l'on trouvera généralement sur une forum fiable, venant d'une contributrice fiable.)).

=== Paquetages complémentaires (add-ons) ===
Si l'on souhaite utiliser des paquetages complémentaires (par exemple, les Google Apps) il est impératif de se les procurer avant de procéder à la mise à jour de LOS.

=== Préparation ===
  * un Honor 5X chargé à bloc
  * un câble USB **fiable**((Le câble d'origine est un bon candidat, s'il a pas connu de déboires…))
  * un ordi avec adb fonctionnel et parvenant à dialoguer avec le Honor 5X
  * un paquetage d'installation système : lineage-17.1-20210311-nightly-kiwi-signed.zip
  * des paquetages d'installation add-ons :
    * open_gapps-arm64-10.0-nano-20210311.zip
    * Magisk-v27.0.zip((Magisk-v27.0.**apk** renommé.))

=== Procédure officielle ===
<code>
sur le Honor 5X : 
Paramètres > Système > Options avancées > Options pour les développeurs > Débogage Android : oui
Paramètres > Système > Options avancées > Options pour les développeurs > Accès root : ADB uniquement

Sur l'ordi :
adb -d root
adb -d reboot sideload
adb -d sideload /path/to/zip (inserting the path to your LineageOS package).

!!! NE PAS redémarrer le Honor 5X !!!

Sur le Honor 5X :
Apply Update > Apply from ADB

Sur l'ordi :
adb -d sideload /path/to/zip those packages in sequence.

Once you have installed everything successfully, click the back arrow in the top left of the screen, then “Reboot system now”

</code>
==== Mise à jour effective ====
Je décris ici la procédure que j'ai suivie.

La version de TWRP installée étant la dernière produite pour le Honor 5X (3.4.0.0), je ne change pas de recovery.

OpenGapps signalant des instabilités sous Android 10 et ayant atteint une taille colossale (289 Mio contre 168 Mio lors de l'installation de LOS-16), je bascule sur MinTheGapps (127 Mio).

Je choisis d'installer //Magisk// suivant la procédure "périmée" (via TWRP + run) qui semble la plus sûre (déjà validé sur le Poco F3 et recommandée [[https://linuxnorth.wordpress.com/2021/01/16/rooting-lineageos-17-1-with-magisk/|par ailleurs]]

=== Procédure utilisée ===
Le recovery installé étant TWRP, il est impossible de suivre scrupuleusement la procédure officielle. Les principes fondamentaux sont néanmoins respectés. Dans la procédure ci-après, le préfixe de chaque action précise sur quoi on agit :
  * «$» indique une commande saisie dans fenêtre de terminal, sur l'ordi.
  * «@» indique une action sur l'androphone

<code>
@ Paramètres > Système > Options avancées > Options pour les développeurs > Débogage Android = coché
@ Paramètres > Système > Options avancées > Options pour les développeurs > Accès root > ADB et applications

$ adb devices         // pour vérifier que ça fonctionne
$ adb reboot recovery    // adb sous TWRP tourne automatiquement sous root 
$ adb reboot sideload      // attendre l'écran de sideload sur l'androphone
$ adb sideload OS/lineage-17.1-20210311-nightly-kiwi-signed.zip
$ adb reboot sideload      // attendre l'écran de sideload sur l'androphone
$ adb sideload OpenGapps/MindTheGapps-10.0.0-arm64-20220224_161733.zip
$ adb reboot sideload      // attendre l'écran de sideload sur l'androphone
$ adb sideload Magisk/Magisk-v27.0.zip

@ Reboot > System
@ Magisk  >>> se laisser guider par Magisk pour terminer l'installation et le rootage
</code>
=== Premiers constats ===
  * Le Honor 5X a parfaitement redémarré sous LOS-17 (Android 10).
  * Les données utilisatrice sont conservées (empreintes, contact, agenda, comptes divers, fond d'écran, wifi, Bluetooth…).
  * La continuité des //Google Apps// est automatique (passage de //OpenGApps// à //MinTheGapps// sans conséquence).
  * Le rootage via //Magisk// est opérationnel (testé sur //Titanium Backup//).
  * D'une manière générale, l'interface semble légèrement plus réactive.
  * **On perd la fonctionnalité de radio-FM**((L'application (préinstallée) conserve la mémoire des stations détectées sous LOS-16 mais n'accède plus au récepteur FM.))
  * Les autres applications préinstallées((Incluses dans LOS-17.)) bénéficient de quelques améliorations.

La radio-FM faisant partie du cahier des charges de cet androphone, j'arrête les tests.

=== Non testé ===
L'androphone n'étant pas équipé d'une carte SIM, les fonctionnalités suivantes n'ont pas été testées :
  * double-SIM
  * téléphonie (réseau, 4G, conversation, notification, gestion d'appels, etc.)
  * SMS/MMS
  * partage de connexion
Mais aussi :
  * GPS
  * accéléromètre
  * …
==== Restauration LOS-16 ====
Ayant effectué une sauvegarde complète préalable, sous TWRP, il m'a suffit de la restaurer pour retrouver un Honor 5X exactement dans l'état où il était avant la montée de version en LOS-17 : système, applis((Y compris la radio-FM, balayant l'hypothèse d'une défaillance ou d'un écrasement du firmware. C'est bien LOS-17 qui est défaillant.)), données, réglages ! :-)