Installieren Sie axe DevTools Cypress über Agora

Greifen Sie direkt auf das Artefakt-Repository von Deque zu, um axe DevTools herunterzuladen

Für Kunden, die über kein internes Artefakt-Repository verfügen und eine nachhaltigere und skalierbarere Lösung für die Installation wünschen als das direkte Herunterladen von axe DevTools, stellt Deque ausgewählten Kunden ein eigenes Artefakt-Repository zur Verfügung. Informationen zu anderen Möglichkeiten zum Installieren von axe DevTools finden Sie in den Anleitungen unter Installieren aus Ihrem Artefakt-Repository

Voraussetzungen

Um axe DevTools von Agora zu installieren, müssen Sie über Agora-Anmeldeinformationen verfügen. Darüber hinaus müssen Sie über ein vorhandenes NodeJS-basiertes Webprojekt verfügen, in dem Sie axe DevTools installieren können. Abhängig von der Konfiguration Ihrer Testumgebung kann Ihre Testbibliothek als zusätzliche Abhängigkeit erforderlich sein.

Erstellen eines Identitätstokens

Der einfachste Weg, ein Identitätstoken zu erstellen, ist über die Agora-Webanwendung. Sobald Sie angemeldet sind, können Sie ein Identitätstoken erstellen, indem Sie in der oberen Leiste neben der Hilfe-Schaltfläche auf die Schaltfläche Willkommen Ihre E-Mail-Adresse klicken. Von dort können Sie Ihr Identitätstoken kopieren.

Authentifizierung hinzufügen

Um über NPM oder Yarn auf axe DevTools-Pakete zuzugreifen, müssen Sie Ihre Agora-Authentifizierungsinformationen zu einer ~/.npmrc-Datei hinzufügen. Am einfachsten geht das mit einem Curl-Befehl.

curl -u"<your-email>":<your-identity-token> "https://agora.dequecloud.com/artifactory/api/npm/auth"

Ersetzen Sie durch Ihre Agora-Anmelde-E-Mail bei der Ausführung dieses Befehls und ersetzen Sie mit dem Identitätstoken, das Sie im vorherigen Schritt kopiert haben. Die Rückgabe des Befehls sollte folgendermaßen aussehen:

_auth = <generated-auth-string>
always-auth = true
email = <your-email>

Einrichten Ihrer .npmrc Datei (yarn/npm)

Öffnen Sie Ihre ~/.npmrc-Datei zum Bearbeiten. Fügen Sie zuerst die Registrierungsinformationen und dann die Ausgabe des Curl-Befehls hinzu. Das Endprodukt sollte wie folgt 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@email.com>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true

Einrichten Ihrer .yarnrc.yml Datei (yarn modern)

Öffnen Sie Ihre Datei ~/.yarnrc.yml zum Bearbeiten. Fügen Sie zuerst die Registrierungsinformationen und dann die Ausgabe des Curl-Befehls hinzu. Das Endprodukt sollte wie folgt aussehen:

npmScopes:
  axe-devtools:
      npmRegistries: 'https://agora.dequecloud.com/artifactory/api/npm/dequelabs/':
      npmAuthIdent: <generated-auth-string>
      npmRegistryServer: 'https://agora.dequecloud.com/artifactory/api/npm/dequelabs/'
      npmAlwaysAuth: true

Wenn Sie keine curl-Befehle ausführen können, können Sie Ihre Authentifizierungszeichenfolge generieren, indem Sie <your-email> mit Base-64 kodieren:` und fügen Sie das Produkt auf dieselbe Weise zur Datei ~/.npmrc hinzu, als wäre es mit dem Befehl curl generiert worden.

Installieren

Um axe DevTools Cypress in Ihrem Projekt zu installieren, führen Sie diesen Befehl aus:

npm install @axe-devtools/cypress

Wenn Sie Cypress selbst noch nicht installiert haben, können Sie es mit dem Befehl installieren

npm install cypress

Nächster Schritt

Wenn Sie Probleme bei der Installation von axe DevTools haben, wenden Sie sich direkt an Ihren Deque-Vertreter, fragen Sie uns über unseren Support-Desk oder senden Sie uns eine E-Mail. Wir helfen Ihnen gerne beim Einstieg.