Une place pour une véritable innovation. Partagez vos propres utilitaires créés avec la communauté Manjaro.
Questions et discussions sur la programmation et le codage.
Répondre

Procédure pour soumettre un paquet sur AUR-git

#1Messageil y a 8 ans

Bonjour à tous

Pour les utilisateurs qui voudraient œuvrer pour la communauté par l'intermédiaire de soumission de paquets, cette procédure détaillée est basée sur du vécu ; je remercie vivement lemust83 pour le coup de main qu'il m'a apporté pour arriver à mes fins. papajoke m'a donné un coup de main appréciable en relisant/contrôlant ce sujet. Merci à eux deux :bien

Tout d'abord, un peu de doc, ce sujet archlinux (in british)
Une autre doc, cette page du wiki francophone
Autre doc rendant bien service. Cette dernière est obsolète, mais il est utile de la lire car c'est un excellent point de départ.


1) En tout premier il faut installer 3 paquets :

sudo pacman -S openssh git pkgbuild-introspection
Edit: pkgbuild-introspection n'est plus dans les dépôts officiels. Il faut passer par Aur pour l'installer. Ce paquet permet de générer le fichier .SRCINFO (tarball). mais la commande makepkg --printsrcinfo > .SRCINFO permet de s'en passer

A partir d'ici nous n'interviendrons uniquement qu'en tant qu'utilisateur normal.

2) Vous pouvez aussi dès à présent songer à concocter une passphrase suffisamment complexe, facile à se rappeler et différente du MP qui vous sera demandé lors de votre inscription sur AUR...


3) Ensuite on va créer une clé ssh reconnue dans AUR en passant la commande suivante (en simple utilisateur) :

ssh-keygen -f ~/.ssh/id_rsa-aur
Un répertoire ~/.ssh/id_rsa-aur.pub s'est créé contenant la clé publique.


4) S'enregistrer sur Aur (si ce n'est déjà le cas)
Renseigner son pseudo, son adresse email.
PGP Key Fingerprint > laisser vide
Dans la fenêtre SSH Public Key, copier-coller le contenu de ~/.ssh/id_rsa-aur.pub. Si cette dernière action n'est pas indispensable, ne le faites pas maintenant, vous le ferez au point 5).


5) Se connecter sur AUR > Mon compte (à droite on peut passer de l'english au français).
Copier-coller la clé contenue dans ~/.ssh/id_rsa-aur.pub dans le carré Clé SSH publique.
Même si c'est déjà fait par défaut, le refaire puis Mise à jour.


6) On modifie le fichier ~/.ssh/config en y mettant ceci (si le fichier n'existe pas, le créer) :

Host aur.archlinux.org
IdentityFile ~/.ssh/id_rsa-aur
User aur
Port 22
*=*=*=*=*=*=*

CRÉATION D'UN PAQUET GIT

7) Assurez-vous que votre PKGBUILD est bien fonctionnel, vérifiez-le plutôt deux fois qu'une, qu'il ne manque aucunes dépendances. Vous pouvez vous aider de namcap (à installer par pacman).
Voir ce sujet :
https://wiki.archlinux.org/title/PKGBUI ... %C3%A7ais)

Assurez-vous aussi que le paquet que vous projetez de publier ne l'est pas déjà. Inutile d'encombrer AUR.


8) Passer la commande suivante, en utilisateur simple :

git clone git+ssh://aur@aur.archlinux.org/nom_du_paquet.git
Vous allez obtenir ce retour :

Clonage dans 'nom_du_paquet'...
Enter passphrase for key '/home/votre_user/.ssh/id_rsa-aur': 
warning: Vous semblez avoir cloné un dépôt vide.
Vérification de la connectivité... fait.
Un répertoire portant le nom de votre paquet s'est créé dans votre home (dossier personnel).

Y mettre au minimum le PKGBUILD et .SRCINFO plus, éventuellement, un fichier d'installation xxxxx.install mais jamais les sources du paquets.

Pour obtenir le .SRCINFO, ouvrir un terminal dans le répertoire contenant le PKGBUILD et taper la commande suivante :

mksrcinfo
ou si pkgbuild-introspection n'est pas installé

makepkg --printsrcinfo > .SRCINFO

9) Créer dans votre dossier personnel (home), s'il n'existe déjà, le fichier .gitconfig et mettre dedans :

[user]
         email = votre_email_renseignée_lors_de_votre_inscription_chez_AUR
         name = votre_pseudo
[push]
         default = simple

10) Vous placer dans le répertoire contenant le PKGBUILD et .SRCINFO, et passer les commandes suivantes :

git add PKGBUILD .SRCINFO
git commit -m 'Initial import'
git push origin master
Lors du "push", aur va automatiquement vérifier la syntaxe de ces 2 fichiers et peut vous retourner des messages d'erreurs.

Lors de ces procédures, quand il vous est demandé 'Enter passphrase', veuillez entrer ce qui a été vu au point 2).

Vous pouvez ensuite aller vérifier, votre paquet doit être sur AUR.


*=*=*=*=*=*=*

MODIFICATION D'UN PAQUET GIT

11) On modifie le pkgbuild puis on entre les commandes suivantes :

makepkg --printsrcinfo > .SRCINFO
git commit -am 'Modif....'
git push origin master
Note : par sécurité, on peut souhaiter ne pas réutiliser un dépôt local mais préférer télécharger la dernière version sur aur et retravailler à partir d'elle.

git clone git+ssh://aur@aur.archlinux.org/nom_du_paquet.git
Commande possible avec uniquement ces propres paquets !

Procédure pour soumettre un paquet sur AUR-git

#2Messageil y a 8 ans

Pour la configuration locale de git , le fichier ~/.gitconfig au point 9)

L'email et le login sont obligatoires mais elles ne sont que informatives :
- L'adresse email sera publique...
- Il n'est pas obligatoire d'utiliser le login et email entrés lors de l'inscription dans aur: aur n'utilise pas ce champ "name" pour vous l'attribuer ou pour se connecter et, n'utilise pas cet email pour vous notifier; ce ne sont normalement que 2 valeurs qui vont apparaître publiquement dans les dépôts git pour l'échange d'informations entre développeurs travaillant sur un même paquet.
- Généralement le champ user.name contient le nom et prénom et non un pseudo

Donc si vous avez déjà un compte github, gitlab ou bitbucket il n'est pas nécessaire de changer ces valeurs.

Bonnes contributions à vous

Procédure pour soumettre un paquet sur AUR-git

#3Messageil y a 8 ans

À l'étape 11, sauf erreur de ma part, il faut ajouter :

git add .


ou encore

git add .SRCINFO PKGBUILD
et les autres fichiers nécessaires avant le

git commit -am


Du moins, c'est ainsi que je fais avec ma trentaine de paquets sur aur4. https://aur.archlinux.org/packages/?SeB=m&K=FredBezies

Procédure pour soumettre un paquet sur AUR-git

#4Messageil y a 8 ans

bonjour Fred

il n'est pas obligatoire de re-faire un git add puisque les fichiers sont déjà marqués comme suivi
l'option -a dans le commit va le refaire automatiquement.



par contre avant le commit je fais (toujours) un

git diff
Image
histoire d'avoir un rapide résumé de mes changements (rouge remplacé par le vert)
git diff affiche automatiquement les différences entre la version normalement en ligne(le dernier commit) et les fichiers suivis en cours non encore commités

------------------------------------------------------------------------------------

ps: il existe de nombreux plugins (powerline-shel,liquidprompt...) au prompt (zsh et bash) pour nous aider à voir le statut, la branche de notre dépôt gif :
Image

Procédure pour soumettre un paquet sur AUR-git

#5Messageil y a 8 ans

Salut papajoke, salut Fred

Je corrigerai le tuto une fois que vous vous mettrez d'accord, je n'ai pas assez l'expérience pour juger de vos propos.
Donc, après réflexion, faites un résumé sur lequel vous tombez d'accord :gsourire:

Procédure pour soumettre un paquet sur AUR-git

#6Messageil y a 8 ans

Je n'ai pas super l'habitude de git. Je n'ai fait que suivre les recommandations du wiki :D

Procédure pour soumettre un paquet sur AUR-git

#7Messageil y a 8 ans

'LLo Fred,

M'en parle pas, il faut que je m'y mette (à giter) & pour l'instant, c'est plutôt à reculons, pfuuu... :siffle

Procédure pour soumettre un paquet sur AUR-git

#8Messageil y a 7 mois

@ ewolnux

Bonjour,
Le lien au point 7 est cassé
ewolnux a écrit : il y a 8 ans .../...
7) Assurez-vous que votre PKGBUILD est bien fonctionnel, vérifiez-le plutôt deux fois qu'une, qu'il ne manque aucunes dépendances. Vous pouvez vous aider de namcap (à installer par pacman).
Voir ce sujet :
https://wiki.archlinux.fr/Standard_paquetage
Slt

Procédure pour soumettre un paquet sur AUR-git

#9Messageil y a 7 mois

Répondre