Installation des Axe DevTools Linter Connector als npm-Paket

Dieser Artikel beschreibt, wie Sie den Axe DevTools Connector mit Agora als npm-Paket-Registry herunterladen und installieren. Dies ermöglicht es Ihnen, von der Infrastruktur von Node.js zu profitieren und npm Ihre Axe DevTools Linter Connector-Binärdatei herunterzuladen, zu versionieren und zu aktualisieren und dabei die manuellen Schritte zu vermeiden, die erforderlich sind, wenn Sie den Connector direkt über die Downloads Seite herunterladen.

Was ist Agora?

Agora ist Deques Repository (gehostet von JFrog als Artifact Factory oder Artifactory), das Binärartefakte (Pakete, Bibliotheken und ausführbare Dateien) sicher speichert und für den Zugriff ein Konto erfordert. Agora hostet den Axe Linter Connector (sowohl das npm-Paket als auch die manuell herunterladbare ausführbare Datei).

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 eingeloggt sind, werden Sie möglicherweise nach dem Login auf eine andere Seite als Ihre Profilseite weitergeleitet. Klicken Sie den gleichen Link ein zweites Mal an, nachdem Sie eingeloggt sind, um zu Ihrer Profilseite zu gelangen. Oder klicken Sie auf den Button rechts neben dem Hilfebutton 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

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

1. Besuchen Sie die Site „Konfiguration des Zugangs zu Agora-Paketen“ , um die Konfiguration zu erstellen, die Sie in Ihre .npmrc Datei einfügen müssen. Beachten Sie, dass keine der Informationen auf dieser Seite gespeichert oder übertragen wird.
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 Kopiersymbol.
5. Fügen Sie die kopierten Zeilen in Ihre .npmrc Datei ein. Der Pfad zur Datei ist auf der Site 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 Beispiel zeigt die Zeilen, die zu 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 mit der --version Option:

axe-linter-connector --version

Nächste Schritte

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