Отладка правил в AdGuard для Chrome MV3

В Журнале фильтрации MV3-расширениия AdGuard отображаются только приблизительные применённые правила, которые мы называем «предполагаемыми правилами». Это связано с тем, что браузер не предоставляет подробную информацию о том, какие именно декларативные правила были использованы, если расширение не «распаковано». Для получения точной информации можно самостоятельно установить «распакованное» расширение в браузере.

Эта инструкция также пригодится для проблемных случаев, когда вы хотите изменить правила, которые статически включены в расширение. В большинстве случаев достаточно использовать Пользовательские правила в расширении.

Необходимые условия

1. Git: Установите Git

2. Node: Установите Node.js

3. Yarn: Установите Yarn

Как клонировать расширение

1. Клонируйте репозиторий:

   git clone git@github.com:AdguardTeam/AdguardBrowserExtension.git

2. Перейдите в каталог:

   cd AdguardBrowserExtension

3. Переключитесь на ветку v5.0:

   git checkout v5.0

4. Установите зависимости:

   yarn install

Как собрать расширение

1. Переключитесь на ветку v5.0:

   git checkout v5.0

2. Выполните следующую команду в терминале:

   yarn dev chrome-mv3

3. Собранное расширение будет находиться в каталоге:

   ./build/dev/chrome-mv3

Как установить распакованное расширение в браузере

1. Включите режим разработчика:

   

2. Нажмите Загрузить распакованное:

   

3. Выберите каталог расширения и нажмите Выбрать:

   

Готово!

Как отлаживать правила

1. Найдите и измените нужное вам правило в каталоге ./Extension/filters/chromium-mv3 в файлах .txt.

2. Преобразуйте правила из txt в декларативный формат:

   yarn convert-declarative

3. Снова соберите расширение:

   yarn dev chrome-mv3

4. Перезагрузите расширение в браузере: