Zum Hauptinhalt springen

So debuggen Sie Regeln in AdGuard für Chrome MV3

In AdGuard für Chrome MV3 zeigt das Filter-Protokoll nur die ungefähren Regeln an, die angewendet wurden, die wir „mutmaßliche Regeln“ nennen. Dies liegt daran, dass der Browser keine Details darüber liefert, welche spezifischen deklarativen Regeln verwendet wurden, es sei denn, die Erweiterung liegt in einem „entpackten" Format vor. Um genaue Informationen zu erhalten, müssen Sie die entpackte Version der Erweiterung selbst in Ihrem Browser installieren.

Diese Anweisungen sind auch für problematische Fälle gedacht, in denen Sie die statisch mit der Erweiterung gelieferten Regeln ändern wollen. In den meisten Fällen sollte die Verwendung von Benutzerregeln in der Erweiterung ausreichen.

Voraussetzungen

  1. Git: Git installieren

  2. Node: Node.js installieren

  3. Yarn: Yarn installieren

So klonen Sie die Erweiterung

  1. Klonen Sie das Repository:

    git clone git@github.com:AdguardTeam/AdguardBrowserExtension.git
  2. Wechseln Sie in den Ordner:

    cd AdguardBrowserExtension
  3. Wechseln Sie zum Zweig v5.0:

    git checkout v5.0
  4. Installieren Sie Abhängigkeiten:

    yarn install

So erstellen Sie eine Erweiterung

  1. Wechseln Sie zum Zweig v5.0:

    git checkout v5.0
  2. Führen Sie den folgenden Befehl im Terminal aus:

    yarn dev chrome-mv3
  3. Die erstellte Erweiterung befindet sich in diesem Ordner:

    ./build/dev/chrome-mv3

So installieren Sie entpackte Erweiterung im Browser

  1. Aktivieren Sie den Entwicklermodus:

    Entwicklermodus

  2. Klicken Sie auf Entpackt laden:

    Entpackte Erweiterung laden

  3. Wählen Sie den Ordner der Erweiterung und klicken Sie auf Auswählen:

    Auswählen

Das war's!

So debuggen Sie Regeln

  1. Suchen Sie die gewünschte Regel im Ordner ./Extension/filters/chromium-mv3 in den .txt-Dateien und ändern Sie sie.

  2. Konvertieren Sie die Regeln von txt in deklarative Form:

    yarn convert-declarative
  3. Erstellen Sie die Erweiterung erneut:

    yarn dev chrome-mv3
  4. Laden Sie die Erweiterung erneut im Browser:

    Erweiterung neu laden