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.

Pour déterminer les spécifications de votre appareil, recherchez-le sur GSM Arena et/ou Device Specifications.

We encourage the following specifications:

Kernel: Ubuntu Touch currently requires a device with a Linux kernel version greater than or equal to 3.15. According to the systemd v255 README, older device kernels are not compatible with systemd v255 or newer. You may learn your device’s kernel version by finding « Kernel Version » in the About page of your Android settings. The kernel version can also be found in the Makefile at the top level of any Linux kernel source tree.
RAM: At least 1GB is required for Operating System to work. 3GB or higher is recommended for a better end-user experience.
Stockage: At least 16GB of storage is required. Devices with less storage will likely not have enough space for a full Ubuntu Touch installation.

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.

Another rich source of information is the XDA Developers Forum.

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.

Note

Some devices do not have a TWRP image available. While it is technically possible to port a device without a recovery, it makes the process a lot more complicated, especially when debugging early in the porting process.

Recommandation pour le PC hôte/de build¶

The remainder of this guide presumes you are using a build PC running Linux. Although high performance always is nice, stability and sufficient RAM and harddisk space are the main concerns here. You do not need the latest and the best hardware, nor do you need the latest distribution release. In fact, it is not uncommon to run into issues when choosing the very newest release, as some of the software needed may not yet have been built for it. For example, using a Ubuntu LTS release, or a LTS release of another distribution, is often a good choice.

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).