メインコンテンツへスキップする

AdGuard for Chrome MV3対応版でルールをデバッグする方法

AdGuard for Chrome MV3対応版 では、フィルタリングログに適用されたであろうというルールのみが表示されます。これを「想定ルール」と呼びます。 これは、拡張機能が「解凍」された形式でない限り、ブラウザが具体的にどの宣言的ルールが使われたかについての詳細を提供しないからです。 正確な情報を確認するには、ご自身でブラウザにAdGuardブラウザ拡張機能の「解凍」版をインストールする必要があります。

以下の手順は、拡張機能にバンドルされているルールを静的に変更したいという、問題がある場合のためにも使えます。 ほとんどの場合、拡張機能の「ユーザールール」を使用すれば十分です。

前提条件​

  1. Git: Git をインストールする

  2. Node: Node.js をインストールする

  3. Yarn: Yarn をインストールする

拡張機能をクローンする方法​

  1. リポジトリをクローンします:

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

  2. ディレクトリに移動します:

    cd AdguardBrowserExtension

  3. v5.0 ブランチに切り替えます:

    git checkout v5.0

  4. 依存関係をインストールします:

    yarn install

拡張機能のビルド方法​

  1. v5.0 ブランチに切り替えます:

    git checkout v5.0

  2. ターミナルで次のコマンドを実行します:

    yarn dev chrome-mv3

  3. ビルドされた拡張機能は次のディレクトリに配置されます:

    ./build/dev/chrome-mv3

ブラウザに解凍版をインストールする方法​

  1. 開発者モードをオンにします:

    Developer mode

  2. 「解凍して読み込む」をクリックします:

    Load unpacked

  3. 拡張機能ディレクトリを選択し、「選択」をクリックします:

    Select

これで完了です。

ルールをデバッグする方法​

  1. .txt ファイルの ./Extension/filters/chromium-mv3 ディレクトリで必要なルールを見つけて変更します。

  2. ルールを txt から宣言形式に変換します:

    yarn convert-declarative

  3. 拡張機能を再度ビルドします:

    yarn dev chrome-mv3

  4. ブラウザで拡張機能を再読み込みします:

    Reload extension