Code source
Obtenir le code source
Le code source d’Adblock Plus peut être consulté via l’interface Web HG. Pour obtenir une copie de la source en local, lancez en ligne de commande ceci :
hg clone http://hg.mozdev.org/adblockplus/
Pour réinitialiser votre copie locale à un état d’une version d’Adblock Plus particulière, lancez la commande :
hg up -r ADBLOCK_PLUS_0_7_5_4_RELEASE
(remplacez ADBLOCK_PLUS_0_7_5_4_RELEASE par la version correspondant à votre choix).
Liens pour clients HG et documentation
- Mercurial (Démarrage rapide) [en]
- FAQ de Mozilla sur Mercurial [en]
- Distributed Revision Control with Mercurial (Livre hg) [en]
- Clients GUI et autres outils [en]
- Mercurial sur Wikipédia [fr]
- Traduction du wiki de Mercurial [fr]
- Les pages traitant de Mercurial sur Mozilla Developper Center [fr]
Création d’une version d’Adblock Plus
Pour créer une version de développement , rendez-vous dans le répertoire “src” dans le dépôt de votre copie locale et lancez la commande :
perl make_devbuild.pl
Cela créera un fichier du type adblockplus-1.2.3.4+.nnnnnnnnnn.xpi contenant le code source actuellement dans le dépôt et toutes les traductions disponibles. Pour créer une version de développement ne contenant que certaines traductions, spécifiez les langues souhaitées dans la ligne de commande. Exemple :
perl make_devbuild.pl en-US de-DE ru-RU
Remarque: Pour que le script démarre, aucune application supplémentaire n’est nécessaire pour Linux et OS X, par contre sur Windows vous aurez besoin de Perl et de Info-ZIP. Il sont tous les deux intégrés dans le MozillaBuild.
Configuration d’un environnement de test et lancement de tests d’unité
La création d’une version, son installation et le redémarrage du navigateur pour tester chaque petit changement est une démarche relativement fastidieuse. Pour développer de manière plus efficace, créez un fichier “.profileDirs” dans le répertoire “src” du dépôt listant les profils pour lesquels il faudra tester. Par exemple :
c:\Documents and Setting\<user>\Application Data\Mozilla\Firefox\Profiles\<seed>.default c:\Documents and Setting\<user>\Application Data\Songbird1\Profiles\<seed>.default
Ensuite lancez le script setupTestEnvironment.pl en ligne de commande :
perl setupTestEnvironment.pl
Cela installera Adblock Plus dans tous les profils listés. Ne seront réellement copiés que les fichiers install.rdf, chrome.manifest, les composants XPCOM et les préférences, le navigateur accèdera directement à votre dépôt pour les fichiers chrome. En passant la valeur de la préférence nglayout.debug.disable_xul_cache à true vous vous assurerez que les modifications dans le dépôt apparaissent dans le navigateur sans redémarrage de ce dernier.
Une fois que l’environnement de test est configuré vous pouvez passer aux tests d’unité en vous rendant à chrome://mochikit/content/harness-abp.xul?autorun=1 dans votre navigateur.