# Mkd (Extracteur de documents)/Dépôt parrainé du paquet ''original'' mkd-131215/Mise à jour de paquets

* 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 :
* votre usage personnel,
* proposer votre version sur votre dépôt personnel (ppa:)
* La suite des solutions aux exercices d'empaquetage devrait vous y aider.
* À petit pas, avec les erreurs communes et leurs solutions.

## 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 : 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
    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

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.

### Tester la compilation
#### 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"

#### 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.
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?
    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.

#### 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, 'saucy' pour ubuntu-13.10, en minuscules.
* control :
       Section il est impératif de remplacer unknown par devel (sous-section de Développement) 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 :

#### 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.

### Empaqueter
#### La commande suivante va lancer la construction du paquet

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 :
Correction de la ligne OBJS

#### À 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
On relance debuild -i -us -uc -b
Cette fois le paquet binaire est complet.

#### Pour information

* Éditer le fichier .changes. 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.
* 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.

#### 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

#### É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

#### 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 : 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
    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 :

#### Créer et tester les paquets
##### vérifier la compilation

* 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

    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

##### 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).
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 :
    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

#### 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

##### Valider les modifications par un examen du fichier des tests

Vérifier que tout est en ordre et que la langue allemande est bien à sa place

##### Ajouter un fichier README-INSTALL
#### 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
    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.
    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, vérifier, et tester les fichiers de transfert au dépôt

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
* Tenter malgré tout le dépôt du paquet sur Launchpad :
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
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

* vérifier que usr/bin/mkd est mis à jour : (heure de compilation actualisée)

#### Créer les conditions d'empaquetage debian avec dh_make
##### Modifier les fichiers comme dans les exercices précédents

debian/changelog
debian/control
debian/copyright
debian/docs
debian/README

##### Ajouter le fichier README-INSTALL dans le répertoire origine mkd-120515

et README-INSTALL.pdf de l'exercice précédent :
README-INSTALL

#### Créer le paquet local

Dans le répertoire origine :
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

#### Préparer l'envoi au dépôt Launchpad

* Créer les fichiers pour Launchpad
Éditer et vérifier les fichiers : mkd_120515_source.build, mkd_120515_source.changes, mkd_120515.dsc
* Vérifier le paquet
* Simuler le dépôt
* Tenter le dépôt du paquet sur Launchpad :

## 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 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 :
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
   #### Édition du fichier Build Log _FAILEDTOBUILD.txt.gz

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 :
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
#### 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

    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 ...

#### 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
#### Réponse par courriel

Les fichiers ont été acceptés. Pas de problème pour les sommes de contrôle; mais la compilation ?

#### 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
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

→ Retour par courriel :

#### Consultation du dépôt

https://launchpad.net/~jean-paul-louyot/+archive/exercises/+copy-packages → résulat :

## 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

* L'exemple très simple de mise en paquet Debian pour la maintenance logicielle
* La mise en paquet avec DCBS
* Un exemple de menu : debian/menu et usr/share/applications/mkdcppw.desktop dans l'archive mkdcppw_140201.tar.gz → 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

* ↑ Pré-requis
* ↑ Versions d'Ubuntu
* ↑ Fichier control
* ↑ Sections Ubuntu
* ↑ Exemple de menu dans mkdcppw