Installation von Axe DevTools für Web CLI

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

Installieren Sie das CLI als eigenständige ausführbare Datei oder als Node.js-Paket.

Not for use with personal data

Axe DevTools CLI ist in zwei Formen verfügbar. Wählen Sie diejenige, die zu Ihrer Umgebung passt:

Anforderungen

Axe DevTools CLI erfordert einen Browser-Treiber für jeden Browser, den Sie verwenden möchten. Der Treiber muss sich in Ihrem PATHbefinden. Halten Sie sowohl Ihren Browser als auch dessen Treiber auf dem neuesten Stand.

Browser Treiber
Chrome ChromeDriver
Firefox geckodriver
Safari safaridriver ist in macOS integriert. Möglicherweise müssen Sie safaridriver --enable ausführen, bevor Sie es verwenden können.
Microsoft Edge Microsoft Edge WebDriver
Internet Explorer IE Driver Server

Die ausführbare Datei installieren

Die ausführbaren Dateien haben keine Voraussetzungen; Node.js ist nicht erforderlich.

important

Sie benötigen ein Deque Agora Konto, um auf die Download-Seite zuzugreifen. Wenn Sie kein Konto haben, kontaktieren Sie Ihren Deque-Ansprechpartner, nutzen Sie unseren Support-Desk, oder schreiben Sie uns eine E-Mail.

Laden Sie die passende ausführbare Datei für Ihre Plattform von der CLI-Sektion der Download-Seiteherunter:

  • axe-linux (Linux)
  • axe-macos (macOS)
  • axe-win.exe (Windows)

Einrichtung unter Linux

Machen Sie die Datei ausführbar:

chmod +x axe-linux

Einrichtung unter macOS

Machen Sie die Datei ausführbar und entfernen Sie dann das Quarantäneattribut, das macOS zu heruntergeladenen Dateien hinzufügt:

chmod +x axe-macos
xattr -d com.apple.quarantine axe-macos

Installation testen

Führen Sie den Hilfe-Befehl aus dem Verzeichnis aus, in dem Sie die ausführbare Datei abgelegt haben:

  • Linux: ./axe-linux --help
  • macOS: ./axe-macos --help
  • Windows: axe-win --help

Je nach Konfiguration Ihres Kontos benötigen Sie möglicherweise Administratorrechte.

Machen Sie das CLI global verfügbar

Um axe aus jedem Verzeichnis auszuführen, platzieren Sie die ausführbare Datei in einem Verzeichnis, das in Ihrem PATHenthalten ist.

note

In der restlichen Dokumentation wird davon ausgegangen, dass Sie die ausführbare Datei umbenannt haben in axe (oder axe.exe unter Windows) und dass sie global verfügbar ist.


Installation über Node.js

Sie benötigen Node.js installiert. Um dies zu überprüfen, führen Sie node -v in Ihrem Terminal aus.

note

Sie benötigen Zugriff auf das private Deque Systems-Register. Wenn Sie noch keinen Zugriff haben, kontaktieren Sie den Deque Systems Helpdesk.

Schritt 1: Beschaffen Sie sich ein Agora-Identitätstoken

Agora ist das private npm-Register von Deque, das @axe-devtools -Pakete hostet. Um darauf zuzugreifen, benötigen Sie ein Identitätstoken.

  1. Besuchen Sie Ihre Agora-Profilseite. (Falls Sie nach dem Login weitergeleitet werden, klicken Sie den Link ein zweites Mal oder klicken Sie auf Profil bearbeiten in der oberen rechten Ecke.)
  2. Klicken Sie auf Identitätstoken generieren.
  3. Fügen Sie optional eine Beschreibung hinzu, um das Token später zu identifizieren.
  4. Kopieren Sie das Token in Ihre Zwischenablage. Speichern Sie es an einem sicheren Ort, da Sie es bei Agora nicht erneut abrufen können.
important

Denken Sie daran, den Wert Ihres Identitätstokens beim Erstellen zu kopieren, da dies Ihre einzige Möglichkeit ist. Andernfalls müssen Sie ein neues Token erstellen.

Identitätstoken laufen ab (normalerweise nach einem Jahr), daher müssen Sie Ihr Token regelmäßig neu erstellen.

Schritt 2: Konfigurieren Sie Ihre .npmrc

  1. Besuchen Sie das Werkzeug Konfiguration des Zugriffs auf Agora-Pakete . Keine der eingegebenen Informationen wird gespeichert oder übertragen.
  2. Geben Sie Ihre Agora-E-Mail-Adresse und Ihr Identitätstoken ein.
  3. Klicken Sie auf Konfiguration generieren und kopieren Sie die Ausgabe.
  4. Fügen Sie die kopierten Zeilen in Ihre ~/.npmrc -Datei ein (%USERPROFILE%/.npmrc unter Windows).

Ihr .npmrc sollte so aussehen:

@axe-devtools:registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_auth="<generated-auth-string>"
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:email=<your-email@example.com>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true

Der _auth -Wert ist die Base64-Codierung von <your-email>:<your-identity-token>.

Schritt 3: Installation des Pakets

Installation global mit npm:

npm install -g @axe-devtools/cli

Oder mit Yarn:

yarn global add @axe-devtools/cli

Testen Sie Ihre Installation

axe --help

Wenn der Hilfetext erscheint, ist die CLI installiert und einsatzbereit.