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. 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.
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-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-macosTesta 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.
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.
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à.
- 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.)
- Cliccate 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.
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
- Visitate lo strumento di Configurazione dell'Accesso ai pacchetti Agora . Nessuna delle informazioni che inserite viene memorizzata o trasmessa.
- Inserite il vostro indirizzo email di Agora e il token di identità.
- Cliccate su Genera Configurazione e copiate il risultato.
- Incollate le righe copiate nel vostro
~/.npmrcfile (%USERPROFILE%/.npmrcsu 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=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.
