Apporter des modifications au code de Gaia

Maintenant que vous pouvez lancer Gaia dans Firefox et que vous connaissez certains éléments sur le fonctionnement du code, vous devriez pouvoir commencer à contribuer au projet. Cet article décrit comment apporter des modifications et où trouver des bugs sur lesquels travailler.

Bonnes pratiques Git

  1. Quand vous apportez des modifications au code de Gaia, la première chose à faire est de se mettre à jour par rapport à la branche master du dépôt original (remote upstream) :
    cd chemin/dossier/gaia
    git checkout master
    git pull upstream master
  2. Maintenant, allez sur une nouvelle branche en faisant un « checkout », c'est sur cette branche que vous apporterez vos corrections :
    git checkout -b mon-correctif
  3. Enfin, allez dans votre répertoire gaia/apps et éditez les fichiers des applications.

Exemple de modification simple du code

Pour voir les effets de vos modifications :

  1. Réalisez vos changements souhaités dans le code de Gaia, et sauvegardez les.
  2. Arrêtez Firefox ou le simulateur lancé dans WebIDE.
  3. Reconstruisez le profil Gaia avec la commande make.
  4. Démarrez Firefox ou le simulateur lancé dans WebIDE.

Voyons cela en réalisant un simple changement de couleur de texte, de l'horloge dans l'écran de verrouillage :

Gaia lockscreen showing the clock display in white text

  1. Une des meilleures méthodes pour trouver comment le style est défini est d'utiliser les outils de développement. Effectuez un « Ctrl droit + clic » sur l'horloge dans Firefox (pour ordinateur) puis sélectionnez Examiner l'élément dans le menu contextuel.
  2. Vous pouvez alors déterminer quel fichier CSS est utilisé et doit être édité. Pour cet exemple, il s'agit de gaia/apps/system/lockscreen/style/lockscreen.css. Il suffit d'éditer les styles CSS dans la partie droite de l'affichage pour obtenir l'effet souhaité.
  3. Une fois que vous êtes satisfait-e du résultat, vous pouvez directement éditer le fichier puis le sauvegarder.
  4. Ensuite, rafraîchissez l'onglet (ou utiliser le bouton de réactualisation), le serveur HTTP servira instantanément les changements :

Gaia lockscreen showing the clock display modified from white to red text


Les limitations de la simulation dans Firefox pour lancer Gaia :

  • Le rendu des applications est très proche du fonctionnement sur un appareil réel, vous pourrez cependant observer quelques différences.
  • Toutes les API matérielles ne sont pas supportées dans Firefox pour ordinateur. Vous pourrez trouver une liste de celles qui sont activées dans le fichier preferences.js.

Où trouver des bugs à corriger

La meilleure façon de trouver des bugs Firefox OS sur lesquels travailler est de consulter l'application de Josh Matthews : Bugs Ahoy. Cette application cherche directement parmi les bugs de la plate-forme Bugzilla de Mozilla et les affiche de façon simple et organisée. Une fois que vous avez identifié un bug sur lequel vous voulez travailler, rendez-vous sur la page Bugzilla pour ce bug (créez un compte si ce n'est pas déjà fait) puis assignez-vous pour le bug dans le champ « assigned to ». Une fois que c'est fait, vous pouvez commencer à travailler avec les outils vus ci-avant.

Aide et astuces

  • Lorsque vous travaillez sur des bugs mentorés, un des membres de l'équipe en charge de Gaia surveillera votre progression et vous fournira l'aide nécessaire sur le code et le processus de correction. Si vous commencez à contribuer pour Firefox OS, ça peut être utile de choisir parmi ces bugs mentorés. Pour les trouver : ce sont les pages de bugs Firefox OS dont le champ « Mentor » est rempli. Buys Ahoy liste ces bugs mentorés.
  • Si vous êtes un nouvel utilisateur de Bugzilla, vous ne pourrez pas vous affecter vous-même le travail pour un bug. Si vous ne pouvez pas changer le champ « assigned to », demandez au mentor affecté à ce bug de vous l'affecter. Vous pouvez également le demander dans les commentaires du bug.
  • Une fois que vous avez acquis un peu plus d'expérience avec ce processus, n'hésitez pas à demander à quelqu'un de vous donner le droit de pouvoir vous affecter des bugs à vous-même.
  • Pour trouver des bugs simples à résoudre et commencer à contribuer, vous pouvez également chercher ceux qui ont une balise [good first bug] dans le champ « whiteboard ». Vous pouvez également lister les bugs simples grâce à Bugs Ahoy : http://www.joshmatthews.net/bugsahoy/?b2g=1&simple=1.
  • Dans Bugzilla, vous pouvez enregistrer des recherches. Ainsi, si vous voulez suivre les bugs sur l'application Clock (l'horloge) de Gaia, vous pouvez sauvegarder la requête suivante :

https://bugzilla.mozilla.org/buglist.cgi?columnlist=product%2Ccf_blocking_b2g%2Cbug_status%2Cresolution%2Cshort_desc&resolution=---&query_based_on=CLOCK&query_format=advanced&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&component=Gaia%3A%3AClock&product=Boot2Gecko&known_name=CLOCK&list_id=9776392

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : jwhitlock, SphinxKnight, sousmangoosta, goofy_bz
 Dernière mise à jour par : jwhitlock,