====== Mettre à jour en LineageOS 21 le Poco F3 ======
<note tip>Sur mon F3, la mise à jour a préservé toutes mes données.</note>
<note>LineageOS 21 s'appuie sur les firmwares de la première version de //HyperOS// pour //Poco F3//((//HyperOS// est le nouvel OS de Xiaomi. Il est basé sur //AOSP// et remplace //MIUI// qui était basé sur //Google Android//.)).</note>
===== Cas d'utilisation =====
Disposant d'un F3 fonctionnant sous LOS-20, je constate que LineageOS ne produit plus de mise à jour de cette version du système depuis qu'a été publiée la version LOS-21 sur pour cet androphone.

Souhaitant disposer d'un système maintenu, je choisis d'effectuer une mise à jour de version majeure (upgrade) vers LOS-201 (Android 14).

===== Téléchargements et contrôles =====
  * Version courante de LOS 21 : lineage-21.0-20240605-nightly-alioth-signed.zip
    * sha256
    * update_verifier.py (déjà téléchargé pour LOS-20)
  * Firmware
    * ROM complète Xiaomi : miui_ALIOTHEEAGlobal_OS1.0.1.0.TKHEUXM_b0de6008b0_13.0.zip
      * md5
  * GApps : MindTheGapps-14.0.0-arm64-20240225_232108.zip
  * Magisk : Magisk-v27.0.apk (renommé manuellement en //Magisk-v27.0.zip//)

===== Sauvegardes =====

J'ai fait confiance à la mise à jour et me suis contentée de lancer une sauvegarde via Titanium Backup et copier les fichiers de sauvegarde sur une clé USB externe.

===== Upgrade du firmware =====
  * télécharger la version de référence de la ROM Xiaomi : miui_ALIOTHEEAGlobal_OS1.0.1.0.TKHEUXM_b0de6008b0_13.0
  * extraire le chargement transporté via l'archive zip : ./payload-dumper-go
  * adb reboot bootloader
  * passer les commande fastboot via le script {{ :phone:downgrade_f3.zip |downgrade_F3}}((Qui ne fait rien d'autre qu'automatiser les commandes manuelles, limitant les risques d'erreurs.))
  * fastboot reboot   (to system)

===== Mise à jour LOS + GApps =====
<note important>Ces deux mises à jour sont regroupées dans la même section car j'utilise les Gapps sur ma version actuelle de LOS. Dans ce cas, il est impératif d'enchaîner les deux mises à jour, sans redémarrer le F3 sur le système de base.</note>
  * sur l'ordi
    * adb reboot sideload
    * adb sideload lineage-21.0-20240605-nightly-alioth-signed.zip
      * **laisser le chargement et l'installation se faire !** Dans mon cas elle semblait s'être bloquée à 47% mais elle s'est terminée sans problème, malgré un message contradictoire affiché sur le terminal :<code>serving: 'lineage-21.0-20240605-nightly-alioth-signed.zip'  (~47%)  adb: failed to read command: Success</code>
    * Advanced > Reboot to Recovery
  * sur le F3 (en mode //recovery//)
    * Apply Update > Apply from ADB
  * sur l'ordi
    * adb sideload MindTheGapps-14.0.0-arm64-20240225_232108.zip
      * message dans le terminal : Total xfer: 1.00x 
  * sur le F3
    * yes, pour autoriser l'installation d'un paquet non signé par LineageOS
    * Reboot system now

===== Réinstallation de Magisk =====
Après le redémarrage sur LOS-21, le F3 n'est plus rooté, malgré la présence de l'application Magisk. Je la réinstalle donc en suivant la procédure utilisée avec succès lors de l'installation de LOS-19.
  * sur l'ordi
    * adb reboot sideload
    * adb sideload Magisk-v27.0.zip
      * message dans le terminal : Total xfer: 0.83x 
  * sur le F3
    * yes, pour autoriser l'installation d'un paquet non signé par LineageOS
    * Reboot system now
    * ouvrir l'application Magisk et suivre le dialogue de finalisation de l'installation
      * provoque le redémarrage du F3
    * le F3 est de nouveau rooté. les applis qui étaient autorisées le sont toujours.
===== Résumé des commandes passées dans le terminal =====
<note>Ce n'est qu'un résumé ! Des actions doivent impérativement être effectuées sur le F3, entre certaines commandes.</note>
<code>
downgrade_F3 payload-expanded-dir/
adb reboot sideload
adb sideload lineage-21.0-20240605-nightly-alioth-signed.zip
adb sideload MindTheGapps-14.0.0-arm64-20240225_232108.zip
adb reboot sideload
adb sideload Magisk-v27.0.zip
</code>
===== Premiers constats =====
N'étant pas à la recherche de nouvelles fonctionnalités, je me contente de mentionner quelques modifications observées, dans une utilisation quotidienne.
  * Réactivité. Dans l'ensemble le système et les applications sont plus réactives, dans l'interface.
  * Son. Meilleure qualité des haut-parleurs intégrés (pilotes ?).
  * Titanium Backup. L'exécution des sauvegardes programmées de toutes les applications et données ne rétablit plus le fond d'écran par défaut.
  * Seedvault. L'utilitaire de sauvegarde installé par défaut est toujours aussi limité mais il fournit des notifications claires.
  * Mise à jour OTA. Elle est plus rapide. Le F3 reste rooté par //Magisk// sans devoir intervenir((Validant la procédure d'installation de //Magisk// utilisée.)).
===== Liens utiles =====
  * [[https://lineageos.org/Changelog-28/|Changelog 28 - Fantastic Fourteen, Amazing Applications, Undeniable User-Experience]] (lineageos.org) (en) ; présentation des nouveautés.
  * [[https://wiki.lineageos.org/devices/alioth/upgrade/variant1/|Upgrade LineageOS on Xiaomi POCO F3]] (lineageos.org) (en)
  * [[https://wiki.lineageos.org/devices/alioth/fw_update/variant1/|Update firmware on Xiaomi POCO F3]] (lineageos.org) (en)
  * [[https://www.androidsage.com/2024/02/15/download-lineage-os-21-rom/|Download Lineage OS 21 ROM based on Android 14]] (androidsage.com); How to **Install** Lineage OS, **Gapps**, **Root**, **Recovery** !
  * [[https://wiki.lineageos.org/gapps|Recommandations Google apps]] (en) (lineageos.org)
  * HyperOS
    * [[https://xmfirmwareupdater.com/firmware/alioth/stable/OS1.0.1.0.TKHEUXM/|Firmware OS1.0.1.0.TKHEUXM Stable Release for POCO F3 EEA (alioth)]] (xmfirmwareupdater.com) ; version à jour((Au 24 mai 2024.)) du firmware de MIUI-14, soit Android-13.
    * [[https://www.gizmochina.com/2024/01/31/what-is-hyperos/|What is HyperOS? Is it based on Android?]]
    * [[https://www.mi.com/fr/hyperos|Xiaomi HyperOS]] (mi.com) (fr)
    * [[https://xmfirmwareupdater.com/hyperos/|HyperOS Latest Downloads]] (xmfirmwareupdater) ; Fournit les md5 non proposés sur le site de LineageOS