Přejít k hlavnímu obsahu

How to debug rules in the MV3 extension

In the AdGuard Browser Extension MV3, the Filtering log only shows the approximate rules that were applied, which we call “assumed rules”. Je to proto, že prohlížeč neposkytuje podrobnosti o tom, která konkrétní deklarativní pravidla byla použita, pokud není rozšíření v "rozbaleném" formátu. Chcete-li získat přesné informace, musíte si sami nainstalovat rozbalenou verzi rozšíření do prohlížeče.

Tyto pokyny jsou určeny i pro problematické případy, kdy chcete upravit pravidla, která jsou s rozšířením staticky svázána. Ve většině případů by mělo stačit použití Uživatelských pravidel v rozšíření.

Předpoklady​

  1. Git: nainstalujte Git

  2. Node: nainstalujte Node.js

  3. Yarn: nainstalujte Yarn

Jak klonovat rozšíření​

  1. Naklonujte repozitář:

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

  2. Přejděte do adresáře:

    cd AdguardBrowserExtension

  3. Přepněte na větev v5.0:

    git checkout v5.0

  4. Nainstalujte závislosti:

    yarn install

Jak sestavit rozšíření​

  1. Přepněte na větev v5.0:

    git checkout v5.0

  2. V terminálu spusťte následující příkaz:

    yarn dev chrome-mv3

  3. For Opera, run yarn dev opera-mv3 instead — the built extension will be located in the ./build/dev/opera-mv3 directory.

  4. The built extension will be located in the directory:

    ./build/dev/chrome-mv3

Jak nainstalovat rozbalené rozšíření v prohlížeči​

  1. Zapněte režim vývojáře:

    Developer mode *border

  2. Klikněte na Načíst rozbalené:

    Load unpacked *border

  3. Vyberte adresář s rozšířením a klikněte na Vybrat:

    Select *border

To je vše!

Jak ladit pravidla​

  1. Najděte a upravte potřebné pravidlo v adresáři ./Extension/filters/chromium-mv3 v souborech .txt.

  2. Převeďte pravidla z txt do deklarativní formy:

    yarn convert-declarative

  3. Sestavte rozšíření znovu:

    yarn dev chrome-mv3

  4. Znovu načtěte rozšíření v prohlížeči:

    Reload extension *border