====== Introduction ====== **Bienvenue !** Ce guide a pour objet de faciliter la tâche du packageur nasgaïen, entendez par là le faiseur de nbuilds ! Ncooker, le gestionnaire de paquets, n'est pas encore terminé mais certaines orientations peuvent néanmoins être développées ici. ====== Les ressources ====== * Manuel Ncooker (la référence, à paraître) * [[Memento Ncooker]] ====== Création d'un nbuild ====== Dans ce tutoriel, nous imaginons vouloir créer un nbuild pour un paquet ''toto-1.0''. ====Les données==== * Règles spécifiques Nasgaïa * File Hierarchy System * L'architecture visée est i686 pour les nbas, d'autres pourront s'ajouter. * Le principe d'un nbuild, c'est de ne RIEN installer sur le vrai système, donc pas de make install directement ! ====Les pièges à éviter==== Vérifiez que le nbuild n'existe pas déjà ! ====Sources du logiciel==== Avant d'entamer la création du nbuild, il convient de télécharger et étudier les sources du logiciel. * Quelle est sa chaîne de compilation ? * L'installation respecte-t-elle les règles Nasgaïa et FHS ? * Quelle est sa licence ? * liste à compléter ====Création ex-nihilo==== Lancez la commande : <code> $: Ncooker wizard --files toto </code> Une série de questions vous est posée pour créer un répertoire contenant les fichiers infos et build, puis un nbuild "modèle" est généré automatiquement. Et non ce n'est pas fini ! Vous devrez compléter les fichiers build et infos manuellement. ====Création par analogie==== Ou la reprise d'un nbuild existant. ====Le fichier infos==== ====Le fichier build==== ====Les patches==== ====Le répertoire res (ressources)==== ====Le nbuild==== Placer vous dans le répertoire ou sont vos fichiers, puis utilisez : <code> #: Ncooker pack </code> Un fichier ''toto-1.0-nga1.nbuild'' sera créé. Ce fichier doit être placé dans le répertoire /var/Ncooker/Nbuilds, il doit maintenant être testé. ====== Vérification & Validation ====== ====Par vous-même==== ====Par l'équipe packaging Nasgaïa==== Votre nbuild est officiellement validé. Bravo !! ====== Publication ====== Le nbuild ainsi validé sera mis à disposition des utilisateurs via Subversion. Le nba produit peut également l'être, notamment pour les logiciels demandant un temps de compilation important. ====== Modification ====== L'évolution naturelle des logiciels demande une gestion attentive des paquets inclus dans la distribution. Rappelons que rien n'oblige le premier créateur du paquet à maintenir celui-ci ; toutefois, demandez lui son avis avant d'engager une modification. Le processus de modification est le même que celui de création, les étapes de vérification et validation comprises. ====== Gestion des bugs ====== Les bugs détectés apès publication seront gérés à l'aide du Bug Tracker disponible sur gna!. Il existe une liste de diffusion [[https://mail.gna.org/listinfo/nasgaia-bugs/|Nasgaïa Bugs]]. Tout membre du projet inscrit à cette liste reçoit une notification par mail dès qu'un bug est ajouté/modifié sur le Bug Tracker.