Différences

Ci-dessous, les différences entre deux révisions de la page.

--- tutoriel:demande_inclusion_nouveau_paquet [Le 16/04/2007, 14:56]
192.88.166.35 orthog
+++ tutoriel:demande_inclusion_nouveau_paquet [Le 11/09/2022, 12:19] (Version actuelle)
moths-art Suppression des espaces en fin de ligne (détecté et corrigé via le bot wiki-corrector (https://forum.ubuntu-fr.org/viewtopic.php?id=2067892)
@@ Ligne 1: / Ligne 1: @@
-{{tag>developpement tutoriel}}
+{{tag>paquet programmation tutoriel}}
+----
 ====== Comment demander l'inclusion d'un nouveau paquet dans Ubuntu ? ======
+Ce tutoriel va décrire la démarche pour inclure un nouveau logiciel (paquet) dans les dépôts officiels d'Ubuntu.
+On va utiliser [[:Launchpad]], le portail de développement Ubuntu développé par Canonical.
+Le principe est simple : on va rapporter un bug taggué //needs-packaging//((traduction: "a besoin d'être mis en paquet")), qui n'est pas un « vrai bug » au sens propre, mais qui peut être décrit de la manière suivante :\\
+//« L'installation de ce logiciel n'est pas disponible de la manière la plus simple existante (les dépôts) et demande une étape non triviale pour l'utilisateur lambda (la compilation), c'est donc un « bug » qu'il faut résoudre (en incluant ce paquet aux dépôts) ».//\\
+Il s'agit alors d'une demande d'inclusion d'un paquet.
+<note important>
+Cette procédure n'est pas faite pour demander une mise à jour d'un paquet. Pour la procédure à suivre dans ce cas, lire le [[:tutoriel:demande_mise_a_jour_paquet|tutoriel pour demander la mise à jour d'un paquet]].
+</note>
 ===== Pré-requis =====
-Il manque un programme dans les dépôts de votre distribution préférée ? outch, va falloir le compiler à la main et l'installer cradement sur le système... ou demander son inclusion dans les dépôts ! :)
+Afin qu'un logiciel soit inclus dans Ubuntu, il doit être conforme à la [[http://www.ubuntu.com/project/about-ubuntu/licensing|politique de licence Ubuntu]] (FIXME: à traduire)
-La démarche est très simple, tout se fait via le portail de développement Ubuntu, ce merveilleux outil non libre et qui est super moche et super lent depuis la dernière version, j'ai nommé [[:projets:ecole:launchpad|Launchpad]].
+Vérifiez que l'inclusion du paquet n'a pas déjà été demandé, en faisant une [[https://launchpad.net/ubuntu/+bugs?field.tag=needs-packaging|recherche sur Launchpad]].
-Le principe est simple : on va rapporter un bug taggué "needs-packaging", qui n'est pas un "vrai bug" au sens windaubien du terme, mais bien une demande d'inclusion d'un paquet.
+Les paquets récemment ajoutés à Debian unstable seront automatiquement synchronisés dans Ubuntu avant la Debian Import Freeze (DIF). Après la DIF, il faudra soumettre un bug en remplissant le champ résumé avec "Please sync <packagename> from debian <distro>" ((traduction: "merci de synchroniser le <nom_du_paquet> depuis debian <version_de_debian>")), où <packagename> est le nom du paquet. Le DIF pour Lucid est le 11 février 2010.
-Pour commencer il est préférable de s'assurer que le programme n'est pas déjà empaqueté dans Debian, voici une petite astuce :
-sur google, entrez "<nom_du_programme> site:packages.debian.org" ou encore "<nom_du_programme> site:ftp-master.debian.org/new.htm" oubien tout simplement "<nom_du_programme> debian"
-Ensuite, il va falloir s'assurer que le paquet est sous une licence libre (licences libres au sens de debian: [[http://wiki.debian.org/DFSGLicenses]]).
+===== Demande d'inclusion d'un nouveau paquet =====
-Si le programme est sous GPL, LGPL ou encore BSD par exemple alors aucun problème :)
-Si le programme n'a pas encore été empaqueté et est sous licence libre, alors à vous de jouer ;)
+==== Résumé ====
-Commencez par vous inscrire sur [[http://launchpad.net/]]
+[[https://bugs.launchpad.net/ubuntu/+filebug?no-redirect&field.tag=needs-packaging|Rapporter un bug]] concernant **Ubuntu**, le tagguer //needs-packaging//, et attendre qu'un [[:tutoriel:comment_participer_developpement_ubuntu#ubuntu_developers_motu|MOTU]] s'en occupe.
-(sinon vous ne pourrez pas poster de bug :p)
-**Cette procédure n'est pas faite pour demander une mise à jour d'un paquet. Pour la procédure à suivre dans ce cas, lire la page [[:tutoriel:demande_mise_a_jour_paquet]].**
+==== Pas-à-pas ====
-===== Démarche =====
+  * [[https://bugs.launchpad.net/ubuntu/+filebug?no-redirect&field.tag=needs-packaging|Rapporter un bug]] dans [[:Launchpad]].
-==== Résumé ====
+  * Dans **Summary** mettre un résumé du bug: mettre ici le nom du logiciel. A noter que le lien ci-dessous va chercher si un bug a déjà été soumis avec le nom que vous entrez, dans les bug avec le tag //needs-packaging//.
-Rapporter un bug concernant Ubuntu, et de le tagguer '__needs-packaging__', et attendre qu'un super-MOTU s'en occupe :p
+  * Si le paquet n'a pas été demandé, cliquer sur le bouton "No, I need to report a new bug" en bas de page, pour remplir le bug:
+    * **Summary**: bien mettre "[needs-packaging] <le_nom_du_logiciel>"
+    * **Further information**: décrire le logiciel en quelques mots, donner l'adresse à laquelle on pourra trouver les sources et donner la licence du logiciel.
+  * Cliquer sur le bouton "Submit Bug Report"
+  * Ajouter le tag //needs-packaging//
+===== Créer le paquet vous même =====
+Vous pouvez suivre le tutoriel pour [[tutoriel:creer_un_paquet|créer un paquet]].
+Les paquets qui ne sont pas encore dans Ubuntu passent par une revue de code spéciale avant d'être ajouté aux dépôts et d'obtenir l'aval définitif des administrateurs d'archive. Plus d'informations sur cette revue, y compris les critères de sélection peuvent être trouvés sur la page de [[https://wiki.ubuntu.com/UbuntuDevelopment/CodeReviews#NewPackage|revue de code]] (FIXME: à traduire). Les développeurs sont encouragés à analyser leurs propres paquets en utilisant ces informations avant de soumettre leurs paquets pour la revue.
-==== Pas-à-pas ====
+Afin d'avoir des rapports de bug de meilleure qualité, écrire un "[[https://wiki.ubuntu.com/Apport#Per-package%20Apport%20Hooks|apport hook]]" (FIXME: à traduire). Voir la section de page sur [[:rapporter_un_bug#utiliser_apport|apport]].
-  * S'assurer d'être correctement identifié sur LP, et cliquer sur Bugs.
+Voici la politique d'approbation de l'équipe [[:tutoriel:comment_participer_developpement_ubuntu#ubuntu_developers_motu|MOTU]] pour les nouveaux paquets:
-{{tutoriel:needs_packaging_001.png|}}
+  * Les nouveaux contributeurs MOTU (qui ne sont pas encore membre de l'équipe MOTU) doivent faire évaluer et signer leurs paquets par deux [[https://launchpad.net/~ubuntu-dev/+members|developpeurs Ubuntu]] afin qu'ils soit ajouté à Ubuntu
+  * Les MOTU peuvent directement ajouter leurs paquets dans les archives. Cependant ils sont vivement encouragés à faire évaluer leurs paquet avant ajout.
-  * Cliquer sur "Report a bug"
+Voici le processus de l'équipe [[:tutoriel:comment_participer_developpement_ubuntu#ubuntu_developers_motu|MOTU]]:
-{{tutoriel:needs_packaging_002.png|}}
+  * Lorsque vous commencez à travailler sur un nouveau paquet, assignez le //needs-packaging// bug à vous-même et changer le statut à "In Progress" (s'il n'y a pas de //needs-packaging// bug, en créer un).
+  * Une fois que vous avez un premier paquet, transférez-le sur [[https://wiki.ubuntu.com/MOTU/Packages/REVU|REVU]] (FIXME: à traduire), dans la description du bug ajoutez le lien vers le paquet dans [[:REVU]]. A partir de là il n'y a plus de changement dans Launchpad tant que le paquet n'est pas transféré.
+  * Une fois que le paquet approuvé est transféré, le MOTU en charge du transfert changera le statut du bug à "Fix Committed".
+  * When the package clears the NEW queue it will automatically be set to Fix Released (debian/changelog must close the needs-packaging bug)(FIXME: NDT: //je n'ai pas compris cette partie, donc je ne sais pas comment la traduire//). Ceci est fait par une puce selon le format suivant:
+<code>
+  * Initial release (LP: #242910)
+</code>
+où "LP" désigne Launchpad. Voir le guide d'empaquetage pour [[https://wiki.ubuntu.com/PackagingGuide/Howtos/PackagingFromScratchHelloChangelog|plus d'informations sur les changelogs]]
-  * Laisser la case "Distribution" cochée (avec Ubunut), et dans "Summary" mettre "[needs-packaging] " suivi du nom de l'application, et cliquer sur "continue".
-{{tutoriel:needs_packaging_003.png|}}
- * Vérifiez que le programme n'a pas déjà été empaqueté en regardant la liste.
+===== Échéance =====
-{{tutoriel:needs_packaging_004.png|}}
-  * Décrivez votre programme, sa licence... si vous ne comptez pas l'empaqueter, il faut donner envie à quelqu'un de le faire. S'il est déjà sur REVU, précisez le lien, et validez.
+Le [[https://wiki.ubuntu.com/FeatureFreeze|Feeture Freeze]](gel des fonctionnalité)(FIXME: à traduire) est la dernière date d'approbation (le 18 février 2010 pour [[:lucid|Ubuntu 10.04 - Lucid Lynx]]): il est recommandé de finaliser votre paquet quelques semaines avant, car l'approbation peut prendre du temps. Des "jours REVU" sont planifiés pendant la Feature Freeze, mais les derniers jours sont consacrés aux paquets réellement requis pour obtenir les fonctionnalités attendues pour la release.
-{{tutoriel:needs_packaging_005.png|}}
-La version actuelle de LP ne permet pas d'ajouter directement le tag 'needs-updating' lors du rapport de bug. La prochaine version (actuellement en béta) le permettra, mais en attendant, il faut le rajouter manuellement.
-  * Pour rajouter le tag, il faut éditer la description du bug.
+===== Démarches alternatives =====
-{{tutoriel:needs_packaging_006.png|}}
+  * Celles-ci sont permises, mais [[apt>revu-tools]] est la voie officielle pour la revue de paquet.
-  * Ajoutez le tag "needs-packaging" dans la case prévue à cet effet, et appliquez les changement (bouton "Change").
+  * Le point clé est que deux MOTUs doivent approuver le paquet. Or la plupart des MOTUs passe par [[apt>revu-tools]] et il sera donc plus difficile d'obtenir une approbation pour un paquet hébergé ailleurs.
-{{tutoriel:needs_packaging_007.png|}}
-Et c'est fini ! :-)
-=====Ressources annexes=====
+===== Autres intérêts =====
+  * Toujours vérifié s'il n'y a pas un bug ITP (intent to package)((traduction: "intention d'empaqueter")) existant [[http://bugs.debian.org/wnpp|dans le paquet wnpp]] dans Debian. Il vaut mieux combiner vos efforts avec eux, plutôt que de réinventer la roue.
+  * http://mentors.debian.net/ est un site web où les personnes souhaitant intégrer leur paquet à Debian peuvent les transférer. Il faut [[http://mentors.debian.net/debian/pool/|parcourir le site]] pour trouver les paquets. [[https://wiki.ubuntu.com/ContributingToDebian|Cette page]] (FIXME: à traduire) donne plus d'informations pour ajouter votre travail à Debian.
+  * [[http://svn.debian.org/wsvn|Le WebSVN de Debian]]. Il est possible qu'il y ait un travail sur un paquet pour Debian mais avec un statut //UNRELEASED//. Vérifier le répertoire approprié commençant par "pkg" où votre paquet pourrait se trouver. Par exemple un paquet concernant un jeu se trouvera dans "pkg-games".
-Le mail de Jordan Mantha à l'origine de cette démarche : https://lists.ubuntu.com/archives/ubuntu-motu/2007-March/001471.html
+=====Liens=====
+  * Traduit de la [[https://wiki.ubuntu.com/UbuntuDevelopment/NewPackages|page anglaise]]
+  * Le [[https://lists.ubuntu.com/archives/ubuntu-motu/2007-March/001471.html|mail]] de Jordan Mantha à l'origine de cette démarche.
 ----
-//Contributeur : [[utilisateurs:mr_pouit]], freacky22527//
+//Contributeurs : [[utilisateurs:mr_pouit]], freacky22527, [[:utilisateurs:jahwork]]//