Ubuntu logo

Packaging Guide

6. A la recherche de Relectures et de Parrainages

Un des plus gros avantages de l’utilisation du flux de travail UDD est d’améliorer la qualité en recherchant la relecture des modifications par des pairs. Cela est vrai que vous ayez ou non les droits de téléchargement. Bien entendu, si vous n’avez aucun droit de téléchargement, vous devrez trouver des parrainages.

Une fois satisfait de votre correctif, et que vous avez une branche prête, les étapes suivantes peuvent être utilisées pour publier votre branche sur Launchpad, la relier à une solution de bogue, et créer une proposition de fusion pour que les autres puissent la relire, et que les parrains la téléchargent.

6.1. Publier vers Launchpad

Nous vous avons déjà montré comment associer votre branche au bogue en utilisant dch et bzr commit. Toutefois, la branche et le bogue ne sont réellement liés qu’après publication de la branche vers Launchpad.

Il n’est pas essentiel d’avoir un lien vers un bogue pour chaque modification que vous apportez, mais si vous corrigez des bogues déjà rapportés, les relier sera utile.

La forme générale de l’URL pour publier votre branche est :

lp:~<user-id>/ubuntu/<distroseries>/<package>/<branch-name>

For example, to push your fix for bug 12345 in the Tomboy package for Trusty, you’d use:

$ bzr push lp:~subgenius/ubuntu/trusty/tomboy/bug-12345

Le dernier élément du chemin est arbitraire ; c’est à vous de choisir quelque chose de significatif.

Toutefois, ce n’est généralement pas suffisant pour obtenir la relecture et le parrainage de vos modifications pas les développeurs d’Ubuntu. Vous devez ensuite soumettre une * proposition de fusion*.

Pour ce faire, ouvrez la page de bogue dans un navigateur, par exemple :

$ bzr lp-open

En cas d’échec, vous pouvez utiliser :

$ xdg-open https://code.launchpad.net/~subgenius/ubuntu/trusty/tomboy/bug-12345

où la plus grande partie de l’URL correspond à ce que vous avez utilisé pour bzr push. Sur cette page, vous verrez un lien Proposer la fusion vers une autre branche. Tapez une explication de votre modification dans la boîte de dialogue Commentaire initial. Enfin, cliquez sur Proposer la fusion pour terminer le processus.

Les propositions de fusion pour les branches source de paquets vont automatiquement solliciter l’équipe des ~ubuntu-branches, ce qui sera suffisant pour joindre un développeur Ubuntu pour relire et parrainer votre modification de paquet.

6.2. Génération d’un debdiff

Comme indiqué précédemment, certains parrains préfèrent toujours relire un debdiff attaché à un rapport de bogue plutôt qu’une proposition de fusion. S’il vous est demandé d’inclure un debdiff, vous pouvez en générer un comme ceci (depuis l’intérieur de votre branche bug-12345 :

$ bzr diff -rbranch:../tomboy.dev

Une autre méthode consiste à ouvrir la proposition de fusion et télécharger le diff.

Vous devriez vous assurer que le diff présente les modifications que vous attendez, ni plus ni moins. Nommez le diff de façon appropriée, par exemple foobar-12345.debdiff et joignez-le au rapport de bogue.

6.3. Gestion des retours des parrains

Si un parrain relit votre branche et vous demande d’y modifier quelque chose, vous pouvez le faire assez facilement. Allez simplement dans la branche sur laquelle vous travailliez au préalable, procédez aux modifications demandées, et soumettez de nouveau :

$ bzr commit

Maintenant que vous avez publié votre branche dans Launchpad, Bazaar se souvient de l’emplacement de votre publication, et mettra à jour la branche sur Launchpad avec vos dernières réalisations. Tout ce que vous avez à faire est :

$ bzr push

Vous pouvez alors répondre au courriel de relecture de la proposition de fusion en expliquant ce que vous avez changé, et en demandant une nouvelle relecture, ou vous pouvez répondre sur la page de proposition de fusion sur Launchpad.

Notez que si vous êtes parrainé via un debdiff joint à un rapport de bogue, vous devez manuellement mettre à jour en générant un nouveau diff et en le joignant au rapport de bogue.

6.4. Attentes

Les développeurs d’Ubuntu ont mis en place un calendrier des « pilotes de correctif », qui examinent régulièrement la file d’attente de parrainage et fournissent des retours d’information sur les branches et les correctifs. Même si cette mesure a été mise en place, il peut s’écouler plusieurs jours jusqu’à ce que vous constatiez un retour. Cela dépend de la charge de travail de chacun, si la version de développement est actuellement gelée, ou d’autres facteurs.

Si vous n’avez pas eu de nouvelles depuis un moment, n’hésitez pas à rejoindre le canal #ubuntu-devel sur irc.freenode.net pour découvrir si quelqu’un peut vous y aider.

Pour plus d’informations sur le processus de parrainage général, consultez également la documentation sur notre wiki : https://wiki.ubuntu.com/SponsorshipProcess