Salta al contenuto principale

Come eseguire il debug delle regole in AdGuard per Chrome MV3

In AdGuard per Chrome MV3, il registro di filtraggio mostra solo le regole approssimative applicate, che chiamiamo "regole presunte". Ciò accade perché il browser non fornisce dettagli sulle specifiche regole dichiarative utilizzate, a meno che l'estensione non sia in un formato "non compresso". Per informazioni più precise, dovrai installare tu stesso la versione scompattata dell'estensione nel tuo browser.

Queste istruzioni sono pensate anche per i casi problematici in cui si desidera modificare staticamente le regole fornite con l'estensione. Nella maggior parte dei casi, dovrebbe essere sufficiente utilizzare Regole utente nell'estensione.

Prerequisiti

  1. Git: Installa Git

  2. Node: Installa Node.js

  3. Yarn: Installa Yarn

Come clonare l'estensione

  1. Clonare il repositorio:

    git clone git@github.com:AdguardTeam/AdguardBrowserExtension.git
  2. Passare alla ripartizione:

    cd AdguardBrowserExtension
  3. Passare al ramo v5.0:

    git checkout v5.0
  4. Installare le dipendenze:

    yarn install

Come costruire l'estensione

  1. Passare al ramo v5.0:

    git checkout v5.0
  2. Eseguire il seguente comando nel terminale:

    yarn dev chrome-mv3
  3. L'estensione compilata sarà posizionata nella ripartizione:

    ./build/dev/chrome-mv3

Come installare decompresso nel browser

  1. Attivare la modalità sviluppatore:

    Modalita sviluppatore

  2. Fare clic su Carica decompresso:

    Carica decompresso

  3. Selezionare la ripartizione dell'estensione e fare clic su Seleziona:

    Seleziona

Ecco fatto!

Come eseguire il debug delle regole

  1. Trova e modifica la regola di cui hai bisogno nella ripartizione ./Extension/filters/chromium-mv3 nei file .txt.

  2. Convertire le regole dal formato txt alla forma dichiarativa:

    yarn convert-declarative
  3. Costruire nuovamente l'estensione:

    yarn dev chrome-mv3
  4. Ricaricare l'estensione nel browser:

    Ricarica estensione