Begin add pmbootstrap_custom_build.md
This commit is contained in:
parent
4a5fd7c9f6
commit
ec0a1243de
2 changed files with 162 additions and 0 deletions
|
|
@ -369,3 +369,7 @@ void FlashlightUtil::findTorchDevice()
|
||||||
udev_unref(udev);
|
udev_unref(udev);
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Info utile pour le débogage de KDE Plama Mobile depuis Postmarket OS
|
||||||
|
|
||||||
|
Le fichier de log ce situe dans `~/.local/state/tinydm.log`
|
||||||
|
|
|
||||||
158
data_src/posts/pmbootstrap_custom_build.md
Normal file
158
data_src/posts/pmbootstrap_custom_build.md
Normal file
|
|
@ -0,0 +1,158 @@
|
||||||
|
---
|
||||||
|
image_path: "https://postmarketos.org/logo.svg"
|
||||||
|
slug: pmbootstrap_own_package
|
||||||
|
title: Compiler sa propre version d'un package Postmarket OS
|
||||||
|
date: 2024-02-18T00:00:00Z
|
||||||
|
description: Installation de pmbootstrap et compilation de sa propre version d'un package Postmarket OS
|
||||||
|
project_link: none
|
||||||
|
draft: true
|
||||||
|
tags:
|
||||||
|
- pmOS
|
||||||
|
- linux
|
||||||
|
---
|
||||||
|
|
||||||
|
## À propos de Postmarket OS
|
||||||
|
|
||||||
|
[Postmarket OS](https://postmarketos.org/) est une distribution basé sur [Alpine](https://www.alpinelinux.org/) conçu pour fonctionner sur les téléphones, 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 package 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](https://wiki.postmarketos.org/wiki/Pmbootstrap).
|
||||||
|
|
||||||
|
Une fois installé et configuré, il faut d'abord executer les commandes suivantes:
|
||||||
|
|
||||||
|
_Met à jour le repository [pmaports.git](https://wiki.postmarketos.org/wiki/Pmaports.git) cloné en local._
|
||||||
|
> Le repo pmaports.git stocke tous les packages Alpine avec le fichier fichier `APKBUILD` utilisé par le serveur de compilation.
|
||||||
|
>
|
||||||
|
> Le fonctionnement est similaire à `PKGBUILD` pour les utilisateurs de [Archlinux](https://archlinux.org/)
|
||||||
|
>
|
||||||
|
> Ce fichier contient toute la procédure pour prepare les sources, compiler le package depuis les sources, le numéro de version
|
||||||
|
> ainsi que la procédure pour vérifier si le package fonctionne correctement.
|
||||||
|
> Généralement on utilise les tests du projet comme les tests unitaires ou les tests fonctionnels.
|
||||||
|
```bash
|
||||||
|
pmbootstrap pull
|
||||||
|
```
|
||||||
|
|
||||||
|
_Met à jour le cache de la commande APK depuis l'environnement de travail_
|
||||||
|
> L'environnement de travail ce situe par défaut dans le dossier `$HOME/.local/var/pmbootstrap/`
|
||||||
|
```bash
|
||||||
|
pmbootstrap update
|
||||||
|
```
|
||||||
|
|
||||||
|
_Supprime le dossier de la commande chroot_
|
||||||
|
> 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.
|
||||||
|
> Ça évite de devoir faire une VM ou un container Linux juste pour changer quelque fichier.
|
||||||
|
>
|
||||||
|
> Dans notre cas, il correspont au système pour le téléphone utilisé pour le configuré avant de l'installer ou de le tester sur notre téléphone.
|
||||||
|
>
|
||||||
|
> Par défaut, il se situe dans le dossier `$HOME/.local/var/pmbootstrap/cache_git/pmaports/`
|
||||||
|
```bash
|
||||||
|
pmbootstrap zap
|
||||||
|
```
|
||||||
|
|
||||||
|
_[Optionnel] Changer la branche du repo [pmaports.git](https://wiki.postmarketos.org/wiki/Pmaports.git)_
|
||||||
|
> `$workdir` par défaut se situe dans le dossier `$HOME/.local/var/pmbootstrap/cache_git/pmaports/`
|
||||||
|
> Example de branche utile : `kde-nightly`
|
||||||
|
```bash
|
||||||
|
git -C $workdir checkout [branch]
|
||||||
|
```
|
||||||
|
|
||||||
|
## Compilation de notre package Alpine
|
||||||
|
|
||||||
|
Pour compiler le package, on utilise la commande `pmbootstrap build [package_name]`.
|
||||||
|
|
||||||
|
_Example de commande_
|
||||||
|
```bash
|
||||||
|
pmbootstrap \
|
||||||
|
-mp https://nightly.postmarketos.org/plasma-mobile/packages/ \
|
||||||
|
-mp http://mirror.postmarketos.org/postmarketos/ \
|
||||||
|
--details-to-stdout \
|
||||||
|
-j 32 \
|
||||||
|
-t 3600 -v \
|
||||||
|
build plasma-mobile \
|
||||||
|
--src $home/plasma-mobile/ \
|
||||||
|
--arch aarch64 \
|
||||||
|
-i \
|
||||||
|
-n
|
||||||
|
```
|
||||||
|
|
||||||
|
Dans cette example, j'ai utilisé les arguments suivants:
|
||||||
|
|
||||||
|
* `-mp` : Permet de définir un repository Alpine pour installer les packages.
|
||||||
|
> Dans l'example, j'utilise deux repos
|
||||||
|
>
|
||||||
|
> `https://nightly.postmarketos.org/plasma-mobile/packages/` : Contient la version en cours de développement de KDE Plasma Mobile
|
||||||
|
>
|
||||||
|
> `http://mirror.postmarketos.org/postmarketos/` : Le mirroir officiel de Postmarket OS
|
||||||
|
|
||||||
|
* `--details-to-stdout` : Affiche les logs stocké dans le fichier dans la console
|
||||||
|
* `-j N` : Défini le nombre core utilisé pour la compilation
|
||||||
|
> Dans mon cas, 32 core sur mon CPU.
|
||||||
|
* `-t [En seconde]` : Le nombre de secondes sans nouveau log dans le fichier avant d'abandonner la compilation
|
||||||
|
> Changé à 3600 secondes car plasma-mobile est assez long à compilé et il ne génère aucun log.
|
||||||
|
* `-v` : Mode verbeux pour les logs dans le fichier
|
||||||
|
* `--src` : Change les sources du package. Par défaut ce sont les sources défini dans le fichier `APKBUILD`
|
||||||
|
> Pour ma part, je souhaite utiliser mon propre code pour tester
|
||||||
|
* `--arch [arch]` : L'architecture CPU du téléphone
|
||||||
|
> Pour ma part, mon téléphone est en arm64v8 donc `aarch64`
|
||||||
|
* `-n` : Permet d'éviter de compiler les dépendances du package.
|
||||||
|
> En général, c'est pas recommandé par Alpine mais dans mon cas, je souhaite utilisé les dépendances depuis le repo
|
||||||
|
> mirroir officiel de Postmarket OS.
|
||||||
|
* `-i` : Permet de dire de compiler uniquement les dépendances du package défini dans le fichier `APKBUILD`
|
||||||
|
> Dans mon cas, il vient en complément de l'option `-n`, ça me permet de m'assurer de ne rien build.
|
||||||
|
> Sans cette option, il risque de compiler les sous-dépendances du package comme le noyau Linux.
|
||||||
|
|
||||||
|
Pour plus d'informations, il suffit de taper la commande
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pmbootstrap build --help
|
||||||
|
```
|
||||||
|
|
||||||
|
Et pour avoir les arguments générals
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pmbootstrap --help
|
||||||
|
```
|
||||||
|
|
||||||
|
## Envoie du package sur le téléphone
|
||||||
|
|
||||||
|
Une fois le package compilé, il suffit de demandé à `pmbootstrap` de l'envoyé sur notre téléphon via la connexion SSH.
|
||||||
|
Avec `pmbootstrap`, on utilise la commande `sideload` comme dans l'example ci-dessous.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pmbootstrap sideload plasma-mobile \
|
||||||
|
--host [SSH HOST] \
|
||||||
|
--port [SSH PORT] \
|
||||||
|
--user [SSH USER] \
|
||||||
|
--arch [ARCH] \
|
||||||
|
--install-key
|
||||||
|
```
|
||||||
|
|
||||||
|
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éfini pour le téléphone (Ex: aarch64)
|
||||||
|
* `--install-key` : Permet d'installer la clef utilisé pour la vérification des packages 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 ont rajoute 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.
|
||||||
|
```bash
|
||||||
|
sudo apk upgrade -a
|
||||||
|
```
|
||||||
|
|
||||||
|
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.
|
||||||
|
```bash
|
||||||
|
sudo apk fix --force
|
||||||
|
```
|
||||||
Loading…
Reference in a new issue