Исходные тексты

Получение исходных текстов

Исходный текст Adblock Plus можно посмотреть с помощью HG веб-интерфейса. Локальную копию можно загрузить выполнив в командной строке:

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

Аналогичные репозитории созданы для Element Hiding Helper и Diagnostics для Adblock Plus. Локальная копия может быть сброшена до состояния конкретного релиза запуском команды:

hg up -r 1.0.1

(замените 1.0.1 тегом необходимой версии).

Как вариант, вы также можете загрузить исходный текст последнего релиза.

Документация по исходному тексту Adblock Plus предоставляет обзор внутренней организации дополнения.

HG клиент и ссылки на документацию

Создание сборки Adblock Plus

Тестовую сборку можно создать, войдя в папку "adblockplus" (локальной копии репозитория) и выполнив команду:

python build.py build

Скрипт создаст тестовую сборку с именем вида adblockplus-1.2.3.4+.nnnn.xpi. Этот файл будет содержать текущий исходный текст из репозитория и все доступные локали.

Примечание: Для сборки требуется Python 2.x с модулем Jinja2. Установить Jinja2 можно этой командой:

easy_install Jinja2

Тестирование своих изменений

Чтобы упростить процесс тестирования изменений, можно установить расширение Extension Auto-Installer в браузере. Если Extension Auto-Installer использует порт 8888 (установка по умолчанию), то установить свои изменения в этом браузере можно командой:

  python build.py autoinstall 8888

В случае надобности браузер будет автоматически перезапущен.

Running unit tests

To verify your changes you can use the existing unit test suite. The unit tests are a separate extension that is installed in addition to Adblock Plus. You can either install the existing unit test builds or clone the repository and create your own build. After installing the unit tests go to chrome://adblockplustests/content/index.html to run the tests.