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”. Isso ocorre porque o navegador não fornece detalhes sobre quais regras declarativas específicas foram usadas, a menos que a extensão esteja em um formato "descompactado". Para obter informações precisas, você precisará instalar o formato “descompactado” da extensão no seu navegador.

Estas instruções também são destinadas a casos problemáticos em que você deseja modificar as regras incluídas na extensão de forma estática. Na maioria dos casos, usar Regras de usuário na extensão deve ser suficiente.

Pré-requisitos

1. Git: Instalar Git

2. Node: Instalar Node.js

3. Yarn: Instalar Yarn

Como clonar a extensão

1. Clone o repositório:

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

2. Navegue até o diretório:

   cd AdguardBrowserExtension

3. Mude para a branch v5.0:

   git checkout v5.0

4. Instale as dependências:

   yarn install

Como construir a extensão

1. Mude para a branch v5.0:

   git checkout v5.0

2. Execute o seguinte comando no terminal:

   # 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

Como instalar o unpacked no navegador

1. Ative o modo de desenvolvedor:

   

2. Clique em Carregar unpacked:

   

3. Selecione o diretório da extensão e clique em Selecionar:

   

Tudo pronto!

Como depurar regras

1. Encontre e modifique a regra que você precisa no diretório ./Extension/filters/chromium-mv3, nos arquivos .txt.

2. Converta as regras de txt para a forma declarativa:

   yarn convert-declarative

3. Faça o build da extensão novamente:

   # yarn dev chrome-mv3

4. Recarregue a extensão no navegador: