Installazione di Axe DevTools per Web CLI

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

Installa la CLI come eseguibile autonomo o come pacchetto Node.js.

Not for use with personal data

Axe DevTools CLI è disponibile in due forme. Scegli quella che si adatta al tuo ambiente:

Requisiti

Axe DevTools CLI richiede un driver del browser per ogni browser che si desidera utilizzare. Il driver deve essere nel tuo PATH. Tieni aggiornati sia il tuo browser che il suo driver.

Browser Driver
Chrome ChromeDriver
Firefox geckodriver
Safari safaridriver è integrato in macOS. Potresti dover eseguire safaridriver --enable prima di usarlo.
Microsoft Edge Microsoft Edge WebDriver
Internet Explorer IE Driver Server

Installa l'eseguibile

Gli eseguibili non hanno prerequisiti; Node.js non è richiesto.

important

Hai bisogno di un account Deque Agora per accedere alla pagina dei download. Se non ne hai uno, contatta il tuo rappresentante Deque, utilizza il nostro help desk, o inviaci un'email.

Scarica l'eseguibile appropriato per la tua piattaforma dalla sezione CLI della pagina dei download:

  • axe-linux (Linux)
  • axe-macos (macOS)
  • axe-win.exe (Windows)

Configurazione su Linux

Rendi il file eseguibile:

chmod +x axe-linux

Configurazione su macOS

Rendi il file eseguibile, quindi rimuovi l'attributo di quarantena che macOS aggiunge ai file scaricati:

chmod +x axe-macos
xattr -d com.apple.quarantine axe-macos

Testa la tua installazione

Esegui il comando di aiuto dalla directory in cui hai posizionato l'eseguibile:

  • Linux: ./axe-linux --help
  • macOS: ./axe-macos --help
  • Windows: axe-win --help

A seconda della configurazione del tuo account, potresti avere bisogno dei privilegi di amministratore.

Rendi la CLI disponibile globalmente

Per eseguire axe da qualsiasi directory, posiziona l'eseguibile in una directory nel tuo PATH.

note

Il resto di questa documentazione presume che abbiate rinominato l'eseguibile in axe (o axe.exe su Windows) e che sia disponibile a livello globale.


Installazione tramite Node.js

È necessario avere Node.js installato. Per verificare, eseguite node -v nel vostro terminale.

note

Avete bisogno di accedere al registro privato di Deque Systems. Se non avete già accesso, contattate l' assistenza Deque Systems.

Passo 1: Ottenere un token di identità Agora

Agora è il registro npm privato di Deque che ospita i @axe-devtools pacchetti. Per accedervi, è necessario un token di identità.

  1. Visitate la vostra pagina profilo Agora. (Se siete reindirizzati dopo il login, cliccate nuovamente sul link oppure su Modifica Profilo nell'angolo in alto a destra.)
  2. Cliccate su Genera un Token di Identità.
  3. Opzionalmente, aggiungete una descrizione per identificare il token in seguito.
  4. Copiate il token negli appunti. Salvatelo in un luogo sicuro perché non potrete più recuperarlo da Agora.
important

Ricordati di copiare il valore del tuo Identity Token quando lo crei, perché questa sarà la tua unica opportunità. Altrimenti dovrai creare un nuovo token.

I token di identità scadono (solitamente dopo un anno), quindi dovrai ricrearli periodicamente.

Passo 2: Configurare il vostro .npmrc

  1. Visitate lo strumento di Configurazione dell'Accesso ai pacchetti Agora . Nessuna delle informazioni che inserite viene memorizzata o trasmessa.
  2. Inserite il vostro indirizzo email di Agora e il token di identità.
  3. Cliccate su Genera Configurazione e copiate il risultato.
  4. Incollate le righe copiate nel vostro ~/.npmrc file (%USERPROFILE%/.npmrc su Windows).

Il vostro .npmrc dovrebbe apparire così:

@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=true

Il valore _auth è la codifica base64 di <your-email>:<your-identity-token>.

Passo 3: Installare il pacchetto

Installazione globale con npm:

npm install -g @axe-devtools/cli

Oppure con Yarn:

yarn global add @axe-devtools/cli

Testate la vostra installazione

axe --help

Se appare il testo di aiuto, la CLI è installata ed è pronta all'uso.