====== Comment tester Ncooker ? ====== Cette page explique comment tester la **version en cours de développement** de Ncooker. Avant toute chose, il est important de préciser que personne n'est responsable des dégâts que Ncooker pourrait causer à votre système/ordinateur. Il s'agit d'un programme en cours de développement et qui manipule les fichiers de votre système, risquant de le rendre inutilisable. Vous êtes **seul responsable** dans le choix de l'exécuter sur votre système. Il est fortement recommandé de lire les explications jusqu'à la fin avant de lancer la moindre commande. Note : les instructions barrées ne sont plus nécessaires pour tester la branche principale de Ncooker. Elles sont, par contre, nécessaires pour tester les branches utilisant encore le fichier infos (au format XML). ===== Pré-requis ===== Avant d'installer Ncooker, vous devez disposer notamment des logiciels suivants sur votre système : * **bash** >= 3.0 (http://www.gnu.org/) * <del>**xmlstarlet** >= 1.0.1 (http://xmlstar.sourceforge.net/)</del> * **p7zip** >= 4.20 (http://p7zip.sourceforge.net/) ===== Récupération de Ncooker ===== La version de développement de Ncooker peut être récupéré sur le dépôt Subversion de la façon suivante : <code> $ svn co svn://svn.gna.org/svn/nasgaia/trunk/nlib $ svn co svn://svn.gna.org/svn/nasgaia/trunk/ncooker </code> Ces deux commandes vont récupérer : * l'ensemble des librairies partagées "nlib" (dans un sous-répertoire du répertoire courant nommé "nlib") * la dernière version de développement de Ncooker (dans un sous-répertoire du répertoire courant nommé "ncooker"). ===== Construction de Ncooker ===== Un moyen permet de construire Ncooker sans l'installer sur votre système. Avec un utilisateur quelconque, vous pouvez taper ceci : <code> $ cd ncooker $ make clean && make CONFIG=MConfig.cwd </code> ===== Paramétrage de Ncooker ===== Il convient d'abord de créer un fichier de configuration personnel : <code> $ mkdir ~/.Ncooker $ vi ~/.Ncooker/Ncooker.conf NC_PKG_AUTHOR='Prenom Nom <adresse@electronique.org>' NC_ROOT_DIR=${HOME}'/root' :wq </code> La variable ''NC_PKG_AUTHOR'' doit être obligatoirement définie pour construire un Nbuild. Elle sert à indiquer l'auteur des Nbuilds et des NBAs créés avec Ncooker. Il faut y mettre votre nom ou votre pseudonyme ainsi qu'une adresse électronique où vous pouvez être contacté. La variable ''NC_ROOT_DIR'' n'a rien d'obligatoire mais elle est fortement conseillé si vous testez en tant qu'utilisateur quelconque ou si vous ne voulez pas toucher à votre système. En effet, cette variable définit la racine du système dans laquelle les paquets NBA seront installés/supprimés par Ncooker. Vous pouvez y définir n'importe quel répertoire existant, pour peu qu'il n'aura aucun impact sur votre système. <del>Il faut ensuite initialiser la base de données Ncooker : <code> $ Ncooker config --initdb </code> Dans le répertoire que vous avez défini comme racine de système, vous pouvez alors constater que Ncooker y a créé des répertoires et des fichiers servant de base de données. </del> ===== Test de Ncooker ===== À partir de là, vous pouvez faire tous les tests que vous voulez. Si vous ne savez pas par où commencer, un point de départ est peut-être de lancer la commande ''Ncooker --help'' pour afficher l'aide de Ncooker. Néanmoins, voici quelques manipulations basiques. ==== Création d'un répertoire de travail ==== Le plus simple est de générer un répertoire de travail pour faire un paquet Nbuild à partir des modèles de fichier <del>''infos''</del> ''project'', ''package'' et ''build'' fournis avec Ncooker : <code> $ Ncooker wizard foobar </code> Cette commande crée un sous-répertoire nommé ''foobar'' dans le répertoire courant, contenant des modèles de fichier <del>''infos''</del> ''project'', ''package'' et ''build''. Ces deux fichiers sont totalement commentés. Vous devez les compléter/modifier avec les informations nécessaires pour compiler le projet que vous voulez. Si vous ne voulez pas des commentaires, vous pouvez ajouter l'option ''--no-comment'' à la ligne de commande ci-dessus. Le fichier ''build'' est optionnel. S'il n'y en pas dans le Nbuild, Ncooker utilisera un comportement par défaut pour compiler le projet. ==== Création d'un paquet Nbuild ==== Vous pouvez créer un paquet [[paquet_nbuild|Nbuild]] en faisant : <code> $ Ncooker pack foobar </code> Vous obtenez alors un paquet Nbuild dans le répertoire courant. ==== Construction d'un paquet NBA ==== Vous pouvez obtenir un paquet [[paquet_nba|NBA]] en tapant : <code> $ Ncooker build foobar-1.0-nga1.nbuild </code> Si tout se passe bien, vous devez obtenir un paquet NBA nommé ''foobar-1.0-nga1-i686.nba'' ==== Installation d'un paquet NBA ==== Le paquet NBA s'installe en tapant : <code> $ Ncooker install foobar-1.0-nga1-i686.nba </code> Le paquet NBA s'installe dans la racine spécifiée par la variable de configuration ''NC_ROOT_DIR''. ==== Désinstallation d'un paquet NBA ==== Pour désinstaller, vous pouvez taper : <code> $ Ncooker remove foobar </code> Il y a plusieurs manières d'indiquer le paquet à désinstaller. Lancer ''Ncooker remove --help'' pour plus d'infos. ==== Astuce ==== Il est possible de ne taper que les premières lettres d'une commande pour la lancer. Exemple : <code> $ Ncooker w foobar </code> Cette syntaxe lance la commande « wizard ». Si plusieurs commandes correspondent aux lettres saisies, la première commande trouvée dans l'ordre alphabétique est lancée. Il est recommandée de taper au minimum deux ou trois lettres. ===== Rapport d'anomalie ===== Si vous détectez une anomalie ou bien que quelque chose vous semble anormal, vous pouvez (par ordre de préférence) : * utiliser le gestionnaire d'anomalies pour rapporter les dysfonctionnements (https://gna.org/bugs/?group=nasgaia) ; * en discuter sur la liste de diffusion nasgaia-dev (https://mail.gna.org/listinfo/nasgaia-dev/) ; * en discuter sur le canal IRC (serveur irc.freenode.net, canal #nasgaia). Bons tests !

 
tester_ncooker.txt · Dernière modification: 29/08/2007 21:09 par julienl
 
Recent changes RSS feed Creative Commons License Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki