Installation von Axe DevTools für Web CLI
Installieren Sie das CLI als eigenständige ausführbare Datei oder als Node.js-Paket.
Axe DevTools CLI ist in zwei Formen verfügbar. Wählen Sie diejenige, die zu Ihrer Umgebung passt:
- Ausführbare Dateien: eigenständige Binärdateien ohne Voraussetzungen
- Node.js-Paket: installiert über npm oder Yarn, erfordert Node.js
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.
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-linuxEinrichtung 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-macosInstallation 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.
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.
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.
- 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.)
- Klicken Sie auf Identitätstoken generieren.
- Fügen Sie optional eine Beschreibung hinzu, um das Token später zu identifizieren.
- Kopieren Sie das Token in Ihre Zwischenablage. Speichern Sie es an einem sicheren Ort, da Sie es bei Agora nicht erneut abrufen können.
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
- Besuchen Sie das Werkzeug Konfiguration des Zugriffs auf Agora-Pakete . Keine der eingegebenen Informationen wird gespeichert oder übertragen.
- Geben Sie Ihre Agora-E-Mail-Adresse und Ihr Identitätstoken ein.
- Klicken Sie auf Konfiguration generieren und kopieren Sie die Ausgabe.
- Fügen Sie die kopierten Zeilen in Ihre
~/.npmrc-Datei ein (%USERPROFILE%/.npmrcunter 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=trueDer _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/cliOder mit Yarn:
yarn global add @axe-devtools/cliTesten Sie Ihre Installation
axe --helpWenn der Hilfetext erscheint, ist die CLI installiert und einsatzbereit.
