Mkd (Extracteur de documents)/Maintenance des paquets debian
Mkd (Extracteur de documents)
Maintenance des paquets Debian
https://fr.wikibooks.org/wiki/Mkd(Extracteur_de_documents)
Introduction
mkd est une commande standard pour les systèmes d'exploitation Unix, Linux.
Il est possible de compiler et installer la commande mkd pour tous les systèmes d'exploitation.
→ Des versions ont été compilées pour MS-Windows
Les paquets facilitent l'installation des applications et ils offrent une meilleure sécurité lorsqu'ils ont été téléchargés depuis un dépôt. Les auteurs sont connus et disposent de clés de sécurité pour effectuer leur dépôt.
Sommaire
- 1. Exercice pour comprendre l'empaquetage Debian
- Un exercice simple pour créer un paquet local expérimental.
- 2. Exercices de mises à jour des paquets
- On aborde quatre thèmes :
- L'empaquetage d'une application existante pour une série.
- Créer des patchs pour réparer les bogues dans une série.
- Faire évoluer les versions en y ajoutant des fonctionnalités et créer une nouvelle série.
- Créer un paquet natif.
- + Apprentissage de téléversements sur Launchpad
- On aborde quatre thèmes :
- 3. Application et construction d'un paquet natif avec CDBS
- Créer une nouvelle version avec :
- Une réorganisation du répertoire origine
- Un fichier Makefile spécifique à l'empaquetage
- Un empaquetage avec CDBS
- Créer une nouvelle version avec :
Exercice pour comprendre l'empaquetage Debian
Sommaire
1 Créer un paquet debian
2 Le paquet
2.1 Que doit-il faire ?
2.2 Choix de l'exécutable
2.3 Structure de l'archive projet-mkmaintainerdocu.tar.gz
2.3.1 changelog.debian
2.3.2 copyright
2.3.3 changelog
2.3.4 README
2.3.5 mkmaintainerdocu
2.3.6 postrm
2.3.7 control
2.3.8 postinst
2.4 utilitaires
2.4.1 empaqueter
2.4.2 installer
2.4.3 desinstaller
2.4.4 KONSOLE
2.5 Contenu extrait du paquet
3 Tests
3.1 Fichiers pour les tests
3.1.1 main.c
3.1.2 fonction1.c
3.1.3 fonction2.c
3.2 Résultat des tests
3.2.1 Liste de l'archive myproject.tar.gz
3.2.2 Fichier project.prj
3.2.3 Fichier d'entête (header)
3.2.4 Directives de programmation et de tests
3.2.5 Manuel des fonctions
3.2.6 Document à l'usage des mainteneurs
4 Sécurisation des paquets
4.1 Créer un nouveau paquet sécurisé
4.2 Compilation et envoi au dépôt ppa:
5 Liens utiles
6 Suggestions
7 Références
Les paquets d'installation des logiciels pour les systèmes d'exploitation linux permettent de sécuriser les systèmes grâce à des clés numériques. Ils permettent aussi de faciliter l'installation des applications.
La description qui suit ne conduit pas à la construction d'un paquet sécurisé
Créer un paquet debian
La lecture de la documentation sur le sujet est si obscure qu'il est bien difficile de créer son premier paquet.
L'objet de cet article est de voir, au travers d'un exemple simple, comment sortir de l'obscurité.
Le paquet debian que nous allons créer ne sera pas sécurisé et ne pourra pas être installé par le gestionnaire de la logithèque. Il sera simplement installé et désinstallé par des commandes shell.
Le paquet
- L'idée de la démonstration est de créer un utilitaire très simple à l'usage des programmeurs avec l'aide de la commande mkd.
- Nous nous sommes inspirés de l'article myecho[2] pour vous proposer cette commande que nous appellerons mkmaintainerdocu (Make maintainer documentation)
- Cette commande n'a pas pour ambition de persister dans les répertoires des commandes binaires (/bin, /usr/bin, etc.)
Que doit-il faire ?
- créer un fichier de projet pour une application écrite en langage C
- générer le fichier d'entête de l'application "<projet>.h
- générer la documentation des fonctions
- générer la documentation destinée aux programmeurs
- Si possible afficher les fichier à la fin de leur création ou modification.
Choix de l'exécutable
Le plus simple est de créer une commande shell bash↑, facile à maîtriser et inspirée par myecho cité dans les références.
Structure de l'archive projet-mkmaintainerdocu.tar.gz
"./" est le répertoire conteneur que nous pouvons appeler projet-mkmaintainerdocu Il contient nos utilitaires et les fichiers d'installation. "./mkmaintainerdocu" est le répertoire racine de notre paquet. Ce qui nous intéresse se trouve DANS ce répertoire.
Créer le contenu de l'archive. Les fichiers à créer sont décrits ci-après : ./mkmaintainerdocu/usr ./mkmaintainerdocu/usr/share ./mkmaintainerdocu/usr/share/doc ./mkmaintainerdocu/usr/share/doc/changelog.debian - fichier à créer ./mkmaintainerdocu/usr/share/doc/copyright - fichier à créer ./mkmaintainerdocu/usr/share/doc/changelog - fichier à créer ./mkmaintainerdocu/usr/share/doc/README - fichier à créer ./mkmaintainerdocu/usr/local ./mkmaintainerdocu/usr/local/bin ./mkmaintainerdocu/usr/local/bin/mkmaintainerdocu - fichier à créer ./mkmaintainerdocu/DEBIAN ./mkmaintainerdocu/DEBIAN/postrm - fichier à créer ./mkmaintainerdocu/DEBIAN/control - fichier à créer ./mkmaintainerdocu/DEBIAN/postinst - fichier à créer On y ajoutera les utilitaires décrits ci-après : ./empaqueter - pour créer le paquet - fichier à créer ./installer - pour installer l'application - fichier à créer ./desinstaller - pour désinstaller le paquet - fichier à créer ./KONSOLE - utilitaire pour créer une console locale - fichier à créer Fichiers qui seront créés à l'empaquetage : ./mkmaintainerdocu.deb
changelog.debian
- fichier nécessaire à la création du paquet, peut être vide.
First version : 1.0 (2013-12-15)
copyright
- fichier nécessaire à la création du paquet, peut être vide.
First version : 1.0 (2013-12-15) (c) Demo <demo@demo.com>
changelog
- fichier nécessaire à la création du paquet, peut être vide.
First version : 1.0 (2013-12-15)
README
- fichier utile à la construction du paquet
This demo command is writed to create a self debian package.
mkmaintainerdocu
- notre fichier shell qui va exécuter nos commandes de création des documents
#!/bin/bash
# File mkmaintainerdocu writed by Clara Jimenez 2013-12-15
# Demo : Create any simple debian package for mkd and C programming language
# remove old files :
rm *.c~ # ATTENTION !
# create project file only with C files :
ls -1 *.c > project-prj
# create ./maintainer-documentation directory if not exist :
install -d ./maintainer-documentation
# Make header file project.h and header document; style C, overwrite, text only
echo " make header file './maintainer-documentation/project.h' "
mkd -Cjwt H project-prj ./maintainer-documentation/project.h
echo " make fuctions documentation './maintainer-documentation/project-functions-documentation.txt' "
mkd -Cjwt D project-prj ./maintainer-documentation/project-functions-documentation.txt
# Make individuals tests directives document; style C, overwrite, add line number, text only
echo " make tests document, directives for all functions './maintainer-documentation/\
project-functions-directives.txt' "
mkd -Cjwnt T project-prj ./maintainer-documentation/project-functions-directives.txt
# Make functions updates documentation; style C, overwrite, add line number, text only
echo " make functions maintainers documentation '/maintainer-documentation/\
project-functions-maintainers-doc.txt' "
mkd -Cjwnt P project-prj ./maintainer-documentation/project-functions-maintainers-doc.txt
# Get all strings and select strings for translations (add 2012-02-13)
echo " make list of strings for tranlations"
mkd -pnjs '**' project-prj ./maintainer-documentation/strings.txt | grep gettext > ./maintainer-documentation/strings-for-translations.txt
echo " Make mkd tests : "
echo " See in working directory. "
postrm
- shell exécuté après la suppression du paquet (si nécessaire)
- cet exécutable peut exécuter des mises à jour comme 'cat', 'whatis', et d'autres ...
#!/bin/bash
echo " If this message appears then 'mkmaintainerdocu' is now removed "
control
- fichier nécessaire à la construction du paquet
Version: 1.0
Section: devel
Priority: optional
architecture: all
Depends: bash, mkd
Maintainer: Demo <demo@demo.com>
Description: Make maintainer documentation for C files. See mkd manual.
Suggests: mkdcppw
Recommends: mkd
- Le classement des paquets doit être choisi dans une des sections :
admin, devel, doc, graphics, libs, misc, net, otherofs, pyton, shells, sound, text, utils, x11.
postinst
- shell exécuté après la création du paquet (si nécessaire)
- cet exécutable peut exécuter des mises à jour comme 'cat', 'whatis', et d'autres ...
#!/bin/bash
echo " Use 'mkmaintainerdocu' in your working directory "
echo " Then type 'mkmaintainerdocu' in your terminal or konsole "
echo " See manual man1 'mkd' and, or, 'mkmaintainerdocu' "
utilitaires
empaqueter
#!/bin/bash
fakeroot chmod 755 mkmaintainerdocu/usr/local/bin/mkmaintainerdocu
fakeroot chmod 755 mkmaintainerdocu/DEBIAN/post*
fakeroot chmod 755 mkmaintainerdocu/DEBIAN/pre*
fakeroot rm *.deb
fakeroot dpkg-deb --build mkmaintainerdocu
installer
#!/bin/bash
sudo dpkg -i mkmaintainerdocu.deb
desinstaller
#!/bin/bash
sudo dpkg --remove mkmaintainerdocu
ou :
# sudo dpkg --purge mkmaintainerdocu
KONSOLE
Cet utilitaire facilite l'ouverture d'une console dans le répertoire courant.
#!/bin/bash
echo -e '\E['32';'01'm'"click on New Line to 'start' the Konsole"
# echo -e '\E['31';'01'm' "not 'start in a terminal'"
echo -e '\E['32';'01'm'"click on Ctrl-C to exit"
tput sgr0 # Reset text attributes to normal without clear
read pwd
pwd
echo $pwd
tput sgr0 # Reset text attributes to normal without clear
/usr/bin/konsole background-mode --workdir pwd dir
read
Contenu extrait du paquet
- L'extraction avec le gestionnaire d'archives recrée les répertoires avec la même structure.
./mkmaintainerdocu
./mkmaintainerdocu/usr
./mkmaintainerdocu/usr/share
./mkmaintainerdocu/usr/share/doc
./mkmaintainerdocu/usr/share/doc/changelog.debian
./mkmaintainerdocu/usr/share/doc/copyright
./mkmaintainerdocu/usr/share/doc/changelog
./mkmaintainerdocu/usr/share/doc/README
./mkmaintainerdocu/usr/local
./mkmaintainerdocu/usr/local/bin
./mkmaintainerdocu/usr/local/bin/mkmaintainerdocu
./mkmaintainerdocu/DEBIAN
./mkmaintainerdocu/DEBIAN/postrm
./mkmaintainerdocu/DEBIAN/control
./mkmaintainerdocu/DEBIAN/postinst
Tests
Boîte des tests
Fichiers pour les tests
main.c
/*P
FILE NAME : main.c
PROJECT : myproject
UPDATES :
2013-12-15 Created by me <myemail@emailserver.com>
....-..-.. Updated by ..... for ......
*/
/*T
FILE NAME : main.c
UNIT TESTS DIRECTIVES : Blablabla0 ...
*/
/*D
FILE NAME : main.c
FUNCTION NAME : Main project ; <myproject>
SYNOPSYS, SYNTAX :
#include myproject.h
void main (void);
int function0(char* string0);
char* string0 : <description>
ACTION, DESCRIPTION ....
CONFORMING TO : gcc, UTF-8
PORTABILITY : .....
RETURN VALUE :
COPYRIGHT :
AUTHORS :
RESSOURCES :
NOTES :
BUGS : email <email@mailer>
SEE ALSO MANUAL : man 1 myprojetc
*/
/*H
// FILE NAME : main.c
// function0 (included in main.c)
int function0(char*);
*/
int function0(char* string0){
.....
}
void main(void) {
}
fonction1.c
/*P
FILE NAME : function1.c
PROJECT : myproject
UPDATES :
2013-12-15 Created by me <myemail@emailserver.com>
....-..-.. Updated by ..... for ......
*/
/*T
FILE NAME : function1.c
UNIT TESTS DIRECTIVES : Blablabla1 ...
*/
/*D
FILE NAME : function1.c
FUNCTION NAME :
SYNOPSYS, SYNTAX :
#include myproject.h
.....
*/
/*H
// FILE NAME : function1.c
int funtion1(char*);
*/
int function1(char* string1) {
.....
}
fonction2.c
/*P
FILE NAME : function2.c
PROJECT : myproject
UPDATES :
2013-12-15 Created by me <myemail@emailserver.com>
....-..-.. Updated by ..... for ......
*/
/*T
FILE NAME : function2.c
UNIT TESTS DIRECTIVES : Blablabla2 ...
*/
/*D
FILE NAME : function2.c
FUNCTION NAME :
SYNOPSYS, SYNTAX :
#include myproject.h
.....
*/
/*H
// FILE NAME : function2.c
int function2(char*, int);
*/
int function2(char* string2, int num) {
.....
}
Résultat des tests
Liste de l'archive myproject.tar.gz
./myproject/
./myproject/main.c
./myproject/project-prj
./myproject/fonction2.c
./myproject/fonction1.c
./myproject/maintainer-documentation
./myproject/maintainer-documentation/project-functions-documentation.txt
./myproject/maintainer-documentation/project-functions-directives.txt
./myproject/maintainer-documentation/project.h
./myproject/maintainer-documentation/project-functions-documentation.txt~
./myproject/maintainer-documentation/project-functions-maintainers-doc.txt
Fichier project.prj
fonction1.c
fonction2.c
main.c
Fichier d'entête (header)
project.h:
// FILE NAME : function1.c
int funtion1(char*);
// FILE NAME : function2.c
int funtion2(char*, int);
// FILE NAME : main.c
// function0 (included in main.c)
int function0(char*);
Directives de programmation et de tests
- project-functios-directives.txt
9
10 FILE NAME : function.c
11 UNIT TESTS DIRECTIVES : Blablabla1 ...
12
13
9
10 FILE NAME : function2.c
11 UNIT TESTS DIRECTIVES : Blablabla2 ...
12
13
9
10 FILE NAME : main.c
11 UNIT TESTS DIRECTIVES : Blablabla0 ...
12
Manuel des fonctions
- project-functions-documentation
FILE NAME : function1.c
FUNCTION NAME :
SYNOPSYS, SYNTAX :
#include myproject.h
.....
FILE NAME : function2.c
FUNCTION NAME :
SYNOPSYS, SYNTAX :
#include myproject.h
.....
FILE NAME : main.c
FUNCTION NAME : Main project ; <myproject>
SYNOPSYS, SYNTAX :
#include myproject.h
void main (void);
int function(char* string0);
char* string0 : <description>
ACTION, DESCRIPTION ....
CONFORMING TO : gcc, UTF-8
PORTABILITY : .....
RETURN VALUE :
COPYRIGHT :
AUTHORS :
RESSOURCES :
NOTES :
BUGS : email <email@mailer>
SEE ALSO MANUAL : man 1 myprojetc
Document à l'usage des mainteneurs
1
2 FILE NAME : function1.c
3 PROJECT : myproject
4 UPDATES :
5 2013-12-15 Created by me <myemail@emailserver.com>
6 ....-..-.. Updated by ..... for ......
7
8
1
2 FILE NAME : function2.c
3 PROJECT : myproject
4 UPDATES :
5 2013-12-15 Created by me <myemail@emailserver.com>
6 ....-..-.. Updated by ..... for ......
7
8
1
2 FILE NAME : main.c
3 PROJECT : myproject
4 UPDATES :
5 2013-12-15 Created by me <myemail@emailserver.com>
6 ....-..-.. Updated by ..... for ......
7
Sécurisation des paquets
Les paquets non sécurisés sont à proscrire.
Boîte de sécurisation des paquets
Créer un nouveau paquet sécurisé
Make-new-ppa : Pour créer un dépôt ppa.
#!/bin/bash
# File : Make-new-ppa
# Notes:
# <archive> a la forme : <exécutable>-<version>.tar.gz
# Nettoyage :
echo " Ne pas lancer en 'sudo', 'su' ou 'root'. Utiliser la 'Konsole' ou le 'Terminal' "
# Conserver une trace du vieux répertoire DEBIAN, au cas où ...
echo " Déplacement le vieux répertoire DEBIAN si il existe et le mettre en mode lecture seule. "
mv <répertoire-origine>/debian ./debian.old
chmod 444 ./debian.old
echo "suppression éventuelle du vieux répertoire DEBIAN "
rm -Rf debian/
# Entrer dans le répertoire-origine. C'est le répertoire de vos sources.
echo " entrant dans les sources de l'archive : <répertoire-origine>/src/ "
cd <répertoire-origine>/src
# Nettoyage du répertoire des sources avec l'option -d : print debugging
echo " mettant à jour l'exécutable et le plaçant dans son répertoire ../usr/bin "
make <exécutable> -d
rm *.o
cd ../../
# créer le fichier orig.tar.gz
echo " sortant de l'archive et créant le fichier compressé de l'archive d'origine "
tar cvzf <répertoire-origine>.tar.gz <répertoire-origine>
# attention au point qui se transforme en souligné sauf pour l'archive native
# 'mv' pas pour le natif.
# Rappel : <répertoire-origine> = <exécutable>-<version>
# mv <exécutable>-<version>.tar.gz <exécutable>_<version>.orig.tar.gz
# Créer le nouveau répertoire DEBIAN selon la configuration et options
# -c : avec licence de copyright. -e : avec UNE adresse de courriel des mainteneurs.
# -s : seulement le binaire. -n : paquet natif. -f : <fichier> où <fichier> est le nom
# de l'archive (compressée .tar.gz) que nous venons de créer ci-dessus.
# -s : si il faut compiler le binaire pour chaque architecture, sinon -i pour 'all arch'.
# -r <format> d'exécution (rules) pour la création du paquet : cdbs, ou dh7, ou old
cd <archive>
echo "entrant dans le répertoire <répertoire-origine> "
echo " créant les fichiers de base pour la construction du paquet dans ./debian/ "
dh_make -c GPL -e myemail@mailserver -s -n -f <archive-origine>.tar.gz -r CDBS
echo " Ayant créé les fichiers de base dans le répertoire debian : "
echo " mettre les fichiers suivants à jour:"
echo " changelog : remplacer unstable par votre version ubuntu (precise, saucy, etc.) "
echo " control, copyright, rules, watch "
echo " Il faudra ensuite exécuter la commande 'build-all-<me>' "
Il faut noter que toutes les options citées pour l'exécution de dh_make ne sont pas nécessaires. On peut supprimer la plupart des fichiers créés dans debian si on utilise une compilation simple de l'exécutable avec 'make'. Cependant, pour la portabilité sur d'autres machines avec des processeurs différents x86, amd64 etc. il est nécessaire de re-compiler l'exécutable; c'est le fichier exécutable 'rules' qui devra prendre en charge les différentes versions.
Compilation et envoi au dépôt ppa:
- Build-and-put-to-ppa
#!/bin/bash
# Création du fichier .changes où <clé> est votre clé publique PGP qui permet le cryptage et
# le dépôt parrainé sécurisé
# L'option -sa précise que le fichier source d'origine '.tar' est un répertoire.
# L'option -S pour ne créer qu'un seul binaire.
echo " entrant dans l'archive : compilation cryptée d'un seul paquet source.changes pour le dépôt "
cd <répertoire-origine>
debuild -S -sa -k<clé>
cd ..
echo " sortant de l'archive, envoi parrainé au dépôt ppa "
dput ppa:<your-ppa/<exécutable> <exécutable>_<version+1>_source.changes
# Création du paquet crypté sans re-signer le fichier '.changes' ou/et '.dsc'
# -i (--info) directive pour lintian. Affiche les problèmes et les erreurs.
# -us et -uc directives pour ne pas modifier les fichiers '.changes' et '.dsc'
echo " construction de paquets binaires "
cd <répertoire-origine>
debuild -i -us -uc -b
cd ..
Suggestions
- Si vous utilisez souvent les mêmes codes d'extraction, vous pouvez créer un shell pour la maintenance dans le répertoire /usr/local/bin, sans pour cela créer un paquet ....
- Les paquets sont réellement utiles lorsque l'installation est complexe ou pour une meilleure sécurité par un dépôt officiel (Voir Launchpad)
Liens utiles
Liste 'complète' ? des pages décrivant l'utilisation des paquets sous Ubuntu
Références
- ↑ Dépôt officiel de mkddocu : mkd-doc_140515_all.deb
- ↑ http://alp.developpez.com/tutoriels/debian/creer-paquet/
Exercices de mises à jour des paquets
Sommaire
1 L'intention d'empaqueter
1.1 Modifier le Makefile pour l'empaquetage
1.2 Tester la compilation
1.3 Créer la configuration d'empaquetage
1.4 Empaqueter
1.5 Préparer le paquet pour un dépôt
2 Patch (rustine)
2.1 Recréer l'environnement de travail
2.2 Créer le patch
2.2.1 Environnement de travail pour quilt
2.2.2 Avant de modifier des fichiers du patch
2.2.3 Modifier les fichiers (Makefile)
2.2.4 Après la modification des fichiers du patch
2.2.5 Créer et tester les paquets
2.2.6 Tester, simuler, l'envoi au dépôt
3 Mettre à jour
3.1 Déroulement normal des opérations de mise à jour
3.2 Notre opération de mise à jour
3.2.1 Quelle mise à jour ?
3.2.2 Créer une nouvelle version origine sans paquet version doc
3.2.3 Mise à jour des fichiers du répertoire source
3.2.4 Mise à jour du répertoire debian
3.2.5 Créer les paquets locaux
3.2.6 Créer, vérifier, et tester les fichiers de transfert au dépôt
4 Nouvelle version
4.1 Créer le nouvel environnement de travail
4.2 Créer le Makefile d'empaquetage
4.3 Créer les conditions d'empaquetage debian avec dh_make
4.4 Créer le paquet local
4.5 Préparer l'envoi au dépôt Launchpad
5 Dépôt sur Launchpad
5.1 Launchpad - Premier exercice : ITP mkd_0~120302-1
5.2 Launchpad - Deuxième exercice : Patch mkd_0~120302-1ubuntu1
5.3 Launchpad - Troisième exercice : Mettre à jour
5.4 Launchpad - Quatrième exercice : Nouvelle version
6 Résumés, notes et références
6.1 Résumés
6.1.1 Exercice-0 Intention d'empaqueter
6.1.2 Exercice-1 Patch (rustine)
6.1.3 Exercice-2 Mettre à jour
6.1.4 Exercice-3 Nouvelle version
6.2 Notes
6.3 Références
| Mise à jour de paquets Debian-Ubuntu
Vous envisagez d'empaqueter ou de mettre à jour une de vos applications. Vous désirez personnaliser un paquet existant pour :
La suite des solutions aux exercices d'empaquetage devrait vous y aider.
|
- Votre participation est souhaitée pour faire évoluer les projets mkd; vous pouvez
- modifier les sources de mkd et ses dérivés (mkdw, mkdcppw, etc.) avec les restrictions d'usage : Consultez le copyright de chaque application ; citez l'origine de l'application et le nom des auteurs.
- participer aux traductions.
- Prérequis[1] : Avoir installé les paquets suivants : debhelper cdbs lintian build-essential fakeroot devscripts pbuilder dh-make debootstrap.
- Sigles usuels que vous pouvez rencontrer
- Paquets en souffrance et paquets souhaités[1]
- Bogues, ITP:intention d'empaqueter, RFA:paquets disponibles à l'adoption, O:orphelins, RFH:demande d'aide, RFP:demande à empaqueter
L'intention d'empaqueter
Bien entendu, nous n'allons pas déposer une requête à Debian.
Nous nous contenterons des dépôts sur les serveurs Launchpad et des sources du projet mkd.
Dans l'intention d'empaqueter on suppose, à priori que l'application n'a jamais été empaquetée, elle s'installe très bien avec une procédure par un fichier de commandes 'install.sh' ou avec 'make' dans un répertoire d'installation contenant le fichier 'Makefile'
- Exemple d'un Makefile original
#!/bin/make
# file: Makefile for Ubuntu / Debian
# updated by JPL 2012-05-22
#
# Attention: avant de compiler, il faut valider les options de compilation
# dans version.h (notamment version UNIX ou version PC, ainsi que la langue)
#
PGM = mkd
BINDIR = /usr/bin
BINMODE = 755
MAN_FR = mkd_fr.1
MAN_EN = mkd_en.1
CATMANDIR = /var/cache/man/cat1 # ubuntu / debian
CATMANDIR_FR = /var/cache/man/fr.UTF-8/cat1 debian
MANDIR = /usr/share/man/man1
MANDIR_FR = /usr/share/man/fr.UTF-8/man1
SRCS = mkd.c asm.c cpp.c
HDRS = version.h asm.h cpp.h find.inc.h internationalisation.h find.inc.c \
basic.inc.c fortran.inc.c pascal.inc.c shell.inc.c tri.inc.c syn-fr.i syn-eng.i
OBJS =
LIBS =
CFLAGS = -O
LDFLAGS =
SPLINTFLAG = -weak
install: $(PGM) $(MAN_EN) $(MAN_FR)
# install PGM in BINDIR
-@if [ -d $(BINDIR) ]; then \
cp -f $(PGM) $(BINDIR)/$(PGM);\
chmod $(BINMODE) $(BINDIR)/$(PGM);\
if [ $(BINDIR) != "/bin" ]; then \
ln -s $(BINDIR)/$(PGM) /bin/$(PGM);\
fi \
else \
echo "couldn't find $(BINDIR)";\
fi
#
./install_manuals
#
./install_languages
#
./install_icons
#
./install_mime_database
# End install
$(PGM): $(SRCS) $(HDRS)
$(CC) $(CFLAGS) -o $(PGM) $(SRCS)
@#$(CC) $(LDFLAGS) -o $(PGM) $(OBJS) $(LIBS)
-@strip $(PGM) # clean ASM and LINK reloc.
$(MAN_EN).gz: manuals
-$(PGM) -Ctw M manuals $(MAN_EN)
-@gzip $(MAN_EN) # make en manual $(MAN_EN).gz
$(MAN_FR).gz: manuals
-$(PGM) -Ctw F manuals $(MAN_FR)
-@gzip $(MAN_FR) # make en manual $(MAN_FR).gz
clean:
#rm -f $(PGM) $(OBJS) $(MAN)
Pour empaqueter il est nécessaire de disposer d'un fichier 'Makefile' contenant une directive 'clean' et d'une directive d'installation de l'application dans les répertoires usuels (Compilation, manuels, traductions, etc.)
L'empaquetage se fera dans le répertoire debian. Le binaire doit se trouver dans debian/<app>/usr/bin/, et pas dans /usr/bin/. Pour que ce soit possible il est nécessaire d'introduire une macro $(DESTDIR).
Modifier le Makefile pour l'empaquetage
- Il est nécessaire
- de déplacer en tête de fichier la dépendance de création du binaire $(PGM)
- vérifier que la dépendance 'install' dépende de la création du binaire; "$(PGM)" dans ce Makefile
- d'effacer le fichier binaire $(PGM) dans la dépendance inconditionnelle 'clean'. Elle sera la première exécutée à la création du paquet
- d'inclure les commandes séparées du Makefile précédent ./install_*
- d'ajouter la macro $(DESTDIR)
- de vérifier qu'aucune commande risque de retourner inutilement une valeur différente de zéro par exemple en cas d'absence de fichier à effacer.
- nettoyer le répertoire à la fin de la compilation.
#!/bin/make
# File: Makefile for packaging mkd on debian or ubuntu systems
#######################################################
# Updated by JPL 2012-05-22
# Amended by JPL 2012-06-08
# Amended by Clara for Wikibooks 2014-01-12
#
# Copyright: ©EELL http://edeulo.free.fr/wiki/index.php/Projet_mkd#LE_DROIT_DE_COPIE:
# For tests type the command "make -d install DESTDIR=../tests" for tests
#######################################################
#
BIN = $(DESTDIR)/usr/bin
CATMANDIR = $(DESTDIR)/var/cache/man
ETC = $(DESTDIR)/etc
DOC = $(DESTDIR)/usr/share/doc
ICONS = $(DESTDIR)/usr/share/icons/hicolor
LANG = $(DESTDIR)/usr/share/locale
MAN = $(DESTDIR)/usr/share/man
MIME = $(DESTDIR)/usr/share/mime
PGM = mkd
SRCS = mkd.c asm.c cpp.c
HDRS = version.h asm.h cpp.h find.inc.h internationalisation.h \
find.inc.c basic.inc.c fortran.inc.c pascal.inc.c shell.inc.c tri.inc.c syn-fr.i syn-eng.i
OBJS =
LIBS =
CFLAGS = -O
LDFLAGS =
SPLINTFLAG = -weak
# create bin files: see clean : rm -f $(PGM)
# force recompilation $(SRCS) $(HDRS)
$(PGM):
gcc -c $(CFLAGS) $(SRCS) $(LIBS)
gcc -o $(LDFLAGS) $(PGM) $(OBJS) $(LIBS)
chmod 755 $(PGM)
install: $(PGM)
# create $(DESTDIR), sub-directories, and copy executable in bin directory:
install -d $(BIN) $(CATMANDIR) $(ETC) $(DOC) $(ICONS) $(LANG) $(MAN) $(MIME)
install $(PGM) $(BIN)/.
#
# install docs: see file ./install_docs
# install -d $(DOC)/$(PGM)/html
# install -m644 doc/*.html $(DOC)/$(PGM)/html/.
#
# install icons and update cache: see update in post-install package and see ./install_icons.
install -d $(ICONS)/256x256/apps $(ICONS)/48x48/apps $(ICONS)/32x32/apps $(ICONS)/16x16/apps
chmod 644 icons/*
cp -f icons/mkd-256x256.png $(ICONS)/256x256/apps/mkd.png
cp -f icons/mkd-48x48.png $(ICONS)/48x48/apps/mkd.png
cp -f icons/mkd-32x32.png $(ICONS)/32x32/apps/mkd.png
cp -f icons/mkd-16x16.png $(ICONS)/16x16/apps/mkd.png
if [ -e "/usr/share/icons/hicolor/16x16/apps/mkd.png" ]; \
then gtk-update-icon-cache -t /usr/share/icons/hicolor; fi
#
# install languages: see file ./install_languages.
# Installs for tests the local languages, 'de', 'es', 'fr', it, ro, etc.:
install -d $(LANG)/en/LC_MESSAGES $(LANG)/de/LC_MESSAGES $(LANG)/fr/LC_MESSAGES
chmod 644 lang/*
cp -f lang/mkd_en.mo $(LANG)/en/LC_MESSAGES/mkd.mo
cp -f lang/mkd_fr.mo $(LANG)/fr/LC_MESSAGES/mkd.mo
#
# install manuals: see file ./install_manuals
## install default manual:
install -D -m644 lang/mkd_en.1.gz $(MAN)/man1/mkd.1.gz
#
## install 'fr' manual:
if [ -d "/usr/share/man/fr.UTF-8/man1" ]; \
then \
install -d $(MAN)/fr.UTF-8/man1;\
cp -f lang/mkd_fr.1.gz $(MAN)/fr.UTF-8/man1/mkd.1.gz; \
elif [ -d "/usr/share/man/fr/" ]; \
then \
install -d $(MAN)/fr/man1; \
cp -f lang/mkd_fr.1.gz $(MAN)/fr/man1/mkd.1.gz ; \
fi
#
# install catman only if selected manual exist: see file ./install_catman.
if [ -e $(MAN)"/man1" ]; then catman -M $(MAN)/man1/mkd.1.gz; fi
if [ -e $(MAN)"/fr.UTF-8/man1/mkd.1.gz" ]; then catman -M $(MAN)/fr.UTF-8/man1/mkd.1.gz; fi
if [ -e $(MAN)"/fr/man1/mkd.1.gz" ]; then catman -M $(MAN)/fr/man1/mkd.1.gz ; fi
#
# install and update MIME database: see update in post-install packageand see file ./install_mime_database
install -D -m644 mkdw.xml $(MIME)/packages/mkdw.xml
if [-e "/usr/share/mime/packages/mkdw.xml" ]; then update-mime-database /usr/share/mime/; fi
# clean #
rm -f $(PGM) $(OBJS) $(MAN) *.o
# create man only in programmers source file; not for packaging
# type command "make -d mkd.1" to create updated file "manuals"
mkd.1: manuals
if [ -e "/usr/bin/mkd" ]; \
then \
mkd -Ct F manuals mkd.1; \
gzip -cf mkd.1 > lang/mkd_fr.1.gz; \
mkd -Ctw M manuals mkd.1; \
gzip -cf mkd.1 > lang/mkd_en.1.gz; \
rm -f mkd.1; \
fi
clean:
rm -f $(PGM) $(OBJS) $(MAN) *.o *.~
Tester la compilation
make -d install DESTDIR=../tests
- Contenu du répertoire des tests. S'assurer que
- le binaire mkd a bien été créé et copié dans le répertoire usr/bin/
- tous les fichiers ont été copiés dans les répertoires usuels
Listing du répertoire "tests"
edeulo@jpl-ubuntu-13:~/Packaging/mkd/mkd_12XXXX/mkd-120302-exercice-0$ find tests
tests
tests/usr
tests/usr/share
tests/usr/share/mime
tests/usr/share/mime/packages
tests/usr/share/mime/packages/mkdw.xml
tests/usr/share/doc
tests/usr/share/doc/mkd
tests/usr/share/doc/mkd/html
tests/usr/share/man
tests/usr/share/man/fr.UTF-8
tests/usr/share/man/fr.UTF-8/man1
tests/usr/share/man/fr.UTF-8/man1/mkd.1.gz
tests/usr/share/man/man1
tests/usr/share/man/man1/mkd.1.gz
tests/usr/share/icons
tests/usr/share/icons/hicolor
tests/usr/share/icons/hicolor/256x256
tests/usr/share/icons/hicolor/256x256/apps
tests/usr/share/icons/hicolor/256x256/apps/mkd.png
tests/usr/share/icons/hicolor/16x16
tests/usr/share/icons/hicolor/16x16/apps
tests/usr/share/icons/hicolor/16x16/apps/mkd.png
tests/usr/share/icons/hicolor/32x32
tests/usr/share/icons/hicolor/32x32/apps
tests/usr/share/icons/hicolor/32x32/apps/mkd.png
tests/usr/share/icons/hicolor/48x48
tests/usr/share/icons/hicolor/48x48/apps
tests/usr/share/icons/hicolor/48x48/apps/mkd.png
tests/usr/share/locale
tests/usr/share/locale/fr
tests/usr/share/locale/fr/LC_MESSAGES
tests/usr/share/locale/fr/LC_MESSAGES/mkd.mo
tests/usr/share/locale/en
tests/usr/share/locale/en/LC_MESSAGES
tests/usr/share/locale/en/LC_MESSAGES/mkd.mo
tests/usr/share/locale/de
tests/usr/share/locale/de/LC_MESSAGES
tests/usr/bin
tests/usr/bin/mkd
tests/var
tests/var/cache
tests/var/cache/man
tests/etc
- vérifier que le contenu du répertoire d'origine n'a pas changé
- vérifier les dates, éventuellement mettre les dates à jour avant de lancer le test. commande touch -a
- s'assurer que le binaire a été effacé
Créer la configuration d'empaquetage
- Cela se traduit par la création d'un répertoire debian dans le répertoire racine.
- Ce répertoire debian contiendra tous le fichiers nécessaires à l'empaquetage.
dh_make --createorig
Cette commande va créer le répertoire debian et le fichier .orig.tar.xz au dessus du répertoire racine et se traduit par des questions :
- Type of package: single binary, indep binary, multiple binary, library, kernel module, kernel patch?
[s/i/m/l/k/n] On peut choisir s, i ou m
- l'option '-s' ne devrait être utilisée que pour produire un binaire mais on peut créer un paquet binaire plus complet avec le manuel et de la documentation.
- l'option '-m' produit deux paquets : un paquet binaire et un paquet -doc commun à tous les paquets binaires générés.
edeulo@jpl-ubuntu-13:~/Packaging/mkd/mkd_12XXXX/mkd-120302-exercice-0/mkd-0~120302$ dh_make --createorig
Type of package: single binary, indep binary, multiple binary, library, kernel module, kernel patch?
[s/i/m/l/k/n] m
Maintainer name : Edeulo
Email-Address : edeulo@unknown
Date : Sun, 12 Jan 2014 18:20:02 +0100
Package Name : mkd
Version : 0~120302
License : blank
Type of Package : Multi-Binary
Hit <enter> to confirm:
Done. Please edit the files in the debian/ subdirectory now. You should also
check that the mkd Makefiles install into $DESTDIR and not in / .
- Fichiers créés dans le répertoire debian
edeulo@jpl-ubuntu-13:~/Packaging/mkd/mkd_12XXXX/mkd-120302-exercice-0/mkd-0~120302/debian$ ls
changelog docs manpage.xml.ex mkd.doc-base.EX postrm.ex README.source
compat init.d.ex menu.ex mkd-doc.docs preinst.ex rules
control manpage.1.ex mkd.cron.d.ex mkd-doc.install prerm.ex source
copyright manpage.sgml.ex mkd.default.ex postinst.ex README.Debian watch.ex
- Pour notre exercice on peut, à priori,
- supprimer tous les fichier se terminant par '.ex', sauf postinst et postrm qui nous serviront à mettre les bases de données à jour après installation et désinstallation.
- effacer les fichiers DEBIAN.* et le fichier mkd.doc-base.EX
- Il est nécessaire de modifier
- changelog : remplacer 'unstable' par votre version d'Ubuntu[2], 'saucy' pour ubuntu-13.10, en minuscules.
- control[3] :
- Section il est impératif de remplacer unknown par devel (sous-section de Développement)[4] ou autre sous-section ...
- Maintainer compléter l'adresse électronique
- Homepage compléter l'adresse des mises à jour
- Description Les paquets mkd et mkd-doc doivent être présentés dans le paragraphe d'affichage dans l'installeur de la Logithèque Ubuntu
- Ajouter Recommends: et "Suggests:" pour, à l'installation, faire référence à l'un et à l'autre paquet.
- fichier control d'essais :
Source: mkd
Section: devel
Priority: extra
Maintainer: Edeulo <edeulo@free.fr>
Build-Depends: debhelper (>= 8.0.0)
Standards-Version: 3.9.4
Homepage: <insert the upstream URL, if relevant>
#Vcs-Git: git://git.debian.org/collab-maint/mkd.git
#Vcs-Browser: http://git.debian.org/?p=collab-maint/mkd.git;a=summary
Package: mkd
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: Exercice "Intention d'empaqueter"
Voir "mkd (extracteur de documents)" sur Wikibooks
Ce paquet debian Ubuntu est destiné à installer le binaire
Suggests: mkd-doc
Package: mkd-doc
Architecture: all
Description: Exercice "Intention d'empaqueter"
Voir "mkd (extracteur de documents)" sur Wikibooks
Ce paquet debian Ubuntu est destiné à présenter la
documentation commune à tous les paquets binaires
Recommends: mkd
- Autres fichiers à mettre à jour
- docs : Contient les fichiers documentaires du répêrtoire d'origine : README, INSTALL, UNINSTALL, COPYRIGHT, AUTHORS etc. Si ce fichier est vide c'est que ces fichiers n'existaient pas à la création du répertoire debian. ces fichier se trouveront dans /usr/
- copyright : Éditer et compléter ...
- postinst : Inclure les commandes tels que les mises à jour non exécutable à la fabrication du paquet.
- postrm : Idem !
- Ajouter les quatre lignes de mise à jour des bases de données.
#!/bin/sh
# postrm script for mkd
#
# see: dh_installdeb(1)
set -e
# summary of how this script can be called:
# * <postrm> `remove'
# * <postrm> `purge'
# * <old-postrm> `upgrade' <new-version>
# * <new-postrm> `failed-upgrade' <old-version>
# * <new-postrm> `abort-install'
# * <new-postrm> `abort-install' <old-version>
# * <new-postrm> `abort-upgrade' <old-version>
# * <disappearer's-postrm> `disappear' <overwriter>
# <overwriter-version>
# for details, see http://www.debian.org/doc/debian-policy/ or
# the debian-policy package
case "$1" in
purge|remove|upgrade|failed-upgrade|abort-install|abort-upgrade|disappear)
echo " postrm : update icon cache "
gtk-update-icon-cache -t /usr/share/icons/hicolor
echo " postrm : update MIME database "
update-mime-database /usr/share/mime
;;
*)
echo "postrm called with unknown argument \`$1'" >&2
exit 1
;;
esac
# dh_installdeb will replace this with shell code automatically
# generated by other debhelper scripts.
#DEBHELPER#
exit 0
Empaqueter
- La commande suivante va lancer la construction du paquet
debuild -i -us -uc -b
En cas d'erreurs la construction sera annulée et la lecture du fichier mkd_0~120302-1_<processeur>.build vous permettra de savoir où et pourquoi la compilation s'est arrêtée.
Dans notre cas, alors que la compilation s'était bien déroulée dans les tests nous obtenons une erreur :
gcc -o mkd
gcc: fatal error: no input files
compilation terminated.
make[1]: *** [mkd] Erreur 4
make[1]: quittant le répertoire « /home/edeulo/Packaging/mkd/mkd_12XXXX/mkd-120302-exercice-0/mkd-0~120302 »
dh_auto_build: make -j1 returned exit code 2
make: *** [build] Erreur 2
dpkg-buildpackage: erreur: debian/rules build a produit une erreur de sortie de type 2
Correction de la ligne OBJS
OBJS = mkd.o asm.o cpp.o
- À la relance de la construction tout se passe bien et nous obtenons
edeulo@jpl-ubuntu-13:~/Packaging/mkd/mkd_12XXXX/mkd-120302-exercice-0$ ls -al
total 252
drwxr-xr-x 4 edeulo edeulo 4096 janv. 13 12:04 .
drwx------ 6 edeulo edeulo 4096 janv. 12 18:00 ..
-rwx--x--x 1 edeulo edeulo 375 mars 12 2013 KONSOLE
drwx------ 6 edeulo edeulo 4096 janv. 13 12:04 mkd-0~120302
-rw-r--r-- 1 edeulo edeulo 14058 janv. 13 12:04 mkd_0~120302-1_amd64.build
-rw-r--r-- 1 edeulo edeulo 1004 janv. 13 12:04 mkd_0~120302-1_amd64.changes
-rw-r--r-- 1 edeulo edeulo 2748 janv. 13 12:04 mkd_0~120302-1_amd64.deb
-rw-r--r-- 1 edeulo edeulo 205340 janv. 12 18:20 mkd_0~120302.orig.tar.xz
-rw-r--r-- 1 edeulo edeulo 2124 janv. 13 12:04 mkd-doc_0~120302-1_all.deb
drwxr-xr-x 5 edeulo edeulo 4096 janv. 12 16:35 tests
- Notes
- Le fichier mkd_0~120302.orig.tar.xz a pour date : janv. 12 18:20
- En dehors du fichier Makefile rien n'a changé dans le répertoire d'origine. Les fichiers objets *.o ont bien été effacés.
On peut maintenant mettre à jour l'archive d'origine .tar.xz
- Déplacer le répertoire debian. N'oubliez pas le point '.'
mv -v mkd-0~120302/debian . - Créer le fichier d'origine .tar.xz
tar cvJf mkd-0~120302.tar.xz mkd-0~120302 - Vérifier que la taille du fichier d'origine est à peine plus grande que le fichier orig.tar.xz
-rw-r--r-- 1 edeulo edeulo 205340 janv. 12 18:20 mkd_0~120302.orig.tar.xz
-rw-r--r-- 1 edeulo edeulo 205384 janv. 13 15:37 mkd-0~120302.tar.xz - Replacer le répertoire debian précédemment déplacé
mv -v debian mkd-0~120302/. - Effacer le fichier mkd_0~120302.orig.tar.xz
rm mkd_0~120302.orig.tar.xz - Recréer le paquet avec le nouveau fichier d'origine
Dans le répertoire d'origine : debuild -i -us -uc -b
- Vérifier le contenu des paquets .deb avec le gestionnaire d'archives ou dans le répertoire debian
Notes :
- Ces archives sont quasiment vides, il n'y a aucun binaire dans le paquet binaire, on le vérifie aussi en consultant le répertoire debian/mkd
- Le répertoire debian contient un répertoire tmp qui, lui contient toute l'archive.
Conclusion dh_install n'a pas fonctionné pour le paquet binaire.
Le manuel de dh_install nous apprend que chaque paquet est construit par un fichier debian/<paquet>.install. Or, si le répertoire debian contient bien un fichier de construction mkd-doc.install, il manque le fichier de construction binaire mkd.install que nous allons créer. C'est hélas courant avec ces paquets multiples.
- On copie le listing du fichier des tests que l'on colle dans un fichier debian/mkd.install
- On supprime toutes les lignes qui ne contiennent que des répertoires.
- On supprime le préfixe tests/ de toutes les lignes qui restent.
- À chaque ligne on ajoute le répertoire où le fichier doit être copié.
Fichier mkd.install :
Fichier à copier du répertoire debian/tmp vers le répertoire debian/mkd
usr/bin/mkd usr/bin
usr/share/mime/packages/mkdw.xml usr/share/mime/packages
usr/share/man/fr.UTF-8/man1/mkd.1.gz usr/share/man/fr.UTF-8/man1
usr/share/man/man1/mkd.1.gz usr/share/man/man1
usr/share/icons/hicolor/256x256/apps/mkd.png usr/share/icons/hicolor/256x256/apps
usr/share/icons/hicolor/16x16/apps/mkd.png usr/share/icons/hicolor/16x16/apps
usr/share/icons/hicolor/32x32/apps/mkd.png usr/share/icons/hicolor/32x32/apps
usr/share/icons/hicolor/48x48/apps/mkd.png usr/share/icons/hicolor/48x48/apps
usr/share/locale/fr/LC_MESSAGES/mkd.mo usr/share/locale/fr/LC_MESSAGES
usr/share/locale/en/LC_MESSAGES/mkd.mo usr/share/locale/en/LC_MESSAGES
On relance debuild -i -us -uc -b
Cette fois le paquet binaire est complet.
- Pour information
- Éditer le fichier .changes[2]. Notez le contenu. Le champ Date est la date de la mise à jour extraite du fichier changelog alors que le paquet a été construit le jour suivant.
- Éditer le fichier .build et vérifier qu'il n'y a pas d'erreur ou d'incompréhension. Exemple, ligne 204 : W: mkd: bad-homepage <insert the upstream URL, if relevant>
- Actions complémentaires
- Modifier ou compléter les fichiers changelog, control, copyright, s'il y a lieu.
- Si tout est correct, le paquet est prêt à être installé sur la machine locale.
- Remarques
- Nous n'avons rien touché au répertoire d'origine
- À l'installation du paquet, avec la Logithèque Ubuntu ou GDebi, le copyright, les suggestions de paquets et les paquets recommandés, n'apparaissent pas.
Préparer le paquet pour un dépôt
- Rappel, consultez le chapitre Dépôt sur Launchpad
- Pour déposer un paquet il faut disposer d'un compte de dépôt (PPA), et d'une clé PGP
- Créer les conditions de transfert sécurisé
Si l'option -sn de debuild ne fonctionne pas il faut utiliser l'option -sa et simuler une nouvelle version .orig.tar.xz
- renommer le répertoire mkd-0~120302.tar.xz mkd_0~120302.orig.tar.xz
- entrer dans le répertoire d'origine mkd-0~120302
- sécuriser le transfert avec la clé de Edeulo 230B1A04
debuild -S -sa -k230B1A04 - sortir du répertoire d'origine.
- Liste des nouveaux fichiers
- -rw-r--r-- 1 edeulo edeulo 3264 janv. 15 14:53 mkd_0~120302-1.debian.tar.gz
- -rw-r--r-- 1 edeulo edeulo 1486 janv. 15 14:53 mkd_0~120302-1.dsc
- -rw-r--r-- 1 edeulo edeulo 1407 janv. 15 14:53 mkd_0~120302-1_source.build
- -rw-r--r-- 1 edeulo edeulo 1723 janv. 15 14:53 mkd_0~120302-1_source.changes
- -rw-r--r-- 1 edeulo edeulo 205384 janv. 13 15:37 mkd_0~120302.orig.tar.xz
- L'archive mkd_0~120302-1.debian.tar.gz contient l'essentiel du répertoire debian.
- L'archive mkd_0~120302.orig.tar.xz contient le répertoire de référence d'origine.
- Les fichiers .dsc et .changes sont sécurisés pour le transfert au dépôt.
- Le fichier .build liste le détail de l'opération de sécurisation.
- 5. Vérifier le paquet
- dput -ol ppa:<nom-du-ppa>/mkd mkd_0~120302-1_source.changes
- 6. Simuler le dépôt
- dput -s ppa:<nom-du-ppa>/mkd mkd_0~120302-1_source.changes
- 7. Tenter le dépôt du paquet sur Launchpad; il peut encore y avoir un rejet.
Patch (rustine)
La rustine informatique est destinée à corriger les bogues apparus au cours de l'utilisation du logiciel, ou pour ajouter des fonctionnalités particulières.
Dans notre cas, à titre expérimental, on peut appliquer des rustine à des fichiers acceptés par le dépôt et qui ont fait apparaître des erreurs de compilation.
| ☞ | Dans ces deux cas la somme de contrôle de la nouvelle version ne correspondra pas à celle qui a été déposée. La version doit être incrémentée. |
- Appliquer une rustine est nécessaire pour le 'suivi' d'une application
- Le travail nécessaire pour appliquer une rustine informatique est assez lourd. Il est souvent plus facile de créer une nouvelle version avec les défauts corrigés.
- Il se pose alors la question du suivi de l'empaquetage.
- Exemple
- L'ordinateur du dépôt va compiler l'application pour plusieurs types de processeurs avec la rigueur nécessaire et va générer des erreurs. Votre paquet est refusé.
- L'application ne fait apparaître aucune erreur localement et le paquet que vous avez produit fonctionne très bien.
- L'erreur ou le type d'erreur est communiqué par courrier électronique.
- Ce type d'erreur vient souvent du Makefile
Recréer l'environnement de travail
- Créer le répertoire de travail 'natif' dans l'exemple.
- Dans le répertoire natif : télécharger le fichier source à corriger, avec le navigateur, ou avec la commande wget
- Afin de faciliter l'accès à la console dans le répertoire natif, créer la commande KONSOLE qu'il faut rendre exécutable.
#!/bin/bash
echo -e '\E['32';'01'm'"click on New Line to 'start' the Konsole"
# echo -e '\E['31';'01'm' "not 'start in a terminal'"
echo -e '\E['32';'01'm'"click on Ctrl-C to exit"
tput sgr0 # Reset text attributes to normal without clear
read pwd
pwd
echo $pwd
tput sgr0 # Reset text attributes to normal without clear
/usr/bin/konsole background-mode --workdir pwd dir
read
| ☞ | Dans la console, utilisez les touches CTRL+SHIFT+c Pour copier, CTRL+SHIFT+v pour coller. |
- Télécharger ;
- https://launchpad.net/~jean-paul-louyot/+archive/exercises/+packages
- → mkd_0~120302-1.debian.tar.gz (3.2 KiB)
- → mkd_0~120302.orig.tar.xz (200.6 KiB)
- Copier les fichiers dans un répertoire mkd-120302-exercice-1
- décompressez l'archive .orig.tar.gz → mkd-120302-exercice-1/mkd-0~120302 →
- décompressez l'archive .debian.tar.gz dans mkd-0~120302 → mkd-0~120302/debian
- Réserver les fichiers d'origine dans un répertoire des fichiers originaux.
- Éditer le fichier mkd-0~120302/Makefile et corriger
Créer le patch
Voir le manuel des commandes unix diff, patch, quilt (ou dquilt)
Créer un patch consiste à faire la différence une diff entre un ancien et un nouveau fichier, puis de faire un patch (coller une rustine) afin de ne corriger que la partie modifiée pour mettre à jour ou pour être applicable dans d'autres conditions d'utilisation. Ceci évite de recharger tous les fichiers et de figer une application. On garde ainsi une souplesse d'utilisation.
Un patch pourrait par exemple, ne mettre à jour que des langues déjà installées.
Environnement de travail pour quilt
- pour préciser où se trouvent les correctifs
- ajouter dans le ~/.bashrc export QUILT_PATCHES=debian/patches
- vérifier que l'environnement n'est pas déjà établi : cat ~/.bashrc | grep patches
- sinon echo "export QUILT_PATCHES=debian/patches" >> ~/.bashrc
Avant de modifier des fichiers du patch
- Dans le répertoire natif mkd-0~120302
- vérifier qu'il n'existe pas déjà des patches :
quilt applied - créer le répertoire patch : mkdir debian/patches
- lancer la commande (dquilt pour debian) :
→ Le patch fix-uploads.patch est maintenant au sommet
quilt new fix-uploads.patch
Deux répertoire viennent d'être mis à jour ou créés depuis le répertoire courant :
debian/patches et un caché .pc qui contient 'applied-patches' et un répertoire fix-uploads-patch avec le nom du patch en tête de liste, le sous répertoire fix-uploads.patch, et trois fichiers de construction cachés. - ajouter le (ou plusieurs) fichier à modifier en tête du patch avant toute modification. Les fichiers déjà modifiés ne peuvent pas être ajoutés.
quilt add Makefile.
→ Le fichier Makefile a été ajouté au patch fix-uploads.patch
Modifier les fichiers (Makefile)
#!/bin/make
# File: Makefile for packaging mkd on debian or ubuntu systems
#######################################################
# Updated by JPL 2012-05-22
# Amended by JPL 2012-06-08
# Amended by Clara for Wikibooks 2014-01-12, 2014-01-16
#
# Copyright: ©EELL http://edeulo.free.fr/wiki/index.php/Projet_mkd#LE_DROIT_DE_COPIE:
# For tests type the command "make -d install DESTDIR=../tests" for tests
#######################################################
BIN = $(DESTDIR)/usr/bin
CATMANDIR = $(DESTDIR)/var/cache/man
ETC = $(DESTDIR)/etc
DOC = $(DESTDIR)/usr/share/doc
ICONS = $(DESTDIR)/usr/share/icons/hicolor
LANG = $(DESTDIR)/usr/share/locale
MAN = $(DESTDIR)/usr/share/man
MIME = $(DESTDIR)/usr/share/mime
PGM = mkd
SRCS = mkd.c asm.c cpp.c
HDRS = version.h asm.h cpp.h find.inc.h internationalisation.h \
find.inc.c basic.inc.c fortran.inc.c pascal.inc.c shell.inc.c tri.inc.c syn-fr.i syn-eng.i
OBJS = mkd.o asm.o cpp.o
LIBS =
CFLAGS = -O
LDFLAGS =
SPLINTFLAG = -weak
# create bin files:
# force recompilation $(SRCS) $(HDRS)
$(PGM):
# see clean : rm -f $(PGM)
gcc -c $(CFLAGS) $(SRCS) $(LIBS)
gcc -o $(LDFLAGS) $(PGM) $(OBJS) $(LIBS)
chmod 755 $(PGM)
# -@strip $(PGM) # clean ASM and Link reloc
install: $(PGM)
# create $(DESTDIR), sub-directories, and copy executable in bin directory:
install -d $(BIN) $(CATMANDIR) $(ETC) $(DOC) $(ICONS) $(LANG) $(MAN) $(MIME)
install $(PGM) $(BIN)/.
#
# install docs:
# see ./install_docs
# install -d $(DOC)/$(PGM)/html
# install -m644 doc/*.html $(DOC)/$(PGM)/html/.
#
# install icons and update cache: see update in post-install package.
# see ./install_icons
install -d $(ICONS)/256x256/apps $(ICONS)/48x48/apps $(ICONS)/32x32/apps $(ICONS)/16x16/apps
chmod 644 icons/*
cp -f icons/mkd-256x256.png $(ICONS)/256x256/apps/mkd.png
cp -f icons/mkd-48x48.png $(ICONS)/48x48/apps/mkd.png
cp -f icons/mkd-32x32.png $(ICONS)/32x32/apps/mkd.png
cp -f icons/mkd-16x16.png $(ICONS)/16x16/apps/mkd.png
if [ -e "/usr/share/icons/hicolor/16x16/apps/mkd.png" ]; \
then gtk-update-icon-cache -t /usr/share/icons/hicolor; fi
#
# install languages:
# see ./install_languages
# Installs for tests the local languages, 'de', 'es', 'fr', it, ro, etc.:
install -d $(LANG)/en/LC_MESSAGES $(LANG)/de/LC_MESSAGES $(LANG)/fr/LC_MESSAGES
chmod 644 lang/*
cp -f lang/mkd_en.mo $(LANG)/en/LC_MESSAGES/mkd.mo
cp -f lang/mkd_fr.mo $(LANG)/fr/LC_MESSAGES/mkd.mo
#
# install manuals:
# see ./install_manuals
## install default manual:
install -D -m644 lang/mkd_en.1.gz $(MAN)/man1/mkd.1.gz
#
## install 'fr' manual:
# if [ -d "/usr/share/man/fr.UTF-8/man1" ]; \
# then \
install -d $(MAN)/fr.UTF-8/man1; \
cp -f lang/mkd_fr.1.gz $(MAN)/fr.UTF-8/man1/mkd.1.gz; \
# elif [ -d "/usr/share/man/fr/" ]; \
# then \
# install -d $(MAN)/fr/man1; \
# cp -f lang/mkd_fr.1.gz $(MAN)/fr/man1/mkd.1.gz ; \
# fi
#
# install catman only if selected manual exist:
# see ./install_catman
# if [ -e $(MAN)"/man1" ]; then catman -M $(MAN)/man1/mkd.1.gz; fi
# if [ -e $(MAN)"/fr.UTF-8/man1/mkd.1.gz" ]; then catman -M $(MAN)/fr.UTF-8/man1/mkd.1.gz; fi
# if [ -e $(MAN)"/fr/man1/mkd.1.gz" ]; then catman -M $(MAN)/fr/man1/mkd.1.gz ; fi
#
# install and update MIME database: see update in post-install package
# see install_mime_database
install -D -m644 mkdw.xml $(MIME)/packages/mkdw.xml
# if [-e "/usr/share/mime/packages/mkdw.xml" ]; then update-mime-database /usr/share/mime/; fi
# clean
rm -f $(PGM)
rm -f *.o
rm -f *~
# create man only in programmers source file; not for packaging
# type command "make -d mkd.1" to create updated file "manuals"
# mkd.1: manuals
# if [ -e "/usr/bin/mkd" ]; \
# then \
# mkd -Ct F manuals mkd.1; \
# gzip -cf mkd.1 > lang/mkd_fr.1.gz; \
# mkd -Ctw M manuals mkd.1; \
# gzip -cf mkd.1 > lang/mkd_en.1.gz; \
# rm -f mkd.1; \
# fi
clean:
rm -f $(PGM)
rm -f *.o
rm -f *~
Après la modification des fichiers du patch
- rafraîchir les modifications dans 'fix-uploads.patch'
quilt refresh
→ Patch fix-uploads.patch rafraîchi
- valider le patch[3] : quilt header -e fix-uploads.patch pour éditer le correctif
Description : Mise en commentaire des installations conditionnelles du fichier Makefile
Author: Clara <clara@mail.com>
Origin: Erreur au téléversement
etc.
→ En-tête du patch fix-uploads.patch remplacé - voir les différences : quilt diff
Index: mkd-0~120302/Makefile
===================================================================
--- mkd-0~120302.orig/Makefile 2014-01-13 12:04:22.000000000 +0100
+++ mkd-0~120302/Makefile 2014-01-17 14:35:01.186811564 +0100
@@ -4,7 +4,7 @@
#######################################################
# Updated by JPL 2012-05-22
# Amended by JPL 2012-06-08
-# Amended by Clara for Wikibooks 2014-01-12
+# Amended by Clara for Wikibooks 2014-01-12, 2014-01-16
#
# Copyright: <C2><A9>EELL http://edeulo.free.fr/wiki/index.php/Projet_mkd#LE_DROIT_DE_COPIE:
# For tests type the command "make -d install DESTDIR=../tests" for tests
@@ -73,26 +73,26 @@
install -D -m644 lang/mkd_en.1.gz $(MAN)/man1/mkd.1.gz
#
## install 'fr' manual:
- if [ -d "/usr/share/man/fr.UTF-8/man1" ]; \
- then \
- install -d $(MAN)/fr.UTF-8/man1;\
+ # if [ -d "/usr/share/man/fr.UTF-8/man1" ]; \
+ # then \
+ install -d $(MAN)/fr.UTF-8/man1; \
cp -f lang/mkd_fr.1.gz $(MAN)/fr.UTF-8/man1/mkd.1.gz; \
- elif [ -d "/usr/share/man/fr/" ]; \
- then \
- install -d $(MAN)/fr/man1; \
- cp -f lang/mkd_fr.1.gz $(MAN)/fr/man1/mkd.1.gz ; \
- fi
+ # elif [ -d "/usr/share/man/fr/" ]; \
+ # then \
+ # install -d $(MAN)/fr/man1; \
+ # cp -f lang/mkd_fr.1.gz $(MAN)/fr/man1/mkd.1.gz ; \
+ # fi
#
# install catman only if selected manual exist:
# see ./install_catman
- if [ -e $(MAN)"/man1" ]; then catman -M $(MAN)/man1/mkd.1.gz; fi
- if [ -e $(MAN)"/fr.UTF-8/man1/mkd.1.gz" ]; then catman -M $(MAN)/fr.UTF-8/man1/mkd.1.gz; f
- if [ -e $(MAN)"/fr/man1/mkd.1.gz" ]; then catman -M $(MAN)/fr/man1/mkd.1.gz ; fi
+ # if [ -e $(MAN)"/man1" ]; then catman -M $(MAN)/man1/mkd.1.gz; fi
+ # if [ -e $(MAN)"/fr.UTF-8/man1/mkd.1.gz" ]; then catman -M $(MAN)/fr.UTF-8/man1/mkd.1.gz;
+ # if [ -e $(MAN)"/fr/man1/mkd.1.gz" ]; then catman -M $(MAN)/fr/man1/mkd.1.gz ; fi
#
# install and update MIME database: see update in post-install package
# see install_mime_database
install -D -m644 mkdw.xml $(MIME)/packages/mkdw.xml
- if [-e "/usr/share/mime/packages/mkdw.xml" ]; then update-mime-database /usr/share/mime/;
+ # if [-e "/usr/share/mime/packages/mkdw.xml" ]; then update-mime-database /usr/share/mime/
# clean
rm -f $(PGM)
rm -f *.o
@@ -100,17 +100,18 @@
- 3. incrémenter la version dans changelog :
dch -i "Add patch fix-uploads (Correctif de téléversement ppa Launchpad)" - 4. éditer le fichier debian/changelog et remplacer UNRELEASED par saucy
- changelog :
mkd (0~120302-1ubuntu1) saucy; urgency=low
* Add patch fix-uploads (Correctif de téléversement ppa Launchpad)
-- Edeulo <edeulo@jpl-ubuntu-13.04> Fri, 17 Jan 2014 15:05:36 +0100
mkd (0~120302-1) saucy; urgency=low
* Initial release
-- Edeulo <edeulo@free.fr> Sun, 12 Jan 2014 18:20:02 +0100
Créer et tester les paquets
- vérifier la compilation
make -d install DESTDIR=../tests
- vérifier que les fichiers listés dans debian/mkd.install se trouvent bien dans le répertoire ../tests/usr
- créer les paquets locaux et on vérifie le contenu
debuild -i -us -uc -b
- ls -l ..
- drwxr-xr-x 2 edeulo edeulo 4096 janv. 17 14:33 Fichiers-d'origine
- -rwx--x--x 1 edeulo edeulo 375 mars 12 2013 KONSOLE
- drwx------ 7 edeulo edeulo 4096 janv. 17 16:55 mkd-0~120302
- -rw-r--r-- 1 edeulo edeulo 3264 janv. 16 16:10 mkd_0~120302-1.debian.tar.gz
- -rw-r--r-- 1 edeulo edeulo 13030 janv. 17 16:55 mkd_0~120302-1ubuntu1_amd64.build
- -rw-r--r-- 1 edeulo edeulo 1072 janv. 17 16:55 mkd_0~120302-1ubuntu1_amd64.changes
- -rw-r--r-- 1 edeulo edeulo 176286 janv. 17 16:55 mkd_0~120302-1ubuntu1_amd64.deb
- -rw-r--r-- 1 edeulo edeulo 205384 janv. 16 15:56 mkd_0~120302.orig.tar.xz
- -rw-r--r-- 1 edeulo edeulo 2538 janv. 17 16:55 mkd-doc_0~120302-1ubuntu1_all.deb
- drwxr-xr-x 5 edeulo edeulo 4096 janv. 17 16:42 tests
- créer les fichiers à transférer
debuild -S -sa -k230B1A04
dpkg-source -b mkd-0~120302
dpkg-source: avertissement: Le numéro de version indique des modifications Ubuntu mais le champ « Maintainer: » ne comporte pas d'adresse Ubuntu
dpkg-source: avertissement: Le numéro de version indique des modifications Ubuntu mais il n'existe pas de champ « XSBC-Original-Maintainer: »
dpkg-source: info: utilisation du format source « 3.0 (quilt) »
dpkg-source: info: construction de mkd à partir de ./mkd_0~120302.orig.tar.xz
dpkg-source: erreur: impossible d'identifier les changements de icons/mkd_0~120302-1.debian.tar.gz : contenu d'un fichier binaire modifié
dpkg-source: erreur: Ajoutez icons/mkd_0~120302-1.debian.tar.gz dans debian/source/include-binaries si vous souhaitez conserver le binaire modifié dans le ficher tar debian
dpkg-source: erreur: modifications non représentables des sources
dpkg-buildpackage: erreur: dpkg-source -b mkd-0~120302 a produit une erreur de sortie de type 2
debuild: fatal error at line 1361:
dpkg-buildpackage -rfakeroot -d -us -uc -S -sa failed
- enregistrer les modifications
dpkg-source --commit
- relancer debuild -S -sa -k230B1A04
→ Successfully signed dsc and changes files
- drwxr-xr-x 2 edeulo edeulo 4096 janv. 17 14:33 Fichiers-d'origine
- -rwx--x--x 1 edeulo edeulo 375 mars 12 2013 KONSOLE
- drwx------ 7 edeulo edeulo 4096 janv. 17 17:58 mkd-0~120302
- -rw-r--r-- 1 edeulo edeulo 3264 janv. 16 16:10 mkd_0~120302-1.debian.tar.gz
- -rw-r--r-- 1 edeulo edeulo 13358 janv. 17 17:58 mkd_0~120302-1ubuntu1_amd64.build
- -rw-r--r-- 1 edeulo edeulo 1072 janv. 17 17:58 mkd_0~120302-1ubuntu1_amd64.changes
- -rw-r--r-- 1 edeulo edeulo 176286 janv. 17 17:58 rouge|mkd_0~120302-1ubuntu1_amd64.deb
- -rw-r--r-- 1 edeulo edeulo 7765 janv. 17 18:25 mkd_0~120302-1ubuntu1.debian.tar.gz
- -rw-r--r-- 1 edeulo edeulo 1514 janv. 17 18:25 mkd_0~120302-1ubuntu1.dsc
- -rw-r--r-- 1 edeulo edeulo 1755 janv. 17 18:25 mkd_0~120302-1ubuntu1_source.build
- -rw-r--r-- 1 edeulo edeulo 1839 janv. 17 18:25 mkd_0~120302-1ubuntu1_source.changes
- -rw-r--r-- 1 edeulo edeulo 205384 janv. 16 15:56 mkd_0~120302.orig.tar.xz
- -rw-r--r-- 1 edeulo edeulo 2534 janv. 17 17:58 mkd-doc_0~120302-1ubuntu1_all.deb
- drwxr-xr-x 5 edeulo edeulo 4096 janv. 17 16:42 tests
Tester, simuler, l'envoi au dépôt
- Vérifier le paquet
dput -ol ppa:jean-paul-louyot/exercises mkd_0~120302-1ubuntu1_source.changes - Simuler le dépôt
dput -s ppa:jean-paul-louyot/exercises mkd_0~120302-1ubuntu1_source.changes - Tenter le dépôt du paquet sur Launchpad; il peut encore y avoir un rejet.
Mettre à jour
En cas d'échec de transfert vers un dépôt, il est souvent plus facile d'effacer le dépôt en échec et de faire une mise à jour après corrections. (Le fichier déposé ne disparaît jamais dans les listes).
| ☞ | * La somme de contrôle des fichiers (Checksum) ne doit pas changer pour une surcharge de version (voir l'option -f de dput). * En cas d'échec de dépôt par une différence de checksum vous devez changer le numéro de version. |
On fait généralement des mises à jour d'une application en conservant le numéro de version suivi d'un tiret et d'un chiffre de version des mêmes sources.
- Exemple
- mkd-0~120508 devient mkd-0~120508-1 puis mkd-0~120508-2
En général, les sources compilables restent les mêmes. On révise, ou on ajoute, des traductions, des images, etc.
Déroulement normal des opérations de mise à jour
Cette opération consiste à récupérer les fichiers de la version précédente.
Elle devra être téléchargée du dépôt
On peut aussi reprendre les fichiers locaux, mais le risque de se voir refuser un nouveau dépôt est grand. Les fichiers du dépôt ne sont pas nécessairement identiques aux fichiers locaux.
- On récupère
- le fichier .orig.tar.gz de la version précédente
Ce fichier est le même depuis la création de l'application et tout changement dans ce fichier d'origine sera refusé par le serveur de dépôt. - le fichier .debian.tar.gz de la même version. Ce fichier contient toutes les informations pour créer une mise à jour.
- éventuellement tous les autres fichiers.
On peut faire un nouveau patch. La version ubuntu2 remplacera la version ubuntu1 sur le serveur du dépôt.
Notre opération de mise à jour
Quelle mise à jour ?
- On veut ajouter les messages en langue allemande.
- On veut créer un seul fichier, car le fichier commun .all.deb n'a pas d'intérêt pour nous. Nous avons peu de documents à proposer.
- La version ? mkd (0~120302)
- Le nom du paquet ? mkd
- Le nom des paquets debian .deb ? mkd (0~120302-2)
Créer une nouvelle version origine sans paquet version doc
- copier l'archive version dans un répertoire mkd-120302-exercice-2/fichiers-d'origine
- copier mkd_0~120302-1ubuntu1.debian.tar.gz le décompresser dans le répertoire mkd-120302-exercice-2/fichiers-d'origine/.
- décompresser ces fichiers
- déplacer le répertoire décompressé mkd-0~120302 dans mkd-120302-exercice-2/."
- Créer les nouvelles directives d'empaquetage (DEBIAN)
- Début d'un petit fichier de travail Build exécutable :
#!/bin/bash
echo "supprimer un éventuel fichier .orig.tar.gz"
rm -f *.orig.tar.gz
echo " créer le fichier orig .tar.gz "
tar cvzf mkd_0~120302.orig.tar.gz mkd-0~120302
echo " entrant dans le répertoire mkd-0~120302"
cd mkd-0~120302
echo " action : dh_make -c GPL -e edeulo@free.fr -s -f ../mkd-0~120302.tar.gz -p mkd"
echo " ATTENTION"
echo " le répertoire debian ne sera pas modifié si il existe !!!"
dh_make -c GPL -e edeulo@free.fr -s -f ../mkd_0~120302.orig.tar.gz -p mkd
echo " sortant du répertoire mkd-0~120302"
cd ..
- Options :
- -c GPL pour le copyright
- -e <email> pour l'adresse du mainteneur
- -s binaire seul
- -n natif
- -f <fichier> fichier d'origine
- -p <version> version de paquet
entrant dans le répertoire mkd-0~120302
action : dh_make -c GPL -e edeulo@free.fr -s -f ../mkd-0~120302.tar.gz -p mkd
ATTENTION
le répertoire debian ne sera pas modifié si il existe !!!
Maintainer name : Edeulo
Email-Address : edeulo@free.fr
Date : Mon, 20 Jan 2014 16:58:42 +0100
Package Name : mkd
Version : 0~120302
License : gpl3
Type of Package : Single
Hit <enter> to confirm:
Skipping creating ../mkd_0~120302.orig.tar.gz because it already exists
Done. Please edit the files in the debian/ subdirectory now. You should also
check that the mkd Makefiles install into $DESTDIR and not in / .
sortant du répertoire mkd-0~120302
Mise à jour des fichiers du répertoire source
Ajouter les fichiers de langue mkd_de.mo et mkd_de.1.gz dans le répertoire 'lang'
- Modifier le Makefile
- Remplacer le Makefile par celui de l'exercice-1
- Éditer le Makefile
- Supprimer les lignes de commentaires inutiles
- Ajouter les lignes d'installation de la langue allemande
#!/bin/make
# File: Makefile for packaging mkd on debian or ubuntu systems
#######################################################
# Updated by JPL 2012-05-22
# Amended by JPL 2012-06-08
# Amended by Clara for Wikibooks 2014-01-12, 2014-01-16, 2014-01-20
#
# Copyright: ©EELL http://edeulo.free.fr/wiki/index.php/Projet_mkd#LE_DROIT_DE_COPIE:
# For tests type the command "make -d install DESTDIR=../tests" for tests
#######################################################
BIN = $(DESTDIR)/usr/bin
CATMANDIR = $(DESTDIR)/var/cache/man
ETC = $(DESTDIR)/etc
DOC = $(DESTDIR)/usr/share/doc
ICONS = $(DESTDIR)/usr/share/icons/hicolor
LANG = $(DESTDIR)/usr/share/locale
MAN = $(DESTDIR)/usr/share/man
MIME = $(DESTDIR)/usr/share/mime
PGM = mkd
SRCS = mkd.c asm.c cpp.c
HDRS = version.h asm.h cpp.h find.inc.h internationalisation.h \
find.inc.c basic.inc.c fortran.inc.c pascal.inc.c shell.inc.c tri.inc.c syn-fr.i syn-eng.i
OBJS = mkd.o asm.o cpp.o
LIBS =
CFLAGS = -O
LDFLAGS =
SPLINTFLAG = -weak
# create bin files:
# force recompilation $(SRCS) $(HDRS)
$(PGM):
# see clean : rm -f $(PGM)
gcc -c $(CFLAGS) $(SRCS) $(LIBS)
gcc -o $(LDFLAGS) $(PGM) $(OBJS) $(LIBS)
chmod 755 $(PGM)
# -@strip $(PGM) # clean ASM and Link reloc
install: $(PGM)
# create $(DESTDIR), sub-directories, and copy executable in bin directory:
install -d $(BIN) $(CATMANDIR) $(ETC) $(DOC) $(ICONS) $(LANG) $(MAN) $(MIME)
install $(PGM) $(BIN)/.
#
# install icons and update cache: see update in post-install package.
# see ./install_icons
install -d $(ICONS)/256x256/apps $(ICONS)/48x48/apps $(ICONS)/32x32/apps $(ICONS)/16x16/apps
chmod 644 icons/*
cp -f icons/mkd-256x256.png $(ICONS)/256x256/apps/mkd.png
cp -f icons/mkd-48x48.png $(ICONS)/48x48/apps/mkd.png
cp -f icons/mkd-32x32.png $(ICONS)/32x32/apps/mkd.png
cp -f icons/mkd-16x16.png $(ICONS)/16x16/apps/mkd.png
#if [ -e "/usr/share/icons/hicolor/16x16/apps/mkd.png" ]; \
# then gtk-update-icon-cache -t /usr/share/icons/hicolor; fi
#
# install languages:
# see ./install_languages
# Installs for tests the local languages, 'de', 'es', 'fr', it, ro, etc.:
install -d $(LANG)/en/LC_MESSAGES $(LANG)/de/LC_MESSAGES $(LANG)/fr/LC_MESSAGES
chmod 644 lang/*
cp -f lang/mkd_en.mo $(LANG)/en/LC_MESSAGES/mkd.mo
cp -f lang/mkd_fr.mo $(LANG)/fr/LC_MESSAGES/mkd.mo
cp -f lang/mkd_de.mo $(LANG)/de/LC_MESSAGES/mkd.mo
#
# install manuals:
# see ./install_manuals
## install default manual:
install -D -m644 lang/mkd_en.1.gz $(MAN)/man1/mkd.1.gz
#
## install 'fr' manual:
install -d $(MAN)/fr.UTF-8/man1; \
cp -f lang/mkd_fr.1.gz $(MAN)/fr.UTF-8/man1/mkd.1.gz; \
## install 'de' manual:
install -d $(MAN)/de/man1; \
cp -f lang/mkd_de.1.gz $(MAN)/de/man1/mkd.1.gz; \
#
# install and update MIME database: see update in post-install package
# see install_mime_database
install -D -m644 mkdw.xml $(MIME)/packages/mkdw.xml
# if [-e "/usr/share/mime/packages/mkdw.xml" ]; then update-mime-database /usr/share/mime/; fi
# re-clean
rm -f $(PGM)
rm -f *.o
rm -f *~
clean:
rm -f $(PGM)
rm -f *.o
rm -f *~
- Valider les modifications par un examen du fichier des tests
make -d install DESTDIR=../tests (Dans le répertoire des sources)
Vérifier que tout est en ordre et que la langue allemande est bien à sa place
- Ajouter un fichier README-INSTALL
Remarque importante
La commande mkd est une commande UNIX comme mkdir, ls, grep, ...
L'installation universelle de la commande mkd est exécutée dans le répertoire
des sources par un super utilisateur :
1. Télégargez le fichier d'origine sur le serveur Launchpad
https://launchpad.net/~jean-paul-louyot/+archive/mkd/+copy-packages
2. Décompactez le fichier mkd_<version>.tar.gz ou .orig.tar.gz
3. Tapez la commande sudo make install pour les versions Debian ou dérivés ou
sous utilisateur root (Voir la commande su)
4. Pour désintaller tapez la command ./uninstall dans le répertoire des sources.
Les paquets d'installation peuvent être utilisés par facilité.
Les paquets debian peuvent être mués en paquets rpm ou slp avec la commande
alien :
alien [--to-deb] [--to-rpm] [--to-tgz] [--to-slp] [options] file [...]
Mise à jour du répertoire debian
- Commencer par mettre ce répertoire à jour
- le supprimer dans le répertoire des sources
- Relancer la commande Build (dans le répertoire de l'exercice)
- Entrer dans le répertoire debian
- Éditer le fichier changelog et remplacer mkd (0~120302-1) unstable par """mkd (0~120302-2) saucy. La version courante de linux ubuntu est saucy en janvier 2014. Supprimer ce qui suit Initial release
- Éditer le fichier control et remplacer unknown à la ligne Section par devel. Pour le reste, se reporter à l'exercice précédent
Source: mkd
Section: devel
Priority: extra
Maintainer: Edeulo <edeulo@free.fr>
Build-Depends: debhelper (>= 8.0.0)
Standards-Version: 3.9.4
Homepage: https://fr.wikibooks.org/wiki/Mkd_(Extracteur_de_documents)/Dépôt_parrainé_du_paquet_"original"_mkd-131215/Mise_à_jour_de_paquets#Mettre_à_jour
#Vcs-Git: git://git.debian.org/collab-maint/mkd-120302-2.git
#Vcs-Browser: http://git.debian.org/?p=collab-maint/mkd-120302-2.git;a=summary
Package: mkd
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: Exercice "Intention d'empaqueter"
Voir "mkd (extracteur de documents)" sur Wikibooks
Ce paquet debian Ubuntu est destiné à installer le binaire
- 6. Éditer le fichier copyright et remplacer la ligne Source: par
Source: http://edeulo.free.fr/pub/Packaging-exercises/mkd-120302-exercice-2.tar.xz
Puis recopier le reste de Files: * ... jusqu'à la fin.
Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: mkd
Source: http://edeulo.free.fr/pub/Packaging-exercises/mkd-120302-exercice-2.tar.xz
Files: *
Copyright: 1986-2001 Jean-Paul Louyot <jpl@cem2.univ-montp2.fr>
2001-2014 Jean-Paul Louyot <jean.paul.louyot@gamail.com>
2001-2014 Clara Jimenez <clara.jimenez2@gmail.com>
License: EUPL-1.1
This package is free software; you can redistribute it and/or modify
it under the terms of the European Licence EUPL.
http://edeulo.free.fr/wiki/index.php/Projet_mkd#LE_DROIT_DE_COPIE:
.
Sauf obligation légale ou contractuelle écrite, le logiciel distribué sous la
Licence est distribué «en l’état»,
SANS GARANTIES OU CONDITIONS QUELLES QU’ELLES SOIENT, expresses ou implicites.
Consultez la Licence pour les autorisations et les restrictions linguistiques
spécifiques relevant de la Licence.
# If you want to use GPL v2 or later for the /debian/* files use
# the following clauses, or change it to suit. Delete these two lines
Files: debian/*
Copyright: 2014 Edeulo <edeulo@free.fr>
License: GPL-2+
This package is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.
This package is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>
.
On Debian systems, the complete text of the GNU General
Public License version 2 can be found in "/usr/share/common-licenses/GPL-2".
# Please also look if there are files or directories which have a
# different copyright/license attached and list them here.
# Please avoid to pick license terms that are more restrictive than the
# packaged work, as it may make Debian's contributions unacceptable upstream.
- 7. Vérifier que le fichier doc contienne bien 'README-INSTALL'
- 8. Supprimer tous les fichiers .ex, .EX; et README.*
- 9. Copier les fichiers postinst et postrm de l'exercice précédent. puisque rien n'a changé ...
- Contenu du répertoire debian après mise à jour
- -rw-r--r-- 1 edeulo edeulo 128 janv. 20 15:36 changelog
- -rw-r--r-- 1 edeulo edeulo 2 janv. 20 15:26 compat
- -rw-r--r-- 1 edeulo edeulo 696 janv. 20 15:36 control
- -rw-r--r-- 1 edeulo edeulo 1394 janv. 20 15:26 copyright
- -rw-r--r-- 1 edeulo edeulo 34 janv. 20 15:26 docs
- -rw-r--r-- 1 edeulo edeulo 1285 janv. 13 10:43 postinst
- -rw-r--r-- 1 edeulo edeulo 1092 janv. 13 10:41 postrm
- -rwxr-xr-x 1 edeulo edeulo 442 janv. 20 15:26 rules
- drwxr-xr-x 2 edeulo edeulo 4096 janv. 20 15:26 source
Créer les paquets locaux
debuild -i -us -uc - b cd .. edeulo@jpl-ubuntu-13:~/Packaging/mkd/mkd_12XXXX/mkd-120302-exercice-2$ ls -al -rwxr-xr-x 1 edeulo edeulo 530 janv. 20 17:06 Build drwxr-xr-x 4 edeulo edeulo 4096 janv. 20 14:12 Fichiers-d'origine drwxr-xr-x 5 edeulo edeulo 4096 janv. 20 16:55 Fichiers-intermédiares -rwx--x--x 1 edeulo edeulo 375 mars 12 2013 KONSOLE drwx------ 6 edeulo edeulo 4096 janv. 20 17:34 mkd-0~120302 -rw-r--r-- 1 edeulo edeulo 11536 janv. 20 17:34 mkd_0~120302-2_amd64.build -rw-r--r-- 1 edeulo edeulo 638 janv. 20 17:34 mkd_0~120302-2_amd64.changes -rw-r--r-- 1 edeulo edeulo 222430 janv. 20 17:34 mkd_0~120302-2_amd64.deb -rw-r--r-- 1 edeulo edeulo 290955 janv. 20 16:58 mkd_0~120302.orig.tar.gz drwxr-xr-x 5 edeulo edeulo 4096 janv. 20 11:57 tests
Créer, vérifier, et tester les fichiers de transfert au dépôt
cd mkd-0~12030 debuild -S -sa -k230B1A04
Les fichiers nécessaires au transfert ont été créés sans erreur
- Vérifier le paquet
dput -ol ppa:jean-paul-louyot/exercises mkd_0~120302-2_source.changes
Good signature on /home/edeulo/Packaging/mkd/mkd_12XXXX/mkd-120302-exercice-2/mkd_0~120302-2.dsc.
Package includes an .orig.tar.gz file although the debian revision suggests
that it might not be required. Multiple uploads of the .orig.tar.gz may be
rejected by the upload queue management software.
- Simuler le dépôt
dput -s ppa:jean-paul-louyot/exercises mkd_0~120302-2_source.changes
Même message d'avertissement : Peut être refusé par la file d'attente de téléchargement
On peut s'attendre à avoir un rejet.
Nouvelle version
Dans tous les exercice précédents, le seul but était d'apprendre à créer des paquets et à les envoyer en dépôt sur le serveur Launchpad.
Or notre application se veut universelle compilable sur tous les systèmes Unix, Linux, et accessoirement sous d'autres systèmes tels que MS-Windows ou Mac.
L'application se compile en ligne de commande à l'aide d'un Makefile ou un shell de commandes install (install.sh, install.bat)
Les paquets sont agréables à installer.
L'idée est donc de créer des paquets debian avec un original contenant des sources compilables sur tous les systèmes d'exploitation, pour n'importe quelle machine, quel que soit son processeur.
Pour ce faire, nous allons transposer tout le répertoires des sources dans un répertoire d'origine/sources et créer un Makefile spécialisé pour la construction de paquets.
Nous devrons aussi donner un maximum de renseignements pour installer l'application sur d'autres machines.
Créer le nouvel environnement de travail
- Créer les répertoire contenant l'ensemble des éléments de travail
mkdir mkd-120515-exercice-3 mkd-120515-exercice-3/mkd-120515 - Copier dans ce répertoire les utilitaires KONSOLE et Build de l'exercice précédent.
- Copier mkd_0~120302.orig.tar.xz de l'exercice-0 dans le répertoire mkd-120515
- Décompacter mkd_0~120302.orig.tar.xz et renommer src le répertoire décompacté.
- Entrer dans le répertoire src et lancer la commande :
make -d install DESTDIR=../.
Cette commande va créer les répertoires utiles à la fabrication des paquets.
- Vérifier le contenu du répertoire mkd-120515/usr
edeulo@jpl-ubuntu-13:~/Packaging/mkd/mkd_12XXXX/mkd-120515-exercice-3/mkd-120515/usr$ find
.
./share
./share/mime
./share/mime/packages
./share/mime/packages/mkdw.xml
./share/doc
./share/man
./share/man/fr.UTF-8
./share/man/fr.UTF-8/man1
./share/man/fr.UTF-8/man1/mkd.1.gz
./share/man/man1
./share/man/man1/mkd.1.gz
./share/icons
./share/icons/hicolor
./share/icons/hicolor/256x256
./share/icons/hicolor/256x256/apps
./share/icons/hicolor/256x256/apps/mkd.png
./share/icons/hicolor/16x16
./share/icons/hicolor/16x16/apps
./share/icons/hicolor/16x16/apps/mkd.png
./share/icons/hicolor/32x32
./share/icons/hicolor/32x32/apps
./share/icons/hicolor/32x32/apps/mkd.png
./share/icons/hicolor/48x48
./share/icons/hicolor/48x48/apps
./share/icons/hicolor/48x48/apps/mkd.png
./share/locale
./share/locale/fr
./share/locale/fr/LC_MESSAGES
./share/locale/fr/LC_MESSAGES/mkd.mo
./share/locale/en
./share/locale/en/LC_MESSAGES
./share/locale/en/LC_MESSAGES/mkd.mo
./share/locale/de
./share/locale/de/LC_MESSAGES
./bin
./bin/mkd
On voit qu'il y manque la langue allemande pour les messages et le manuel
Créer le Makefile d'empaquetage
- Seul le binaire usr/bin/mkd doit être mis à jour pour les différents processeurs
- Il faut donc
- précompiler tous les fichiers d'accompagnement de l'application (langues, icônes, etc.),
- mettre le binaire mkd à jour pour chaque processeur par le serveur Launchpad.
- Construction du Makefile à l'aide du Makefile des sources
#!/bin/make
# File: Makefile for packaging mkd on debian or ubuntu systems
# https://fr.wikibooks.org/wiki/Mkd_(Extracteur_de_documents) Dépôt_parrainé_du_paquet_"original"_mkd-131215/Mise_à_jour_de_paquets#Créer_le_Makefile_d'empaquetage
#######################################################
# Updated by JPL 2012-05-22
# Amended by JPL 2012-06-08
# Amended by Clara for Wikibooks 2014-01-12, 2014-01-22
#
# Copyright: ©EELL http://edeulo.free.fr/wiki/index.php/Projet_mkd#LE_DROIT_DE_COPIE:
#
#######################################################
PGM = mkd
SRC = src
BINDIR = usr/bin
BINMODE = 755
CC = cc
SRCS = $(SRC)/mkd.c $(SRC)/asm.c $(SRC)/cpp.c
#
HDRS = $(SRC)/version.h $(SRC)/asm.h $(SRC)/cpp.h $(SRC)/find.inc.h \
$(SRC)/internationalisation.h $(SRC)/find.inc.c $(SRC)/basic.inc.c $(SRC)/ \
$(SRC)/fortran.inc.c $(SRC)/pascal.inc.c $(SRC)/shell.inc.c $(SRC)/tri.inc.c \
$(SRC)/syn-fr.i $(SRC)/syn-eng.i
#
OBJS =
LIBS =
CFLAGS = -O
LDFLAGS =
SPLINTFLAG = -weak
$(PGM): $(SRCS) $(HDRS)
# cette section doit provoquer une erreur si $(BINDIR) n'existe pas
#-@echo "*********** update $(PGM) ***********"
$(CC) $(CFLAGS) -o $(PGM) $(SRCS)
-@if [ -d $(BINDIR) ]; then \
mv -f $(PGM) $(BINDIR)/$(PGM);\
chmod $(BINMODE) $(BINDIR)/$(PGM);\
else \
echo "couldn't find $(BINDIR)";\
fi
install:
mkdir -p debian/mkd/usr/bin
cp -rf usr debian/mkd/.
clean:
rm -rf *~
rm -f $(PGM)
rm -f $(PGM) $(BINDIR)/$(PGM)
- vérifier que usr/bin/mkd est mis à jour : (heure de compilation actualisée)
edeulo@jpl-ubuntu-13:~/Packaging/mkd/mkd_12XXXX/mkd-120515-exercice-3/mkd-120515$ \
make mkd ls -l usr/bin/mkd → -rwxr-xr-x 1 edeulo edeulo 35122 janv. 22 15:49 usr/bin/mkd
Créer les conditions d'empaquetage debian avec dh_make
tar cvzf mkd-120515.tar.gz mkd-120515 cd mkd-120515/ dh_make -c GPL -e edeulo@free.fr -s -n -f mkd-120515.tar.gz
- Modifier les fichiers comme dans les exercices précédents
debian/changelog
mkd (120515) saucy; urgency=low
* Initial Release.
-- Edeulo <edeulo@free.fr> Wed, 22 Jan 2014 17:20:01 +0100
debian/control
Source: mkd
Section: devel
Priority: extra
Maintainer: Edeulo <edeulo@free.fr>
Build-Depends: debhelper (>= 8.0.0)
Standards-Version: 3.9.4
Homepage: https://fr.wikibooks.org/wiki/Mkd_(Extracteur_de_documents)/Dépôt_parrainé_du_paquet_"original"_mkd-131215/Mise_à_jour_de_paquets#Nouvelle_version
Package: mkd
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: Exercice "Nouvelle version"
Voir "mkd (extracteur de documents)" sur Wikibooks
Ce paquet debian Ubuntu est destiné à installer la commande mkd
debian/copyright
Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: mkd
Source: http://edeulo.free.fr/pub/Packaging-exercises/mkd-120302-exercice-3.tar.xz
Files: *
Copyright: 1986-2001 Jean-Paul Louyot <jpl@cem2.univ-montp2.fr>
2001-2014 Jean-Paul Louyot <jean.paul.louyot@gamail.com>
2001-2014 Clara Jimenez <clara.jimenez2@gmail.com>
License: EUPL-1.1
This package is free software; you can redistribute it and/or modify
it under the terms of the European Licence EUPL.
http://edeulo.free.fr/wiki/index.php/Projet_mkd#LE_DROIT_DE_COPIE:
.
Sauf obligation légale ou contractuelle écrite, le logiciel distribué sous la
Licence est distribué «en l’état»,
SANS GARANTIES OU CONDITIONS QUELLES QU’ELLES SOIENT, expresses ou implicites.
Consultez la Licence pour les autorisations et les restrictions linguistiques
spécifiques relevant de la Licence.
Files: debian/*
Copyright: 2014 Edeulo <edeulo@free.fr>
License: GPL-3.0+
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
.
This package is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
.
On Debian systems, the complete text of the GNU General
Public License version 3 can be found in "/usr/share/common-licenses/GPL-3".
debian/docs
README-INSTALL
README-INSTALL.pdf
debian/README
The Debian Package mkd
----------------------------
Nouveau projet exercice N°4
-- Edeulo <edeulo@free.fr> Wed, 22 Jan 2014 17:20:01 +0100
- recopier les fichiers debian/postinst et debian/postrm des exercices précédents
- Ajouter le fichier README-INSTALL dans le répertoire origine mkd-120515
et README-INSTALL.pdf de l'exercice précédent :
README-INSTALL
Remarque importante
La commande mkd est une commande UNIX comme mkdir, ls, grep, ...
L'installation universelle de la commande mkd est exécutée dans le répertoire
des sources par un super utilisateur :
1. Télégargez le fichier d'origine sur le serveur Launchpad
https://launchpad.net/~jean-paul-louyot/+archive/mkd/+copy-packages
2. Décompactez le fichier mkd_<version>.tar.gz ou .orig.tar.gz
3. Tapez la commande sudo make install pour les versions Debian ou dérivés ou
sous utilisateur root (Voir la commande su)
4. Pour désinstaller tapez la command ./uninstall dans le répertoire des sources.
Les paquets d'installation peuvent être utilisés par facilité.
Les paquets debian peuvent être mués en paquets rpm ou slp avec la commande
alien :
alien [--to-deb] [--to-rpm] [--to-tgz] [--to-slp] [options] file [...]
Créer le paquet local
Dans le répertoire origine :
debuild -i -us -uc -b
dpkg-deb : construction du paquet « mkd » dans « ../mkd_120515_amd64.deb ».
dpkg-genchanges -b >../mkd_120515_amd64.changes
dpkg-genchanges: envoi d'un binaire - aucune inclusion de code source
dpkg-source -i --after-build mkd-120515
dpkg-buildpackage: envoi d'un binaire seulement (aucune inclusion de code source)
Now running lintian...
Finished running lintian.
Relisant le fichier créé :mkd_120515_amd64.deb avec le gestionnaire d'archives on s'aperçoit que l'on a oublié la langue allemande :
- copier les fichiers mkd-de.1.gz et mkd_de.mo dans src/lang
- ajouter cp -f lang/mkd_de.mo $(LANG)/de/LC_MESSAGES/mkd.mo dans src/Makefiles (ligne ±69)
- ajouter install -D -m644 lang/mkd_de.1.gz $(MAN)/de/man1/mkd.1.gz dans src/Makefile (ligne ±75)
- relancer make -d install DESTDIR=../. dans le répertoire src
- contrôler que la langue allemande est maintenant présente
- ./share/man/fr.UTF-8/man1/mkd.1.gz
- ./share/man/de/man1/mkd.1.gz
- ./share/man/man1/mkd.1.gz
- ...
- ./share/locale/fr/LC_MESSAGES/mkd.mo
- ./share/locale/en/LC_MESSAGES/mkd.mo
- ./share/locale/de/LC_MESSAGES/mkd.mo
- Tout reconstruire
- Build
#!/bin/bash
echo " créer le fichier d'origine native .tar.gz "
tar cvzf mkd-120515.tar.gz mkd-120515
echo " Il est inutile de recréer les fichiers debian"
echo " entrant dans le répertoire mkd-0~120302"
cd mkd-120515
echo " action : création du paquet debian : debuild -i -us -uc -b"
debuild -i -us -uc -b
echo " sortant du répertoire mkd-120515"
cd ..
echo " Contrôler le contenu du paquet .deb avec le gestionnaire d'archives"
echo " Vérifier la présence des langues"
echo " Vérifier le copyright et README-INSTALL dans /usr/share/doc/mkd"
read
Préparer l'envoi au dépôt Launchpad
- Créer les fichiers pour Launchpad
cd mkd-120515 debuild -S -sa -k230B1A04
Éditer et vérifier les fichiers : mkd_120515_source.build, mkd_120515_source.changes, mkd_120515.dsc
- Vérifier le paquet
cd .. dput -ol ppa:jean-paul-louyot/exercises mkd_120515_source.changes
- Simuler le dépôt
dput -s ppa:jean-paul-louyot/exercises mkd_0~120302-2_source.changes
Dépôt sur Launchpad
Pour déposer un paquet il faut disposer d'un compte de dépôt (PPA)[4] et d'une clé PGP avec GnuPG
- Création d'un dépôt pour les exercices
- Pour la démonstration on a créé un nouvel espace :
- Dans le ppa:jean-paul-louyot, on a créé le répertoire exercises avec le nouveau ppa Do a package
- https://launchpad.net/~jean-paul-louyot/+archive/exercises
Launchpad - Premier exercice : ITP mkd_0~120302-1
- La commande
- dput ppa:jean-paul-louyot/exercises mkd_0~120302-1_source.changes
- a correctement téléversé les fichiers suivants :
Uploading to ppa (via ftp to ppa.launchpad.net):
Uploading mkd_0~120302-1.dsc: done.
Uploading mkd_0~120302.orig.tar.xz: done.
Uploading mkd_0~120302-1.debian.tar.gz: done.
Uploading mkd_0~120302-1_source.changes: done.
Successfully uploaded packages.
Si vous vous êtes trompé dans l'envoi vous trouverez le fichier .upload qu'il faudra supprimer si vous désirez faire un nouvel envoi.
- Réception du courrier après build
* Source Package: mkd
* Version: 0~120302-1
* Architecture: amd64
* Archive: jean-paul-louyot-exercises PPA
* Component: main
* State: Failed to build
* Duration: 3 minutes
* Build Log: https://launchpad.net/~jean-paul-louyot/+archive/exercises/+build/5463514/+files/buildlog_ubuntu-saucy-amd64.mkd_0%7E120302-1_FAILEDTOBUILD.txt.gz
* Builder: https://launchpad.net/builders/seaborgium
* Source: not available
- Édition du fichier Build Log _FAILEDTOBUILD.txt.gz
552 make[1]: Leaving directory `/build/buildd/mkd-0~120302'
553 dh_install -a
554 cp: cannot stat 'debian/tmp/usr/share/man/fr.UTF-8/man1/mkd.1.gz': No such file or directory
555 dh_install: cp -a debian/tmp/usr/share/man/fr.UTF-8/man1/mkd.1.gz debian/mkd/usr/share/man/fr.UTF-8/man1/ returned exit code 1
556 make: *** [binary-arch] Error 2
557 dpkg-buildpackage: error: /usr/bin/fakeroot debian/rules binary-arch gave error exit status 2
La construction des paquets s'est donc arrêtée faute de trouver le fichier mkd.1.gz. La construction de notre paquet local n'a pas généré d'erreur et le répetoire des tests que nous avons utilisé pour créer le fichier mkd.install montre bien le fichier mkd.1.gz dans le bon répertoire.
- Pourquoi ça n'a pas fonctionné alors que le répertoire debian/tmp a bien été créé
Pour cela il faut pour cela relire la compilation dans _FAILEDTOBUILD.txt.gz :
## install 'fr' manual:
if [ -d "/usr/share/man/fr.UTF-8/man1" ]; \
then \
install -d /build/buildd/mkd-0~120302/debian/tmp/usr/share/man/fr.UTF-8/man1;\
cp -f lang/mkd_fr.1.gz /build/buildd/mkd-0~120302/debian/tmp/usr/share/man/fr.UTF-8/man1/mkd.1.gz; \
elif [ -d "/usr/share/man/fr/" ]; \
then \
install -d /build/buildd/mkd-0~120302/debian/tmp/usr/share/man/fr/man1; \
cp -f lang/mkd_fr.1.gz /build/buildd/mkd-0~120302/debian/tmp/usr/share/man/fr/man1/mkd.1.gz ; \
fi
On voit que la condition d'installation du fichier mkd.1.gz dépend de la machine sur laquelle on va effectuer la compilation.
- Il est impératif d'éliminer les compilations conditionnelles
- On peut installer
- des fichiers, sans avoir recours à une copie conditionnelle.
- les fichiers dans un répertoire déterminé (là où il sera installé avec le paquet). En cas de nécessité, on pourra déplacer ces fichiers par un script dans debian/post-install.
- Reconstruction du paquet par modification du Makefile.
Launchpad - Deuxième exercice : Patch mkd_0~120302-1ubuntu1
dput ppa:jean-paul-louyot/exercises mkd_0~120302-1ubuntu1_source.changes
- → message sur console
edeulo@jpl-ubuntu-13:~/Packaging/mkd/mkd_12XXXX/mkd-120302-exercice-1$ dput ppa:jean-paul-louyot/exercises mkd_0~120302-1ubuntu1_source.changes
Checking signature on .changes
gpg: Signature faite le ven. 17 janv. 2014 18:25:20 CET avec la clef RSA d'identifiant 230B1A04
gpg: Bonne signature de « Éditeurs Européens (Logiciels libres) <edeulo@free.fr> »
gpg: alias « Jean-Paul Louyot (clé pour launchpad) <jean.paul.louyot@free.fr> »
Good signature on /home/edeulo/Packaging/mkd/mkd_12XXXX/mkd-120302-exercice-1/mkd_0~120302-1ubuntu1_source.changes.
Checking signature on .dsc
gpg: Signature faite le ven. 17 janv. 2014 18:25:20 CET avec la clef RSA d'identifiant 230B1A04
gpg: Bonne signature de « Éditeurs Européens (Logiciels libres) <edeulo@free.fr> »
gpg: alias « Jean-Paul Louyot (clé pour launchpad) <jean.paul.louyot@free.fr> »
Good signature on /home/edeulo/Packaging/mkd/mkd_12XXXX/mkd-120302-exercice-1/mkd_0~120302-1ubuntu1.dsc.
Uploading to ppa (via ftp to ppa.launchpad.net):
Uploading mkd_0~120302-1ubuntu1.dsc: done.
Uploading mkd_0~120302.orig.tar.xz: done.
Uploading mkd_0~120302-1ubuntu1.debian.tar.gz: done.
Uploading mkd_0~120302-1ubuntu1_source.changes: done.
Successfully uploaded packages.
- → retour par courrier électronique
Rejected:
Unable to identify 'Edeulo':<edeulo@jpl-ubuntu-13.04> in launchpad
Further error processing not possible because of a critical previous error.
- Consultation du dépôt
- https://launchpad.net/~jean-paul-louyot/+archive/exercises
- La version n'apparaît pas, on peut donc refaire le fichier _sources.changes avec une bonne signature :
- Lecture du fichier _sources.changes.clear
| ☞ | Cliquer sur le fichier _source.changes. Si vous avez la bonne clé vous obtiendrez le fichier _source.changes.clear |
- ligne 9 : Maintainer: Edeulo <edeulo@free.fr>
- ligne 10 : Changed-By: Edeulo <edeulo@jpl-ubuntu-13.04>
- Modifier le fichier debian/changelog
- ligne 5 :
- — -- Edeulo <edeulo@jpl-ubuntu-13.04> Fri, 17 Jan 2014 15:05:36 +0100
- + -- Edeulo <edeulo@free.fr> Fri, 17 Jan 2014 15:05:36 +0100
- Recommencer
- debuild -S -sa -k230B1A04 dans le répertoire dorigine, et vérifier que le fichier _source.changes est bien correctement modifié,
- déplacer ou supprimer mkd_0~120302-1ubuntu1_source.ppa.upload pour qu'il n'y ait pas une nouvelle erreur de transfert.
- dput ppa:jean-paul-louyot/exercises mkd_0~120302-1ubuntu1_source.changes au dessus du répertoire d'origine.
- Voir les fichiers compilés et empaquetés après un temps d'attente variable en fonction du nombre de paquets en instance ...
https://launchpad.net/~jean-paul-louyot/+archive/exercises/+packages
- Remarques
- L'archive debian mkd_0~120302-1ubuntu1.debian.tar.gz, contient maintenant , en plus de sa propre archive debian, une archive icon dans laquelle on retrouve l'ancienne archive mkd_0~120302-1.debian.tar.gz
→ debian habituel
+ incons/mkd_0~120302-1.debian.tar.gz ajouté - Le répertoire debian contient maintenant, en plus du fichier format, le fichier includes-binaries avec le texte "icons/mkd_0~120302-1.debian.tar.gz"
- Sur Launchpad : Le nouveau dépôt, avec le patch, a remplacé celui qui avait échoué.
Launchpad - Troisième exercice : Mettre à jour
dput ppa:jean-paul-louyot/exercises mkd_0~120302-2_source.changes
- Réponse par courriel
Accepted:
OK: mkd_0~120302.orig.tar.gz
OK: mkd_0~120302-2.debian.tar.gz
OK: mkd_0~120302-2.dsc
-> Component: main Section: devel
mkd (0~120302-2) saucy; urgency=low
* Initial release
Les fichiers ont été acceptés. Pas de problème pour les sommes de contrôle; mais la compilation ?
Les paris sont ouverts
- Réponse du serveur
- Tout le monde a faux !
La nouvelle version 0~120302-2 remplace la version 0~120302-1ubuntu1 avec une différence de 3,8Kilo-Bytes Le serveur Launchpad a répondu Erreur de compilation pour amd64 et Compilation copmplète pour i386
Changelog
mkd (0~120302-2) saucy; urgency=low
* Initial release
-- Edeulo <edeulo@free.fr> Mon, 20 Jan 2014 15:26:11 +0100
Available diffs
diff from 0~120302-1ubuntu1 to 0~120302-2 (3.8 KiB)
Builds
[FAILEDTOBUILD] amd64
[FULLYBUILT] i386
Built packages
mkd Exercice "Mettre à jour"
Package files
mkd_0~120302-2.debian.tar.gz (2.8 KiB)
mkd_0~120302-2.dsc (1.4 KiB)
mkd_0~120302-2_i386.deb (215.8 KiB)
mkd_0~120302.orig.tar.gz (284.1 KiB)
Dans https://launchpad.net/~jean-paul-louyot/+archive/exercises/+build/5484224 on a la possibilité de recompiler la version amd64
- [FAILEDTOBUILD] Failed to build Retry this build
- Recompilation correcte pour amd64
Launchpad - Quatrième exercice : Nouvelle version
dput ppa:jean-paul-louyot/exercises mkd_120515_source.changes
→ Retour par courriel :
Accepted:
OK: mkd_120515.tar.gz
OK: mkd_120515.dsc
-> Component: main Section: devel
mkd (120515) saucy; urgency=low
* Initial Release.
- Consultation du dépôt
https://launchpad.net/~jean-paul-louyot/+archive/exercises/+copy-packages → résulat :
Publishing details
Published 36 minutes ago
Changelog
mkd (120515) saucy; urgency=low
* Initial Release.
-- Edeulo <edeulo@free.fr> Wed, 22 Jan 2014 17:20:01 +0100
Available diffs
diff from 0~120302-2 to 120515 (111.4 KiB)
Builds
[FULLYBUILT] amd64
[FULLYBUILT] i386
Built packages
mkd Exercice "Nouvelle version"
Package files
mkd_120515.dsc (1.1 KiB)
mkd_120515.tar.gz (446.3 KiB)
mkd_120515_amd64.deb (218.0 KiB)
mkd_120515_i386.deb (216.9 KiB)
Résumés, notes et références
Résumés des solutions
Exercice-0 Intention d'empaqueter
- On y apprend à
- modifier le fichier Makefile de l'application d'origine,
- créer des paquets multiples et à modifier les fichiers du répertoire debian, en particulier pour les paquets multiples,
- préparer les fichiers nécessaires à un dépôt sur Launchpad
- déposer sur Launchpad une application testée et sécurisée par une clé personnelle
- trouver les raisons de l'échec au dépôt
- renvoyer les fichiers corrigés après une erreur de compilations sur Launchpad
Exercice-1 Patch (rustine)
- On y apprend à
- créer les conditions de travail dans l'environnement utilisateur : QUILT_PATCHES,
- créer un patch avec quilt et ajouter les fichiers bogués au patch,
- modifier les fichiers bogués et rafraîchir le patch
- contrôler et modifier le fichier debian/changelog
- créer les nouveaux paquets
- mettre les modifications à jour avec dpkg-source --commit, et créer les fichiers de transfert sécurisés,
- préparer les fichiers nécessaires à un dépôt sur Launchpad,
- modifier une signature de clé erronée sans changer le checksum du fichier d'origine,
- renvoyer le fichier -source.changes et contrôler les applications déposées
Exercice-2 Mettre à jour
- On y apprend à
- à créer une nouvelle version origine (Sans le paquet doc. La version remplacera la précédente sur le dépôt)
- Ajouter des fichiers dans le répertoire source (Langues et README-INSTALL)
- (Makefile) Recréer les conditions de compilation adaptées à ces nouveaux fichiers, sans passer par un patch.
- Adapter les fichiers du répertoire debian pour une version binaire simple
- Créer les conditions de transfert comme dans les exercices précédents
- Relancer la compilation d'une version partiellement en échec
Exercice-3 Nouvelle version
- Création d'un paquet natif
- Simplification du répertoire d'origine
- Simplification du Makefile d'installation
Notes
- Téléchargement des exercices
- Exercice-0 Intention d'empaqueter mkd-120302-exercice-0.tar.xz
- Exercice-1 Patch (rustine) mkd-120302-exercice-1.tar.xz
- Exercice-2 Mettre à jour mkd-120302-exercice-2.tar.xz
- Exercice-3 Nouvelle version mkd-120515-exercice-3.tar.xz
- Voir aussi
→ Le paquet menu n'existe plus dans les versions récentes d'Ubuntu. Cependant il est possible d'ajouter une application manuellement en suivant cet exemple.
Références
Application et construction d'un paquet avec CDBS
Sommaire
1 Créer la hiérarchie des fichiers et répertoires de travail
2 Création du sous répertoire debian
3 Fichiers nécessitant une explication
3.1 debian/changelog
3.2 debian/control
3.3 debian/copyright
3.4 debian/rules
3.5 debian/doc
3.6 debian/postinst
3.7 debian/postrm
3.8 Makefile d'empaquetage
4 Création du paquet (debuild)
5 Échecs et mise à jour de paquets
5.1 Éviter les échecs
5.2 Échecs
5.3 Mise à jour de paquets
6 Notes et références
Les paquets d'installation des logiciels pour les systèmes d'exploitation linux permettent de sécuriser les systèmes grâce à des clés numériques. Ils permettent aussi de faciliter l'installation des applications.
Un paquet original est le premier paquet d'une série. Le paquet natif 131215 a été créé pour un nouveau dépôt ppa (Personnal packages)[1] personnalisé par l'équipe de maintenance de l'EELL (Éditeurs européens de logiciels libres)
Créer la hiérarchie des fichiers et répertoires de travail
- Répertoires
- ~Packaging/mkd/mkd-131215/ répertoire de travail qui contient :
- les fichiers de commandes
Make-new-ppa, Buid-all, Rebuild-all. - le répertoire origine ./mkd-0~131215
Contiendra le Makefile de création du paquet et les documents README, NEWS, etc. - le répertoire des sources ./mkd-0~131215/src
Contiendra tous les fichiers nécessaires à la compilations des sources
./mkd-0~131215/src/find.inc.c
./mkd-0~131215/src/shell.c
./mkd-0~131215/src/asm.c
./mkd-0~131215/src/cpp.h
./mkd-0~131215/src/version.h
./mkd-0~131215/src/internationalisation.h
./mkd-0~131215/src/basic.h
./mkd-0~131215/src/tri.c
./mkd-0~131215/src/cpp.c
./mkd-0~131215/src/basic.c
./mkd-0~131215/src/fortran.h
./mkd-0~131215/src/fortran.c
./mkd-0~131215/src/mkd.h
./mkd-0~131215/src/shell.h
./mkd-0~131215/src/pascal.h
./mkd-0~131215/src/find.inc.h
./mkd-0~131215/src/mkd.c
./mkd-0~131215/src/asm.h
./mkd-0~131215/src/tri.h
./mkd-0~131215/src/pascal.c
- 4. le répertoire des binaires et des données ./mkd-0~131215/usr
On pourra prévoir de les créer avec un Makefile ou les placer dores et déjà dans la hiérarchie 'usr' lorsque ces fichiers ne nécessitent pas de nouvelle compilation : les manuels, langues, icônes etc. :
./mkd-0~131215/usr/share/mime/packages/mkd.xml
./mkd-0~131215/usr/share/doc
./mkd-0~131215/usr/share/man/fr.UTF-8/man1/mkd.1.gz
./mkd-0~131215/usr/share/man/fr
./mkd-0~131215/usr/share/man/de/man1/mkd.1.gz
./mkd-0~131215/usr/share/man/man1/mkd.1.gz
./mkd-0~131215/usr/share/icons/hicolor/256x256/apps/mkd.pngps
./mkd-0~131215/usr/share/icons/hicolor/16x16/apps/mkd.png
./mkd-0~131215/usr/share/icons/hicolor/32x32/apps/mkd.png
./mkd-0~131215/usr/share/icons/hicolor/48x48/apps/mkd.png
./mkd-0~131215/usr/share/locale/fr/LC_MESSAGES/mkd.mo
./mkd-0~131215/usr/share/locale/en/LC_MESSAGES/mkd.mo
./mkd-0~131215/usr/share/locale/de/LC_MESSAGES/mkd.mo
./mkd-0~131215/usr/bin
Notez que :
- le seul fichier qui nécessite d'être mis à jour et placé dans le répertoire usr/bin/, est le binaire mkd adapté au processeur. (i386, amd64, ...)
Création du sous répertoire debian
Le répertoire ./mkd-0~131215/debian est créé à l'aide du fichier de commande 'Make-new-ppa' que nous avons placé au dessus du répertoire origine pour simplifier la création des divers paquets.
#!/bin/bash
# File Make new ppa
# ne pas lancer en sudo, et utiliser la Konsole
# créer le fichier orig.tar.gz
tar cvzf mkd-0~131215.tar.gz mkd-0~131215
# attention au souligné
# pas pour le natif : mv mkd-0~131015.tar.gz mkd_0~131015.orig.tar.gz
cd mkd-0~131215
dh_make -c GPL -e edeulo@free.fr -s -n -f mkd-0~131215.tar.gz -r CDBS
echo "Lorsque le répertoire debian a été créé, mettre les fichiers à jour:"
echo "Fichiers à mettre à jour:"
echo "changelog remplacer unstable par la version (precise ou saucy)"
echo "control, copyright, rules, watch"
echo "Il faudra ensuite lancer Build-all"
- Options dh_make
- -c GPL; general public licence (gpl2, gpl3, lgpl, lgpl2, lgpl3, artistic, apache, bsd ou mit)
- -e adresse électronique des mainteneurs
- -s seulement le binaire
- -n natif, ne pas générer d'archive .orig
- -f mkd-0~131215.tar.gz Ce sera l'archive originale
- -r CDBS directive pour créer le fichier de commande 'rules'
Fichiers nécessitant une explication
debian/changelog
mkd (0~131215) saucy; urgency=low
* Initial Release.
-- Clara <email@mailserver> Thu, 19 Dec 2013 17:44:21 +0100
Notez que :
- à la création, l'option -n a initialisé la version "* Initial Release"
- nous avons modifié la première ligne pour préciser la version saucy (ubuntu 13.10)
- ici, dans ce cadre, l'adresse de courriel est masquée pour éviter les spams
debian/control
Source: mkd
Section: unknown
Priority: extra
Maintainer: Clara <email@emailserver>
Build-Depends: cdbs, debhelper (>= 8.0.0)
Standards-Version: 3.9.4
Homepage: <insert the upstream URL, if relevant>
#Vcs-Git: git://git.debian.org/collab-maint/mkd.git
#Vcs-Browser: http://git.debian.org/?p=collab-maint/mkd.git;a=summary
Package: mkd
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: Application for software maintenance.
mkd (commande unix), extracteur de documents.
.
mkd extrait la documenation logicielle incluse dans les fichiers sources.
.
mkd extract comments in source files and product maintainers documentation.
Notez que :
- le créateur de fichier a bien fait son travail ...
- nous avons ajouté la 'Description' qui sera affichée à l'installation par le gestionnaire d'archives
- d'autres champs peuvent être indispensables[2]
- si le copyright n'apparaît pas à l'installation avec le gestionnaire d'archives il est possible, si c'est indispensable, de l'ajouter à la fin la description longue.
debian/copyright
Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: mkd
Source: <http://edeulo.free.fr>
Files: *
Copyright: 1989-2001 Centre d'électronique de Montpellier <jpl@cem2.univ-montp2.fr>
1989-2013 Jean-Paul Louyot <emailjpl@mailserver>
License: GPL-3.0+
Files: debian/*
Copyright: 2013 Clara <emailclara@mailserver>
License: GPL-3.0+
License: GPL-3.0+
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
.
This package is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
.
On Debian systems, the complete text of the GNU General
Public License version 3 can be found in "/usr/share/common-licenses/GPL-3".
# Please also look if there are files or directories which have a
# different copyright/license attached and list them here.
# Please avoid to pick license terms that are more restrictive than the
# packaged work, as it may make Debian's contributions unacceptable upstream.
Notez que :
- l'option -c GPL a automatiquement créé la licence GPL-3+
- nous avons ajouté les droits de copie et les licences depuis l'origine du fichier
- ce droit de copie va apparaître dans les docs '/usr/share/doc/mkd/. ' et n'est pas vraiment nécessaire si on propose les fichiers HISTORY ou/et COPYING ou/et AUTHORS avec les droits détaillés.
debian/rules
#!/usr/bin/make -f
include /usr/share/cdbs/1/rules/debhelper.mk
include /usr/share/cdbs/1/class/makefile.mk
# Add here any variable or target overrides you need.
# Cette classe est destinée à ceux qui ont uniquement un fichier Makefile (aucun autotools disponible) pour construire le programme. Vous avez uniquement besoin de quatre règles dans le Makefile :
# – une pour nettoyer le répertoire de construction (c’est-à-dire « mrproper »)
# – une pour construire votre logiciel (c’est-à-dire « myprog »)
# – une pour vérifier que votre logiciel fonctionne correctement (c’est-à-dire « check »)
# – une pour installer votre logiciel (c’est-à-dire « install »)
# Pour être honnête, la présence des règles d’installation n’est pas essentielle, mais cela aide toujours beaucoup lorsque vous les avez.
# The first operation, is to write the debian/rules. First, we add the include lines:
# Add here any variable or target overrides you need.
# if you detect authors’s loss of sanity, tell CDBS not to try running the nonexistent
# clean rule, and do the job yourself in debian/rules
DEB_MAKE_CLEAN_TARGET:= mrproper
DEB_MAKE_BUILD_TARGET:= mkd
DEB_MAKE_INSTALL_TARGET:= install
# no check for this software
##DEB_MAKE_CHECK_TARGET :=
# allow changing the makefile filename in case of emergency exotic practices
##DEB_MAKE_MAKEFILE:= MaKeFiLe
# example when changing environnement variables is necessary :
##DEB_MAKE_ENVVARS:= CFLAGS="-fomit-frame-pointer"
##DEB_BUILD_OPTIONS is checked for the following options :
##– noopt: utilise -O0 au lieu de -O2
##– nocheck: skip the check rule
# If your Makefile doesn’t support the DESTDIR variable, take a look in it and find the variable responsible for setting installation directory. If you don’t find some variable to do this, you’ll have to patch the file...
# C’est tout :)
Notez que :
- le fichier a été créé par l'option '-r CDBS'
- nous avons ajouté les commentaires de la notice
- notre nettoyeur s'appele 'mrproper' dans le Makefile d'empaquetage. on aurait pu utiliser le traditionnel 'clean'
- mkd est l'exécutable qu'il faut générer pour chaque configuration de processeur
- install va copier les fichiers ./mkd-0~131215/usr/* dans le répertoire ./mkd-0~131215/debian/mkd/usr/* .
A titre indicatif, il est possible d'utiliser une variante install DESTDIR=debian/mkd à condition de le prévoir; cette solution permet de créer un fichier temporaire de test avec install DESTDIR=debian/tmp/ (Pas vraiment utile !)
debian/doc
NEWS
README
AUTHORS
COPYING
HISTORY
INSTALL
les fichiers NEWS à INSTALL seront copiés dans le répertoire ./mkd-0~131215/debian/mkd/usr/share/doc/mkd/ avant d'être recopié dans /usr/share/doc/mkd/. à l'installation du paquet.
./mkd-0~131215/debian/mkd/usr/share/doc/mkd/HISTORY
./mkd-0~131215/debian/mkd/usr/share/doc/mkd/NEWS.gz
./mkd-0~131215/debian/mkd/usr/share/doc/mkd/INSTALL
./mkd-0~131215/debian/mkd/usr/share/doc/mkd/AUTHORS
./mkd-0~131215/debian/mkd/usr/share/doc/mkd/changelog.gz
./mkd-0~131215/debian/mkd/usr/share/doc/mkd/COPYING
./mkd-0~131215/debian/mkd/usr/share/doc/mkd/copyright
./mkd-0~131215/debian/mkd/usr/share/doc/mkd/README
Notez que :
- ces fichier sont dans le répertoire origine
- ces fichiers ne sont pas tous indispensables. Les fichiers intéressant sont le plus souvent
- NEWS qui sont les nouveautés par rapport aux versions précédentes
- README qui sont les commentaires qui concernent ce paquet.
Vous pouvez ajouter :
- AUTHORS avec le droit de copie spécial à chaque contributeur
- COPYING même chose que Copyright, mais peut spécifier des particularités notamment si une partie du logiciel contient une autre source.
- HISTORY décrit l'historique et les péripéties du logiciel si il y a lieu
- INSTALL est généralement créé par un 'autotool'. Dans ce cas in est inutile de l'intégrer dans les docs, Dans notre cas on peut y préciser une autre manière d'installer le logiciel sans le paquet (qui ne sera donc pas automatiquement mis à jour)
On peut ajouter d'autres fichiers tels que :
- SURVEY souvent pour obtenir un soutien financier, mais ce peut être aussi un appel à contribution technique
- TRANSLATIONS demande d'aide pour traduire les messages et les manuels.
- ...etc.
debian/postinst
Ce fichier sera exécuté après l'installation du paquet et doit mettre les bases de données à jour.
#!/bin/sh -e
# file postinst for mkd debian installation
#
#
# POST INSTALL
#
echo " postinst : update icon cache "
gtk-update-icon-cache -t /usr/share/icons/hicolor
echo " postinst : install and update MIME database "
update-mime-database /usr/share/mime
# OPTIONS :
# update catman only if selected manuals exist in manpath :
# if [ -e $(MAN)"/man1/mkd.1.gz" ]; then catman -M $(MAN) 1 3; fi ;
# if [ -e $(MAN)"/de.UTF-8/man1/mkd.1.gz" ]; then catman -M $(MAN)/de.UTF-8 1; fi ;
# if [ -e $(MAN)"/de/man1/mkd.1.gz" ]; then catman -M $(MAN)/de 1 ; fi ;
# if [ -e $(MAN)"/fr.UTF-8/man1/mkd.1.gz" ]; then catman -M $(MAN)/fr.UTF-8 1; fi ;
# if [ -e $(MAN)"/fr/man1/mkd.1.gz" ]; then catman -M $(MAN)/fr 1 ; fi ;
#
# END POST INSTALL
#
Notez que :
- Si le manuel man1 du logiciel a été installé on peut aussi ajouter, en cas de nécessité, la mise à jour de la base de données 'whatis'. C'est en principe automatique ....
debian/postrm
Ce fichier sera exécuté après la désinstallation de l'application pour mettre les bases de données à jour.
#!/bin/sh -e
# file postrm for mkd debian installation
#
# POST RM
#
echo " postrm : update icon cache "
gtk-update-icon-cache -t /usr/share/icons/hicolor
echo " postrm : update MIME database "
update-mime-database /usr/share/mime
#
# END POST RM
#
Makefile d'empaquetage
- Le fichier le plus important du répertoire origine est le Makefile
# file: Makefile pour version LINUX UNBUNTU 13.10 reprise de la version de janvier 2012 par Clara
#####################################################
### UBUNTU version for mkd_R_13.12 debian package ###
#####################################################
PGM = mkd
SRC = src
BINDIR = usr/bin
BINMODE = 755
SRCS = $(SRC)/mkd.c $(SRC)/asm.c $(SRC)/basic.c $(SRC)/cpp.c $(SRC)/fortran.c $(SRC)/pascal.c $(SRC)/shell.c $(SRC)/tri.c
HDRS = $(SRC)/version.h $(SRC)/mkd.h $(SRC)/asm.h $(SRC)/basic.h $(SRC)/cpp.h $(SRC)/fortran.h $(SRC)/pascal.h $(SRC)/shell.c $(SRC)/find.inc.c $(SRC)/find.inc.h $(SRC)/tri.h
OBJS = mkd.o asm.o basic.o cpp.o fortran.o pascal.o shell.o tri.o
LIBS =
CFLAGS = -O
LDFLAGS =
SPLINTFLAG = -weak
$(PGM): $(SRCS) $(HDRS)
-@echo "*********** update $(PGM) ***********"
$(CC) $(CFLAGS) -o $(PGM) $(SRCS)
@#$(CC) $(LDFLAGS) -o $(PGM) $(OBJS) $(LIBS)
-@echo " -- update $(BINDIR)/$(PGM):"
-@if [ -d $(BINDIR) ]; then \
mv -f $(PGM) $(BINDIR)/$(PGM);\
chmod $(BINMODE) $(BINDIR)/$(PGM);\
else \
echo "couldn't find $(BINDIR)";\
fi
install:
mkdir -p debian/mkd/usr/bin
cp -rf usr debian/mkd/.
mrproper:
rm -rf *~
rm -f $(PGM) $(BINDIR)/$(PGM)
rm -f $(OBJS)
L'ordre d'exécution du Makefile est défini lors de la création du paquet, notamment par le fichier 'rules" que nous verrons ci_après.
1. nettoyage mrpropper
2. création de l'exécutable mkd
3. transfert des données et du binaire dans le répertoire debian/mkd/usr
- Les lettres majuscules définissent les macros habituelles dans les Makefiles
- La première directive $(PGM): $(SRCS) $(HDRS) va recompiler le binaire 'mkd' en fonction des processeurs : i386, amd64, etc. puis déplacer cet exécutable du répertoire courant vers le répertoire usr/bin
- La seconde directive va copier toute la hiérarchie du répertoire courant usr vers le répertoire debian/mkd/
- La troisième directive sert au nettoyage avant la création du paquet.
1. nettoyage mrpropper
2. création de l'exécutable mkd
3. transfert des données et du binaire dans le répertoire debian/mkd/usr
- Les lettres majuscules définissent les macros habituelles dans les Makefiles
- La première directive $(PGM): $(SRCS) $(HDRS) va recompiler le binaire 'mkd' en fonction des processeurs : i386, amd64, etc. puis déplacer cet exécutable du répertoire courant vers le répertoire usr/bin
- La seconde directive va copier toute la hiérarchie du répertoire courant usr vers le répertoire debian/mkd/
- La troisième directive sert au nettoyage avant la création du paquet.
Création du paquet (debuild)
#!/bin/bash
# File Buid-all-clara
echo " compilation "
cd mkd-0~131215
# clé de clara <emailclara@mailserver> sur le pc GE60 expire le 20 dec 2014 autorisée à déposer sur le ppa de JPL
debuild -S -sa -k49E6B949
cd ..
echo " put to distri server "
dput ppa:jean-paul-louyot/mkd mkd_0~131215-1_source.changes
echo " Attendre le résultat envoyé par courrier électronique ... "
echo " make local debian package "
cd mkd-0~131215
debuild -i -us -uc -b
cd ..
Notez que :
- ceci est la phase finale
- debuild -S -sa -k49E6B949 va créer les fichiers nécessaires à la recompilation des paquets sur le dépôt.
- dput ppa:jean-paul-louyot/mkd mkd_0~131215-1_source.changes. Il faut attendre quelque temps avant que le résultat nous parvienne en positif ou échec
- debuild -i -us -uc -b va créer un paquet local .deb
Échecs et mise à jour de paquets
Créer et administrer un dépôt sur launchpad[3]
Éviter les échecs
ATTENTION : Le dépôt va utiliser l' archive d'origine dans toute la suite des procédures de mises à jour. Si vous avez modifié le Makefile par exemple, il est nécessaire de tout reprendre ou de faire un patch, car l'archive d'origine du dépôt ne va pas contenir le même Makefile, donc pas la même somme de contrôle.
Il est aussi possible de conserver, dans une archive native, le répertoire d'origine avec son sous répertoire debian; cela permet de conserver une mémoire des mises à jour .
- Il est à noter que
- les archives d'origine de série ne contiennent pas le répertoire debian
- le répertoire debian est contenu dans une archive séparée .debian.tar.gz
- Exemple de noms d'archives
- Archive du répertoire d'origine : <répertoire>-<version>.tar.gz
- Archive d'origine native : <répertoire>_<version>.tar.gz
- Archive d'origine de série : <répertoire>_<version>.orig.tar.gz
- Archive d'origine de série : <répertoire>_<version>-<n>.orig.tar.gz où <n> est une suite successive de série 1, 2, 3, etc.
Pour faire les essais il est préférable de lancer la commande 'Rebuild-all' (Clara pour le chiffrage du transfert)
#!/bin/bash
# File Rebuid-all-clara
echo " rm old files "
# rm old files
rm -f *.dsc
rm -f *.changes
rm -f *.build
rm -f *.upload
rm -f *.deb
rm -f mkd-0~131215/debian/*.ex
rm -f mkd-0~131215/debian/*.EX
echo " sauvegarde du répertoire debian"
echo " note d'option -n : les fichiers ne sont pas recopiés si ils existent"
# n'oubliez pas le ' .' après debian. choisir l' option -rf pour recréer les fichiers
cp -rn mkd-0~131215/debian .
# attention à la commande qui suit ...
# cette archive native de référence ne doit plus être récréée lors des mises à jour
# ---------------------------------
echo " re-créer le fichier natif .tar.gz pour tenir compte des modifications "
tar cvzf mkd-0~131215.tar.gz mkd-0~131215
#
# pour une mise à jour :
# -----------------------------------
# - attention au caractère souligné 'mkd_0'
# - mv mkd-0~131015.tar.gz mkd est l'original natif
# - mkd_0~131015.orig.tar.gz ne doit plus être changé
# echo " renommer le fichier original natif .tar.gz en .orig.tar.gz et ne plus le modifier "
# mv mkd-0~131015.tar.gz mkd_0~131015.orig.tar.gz
#
echo " dh_make va créer le répertoire debian avec de nouveaux fichiers si il a été supprimé "
echo " il ne sera pas recréé avec de nouveaux fichiers si il existe "
cd mkd-0~131215
dh_make -c GPL -e edeulo@free.fr -s -n -f mkd-0~131215.tar.gz -r CDBS
# cd..
echo " re-debuild -S -sa -k49E6B949 (Clara) "
# cd mkd-0~131215
debuild -S -sa -k49E6B949
# cd ..
echo " re-debuild -i -us -uc -b création du paquet local "
# cd mkd-0~131215
debuild -i -us -uc -b
cd ..
echo " Si tout s'est bien passé on peut envisager le dépôt "
echo " Entrer la commande 'Buid-all-clara' "
Pour éviter les échecs : Vérifier si tout se passe bien avant d'envoyer le fichier au dépôt.
Échecs
Le transfert au dépôt ne se passe pas toujours très bien, il est rejeté. Il est nécessaire de corriger la construction du paquet.
Les rejets sont souvent dus aux commandes incluses dans le fichier Makefile.
Évitez d'utiliser des commandes susceptibles de renvoyer une valeur différente de zéro.
- Ecrivez rm -f <fichier> plutôt que rm <fichier>. rm -f renvoie zéro même si <fichier> n'existe pas.
- Supprimez le binaire dans la dépendance clean, faute de quoi le binaire ne sera pas mis à jour pour un autre processeur bien qu'il n'y ait aucune erreur de syntaxe.
- Vérifiez la validité des dépendances. N'écrivez pas clean : <fichier> ça n'a pas de sens.
- Veillez à ce que le contenu du répertoire soit propre, identique après compilation :
- De telle sorte que la somme de contrôle du répertoire soit la même après compilation; que tous les fichiers créés soient effacés.
- Effacer tous les fichiers '.o' (rm -f *.o) par exemple, ainsi que le nouvel exécutable qui a déjà été copié dans debian/mkd/usr/bin/
Launchpad renvoie des informations à l'auteur du transfert (Erreurs communes, la raison de l'échec, etc.)
- Rejected: Unable to find distroseries: unstable
- Dans debian/changelog il faut remplacer unstable par une version d'ubuntu : precise, ou version actuelle
- Rejected: Unable to find section: unknown
- Dans debian/control il faut remplacer unknown par la 'Sous-section' concernée[5] : devel pour nos applications
Si vous renvoyez le fichier tel quel avec la correction, il sera refusé si le fichier .upload se trouve dans votre répertoire:
- <UPLOADE_FILE> already exists in <LOCATION>
- Rejected because the logfile <package>_source on <host> .upload exist. Just remove the .upload file and re-run dput, or invoke dput with the flag -lf (-l run lintian before the upload; -f force an upload of an already uploaded package)
- Il faut supprimer le fichier .upload ou renvoyer le paquet corrigé avec les option -lf dput -lf [host [:arg]] package.changes
- Remarque : On peut éviter l'écriture du fichier .upload avec -option -U : dput -U
Résumé en cas d'échec :
- Si vous ne modifiez que les fichiers du répertoire debian dans une série
- Vous pouvez renvoyer les fichiers reconstruits après avoir effacé le fichier .upload
- → Dans une série, l'archive du répertoire debian est séparée. Suffixe: .debian.tar.gz
- Si vous modifiez un fichier du répertoire origine, contenant aussi le répertoire debian, il faut reconstruire le paquet !
- recharger l'original
- régénérer la source
- faire un patch ou reconstruire le paquet avec un numéro de version supérieur à la version en échec
- tester le transfert avec l'option dput -o, débugger avec l'option dput -d, simuler avec dput -s
- transférer le paquet source avec les changements (source.changes) avec dput -lf
- accessoirement, supprimer la version en échec sur launchpad. Cela peut arriver si on change de version Ubuntu dans le fichier changelog. (ATTENTION : La version n'apparaît plus, mais n'est jamais complètement effacée.)
Mise à jour de paquets
- Cas traités
- 1 L'intention d'empaqueter (création de paquets multiples)
- 2 Patch (rustine)
- 3 Mettre à jour (création de paquets binaires simples)
- 4 Nouvelle version (Paquets natifs)
- 5 Dépôts sur Launchpad
Notes et références
- Notes :
- Discussions[6] autour de l'empagetage debian et rpm ( mot de passe antispam : mkd )
- Références :