À propos de Postmarket OS
Postmarket OS est une distribution basée sur Alpine conçut pour fonctionner sur téléphone, tablette
ou sur Raspberry PI.
La communauté autour du projet propose un ensemble d’outils comme pmbootstrap
qui permet de configurer et d’installer Postmarket OS sur son téléphone.
On peut aussi l’utiliser pour compiler son propre paquet et l’installer sur son téléphone facilement.
Configuration de notre environnement de travail
Avant de pouvoir l’utiliser, il faut d’abord l’installer depuis ce lien.
Une fois installé et configuré, il faut d’abord préparer son environnement de travail. Il est parfois nécessaire de mettre à jour le repository pmaports en local. On peut le faire assez facilement avec la commande :
|
|
Met à jour le repository pmaports.git cloné en local.
Le repo pmaports.git stocke tous les paquets Alpine avec le fichier
APKBUILD
utilisé par le serveur de compilation.Le fonctionnement est similaire à
PKGBUILD
pour les utilisateurs de ArchlinuxCe fichier contient toute la procédure pour préparer les sources, compiler le paquet depuis les sources, le numéro de version ainsi que la procédure pour vérifier si le paquet fonctionne correctement. Généralement on utilise les tests du projet comme les tests unitaires ou les tests fonctionnels.
On peut également mettre à jour le cache de la commande apk
même si c’est pas forcément obligatoire.
|
|
Met à jour le cache de la commande APK depuis l’environnement de travail
L’environnement de travail se situe par défaut dans le dossier
$HOME/.local/var/pmbootstrap/
Si on a déjà un environnement de travail en cours et qu’il contient du cache ou un travail en cours, on peut le réinitialiser assez facilement avec la commande :
|
|
Supprime le dossier de la commande chroot pour repartir de 0
La commande chroot permet de changer la racine Linux. Par exemple, on peut faire
chroot $HOME/mon_dossier
et à partir de ce moment-là,/
pointera vers$HOME/mon_dossier
dans notre shell actuel.C’est très utilisé par pmbootstrap pour configurer le système Alpine.
Pour ceux qui veulent utiliser une autre branche, on peut également changer la branche disponible sur le repository.
|
|
$workdir
par défaut se situe dans le dossier$HOME/.local/var/pmbootstrap/cache_git/pmaports/
Exemple de branche utile :
kde-nightly
Compilation de notre paquet Alpine
Maintenant, on va pouvoir compiler n’importe quel paquet avec la commande.
|
|
Par exemple, on peut compiler plasma-mobile (Attention le paquet est long à compiler)
|
|
Par défaut, pmbootstrap va recompiler l’intégralité des dépendances du projet pour s’assurer que notre test sera reproductible. Cependant, lorsque l’on souhaite juste tester un truc, ça peut-être ultra long.
On peut donc utiliser deux options pour nous aider:
-i
Permet de dire de compiler uniquement les dépendances du paquet défini dans le fichierAPKBUILD
-n
Permet d’éviter de compiler les dépendances du paquet défini dans le fichierAPKBUILD
Avec le combot des deux options, ça nous évite de tout recompiler.
On a aussi l’option -mp
qui peut-être pratique pour changer de mirroir si le téléchargement est lent ou si l’on souhaite télécharger des paquets nightly.
Un mirroir est un serveur utilisé pour télécharger les dépendances
On utilise cette option de cette manière:
|
|
On a aussi d’autres options comme:
--details-to-stdout
: Affiche le fichier de log dans la console-j N
: Défini le nombre de core CPU utilisé pour la compilation-t [En seconde]
: Le nombre de secondes sans nouveau log dans le fichier avant d’abandonner la compilation--src
: Change les sources du paquet. Par défaut ce sont les sources définies dans le fichierAPKBUILD
--arch [arch]
: L’architecture CPU du téléphone
Un exemple concret d’une commande que j’ai utilisé pour recompiler ma version de plasma-mobile avec mes changements.
|
|
Attention
Avant de compiler depuis le repository Nightly, il faut d’abord rajouter la clef de signature
1 2
wget https://nightly.postmarketos.org/plasma-mobile/pmos@local-662fcd2f.rsa.pub mv pmos@local-662fcd2f.rsa.pub $(pmbootstrap config work)/config_apk_keys/
Si vous souhaitez avoir plus d’informations, il suffit de taper la commande
|
|
Et pour avoir les arguments généraux
|
|
Envoie du paquet compilé sur le téléphone
Une fois le paquet compilé, il suffit de demander à pmbootstrap
de l’envoyer sur notre téléphone via la connexion SSH.
Avec pmbootstrap
, on utilise la commande sideload
comme dans l’exemple ci-dessous.
|
|
On a les arguments suivants :
--host [SSH HOST]
(Ex: 192.168.1.1)--port [SSH PORT]
(Ex: 22)--user [SSH USER]
(Ex: 192.168.1.1)--arch [ARCH]
: Permet de modifier la valeur définie pour le téléphone (Ex : aarch64)--install-key
: Permet d’installer la clef utilisée pour la vérification des paquets de la machine actuelle.
Tout gestionnaire de paquet comme APK, vérifie si le paquet est valide par rapport à la signature électronique du mainteneur du paquet. Dans notre cas, la signature ne sera pas valide, car le paquet n’est pas compilé par le mainteneur original donc il suffit de rajouter notre signature.
Pour revenir en arrière, il suffit de taper la commande ci-dessous depuis le téléphone ou depuis la connexion SSH
|
|
APK va réinstaller les paquets depuis les repos officiels.
En cas de problème liée à des conflits de fichier, on peut utiliser cette commande
|
|
Cette commande va forcer APK à écraser les fichiers en conflit.