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 Diagnostics for Adblock Plus. Pour réinitialiser votre copie locale à un état d'une version d'Adblock Plus particulière, lancez la commande :

hg up -r 1.0.1

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

Sinon, vous pouvez aussi télécharger le code source de la dernière version.

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 :

python build.py build

Ce script va créer une version de développement avec un nom de la forme adblockplus-1.2.3.4+.nnnn.xpi. Ce fichier contiendra le code source actuellement sur le dépôt et tous les paramètres régionaux disponibles.

Remarque: Vous avez besoin de Python 2.x avec le module Jinja2 pour créer les versions. Pour installer Jinja2 dans Python, exécutez cette commande :

easy_install Jinja2

Tester ses modifications

Afin de tester plus facilement les modifications que vous avez effectuées, vous pouvez installer Extension Auto-Installer dans votre navigateur. En supposant que Extension Auto-Installer est configurée pour utiliser le port 8888 (valeur par défaut), vous pouvez implémenter vos modifications dans le navigateur en exécutant la commande :

  python build.py autoinstall 8888

Il est possible que le navigateur redémarre automatiquement si besoin.

Exécuter un test unitaire

Afin de contrôler vos modifications, vous pouvez utiliser la suite d'unités de test existante. Les unités de test constituent une extension à part qui s'ajoute en addition d'Adblock Plus. Vous pouvez soit installer les versions d'unités de test existantes soit cloner le dépôt et créer votre propre version du logiciel. Après avoir installé les unités de test vous devez aller sur chrome://adblockplustests/content/index.html afin de procéder aux tests.