Broncode

Hoe verkrijg ik de broncode?

De Adblock Plus broncode kan bekeken worden via de HG web interface. Je kan een lokale kopie downloaden door de volgende commandoregel uit te voeren:

hg clone https://hg.adblockplus.org/adblockplus/

Op dezelfde manier zijn er repositories gemaakt voor Element Hiding Helper en Diagnostics for Adblock Plus. Deze lokale kopie kan worden geherinitialiseerd naar de status van een bepaalde release door het volgende commando uit te voeren:

hg up -r 1.0.1

(vervang 1.0.1 door het label van de gewenste versie.)

U kunt eventueel ook de broncode van de laatste release downloaden.

De Adblock Plus broncode documentatie biedt een overzicht van het binnenwerk van de add-on.

HG client en documentatie verwijzingen

Het maken van een Adblock Plus build

Een ontwikkelaars build kan worden gemaakt door naar de "adblockplus" map te gaan (je lokale kopie van de repository) en het volgende commando in te geven:

python build.py build

Het script zal de ontwikkelaars build maken met een naam in de vorm van adblockplus-1.2.3.4+.nnnn.xpi. Dit bestand zal de broncode die op dit moment in de repository is bevatten en de beschikbare vertalingen.

N.B.: U heeft Python 2.x met de Jinja2 module nodig om builds te kunnen maken. Om Jinja2 in Python te installeren moet u dit commando uitvoeren:

easy_install Jinja2

Het testen van uw wijzigingen

Om het testen van uw wijzigingen te vereenvoudigen, kunt u de Extension Auto-Installer in uw browser installeren. Aangenomen dat de Extension Auto Installer geconfigureerd is op poort 8888 (de standaard waarde), kunt u uw wijzigingen naar de browser sturen met het volgende commando:

  python build.py autoinstall 8888

De browser zal automatisch herstarten als dit nodig is.

Het draaien van unit tests

Om je wijzigingen te controleren kan je de bestaande unit test suite gebruiken. De unit tests zijn een aparte extensie die naast Adblock Plus zijn geïnstalleerd. Je kan ofwel de bestaande unix test builds gebruiken of de de repository klonen en je eigen build maken. Ga na het installeren van de unit tests naar chrome://adblockplustests/content/index.html om de tests te uit te voeren.