Installazione di Axe DevTools per Web CLI
Installa la CLI come eseguibile autonomo o come pacchetto Node.js.
Axe DevTools CLI è disponibile in due forme. Scegli quella che si adatta al tuo ambiente:
- Eseguibili: binari autonomi senza prerequisiti
- Pacchetto Node.js: installato tramite npm o Yarn, richiede Node.js
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.
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-linuxConfigurazione 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-macosTestate 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.
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.
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à.
- 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.)
- Fai clic su Genera un Token di Identità.
- Opzionalmente, aggiungete una descrizione per identificare il token in seguito.
- Copiate il token negli appunti. Salvatelo in un luogo sicuro perché non potrete più recuperarlo da Agora.
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
- Visita lo strumento Configurazione dell'Accesso ai pacchetti Agora. Nessuna delle informazioni inserite viene memorizzata o trasmessa.
- Inserite il vostro indirizzo email di Agora e il token di identità.
- Fai clic su Genera Configurazione e copia il risultato.
- Incolla le righe copiate nel tuo file
~/.npmrc(%USERPROFILE%/.npmrcsu 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=trueIl 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/cliOppure con Yarn:
yarn global add @axe-devtools/cliTestate la vostra installazione
axe --helpSe appare il testo di aiuto, la CLI è installata ed è pronta all'uso.
