Différences

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

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
tutoriel:demande_inclusion_nouveau_paquet [Le 04/12/2009, 09:20]
jahwork lien Launchpad corrigé
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 5: Ligne 5:
 ====== Comment demander l'​inclusion d'un nouveau paquet dans Ubuntu ? ====== ====== Comment demander l'​inclusion d'un nouveau paquet dans Ubuntu ? ======
  
-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 salement sur le système... ou demander son inclusion dans les dépôts ! :)+Ce tutoriel va décrire la démarche pour inclure ​un nouveau logiciel (paquet) ​dans les dépôts ​officiels d'Ubuntu.
  
-La démarche est très simpletout se fait via le portail de développement Ubuntu ​(outil non-libre) ​développé par Canonical, j'ai nommé [[:​launchpad|Launchpad]].+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//,​ qui n'est pas un « vrai bug » au sens propre, mais qui peut être décrit de la manière suivante :\\ +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 ​compliquée ​pour l'​utilisateur lambda (la compilation),​ c'est donc un « bug » qu'il faut fixer (en incluant ce paquet aux dépôts) ».//\\+//« 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. 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 ===== ===== Pré-requis =====
  
-Pour commencer il est préférable de s'​assurer que le programme n'est pas déjà empaqueté ​dans Debianvoici une petite astuce ​: +Afin qu'un logiciel soit inclus ​dans Ubuntuil doit être conforme à la [[http://www.ubuntu.com/​project/​about-ubuntu/licensing|politique de licence Ubuntu]] (FIXME: à traduire)
-sur Google, entrez +
-  <​nom_du_programme>​ site:​packages.debian.org +
-ou encore +
-  <​nom_du_programme>​ site:ftp-master.debian.org/new.htm +
-ou bien 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]]). +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]].
-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 ;)+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.
  
-Commencez par **vous inscrire sur [[http://​launchpad.net/​]]** (sinon vous ne pourrez pas poster de bug) 
  
-{{utilisateurs:​enchained:​warning.png }} +===== Demande d'​inclusion d'un nouveau paquet ​=====
->**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]].** +
- +
-===== Démarche ​=====+
  
 ==== Résumé ==== ==== Résumé ====
  
-Rapporter un bug concernant **Ubuntu**, le tagguer //​needs-packaging//,​ et attendre qu'un MOTU s'en occupe.+[[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.
  
 ==== Pas-à-pas ==== ==== Pas-à-pas ====
  
-  * S'​assurer d'​être correctement ​**identifié** sur LPet cliquer sur **Bugs**.+  * [[https://​bugs.launchpad.net/​ubuntu/​+filebug?​no-redirect&​field.tag=needs-packaging|Rapporter un bug]] dans [[:​Launchpad]]. 
 + 
 +  ​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//​. 
 + 
 +  * 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//​
  
-{{tutoriel:needs_packaging_001.png|}}+===== Créer le paquet vous même ===== 
 +Vous pouvez suivre le tutoriel pour [[tutoriel:creer_un_paquet|créer un paquet]].
  
-  * Cliquer ​sur **Report a bug**+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.
  
-{{tutoriel:needs_packaging_002.png|}}+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]].
  
-  * Laisser ​la case « Distribution » cochée (avec Ubuntu), et dans //Summary// mettre **[needs-packaging]** suivi du nom de l'application, ​et cliquer sur //continue//.+Voici la politique d'​approbation de l'​équipe ​[[:​tutoriel:​comment_participer_developpement_ubuntu#​ubuntu_developers_motu|MOTU]pour les nouveaux paquets: 
 +  ​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.
  
-{{tutoriel:needs_packaging_003.png|}}+Voici le processus de l'​équipe [[:tutoriel:comment_participer_developpement_ubuntu#​ubuntu_developers_motu|MOTU]]:​ 
 +  * 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]]
  
- * Vérifiez que le programme n'a pas déjà été empaqueté en regardant la liste. 
  
-{{tutoriel:​needs_packaging_004.png|}}+===== Échéance =====
  
-  * 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 [[http://revu.tauware.de/|REVU]], précisez ​le lienet 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 Freezemais 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-packaging// lors du rapport ​de bugLa prochaine version (actuellement en béta) ​le permettra, mais en attendant, ​il faut le rajouter manuellement.+===== Démarches alternatives ===== 
 +  * Celles-ci sont permises, mais [[apt>​revu-tools]] est la voie officielle pour la revue de paquet. 
 +  * 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.
  
-  * Pour rajouter le tag, il faut éditer la description du bug. 
  
-{{tutoriel:​needs_packaging_006.png|}} 
  
-  ​Ajoutez le tag //needs-packaging/​/ dans la case prévue ​à cet effet, et appliquez ​les changement (bouton ​//Change//).+===== 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: à traduiredonne 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"​.
  
-{{tutoriel:​needs_packaging_007.png|}} 
  
-Et c'est fini ! :-) 
  
-=====Ressources annexes=====+=====Liens=====
  
-Le mail de Jordan Mantha à l'​origine de cette démarche ​: https://​lists.ubuntu.com/​archives/​ubuntu-motu/​2007-March/​001471.html+  * 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.
  
 ---- ----
  
-//​Contributeurs : [[utilisateurs:​mr_pouit]],​ freacky22527//​+//​Contributeurs : [[utilisateurs:​mr_pouit]],​ freacky22527, [[:​utilisateurs:​jahwork]]//
  • tutoriel/demande_inclusion_nouveau_paquet.1259914814.txt.gz
  • Dernière modification: Le 18/04/2011, 14:50
  • (modification externe)