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. Mantieni aggiornati sia il browser che il suo driver.

Browser Driver
Chrome ChromeDriver
Firefox geckodriver
Safari safaridriver è integrato in macOS. Potrebbe essere necessario 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 il file eseguibile appropriato per la tua piattaforma dal 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

Testate la vostra 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 tu abbia rinominato l'eseguibile in axe (o axe.exe su Windows) e che sia disponibile globalmente.


Installazione tramite Node.js

Devi avere Node.js installato. Per verificare, esegui node -v nel tuo terminale.

note

Hai bisogno dell'accesso al registro privato Deque Systems. Se non hai già accesso, contatta il assistenza Deque Systems.

Passo 1: Ottenere un token di identità Agora

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

  1. Visita il tuo pagina profilo Agora. (Se vieni reindirizzato dopo il login, clicca sul link una seconda volta o clicca su Modifica Profilo nell'angolo in alto a destra.)
  2. Fai clic 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

Ricorda di copiare il valore del tuo Token di Identità quando lo crei, poiché questa sarà la tua unica occasione. Altrimenti, dovrai creare un nuovo token.

I Token di Identità scadono (di solito dopo un anno), quindi dovrai ricreare il tuo token periodicamente.

Passo 2: Configura il tuo .npmrc

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

Il tuo .npmrc dovrebbe avere questo aspetto:

@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.