GiteaPC : Installer et mettre à jour automatiquement des projets Gitea
Posté le 01/01/2021 23:19
Ce topic fait partie de la série de topics du fxSDK.
GiteaPC est un programme Python qui automatise l'installation de projets de la
la forge Git de Planète Casio. Son usage principal est d'installer et mettre à jour le
fxSDK de façon automatique.
Le code source est sur le dépôt Git
Lephenixnoir/GiteaPC. Merci notamment à
Breizh_craft,
Dark Storm et
Cakeisalie5 qui m'ont bien aidé à cerner un design plus élégant.
Installation de GiteaPC
Pour Mac OS : GiteaPC fonctionne, mais il y a quelques ajustements à faire. Voyez
le guide de Choukas.
Il y a quelques dépendances à installer. Voici la commande pour les distributions les plus communes sur Planète Casio : copiez la commande (la ligne après le
%) dans un terminal puis appuyez sur Entrée (votre mot de passe sera demandé).
# Si vous avez Debian, Ubuntu, WSL sous Windows, Linux Mint ou d'autres dérivés de Debian :
% sudo apt install curl git python3 build-essential cmake pkg-config
# Si vous avez Arch Linux, Manjaro, ou d'autres dérivés d'Arch Linux :
% sudo pacman -S curl git python3 gcc make cmake pkgconf
Ensuite vous pouvez installer GiteaPC en une ligne avec la commande suivante :
% curl "https://git.planet-casio.com/Lephenixnoir/GiteaPC/raw/branch/master/install.sh" -o /tmp/giteapc-install.sh && bash /tmp/giteapc-install.sh
Vous pouvez
consulter le script ici ou faire l'installation manuelle depuis le dépôt
Lephenixnoir/GiteaPC si vous préférez ça.
Vous aurez probablement besoin de mettre à jour votre PATH. Si vous ne connaissez pas le PATH ou avez du mal à le situer, vous pouvez lire le
Tutoriel du Mercredi #20 sur ce sujet. Si ça se produit, GiteaPC vous demandera de modifier le PATH en ces termes :
<giteapc> In order to use programs installed by GiteaPC, you will need to add their
<giteapc> install folder to your PATH. This can be done automatically when you log
<giteapc> in by adding the following command to your startup file:
<giteapc>
<giteapc> export PATH="$PATH:/home/el/.local/bin"
<giteapc>
<giteapc> -> Press Enter to add this command to /home/el/.profile, or
<giteapc> -> Type another file name to add this command to, or
<giteapc> -> Type "-" to skip setting the PATH entirely.
>
Si vous n'utilisez pas votre
.profile,
.bashrc ou équivalent (ou ne savez pas ce que c'est), appuyez sur Entrée puis fermez et rouvrez votre session (ou redémarrez votre ordinateur). Si vous utilisez
.profile ou équivalent, alors vous comprenez certainement la question, faites ce que vous préférez.
Pour vérifier que l'installation a fonctionné, lancez la commande
giteapc. Vous devez obtenir un message d'aide coloré avec la liste des commandes.
giteapc peut se mettre à jour tout seul donc vous n'aurez plus besoin de refaire ce travail d'installation.
Installation du fxSDK avec GiteaPC
Le fxSDK et toutes les bibliothèques qui vont avec (que je gère, du moins) peuvent être obtenues avec GiteaPC. Le fxSDK dépend de quelques bibliothèques dont vous aurez besoin (même formule que précédemment, attention à bien copier la commande complète d'un coup même si elle s'affiche sur plusieurs lignes) :
# Debian, Ubuntu, WSL sous Windows, Linux Mint, dérivés de Debian :
% sudo apt install python3-pil libusb-1.0-0-dev libudev-dev libsdl2-dev libpng-dev libncurses-dev
# En option pour fxlink -s :
% sudo apt install libudisks2-dev libglib2.0-dev
# ArchLinux, Manjaro, dérivés d'ArchLinux :
% sudo pacman -S python-pillow libusb sdl2 ncurses patch
# En option pour fxlink -s :
% sudo pacman -S udisks2
Avec ces dépendances, vous pouvez obtenir un environnement de développement avec gint et le fxSDK en quelques étapes. Prenez garde aux cas particuliers suivants :
- Si jamais vous avez déjà une version de binutils/GCC installée après le fxSDK 2.9 et que vous ne voulez pas les recompiler (ce qui prend ~30 minutes), vous pouvez ajouter :any après Lephenixnoir/sh-elf-binutils et Lephenixnoir/sh-elf-gcc.
- Si votre Linux n'utilise pas UDisks2 comme gestionnaire de périphériques (vous pouvez tester si la commande udisksctl existe), ajoutez :noudisks2 après Lephenixnoir/fxsdk. Cela désactivera l'option -s de fxlink qui utilise UDisks2 pour copier des fichiers vers les Graph 35+E II et Graph 90+E depuis la ligne de commande.
- Si vous avez déjà une installation du fxSDK installée sans GiteaPC ou avant la version fxSDK 2.9, vous devez la supprimer avant de commencer, sinon tout va interférer et ce sera le chaos !
Cela étant vu, on commence par installer les outils principaux du fxSDK et le cross-compilateur. Pendant qu'on y est, on installe aussi le debugger (optionnel) :
% giteapc install Lephenixnoir/fxsdk Lephenixnoir/sh-elf-binutils Lephenixnoir/sh-elf-gcc
% giteapc install Lephenixnoir/sh-elf-gdb
Ensuite on installe la lib mathématique, la libc, et on repasse sur GCC pour obtenir la lib C++ :
% giteapc install Lephenixnoir/OpenLibm Vhex-Kernel-Core/fxlibc
% giteapc install Lephenixnoir/sh-elf-gcc
Et enfin on installe gint (et si vous le voulez d'autres libs) :
% giteapc install Lephenixnoir/gint # Lephenixnoir/libprof Slyvtt/cZlib1_2_5 ...
À partir de là vous pouvez coder des add-ins.
Vous pouvez toujours consulter les dépôts clonés par GiteaPC avec la commande
giteapc show -p :
cd $(giteapc show -p Lephenixnoir/fxsdk)
Si vous voulez juste coder avec le fxSDK, jetez un œil à la section suivante pour les mises à jour puis vous pouvez arrêter de lire. Le reste de ce topic parle des détails de GiteaPC, qui ne sont pas importants pour juste programmer des add-ins.
Enrichir et mettre à jour une installation du fxSDK avec GiteaPC
Pour installer un nouveau dépôt qui supporte GiteaPC, par exemple la bibliothèque
libprof, utilisez
giteapc install.
giteapc install Lephenixnoir/libprof
Vous pouvez tout mettre à jour avec
giteapc install -u. GiteaPC vous autorise à donner les noms des dépôts sans leur propriétaire s'il n'y a pas d'ambiguïté, ce qui est un peu risqué quand il s'agit des dépôts distants (à l'installation) mais pas trop quand il s'agit de dépôts locaux (durant une mise à jour).
giteapc install -u sh-elf-binutils sh-elf-gcc fxsdk gint libprof
Et voilà, tout est à jour.
Instructions d'utilisations plus précises
Lister et rechercher des dépôts
Utilisez
giteapc list -r pour lister les dépôts de la forge qui peuvent être installés avec Gitea, et
giteapc list pour lister tous les dépôts que vous avez sur votre ordinateur.
Si un argument supplémentaire est donné, il servira à filtrer par nom et par description. Par exemple,
giteapc list -r gcc.
Installer et mettre à jour des dépôts
Utilisez
giteapc install pour installer un dépôt et
giteapc install -u pour mettre à jour un dépôt. La différence c'est qu'avec -u les nouveautés seront téléchargées avant l'installation (git pull).
Installer des versions spécifiques
Les noms des dépôts dans les commandes
install et
build acceptent deux suffixes :
@version et
:config (dans cet ordre). Le premier permet de sélectionner (git checkout) une branche ou un tag. Le second permet de modifier les options de compilation si le dépôt en supporte (par exemple binutils et GCC ont une configuration
:any discutée précédemment).
Par exemple, pour installer spécifiquement binutils 2.35.1, on peut utiliser la commande ci-dessous. Notez que du coup le dépôt est figé à la version 2.35.1 et ne sera pas mis à jour (même avec -u) tant que vous n'installerez pas explicitement
sh-elf-binutils@master pour revenir sur la branche principale.
giteapc install Lephenixnoir/sh-elf-binutils@2.35.1
Pour installer binutils mais utiliser une version déjà installée au bon endroit sans le recompiler, on peut utiliser la configuration
:any.
giteapc install Lephenixnoir/sh-elf-binutils:any
Commandes fines
•
giteapc fetch permet de clôner ou mettre à jour (git fetch) un dépôt sans toucher à rien.
•
giteapc build permet de configure/build un dépôt sans l'installer ou de recompiler sans reconfigurer.
•
giteapc show permet de voir les versions disponibles d'un dépôt local ou distant.
Voyez l'aide (
giteapc --help) pour le détail des options.
Désinstaller un dépôt
giteapc uninstall désinstalle un dépôt et supprime le clône local,
giteapc uninstall -k déinstalle le dépôt mais garde le clône local. Les dépendances ne sont pas vérifiées durant une désinstallation donc gardez un œil dessus.
Créer un projet supportant GiteaPC
Pour pouvoir être installé par GiteaPC, un dépôt doit avoir les choses suivantes :
• Le topic
giteapc sur le dépôt (qu'on peut ajouter en cliquant sur le lien "Manage topics" sur la page principale du dépôt) : c'est ce qui permet au dépôt d'apparaître dans
giteapc list -r.
• Fournir un
giteapc.make qui contient quelques métadonnées, qui inclut optionnellement
giteapc-config.make et fournit quatre cibles
configure,
build,
install et
uninstall (plus de détails ci-dessous).
• Avoir
giteapc-config.make dans le
.gitignore.
giteapc-config.make sera un lien symbolique pointant vers la configuration courante, laquelle sera nommée
giteapc-config-X.make pour
:X.
Le
giteapc.make doit ressembler à ça :
# giteapc: version=1
# giteapc: depends=Lephenixnoir/sh-elf-gcc
-include giteapc-config.make
configure:
...
build:
...
install:
...
uninstall:
...
.PHONY: configure build install uninstall
D'abord les métadonnées ; il y en a deux pour l'instant :
version (doit être "1") et
depends (liste des dépendances). Ensuite l'inclusion de
giteapc-config.make quand une configuration est demandée. Et enfin, les règles
configure,
build,
install et
uninstall, dans lesquelles vous pouvez lancer le code qui va bien.
Quelques exemples :
sh-elf-gcc,
fxsdk,
Template-gint-library.
Citer : Posté le 17/01/2024 19:01 | #
Je sais pas ce que tu appelles une application virtuelle.
fxsdk est un script (au sens un fichier de commandes) qui permet de faire diverses actions:
- créer un nouveau projet : via la commande fxsdk new nom_du_projet
- compiler un projet : via la commande fxsdk build-cg si la cible est la G90+E ou fxsdk build-fxsi la cible est la fx9860G
et quelques autres trucs marrants via des options:
-s pour envoyer via fxlink
-B pour forcer la recompilation de tous les .c / .S
etc...
donc ça a rien de virtuel
Citer : Posté le 17/01/2024 19:03 | #
et comment tu fais pour éditer un programme? sinon je croyais que c'était une application (.exe) que tu lancais
Citer : Posté le 17/01/2024 19:04 | #
Tu édites les fichiers source et tu recompiles.
Caltos : G35+EII, G90+E (briquée )
Citer : Posté le 17/01/2024 19:06 | #
Non, pour ça tu lances un éditeur de texte. Tu as le choix sous linux :
- soit des IDE de dev (vscode, codium, codeblocks, CLion, ...)
- soit des éditeurs de texte (vim, emacs, kate, gedit, ...)
Le fxSDK se charge de compiler ton code pour en faire un addin. Il ne gère pas l'édition du code.
Citer : Posté le 17/01/2024 19:07 | #
ahh ok donc je peux juste l'éditer avec vscode et je peux meme utiliser l'éxtension de Yannis300307 pour m'aider?
EDIT: merci tout le monde (je n'avais pas vu les messages)
Citer : Posté le 17/01/2024 19:08 | #
Exactement
Caltos : G35+EII, G90+E (briquée )
Citer : Posté le 17/01/2024 19:20 | #
par contre, j'avais déja un compilateur gcc, et mtn il reste bloqué pendant 40 min sur ca:
<sh-elf-gcc> Compiling gcc (usually 10-20 minutes)...
Citer : Posté le 17/01/2024 19:27 | #
Non c'est normal, il faut un autre GCC, qui est compilé sur ta machine, pour compiler pour calculatrice
Caltos : G35+EII, G90+E (briquée )
Citer : Posté le 17/01/2024 19:34 | # | Fichier joint
ok c'est bon mais il est toujours en train de charger regarde le FJ
Citer : Posté le 17/01/2024 19:46 | #
Si tu as un PC plus bas de gamme/vieux c'est plus ou moins normal.
Caltos : G35+EII, G90+E (briquée )
Citer : Posté le 17/01/2024 19:47 | #
Il a 5 ans
Citer : Posté le 17/01/2024 20:55 | #
Dsl pour le triple post.
[...]
tu peux éditer (modifier) tes messages plutôt que de créer des nouveaux messages à la suite des précédents
https://joz.alwaysdata.net/info/
Citer : Posté le 23/01/2024 09:39 | #
Désolé de vous importuner
mais je n'arrive pas à exécuter giteapc
giteapc : commande introuvable
$ ls -la /home/joz/.local/bin/
total 16
drwxr-xr-x 2 joz joz 4096 23 janv. 08:56 .
drwx------ 5 joz joz 4096 23 janv. 08:56 ..
-rwxr-xr-x 1 joz joz 5426 23 janv. 09:27 giteapc
ou alors par ./giteapc ?
Edit1
je suis sous Debian
Linux emachines 6.1.0-17-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.1.69-1 (2023-12-30) x86_64 GNU/Linux
https://joz.alwaysdata.net/info/
Citer : Posté le 23/01/2024 09:43 | #
Citer : Posté le 23/01/2024 09:43 | #
C'est la partie PATH qui te manque. Tu as une variable d'environnement dans ton terminal (que tu peux afficher avec la commande echo "$PATH") qui dit au terminal dans quels dossiers chercher les programmes quand tu les appelles par leur nom. Manifestement ton dossier /home/joz/.local/bin n'est pas dedans.
Si tu cherches "PATH" dans l'article ci-dessus tu verras que GiteaPC essaie normalement de modifier le PATH automatiquement pour toi en ajoutant /home/joz/.local/bin dans la variable en modifiant un fichier (typiquement /home/joz/.profile). Cette modification ne prend effet qu'après avoir redémarré ta session, donc vérifie déjà si tu as fait ça.
Si redémarrer ne suffit pas, on peut regarder ensemble dans quel fichier ajouter la commande pour que le PATH soit mis à jour automatiquement sur ta machine.
Citer : Posté le 23/01/2024 09:46 | #
j'avais déja redémarré mais je redémarre à nouveau..
j'éditerai cette réponse
Edit 1
Après redémarrage complet la commande n'est pas reconnu
Edit 2
. ~/.bashrc
export PATH="$PATH:/home/joz/.local/bin"
export PATH="$PATH:/home/joz/.local/bin"
tiens c'est en double
https://joz.alwaysdata.net/info/
Citer : Posté le 23/01/2024 09:56 | #
Ok alors regarde dans /home/joz/.local/bin si tu as bien un exécutable qui s'appelle giteapc.
Si c'est OK qu'il est bien présent alors il faut que tu édites le fichier .profile ou par exemple .bashrc dans ton /home/joz et que tu vérifies que la ligne de définition du PATH contient bien /home/joz/.local/bin. Si pas présent, tu l'ajoutes.
Ensuite tu relances une session et ça devrait fonctionner.
Citer : Posté le 23/01/2024 09:57 | #
Si tu fais un echo $SHELL ça donne quoi ?
Citer : Posté le 23/01/2024 09:58 | #
On s'est croisé. Enlève une des 2 lignes et relances ta session.
As tu bien présent giteapc dans /home/joz/.local/bin ?
Citer : Posté le 23/01/2024 10:14 | #
Si tu fais un echo $SHELL ça donne quoi ?
/bin/bash
https://joz.alwaysdata.net/info/
Citer : Posté le 23/01/2024 10:17 | #
Tu peux exécuter ça et nous donner le résultat pour chaque commande stp ?
cat ~/.bashrc
source .profile
source .bashrc
echo $PATH
which giteapc