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

Das Axe DevTools CLI erfordert einen Browser-Treiber für jeden Browser, den Sie verwenden möchten. Der Treiber muss sich in Ihrem PATH befinden. 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.
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 keines haben, kontaktieren Sie Ihren Deque-Vertreter, nutzen Sie unser Support-Desk oder schreiben Sie uns eine E-Mail.

Laden Sie das passende ausführbare Programm für Ihre Plattform von CLI-Sektion der Download-Seite herunter:

  • 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

Testen Sie Ihre Installation

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 in Ihrem PATH.

note

Der Rest dieser Dokumentation geht davon aus, dass Sie die ausführbare Datei in axe (oder axe.exe auf Windows) umbenannt haben 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 Deques privates npm-Register, das @axe-devtools-Pakete hostet. Um darauf zuzugreifen, benötigen Sie ein Identitätstoken.

  1. Besuchen Sie Ihr Agora-Profilseite. (Wenn Sie nach dem Login umgeleitet werden, klicken Sie ein zweites Mal auf den Link oder 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 Identity Tokens beim Erstellen zu kopieren, da dies Ihre einzige Chance sein wird. Andernfalls müssen Sie ein neues Token erstellen.

Identity Tokens laufen ab (in der Regel nach einem Jahr), daher müssen Sie Ihr Token regelmäßig neu erstellen.

Schritt 2: Konfigurieren Sie Ihren .npmrc

  1. Besuchen Sie das Konfiguration des Zugriffs auf Agora-Pakete-Werkzeug. Keine der von Ihnen 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 auf 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-Kodierung 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.