Riferimento API
Informazioni sulle classi e le funzioni pubbliche della libreria.
AxeDevTools
Quando si imposta un test automatizzato, si imposta il registro di strumentazione, consentendo ad axe DevTools per Android di connettersi alle informazioni del nodo di accessibilità. Durante la creazione dei test, fare riferimento alle classi e alle funzioni pubbliche della libreria riportate di seguito.
Inizializzazione di AxeDevTools
Utilizzare le seguenti API durante l'inizializzazione della libreria AxeDevTools.
loginWithUsername(params)
Genera un token di autenticazione per connettersi alla dashboard.
Obbligatorio params
:
Nome | Tipo | Descrizione |
---|---|---|
Nome utente | String |
Deque nome utente |
password | String |
Deque password |
Facoltativo param
:
Nome | Tipo | Descrizione |
---|---|---|
Configurazione del server | String |
Definisce l'URL del server a cui connettersi. |
loginWithApiKey(param)
Genera un token di autenticazione per connettersi alla dashboard.
Obbligatorio param
:
Nome | Tipo | Descrizione |
---|---|---|
apiKey | String |
Chiave API di Deque |
Facoltativo param
:
Nome | Tipo | Descrizione |
---|---|---|
URL del server | String |
Definisce l'URL del server a cui connettersi. |
setInstrumentation(param)
Consente alla libreria di ottenere la gerarchia di visualizzazione dell'applicazione sottoposta a test.
Obbligatorio param
:
Nome | Tipo | Descrizione |
---|---|---|
strumentazione | android.app.Instrumentation |
Oggetto del registro di strumentazione che fornisce contesto applicativo e strumentazione. |
isUserAuthenticated()
Restituisce un valore booleano per indicare se l'utente è autenticato e pronto a inviare scansioni.
Restituisce:
Tipo | Descrizione |
---|---|
Booleano | Indica se un utente è autenticato per axe DevTools Mobile. |
disconnect()
Cancella la sessione di rete corrente di axe DevTools per consentire una nuova connessione.
Scansione
Dopo aver importato e inizializzato la libreria, sei pronto per la scansione. AxeDevTools
scan()
Esegue la scansione delle informazioni raccolte dall'oggetto del registro di strumentazione passato in setInstrumentation(param)
per individuare eventuali problemi e restituisce un ScanResultHandler
.
Restituisce:
Nome | Tipo | Descrizione |
---|---|---|
Gestore dei risultati di scansione | Annullabile | ScanResultHandler fornisce un modo per ottenere informazioni più dettagliate sul risultato o per aggiornare ulteriormente la scansione specificando un nome o dei tag. |
getResult(param)
Richiede il risultato di una scansione dalla dashboard corrispondente alla chiave di risultato fornita.
Obbligatorio param
:
Nome | Tipo | Descrizione |
---|---|---|
chiaveRisultatoAxeDevTools | AxeDevToolsResultKey |
L'identificatore del risultato che desideri acquisire. |
Restituisce:
Tipo | Descrizione |
---|---|
Risultato di AxeDevTools | Nullable AxeDevToolsResult fornisce l'accesso ai dettagli del risultato. |
Gestione dei risultati
Utilizzare queste API ScanResultHandler
con l'oggetto restituito da una scansione.
uploadToDashboard()
Carica il risultato della scansione di accessibilità sulla dashboard. Restituisce:
Tipo | Descrizione |
---|---|
Risultato di AxeDevTools | Nullable AxeDevToolsResult fornisce l'accesso ai dettagli del risultato. |
saveResultToLocalStorage(param)
Salva il risultato della scansione di accessibilità in un file locale sul dispositivo di prova.
Obbligatorio param
:
Nome | Tipo | Descrizione |
---|---|---|
prefissoDelNomeFile | String |
Inizio del nome del file con cui salvare il risultato. |
getSerializedResult()
Acquisisce il risultato della scansione da utilizzare nel test.
Personalizzazione della configurazione
Assegna un nome e un'etichetta alle tue scansioni, scegli di ignorare determinate regole o crea le tue regole personalizzate.
setScanName(param)
Assegna un nome alla scansione prima di caricarla sulla dashboard.
Obbligatorio param
:
Nome | Tipo | Descrizione |
---|---|---|
nome | String |
Nome per la scansione. |
addCustomRule(param)
Aggiungi una regola da eseguire sulla tua applicazione durante le scansioni.
Obbligatorio param
:
Nome | Tipo | Descrizione |
---|---|---|
customRule | Class<AxeDevToolsRule> |
Regola da aggiungere |
ignoreRules(param)
Ignora completamente le regole, impedendone l'esecuzione in qualsiasi vista.
Obbligatorio param
:
Nome | Tipo | Descrizione |
---|---|---|
regole da ignorare | List<String> |
Elenco delle regole da ignorare. |
ignoreByViewIdResourceName(params)
Parametri obbligatori:
Nome | Tipo | Descrizione |
---|---|---|
viewIdResourceName | String |
Nome ID risorsa per la vista |
Lista delle regole | List<String> |
Elenco delle regole da ignorare |
ignoreExperimental()
Rinuncia alle regole sperimentali. I risultati per le regole sperimentali avranno lo stato di AxeStatus.IGNORED
.
resetIgnoredRules()
Cancella l'elenco delle regole ignorate impostato dalle API delle regole ignorate. Utile per modificare la configurazione delle regole tra i test automatizzati.
tagScanAs(param)
Tagga una scansione prima di caricarla sulla dashboard.
Obbligatorio param
:
Nome | Tipo | Descrizione |
---|---|---|
tag | Set<String> |
Elenco dei tag da aggiungere alla scansione. |
tearDown()
Reimposta i tag e cancella lo stato del test precedente.
deleteResult(param)
Elimina dalla dashboard il risultato di una scansione corrispondente alla chiave di risultato fornita.
Obbligatorio param
:
Nome | Tipo | Descrizione |
---|---|---|
axeDevToolsResultKey | AxeDevToolsResultKey |
L'identificatore del risultato che desideri acquisire. |