Préparatifs#

Tous les appareils ne sont pas conçus pour fonctionner avec Ubuntu Touch. Faites des recherches sur l’appareil cible avant de commencer.

To determine your device’s specifications, search for it on GSM Arena and/or Device Specification. Refer to Pick an Android target device in the Halium Porting Guide for further information on requirements and how to check if your device qualifies.

Trouver les guides et autres informations pertinentes#

If your desired target device complies to the above, the next thing to do is locate the available guides and other documentation. This step will help you later on when you run into issues developing your port. For now, the main thing to look for is how to unlock your bootloader. (See below).

Rendez-vous sur le wiki LineageOS. Cherchez votre appareil, lisez et mettez dans vos favoris les guides qui y sont répertoriés. Essayez une recherche sur internet pour obtenir des informations supplémentaires, en précisant à la fois son nom de vente et le nom de code que vous avez trouvé sur le site de LineageOS. Veillez à vérifier que les informations que vous avez recueillies s’appliquent à votre appareil spécifique, en gardant à l’esprit que de nombreux appareils sont vendus dans un certain nombre de variantes différentes avec des spécifications matérielles différentes.

Une autre source d’information intéressante est le `Forum des développeurs de XDA<https://www.xda-developers.com/>`_.

Déverrouiller le programme de démarrage#

Les fabricants fournissent généralement leurs appareils avec un programme de chargement verrouillé. Il s’agit d’une sorte de «sceau » logiciel destiné à empêcher toute modification directe du système d’exploitation et des logiciels système. Si vous déverrouillez le programme de démarrage, vous pourrez effectuer des modifications, mais dans cet état, la garantie de votre appareil pourrait être annulée. Le choix vous appartient, mais cette étape est obligatoire si vous souhaitez installer Ubuntu Touch sur l’appareil.

Les appareils sont tous différents et il n’existe pas de méthode générale qui couvre toutes les marques et tous les modèles. Par conséquent, vous devez consulter les guides mentionnés ci-dessus pour savoir comment déverrouiller le programme de démarrage de votre appareil en particulier.

Installer l’image de récupération TWRP#

Vous devez installer une image de récupération personnalisée sur votre appareil afin de gérer le formatage et l’écriture des fichiers d’image sur celui-ci. Rendez-vous sur le site de Team Win Recovery Project et localisez le fichier image pour votre appareil. Suivez les instructions d’installation fournies sur le site.

Recommandation pour le PC hôte/de build#

La suite de ce guide part du principe que votre PC de build tourne sous Linux. Bien que de hautes performances soient toujours préférables, la stabilité ainsi que la RAM et l’espace disque disponible restent les points les plus importants. Vous n’avez pas besoin d’un PC de dernière génération ni de la dernière version de votre distro. Au contraire, il n’est pas rare de rencontrer des problèmes en cas d’utilisation de distros trop récentes car certains programmes ne les supportent parfois pas encore. Par exemple, au moment de l’écriture de ce guide, Ubuntu 20.04 est la version stable la plus récente disponible, cependant nous recommandons encore l’utilisation de la précédente version, à savoir Ubuntu 18.04.

Après avoir compléter les étapes précédentes, vous êtes maintenant prêt pour mettre en place votre environnement de compilation, ainsi que de démarrer le processus de potage (voir prochaine section).