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”. 原因是,除非扩展名为“解压”格式,否则浏览器无法提供关于特定声明式规则的详细信息。如需获取准确信息,需要自行在浏览器中安装扩展程序的“解压”版本。
此说明对于有问题的情况也很有用,比如,在用户要更改扩展中静态包含的规则的情况下。在大多数情况下,使用扩展中的「用户规则」就足够了。
先决条件
-
Git:安装 Git
-
Node:安装 Node.js
-
Yarn:安装 Yarn
克隆扩展的方式
-
克隆存储库:
git clone git@github.com:AdguardTeam/AdguardBrowserExtension.git -
转到目录:
cd AdguardBrowserExtension -
切换到
v5.0分支:git checkout v5.0 -
安装依赖项:
yarn install
建构扩展的方式
-
切换到
v5.0分支:git checkout v5.0 -
在终端中运行以下命令:
yarn dev chrome-mv3 -
For Opera, run
yarn dev opera-mv3instead — the built extension will be located in the./build/dev/opera-mv3directory. -
The built extension will be located in the directory:
./build/dev/chrome-mv3
在浏览器中安装解压包
-
开启「开发者模式」:

-
单击「加载已解压的扩展程序」:

-
选择扩展目录并点击「选择」:

完成!
调试规则
-
在
./Extension/filters/chromium-mv3目录中的.txt文件中找到并修改需要的规则。 -
将规则从 TXT 格式转换为声明形式:
yarn convert-declarative -
再次构建扩展:
yarn dev chrome-mv3 -
在浏览器中重新加载扩展:
