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”. Esto se debe a que el navegador no proporciona detalles sobre qué reglas declarativas específicas se utilizaron a menos que la extensión esté en un formato "descomprimido". Para obtener información precisa, deberás instalar la forma “descomprimida” de la extensión en tu navegador.

Estas instrucciones también están destinadas a casos problemáticos donde deseas modificar las reglas que están agrupadas con la extensión de forma estática. En la mayoría de los casos, utilizar Reglas del usuario en la extensión debería ser suficiente.

Requisitos previos

1. Git: Instalar Git

2. Nodo: Instalar Node.js

3. Yarn: Instalar Yarn

Cómo clonar la extensión

1. Clona el repositorio:

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

2. Navegue até o diretório:

   cd AdguardBrowserExtension

3. Cambia a la branch v5.0:

   git checkout v5.0

4. Instala las dependencias:

   yarn install

Cómo construir la extensión

1. Cambia a la branch v5.0:

   git checkout v5.0

2. Ejecuta el siguiente comando en la 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

Cómo instalar la extensión descomprimida en el navegador

1. Activa el modo de desarrollador:

   

2. Haz clic en Cargar descomprimido:

   

3. Selecciona el directorio de la extensión y haz clic en Seleccionar:

   

¡Eso es todo!

Cómo depurar reglas

1. Encuentra y modifica la regla que necesitas en el directorio ./Extensión/filtrado/chromium-mv3 en los archivos .txt.

2. Convierte las reglas de txt a su forma declarativa:

   yarn convert-declarative

3. Haz el build de la extensión de nuevo:

   yarn dev chrome-mv3

4. Recarga la extensión en el navegador: