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: über npm oder Yarn installiert, erfordert Node.js
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.
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-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-macosTesten 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.
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.
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.
- 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.)
- 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 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
- Besuchen Sie das Konfiguration des Zugriffs auf Agora-Pakete-Werkzeug. Keine der von Ihnen 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%/.npmrcauf 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-Kodierung 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.
