====== Installer LineageOS 19 sur un Xiaomi Poco F3 ======
L'installation de cette ROM limite irrémédiablement la définition maximale de l'appareil photo à 12MP((Car 12MP en 4:3 est la résolution maximale proposée par l'API Camera 2 telle qu'implémentée dans le firmware de Xiaomi. Soit 1 MP de moins que mon //Honor 5X// de 2015 !)), contre 48MP sous le système d'origine((MIUI 13)). Cette division par 4 de la définition est cependant très loin de se répercuter sur la qualité des photos. Dans de nombreux cas, [[phone:camera-poco-f3|des applications limitées à 12MP donnent de meilleures images que l'application stock de MIUI]].
Ayant globalement suivi, avec succès, les indications d'installation fournies par LineageOS (LOS), cette fiche est relativement succincte. La principale différence a concerné la mise en conformité du firmware, développée dans cette.
Les utilisatrices habituées à LOS comme celles qui le découvrent gagneront à prendre connaissance du [[https://lineageos.org/Changelog-26/|changelog de la version 19]]((Il se présente comme un texte __rédigé__, assez court (1750 mots) et compréhensible par toute utilisatrice susceptible d'installer une ROM.)).
===== Objectif =====
Le but est d'installer :
* le recovery de LOS (parce que l'installation de TWRP a échoué)
* le system LOS 19.1 (parce que c'est la version courante, à la date de l'installation)
* les GApps (pour disposer de Google Play)
* Magisk (pour rooter le F3)
===== Préalables =====
==== Conformité ====
Le F3 utilisé était en pleine conformité avec les prérequis de LOS, notamment les [[https://wiki.lineageos.org/devices/alioth/|modèles compatibles]]((Je le mentionne car ce prérequis n'est pas rappelé dans la procédure d'installation de LOS.)).
==== Déverrouillage du bootloader ====
Inutile de tenter d'installer LOS avant d'avoir déverrouillé le bootloader du F3. Il s'agit d'une opération indépendante de l'installation de LOS. Elle peut prendre une semaine((En raison d'un "temps de réflexion" imposé par Xiaomi.)). Le déverrouillage est [[phone:unlock-bootloader-poco-f3|décrit sur une fiche dédiée]].
Or, pour procéder au déverrouillage du bootloader, il est recommandé de mettre à jour le système MIUI d'origine dans sa dernière version. On se retrouve donc avec un F3 équipé d'une version de MIUI non conforme à un des prérequis d'installation de LOS((À la date de rédaction de cette fiche : disposer de la [[https://wiki.lineageos.org/devices/alioth/fw_update|version V13.0.6.0.SKHEUXM de MIUI]], pour un POCO F3 EEA.)). D'où la nécessité, documentée par LOS, d'un mise en conformité du firmware ; en l'occurrence, d'une rétrogradation de version (dans mon cas : //V13.0.11.0.SKHEUXM//) .
==== Téléchargements ====
Afin de réduire ma charge mentale et limiter les risques de distraction au cours de l'installation, je télécharge la totalité des fichiers nécessaires, avant de me lancer. Les versions évoluant en permanence, je n'indique pas les liens de téléchargements qui risqueraient d'être obsolètes ou incohérents. Voici la liste des téléchargements que j'ai eu a effectuer pour cette installation :
* [[https://developer.android.com/studio/releases/platform-tools?hl=fr|Android SDK Platform Tools]] pour disposer des dernières versions des commandes //adb// et surtout //fastboot//((La documentation de LOS indique qu'il faut disposer d'une version 31.0.2 ou supérieure. La version disponibles sur mon ordi était 28.0.2.))
* la version de MIUI [[https://wiki.lineageos.org/devices/alioth/fw_update|requise]]
* [[https://github.com/ssut/payload-dumper-go|payload-dumper-go]] pour extraire les composants de la ROM MIUI
* trois fichiers de [[https://download.lineageos.org/devices/alioth/builds|livraison de LOS]] et leurs clés de contrôle d'intégrité SHA256
* le système
* le recovery
* le vendor_boot
* le [[https://wiki.lineageos.org/verifying-builds|vérificateur d'authenticité de LOS]]
* les [[https://androidfilehost.com/?w=files&flid=322935|GApps proposées par MindTheGapps]]
* [[https://github.com/topjohnwu/Magisk/releases|Magisk]]
===== fastbootd =====
La commande "adb reboot fastboot" ne redémarre pas le F3 en mode //fastboot// mais en mode //fastboot**d**//((Ce comportement est conforme aux [[https://source.android.com/docs/core/architecture/bootloader/fastbootd?hl=fr#adb-commands|spécifications d'Android]].)) !
En suivant scrupuleusement la procédure, vous ne devriez pas vous retrouver en mode fastbootd auquel elle ne fait jamais appel. Si, confiante dans vos habitudes, vous vous permettez des écarts, soyez attentive au mode dans lequel se trouve votre F3, avant de lancer des commandes fastboot.
===== Mise en conformité préalable du firmware (ignorer) =====
La procédure indiquée par LOS est inutilement complexe sur ce point. Je recommande vivement d'ignorer cette opération préalable. On fait la même chose, en mieux, après l'installation du //recovery// ;-)
===== Installation du recovery =====
Ayant choisi d'installer le recovery fourni par LOS, j'ai suivi scrupuleusement la procédure décrite par LOS, à partir de la section [[https://wiki.lineageos.org/devices/alioth/install#flashing-additional-partitions|Flashing additional partitions]].
===== Mise en conformité du firmware (la bonne) =====
Sources :
* expérience personnelle (voir plus loin)
* [[https://blog.raw.pm/en/install-lineageos-poco-f3/|Install LineageOS 19.1 on POCO F3 to replace MIUI 13.0.4]]
Je recommande de télécharger le [[https://xiaomifirmwareupdater.com/firmware/alioth/stable/V13.0.6.0.SKHEUXM/|fichier de mise à jour des seuls firmwares]] (zip) proposé par //Xiaomi Firmware Updater//((Ce site est [[phone:install-miui-stock-poco-f3#sources_alternatives|présenté dans une autre fiche]].)) qu'il suffit de sideloader.
Au regard de la procédure officielle, cette mise en conformité s'intercale entre le flashage du //recovery// de LOS et le flashage du système. L'ordi et le F3 sont donc déjà reliés et capables de communiquer. Le F3 a déjà été redémarré en mode //recovery//((fastboot reboot-recovery)).
* sur l'ordi
* comme dans la procédure officielle, prendre connaissance de la version MIUI de référence validée par LOS
* pointer son navigateur sur [[https://xiaomifirmwareupdater.com/archive/miui/alioth/|le site de chargement des firmwares]]
* utiliser les filtres disponibles (//Firmware downloads// et //Search//) pour accéder rapidement au firmware de la version validée par LOS
* télécharger le firmware (fichier zip)
* sur le F3 (en mode //recovery//)
* Apply Update > Apply from ADB
* sur l'ordi
* adb sideload le-firmware-téléchargé.zip
* sur le F3 (en mode //recovery//)
* autoriser l'installation "Yes (install anyway)"
* attendre la fin de l'installation (ça se constate sur l'écran du F3 mais on peut vérifier sur l'ordi)
* back > Advanced > Reboot to recovery
* reprendre la procédure officielle
== Expérience personnelle ==
Lors de l'installation initiale, j'ai scrupuleusement suivi la procédure décrite par LOS sur la page [[https://wiki.lineageos.org/devices/alioth/fw_update|Update firmware on alioth]], dédiée à ce sujet. Dans mon cas, le F3 était équipé de la version //V13.0.11.0.SKHEUXM//.
Si cela s'est avéré suffisant dans un premier temps ((F3 fonctionnel, fluide et stable.)), j'ai néanmoins rencontré de graves problèmes tels que la perte de la 5G et du partage de connexion via USB. Ce problème n'étant pas signalé sur les forums et le système étant stable, j'en ai conclu qu'il s'agissait probablement d'un problème de firmware. J'ai donc procédé à une réinstallation du firmware de référence, après quelque jours d'utilisation. Cette fois, j'ai utilisé le [[https://xiaomifirmwareupdater.com/firmware/alioth/stable/V13.0.6.0.SKHEUXM/|fichier de mise à jour des seuls firmwares]] (zip) proposé par //Xiaomi Firmware Updater//((Ce site est [[phone:install-miui-stock-poco-f3#sources_alternatives|présenté dans une autre fiche]].)) qu'il ma suffit de sideloader, comme indiqué ici.
===== Installation de LOS-19 =====
J'ai scrupuleusement suivi la procédure décrite par LOS, à partir de la section [[https://wiki.lineageos.org/devices/alioth/install#installing-lineageos-from-recovery|Installing LineageOS from recovery]]..
===== Installation des Google Apps =====
Suivant la [[https://wiki.lineageos.org/gapps|recommandation de LOS]], j'ai choisi la version des [[https://androidfilehost.com/?w=files&flid=322935|GApps fournie par MindTheGapps.]]. Puisque je les installe sur un F3 équipé de LOS-19 (Android 12), la version qui convient est "MindTheGapps-12.x.y-arm64".
**Dans la foulée, sans redémarrer le système, j'installe Magisk.**
===== Installation de Magisk =====
source : [[https://youtu.be/yrCCMeGSTto?t=370|How to Download & Install GApps and Magisk on LineageOS 18.1 with LOS Recovery]]
Les [[https://topjohnwu.github.io/Magisk/install.html|indications d'installation recommandées par Magisk]] étaient tellement décourageantes que j'ai choisi de l'installer suivant la méthode [[https://topjohnwu.github.io/Magisk/install.html#custom-recovery|Custom Recovery]], qualifiée de "dépréciée".
- sur l'ordi
- télécharger l'application ; on obtient un fichier ".apk", par exemple //Magisk-v25.2.apk//
- renommer le fichier en ".zip", par exemple //Magisk-v25.2.apk// -> //Magisk-v25.2.zip//
- adb sideload Magisk-v25.2.zip (il faut, sur le F3, autoriser l'installation d'une application non validée par LOS)
- à partir de cette étape, on peut débrancher le F3
- sur le F3
- redémarrer sur le système : Reboot system now
- finaliser l'installation de Magisk en tapant sur l'application et suivant les instructions
===== Transférer les données =====
Si l'installation s'est faite sur un nouvel androphone, on souhaitera transférer certaines données depuis l'ancien androphone. Une [[phone:transferer-donnees|fiche dédiée]] traite de ce sujet.
===== Résumé des opérations =====
Ce résumé vise à donner un aperçu du nombre d'actions à réaliser.
(à faire)