Introduction au portage¶
Cette première section vous présentera les spécificités du portage d’Ubuntu Touch sur un appareil Android. Veuillez noter qu’elle a été rédigée à l’intention du grand public et non du développeur de portage expérimenté. Dans les sections suivantes, nous avons fait un effort de différenciation en gardant le texte principal plus concis afin de répondre aux besoins du lecteur plus expérimenté, tout en fournissant des liens vers des lectures complémentaires pour les moins expérimentés.
L’ensemble du guide est rédigé sous forme d’une séquence d’étapes décrivant comment pourrait se passer un portage idéal. Cependant, le portage est imprévisible et compliqué. Chaque appareil est différent et, en réalité, vous allez probablement itérer sur certaines étapes, en sauter d’autres et découvrir des défis nouveaux et non documentés.
Qu’est-ce qu’Ubuntu Touch ?¶
Ubuntu Touch est un système d’exploitation libre pour les appareils mobiles. Il peut être porté sur des appareils qui, à l’origine, étaient équipés d’un système d’exploitation Android. Hélas, la majorité de ces appareils dépendent dans une certaine mesure de logiciels propriétaires.
Plus précisément, les vendeurs d’appareils ont tendance à garder propriétaires le code qui parle directement au matériel (les pilotes de bas niveau). Ces composants sont communément appelés les vendor “blobs” (Gros objets binaires). Ils doivent être incorporés dans un portage d’Ubuntu Touch. Notez que ces composants sont spécifiques non seulement à chaque appareil, mais aussi à chaque version d’Android. Il est donc nécessaire d’utiliser la version correcte de ces composants lors de la création d’un portage.
C’est pourquoi Ubuntu Touch ne peut pas être entièrement créé à partir du code source de la plupart des appareils commerciaux. Au lieu de cela, le portage du système sur ces appareils implique l’intégration des blobs mentionnés précédemment dans le reste du système, qui peut être construit à partir du code source.
Le composant suivant d’Ubuntu Touch est un système de fichiers racine pré-compilé qui doit être installé sur l’appareil. Ce composant ne communique pas directement avec le matériel de l’appareil. Cette communication est plutôt assurée par une couche d’abstraction matérielle (« Hardware Abstraction Layer », ou HAL) qui doit être créée pour chaque appareil spécifique, car chaque appareil a son architecture matérielle spécifique. Ce composant est appelé Halium et est disponible en différentes versions (5.1 qui est largement obsolète, 7.1 et 9 à l’heure actuelle) correspondant à différentes versions d’Android.
Le projet Halium permet aux systèmes Linux de fonctionner sur le matériel Android. C’est un effort conjoint de plusieurs systèmes d’exploitation mobiles, notamment Lune OS, Droidian et Ubuntu Touch.
Le portage Ubuntu Touch repose sur GSI Halium. Le Halium GSI est examiné plus loin. Il peut parfois aussi être utile de tester avec un des autres systèmes d’exploitation pour déboguer un problème depuis différents angles.
Halium est une partie indispensable d’un portage d’Ubuntu Touch et est disponible sous forme de logiciel libre. Le développement d’une nouvelle version d’Halium est une tâche considérable, c’est pourquoi seules quelques versions d’Halium sont disponibles. Chaque portage d’Ubuntu Touch doit être basé sur une des versions d’Halium disponibles et sur les blobs de la version d’Android correspondante. Voir les deux premières colonnes du tableau ci-dessous pour plus de détails.
- Ainsi, un portage d’Ubuntu Touch est composé de ces composants :
Le système de fichiers racine (rootfs) d’Ubuntu Touch (UT)
Halium (contenu dans les images de démarrage et du système)
Les blobs des fabricants
Vous, le porteur, devez construire un noyau Halium, qui est installé avec le système de fichiers racine Ubuntu Touch et le Halium GSI, pour créer un port Ubuntu Touch fonctionnel.
Versions Android et Halium¶
Halium est créé à partir du code source d’une version modifiée du système d’exploitation Android appelée LineageOS (voir site Web LineageOS et wiki). Le code source requis est disponible en ligne et doit être téléchargé et configuré pour construire la version correcte d’Halium pour chaque portage d’appareil individuel. Le tableau ci-dessous indique les versions requises pour les différentes versions d’Halium.
Version d’Android |
Version d’Halium |
Lineage OS (LOS) |
|---|---|---|
7.1 |
7.1 |
14.1 |
9.0 |
9.0 |
16.0 |
10.0 |
10.0 |
17.1 |
11.0 |
11.0 |
18.1 |
12.0 |
12.0 |
19.1 |
13.0 |
13.0 |
20.0 |
Depuis 20.04, les ports Ubuntu Touch sont normalement basés sur Halium 9.0 ou plus récent. Les versions plus anciennes de Halium sont considérées comme dépréciées et ne sont plus supportées pour les nouveaux ports.
Image Système Générique¶
À partir de la version Android 9.0, un changement important d’architecture a été introduit. Les blobs de fournisseurs spécifiques à l’appareil résident maintenant sur une partition séparée au lieu de partager une partition avec le reste de l’image système. Cette séparation du code spécifique à l’appareil à partir du code générique a rendu possible ce qu’on appelle l’Image de Système Générique (GSI).
Une GSI est une image système qui est construite pour pouvoir fonctionner avec une large gamme de dispositifs. Les appareils Android, à partir de la version 9.0, utilisent un GSI. Pour plus d’informations, voir les pages Android Developer
Le développement de l’architecture GSI Android a également ouvert la voie pour l’image système Halium 9.0 arm64 maintenant disponible (ci-après dénommée le Halium GSI, ou simplement le GSI) qui est utilisé pour Ubuntu Touch. Cela, cependant, est quelque peu différent de l’Android GSI. Pour une explication plus détaillée de la Halium GSI, veuillez vous référer à la page wiki sur Gitlab CI construit de l’image système Halium générique.
Qu’est-ce que cela signifie pour le processus de portage ?¶
Étant donné que le GSI est un composant pré-construit et indépendant de l’appareil, il simplifie efficacement la tâche de construire un port viable en supprimant une grande partie de la tâche minutieuse et fastidieuse d’obtenir les blobs de fournisseurs spécifiques au matériel compilés dans l’image système et de les configurer pour fonctionner correctement.
Les défis du processus de portage¶
Construire les composants nécessaires et les assembler correctement implique toujours pas mal de modifications de code, de configuration et de test.
Heureusement, il existe une communauté de porteurs qui sont impatients de voir Ubuntu Touch porté sur de nouveaux appareils. En cas de problème, vous devriez consulter les sources ci-dessous (Obtenir de l’aide de la communauté) pour voir si d’autres avant vous ont résolu le problème. Il existe des groupes de discussion en ligne sur Telegram que vous pouvez rejoindre pour demander de l’aide, mais n’oubliez pas que les participants le font pendant leur temps libre.
Note
Dans le passé, il y avait différentes méthodes de portage. Trouvez les détails historiques liés à la section de portage section de portages dépréciés.
Connaissances et compétences préalables¶
Les porteurs/euses sont de toutes tailles et de toutes formes, pour ainsi dire. Par conséquent, ce guide ne présuppose pas de connaissances ou de compétences approfondies dans un domaine particulier. Vous devez cependant, au minimum, être familiarisé avec certaines commandes courantes et être à l’aise pour travailler depuis le terminal sur votre ordinateur hôte. En outre, le guide est basé sur un ordinateur hôte fonctionnant sous Linux. Si vous avez quelques connaissances en programmation, cela vous sera utile à un moment donné, surtout si vous êtes familier avec le C / C++. De plus, vous devriez vous familiariser avec git, créer un compte Gitlab ou Github pour garder la trace de vos modifications. Il est sage de commencer à documenter dès le début.
Nous avons tenté de donner un certain nombre d’explications en cours de route, mais ce guide n’est pas une référence approfondie sur l’architecture et le fonctionnement interne d’Ubuntu Touch. L’acquisition d’une compréhension plus approfondie nécessitera par conséquent un certain nombre de recherches de votre part.
Obtenir de l’aide de la communauté¶
Si vous avez des problèmes, et vous en aurez, consultez une ou plusieurs des sources ci-dessous :
Conseils généraux¶
Plus vous serez rigoureux dans la prise de notes et la documentation de vos démarches, moins vous passerez de temps à revenir sur vos pas et à chercher votre chemin. Lorsque vous traitez des questions qui se posent en cours de route, il est préférable de les traiter une à une. Si vous essayez de corriger plusieurs choses à la fois, vous risquez de vous retrouver à essayer de deviner quels changements ont résolu un problème donné, ce qui conduit facilement à casser à nouveau le correctif en question.
Si vous n’êtes pas découragé après avoir lu ceci, nous apprécions vos efforts et vous souhaitons bonne chance !
La section suivante est fondamentale pour le reste de ce guide.