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 https://hg.adblockplus.org/adblockplus/

Des dépôts similaires sont configurés pour Element Hiding Helper et Adblock Plus Watcher. Pour réinitialiser votre copie locale à un état d’une version d’Adblock Plus particulière, lancez la commande :

hg up -r ADBLOCK_PLUS_1_0_1_RELEASE

(remplacez ADBLOCK_PLUS_1_0_1_RELEASE par la version correspondant à votre choix).

Consultez la documentation du code source for an overview.

Liens pour clients HG et documentation

Création d’une version d’Adblock Plus

Pour créer une version de développement , rendez-vous dans le répertoire “adblockplus” (votre copie locale du dépôt) et lancez cette 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 aisée, créez un fichier “.profileDirs” dans le répertoire racine de votre copie du dépôt et listez les profils que vous souhaitez tester, par exemple :

c:\Documents and Setting\<user>\Application Data\Mozilla\Firefox\Profiles\<seed>.default
c:\Documents and Setting\<user>\Application Data\Songbird2\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.