Installation des Axe DevTools Linter Connector als npm-Paket

Dieser Artikel beschreibt, wie Sie den Axe DevTools Connector herunterladen und installieren, indem Sie Agora als npm-Package-Registry verwenden. Auf diese Weise können Sie die von Node.js und npm bereitgestellte Infrastruktur nutzen, um Ihr Axe DevTools Linter Connector-Binary herunterzuladen, zu versionieren und zu aktualisieren, und vermeiden die manuellen Schritte, die erforderlich sind, wenn Sie den Connector direkt über die Downloads-Seite herunterladen.

Was ist Agora?

Agora ist Deques Repository (gehostet von JFrog als Artifactory oder Artifactory), das binäre Artefakte (Pakete, Bibliotheken und ausführbare Dateien) sicher speichert und ein Konto zum Zugriff erfordert. Agora hostet den Axe Linter Connector (sowohl das npm-Paket als auch das manuell herunterladbare ausführbare Programm).

Erstellen eines Agora-Identitätstokens

Der erste Schritt besteht darin, ein Identitätstoken zu erstellen, das npm zur Authentifizierung Ihrer Agora-Sitzung verwendet. Agora-Identitätstokens laufen nach einem Jahr ab, sie müssen also jährlich neu erstellt werden.

1. Besuchen Sie Ihre Agora-Profilseite, um ein Identitätstoken zu erhalten. (Wenn Sie nicht bei Agora angemeldet sind, werden Sie möglicherweise nach dem Anmelden auf eine andere Landingpage als Ihre Profilseite weitergeleitet. Klicken Sie nach dem Anmelden ein zweites Mal auf die gleichen Link, um zu Ihrer Profilseite zu gelangen. Oder klicken Sie auf die Schaltfläche rechts neben der Hilfe-Schaltfläche in der oberen rechten Ecke und dann auf Profil bearbeiten.)
2. Klicken Sie auf Identitätstoken generieren.
3. Fügen Sie eine Beschreibung hinzu, um das Token in Zukunft leichter identifizieren zu können. (Optional)
4. Klicken Sie auf das Kopiersymbol, um das Identitätstoken in die Zwischenablage zu kopieren. (Es könnte sinnvoll sein, dieses Identitätstoken in einem Passwort-Manager zu speichern, da es nicht erneut abgerufen werden kann.)

Richten Sie Ihre .npmrc ein

Jetzt, da Sie ein Agora-Identitätstoken haben, können Sie Ihre .npmrc-Datei einrichten, um die Nutzung der npm-Infrastruktur zur Installation des Connectors zu ermöglichen.

1. Besuchen Sie die Site „Konfiguration des Zugangs zu Agora-Paketen“-Seite, um die Konfiguration zu erstellen, die Sie in Ihre .npmrc-Datei einfügen möchten. Beachten Sie, dass keine Informationen auf dieser Seite gespeichert oder übermittelt werden.
2. Fügen Sie Ihre E-Mail-Adresse hinzu (muss diejenige sein, mit der Sie auf der Agora-Site registriert sind).
3. Fügen Sie Ihr Identitätstoken in das entsprechende Textfeld ein.
4. Klicken Sie auf Konfiguration generieren, um eine Konfiguration zu erstellen, und klicken Sie auf das Kopieren-Symbol.
5. Fügen Sie die kopierten Zeilen in Ihre .npmrc-Datei ein. Der Pfad zur Datei ist auf der Seite für Linux, macOS und Windows angegeben.

Nachdem Sie diese Schritte abgeschlossen haben, können Sie das Axe DevTools Linter Connector npm-Paket verwenden.

Beispiel .npmrc

Das Folgende ist ein Beispiel für die Zeilen, die Ihrer .npmrc-Konfiguration hinzugefügt werden müssen:

@axe-devtools:registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_auth="am9obmRvZUBleGFtcGxlLmNvbTpUaGlzIGlzbid0IGEgdmFsaWQgaWRlbnRpdHkgdG9rZW4K"
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:email=johndoe@example.com
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true

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

//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_authToken="VGhpcyBpc24ndCBhIHZhbGlkIGlkZW50aXR5IHRva2VuCg=="

Installation und Nutzung

Sie können die neueste Version des Axe DevTools Connector installieren mit:

npm install @axe-devtools/axe-linter-connector -g

Dieser Befehl installiert den Connector global. Überprüfen Sie die Installation, indem Sie die --version-Option verwenden:

axe-linter-connector --version

Nächste Schritte

• Siehe die Dokumentation für den Axe Linter Connector.
• (Externe JFrog-Dokumentation) Verbinden Sie Ihren npm-Client mit Artifactory für eine detaillierte Diskussion darüber, wie Sie Ihre .npmrc manuell konfigurieren.