Perguntas Frequentes

Android

Analisador Móvel

Teste Automatizado

Oferecemos compilações offline de nossos SDKs e drivers Appium para seu pipeline de automação que não requerem nenhuma solicitação de rede ao serviço Axe DevTools Mobile. Assim sendo, essas configurações de compilação estão disponíveis apenas através de Artifactory da Deque.

Observe que esta compilação é um subconjunto de funcionalidades dentro do Axe DevTools Mobile para Android. Para usar o conjunto completo de funcionalidades, incluindo o envio de resultados para o painel, utilize nossos SDKs ou drivers Appium padrão. Consulte o guia de introdução.

Setup

Ao navegar pela documentação, observe que nem todos os recursos que requerem interação com o servidor estão disponíveis na build offline.

Configuração para Teste

No arquivo applicationde build.gradle , adicione:

android {
    packagingOptions {
        exclude 'META-INF/DEPENDENCIES'
        exclude 'META-INF/AL2.0' 
        exclude 'META-INF/LGPL2.1'
    }
}

Certifique-se de que há permissão para Internet no AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />

Note que o

Observe que o axe.loginWithUsername(...) e o axe.loginWithApiKey(...) não estão disponíveis nesta versão da biblioteca e devem ser removidos do código de configuração se você estiver convertendo do uso da versão autenticada.

Resultados

@RunWith(AndroidJUnit4::class)
class ExampleInstrumentedTest {
    @Rule    
    @JvmField    
    var rule: ActivityScenarioRule<MainActivity> = ActivityScenarioRule(MainActivity::class.java)

    companion object {
        private val axe = AxeDevTools()
        init {
            axe.setOfflineLicenseKey("deque_provided_license_key_here")
        }
        axe.setInstrumenation(InstrumentationRegistry.getInstrumentation())
    }

    @Test    
    fun exampleTest() {
        onView(withText("Example Button Name")).perform(click())
    }

    @After    
    fun runAccessibilityScan() {
        val scan = axe.scan()
        val result = scan?.getSerializedResult()

        axe.tearDown()   
    }
}

Resultados

iOS

Analisador Móvel

Correção Rápida

1. Abra o Xcode → Vá para Xcode > Settings (ou Preferences em versões mais antigas)
2. Selecione a guia Accounts
3. Selecione seu Apple ID
4. Clique em Manage Certificates
5. Encontre o certificado expirado (terá um ícone de aviso)
6. Selecione o certificado expirado e clique no botão de menos (−) para removê-lo
7. Clique no botão de mais (+) e selecione Apple Development para criar um novo certificado
8. Feche o aplicativo Mobile Analyzer
9. Inicialize o aplicativo novamente. Consulte Testar Apps iOS para Acessibilidade se necessário

Ainda está recebendo um erro?

Às vezes, o Xcode armazena em cache o certificado antigo. Tente o seguinte:

1. Revogue o certificado na sua conta de Desenvolvedor Apple:
   • Vá para developer.apple.com
   • Navegue até Certificates, Identifiers & Profiles
   • Encontre o certificado expirado e revogue-o
   • Volte para o Xcode e repita os passos acima para criar um novo
2. Limpe os dados derivados:
   • Em Xcode: Window > Organizer > Projects guia
   • Selecione seu projeto e clique em Delete próximo a Derived Data
3. Reinicie o Xcode após fazer essas mudanças

1. Obtenha o UDID (Identificador Único do Dispositivo) do seu dispositivo:
   • Conecte seu iPhone ao seu Mac
   • Abra o Finder (macOS Catalina ou posterior) ou iTunes (em versões mais antigas)
   • Selecione seu dispositivo e clique no número de série até que ele exiba o UDID
   • Clique com o botão direito e copie o UDID
   • Alternativamente, você pode abrir o Xcode: Window > Devices and Simulators, selecione seu dispositivo e copie o identificador
2. Adicione o dispositivo à sua conta de Desenvolvedor:
   • Vá para developer.apple.com e faça login
   • Navegue até Certificates, Identifiers & Profiles
   • Selecione Devices na barra lateral
   • Clique no símbolo de mais (+) para registrar um novo dispositivo
   • Digite um nome para o seu dispositivo e cole o UDID
   • Clique em Continue e depois em Register
3. Reinicie o Mobile Analyzer:
   • Feche o aplicativo Mobile Analyzer
   • Abra o aplicativo novamente. Consulte Testar Apps iOS para Acessibilidade se necessário

Lembre-se de que contas gratuitas de Desenvolvedor Apple podem registrar até 3 dispositivos, enquanto contas pagas podem registrar até 100 dispositivos por tipo de dispositivo (100 iPhones, 100 iPads, etc.).

Teste Automatizado

Oferecemos compilações offline de nossos SDKs e drivers Appium para seu pipeline de automação que não requerem nenhuma solicitação de rede para o serviço Axe DevTools Mobile. Como tal, essas configurações de compilação estão disponíveis apenas através de Artifactory da Deque.

Observe que esta compilação é um subconjunto de capacidades dentro do axeDevToolsXCUI. Para usar o conjunto completo de capacidades, incluindo enviar resultados para o painel, use nosso framework axeDevToolsXCUI. Consulte o guia de configuração.

Configuração

1. Importe o framework em qualquer arquivo usado para testes de acessibilidade.

import axeDevToolsXCUI_noauth

2. Crie um objeto dentro da sua classe de teste para manter a instância do Axe DevTools:

var axeDevTools: AxeDevTools?

3. Inicialize o framework dentro dos métodos setUp ou setUpWithError.

axeDevTools = AxeDevTools.startScanSession()

Exemplo Completo de Configuração

import axeDevToolsXCUI_noauth
import XCTest

class MyUITests: XCTestCase {

    var axeDevTools: AxeDevTools?

    override func setUpWithError() throws {
        axeDevTools = AxeDevTools.loginWithLicenseKey("deque_provided_license_key_here") // does this change??
    }
    ...
}

Testes de UI

Para começar os testes, passe qualquer XCUIElement para o framework para executar testes de acessibilidade contra ele e seus filhos.

let result = try axeDevTools.run(onElement: XCUIApplication())

Exemplo Completo

import XCTest
import axeDevToolsXCUI_noauth

final class XCUI_noAuthUITest: XCTestCase {
    var axeDevTools: AxeDevTools = AxeDevTools.startScanSession()

    override func setUpWithError() throws {
        continueAfterFailure = false
    }

    func testExample() throws {
        let app = XCUIApplication()
        app.launch()

        let result = try axeDevTools.run(onElement: app)
        // Do something with the result
    }
}

O que vem a seguir?

Nós fornecemos os dados e ferramentas para criar um fluxo de trabalho CI/CD que ajuda sua equipe. Aqui estão algumas sugestões sobre o que fazer com esse objeto de resultado:

1. Falhe a compilação se falhas forem encontradas. Se você tiver uma tela que já foi limpa de problemas de acessibilidade, talvez queira garantir que nenhum novo problema surja no ciclo de desenvolvimento, verificando se a contagem é 0, e falhando a verificação de status do pull-request se não for.

// Add an assertion to fail the build if issues were found
XCTAssertTrue(result.failures.count > 0)

2. Salve os resultados localmente para criar um relatório detalhado dos problemas encontrados no ramo. Confira como criar um relatório com o nosso CLI de Relatórios para pipelines CICD. Isso pode ser realmente útil para ramos de versões candidatas a lançamento ou beta para trazer consciência sobre os possíveis obstáculos que clientes usando tecnologia assistiva podem enfrentar.

Resultados

Procurando por seu ID de Projeto? Você pode acessá-lo na página principal de Projetos em Axe Developer Hub.

• Vá para 'Configurações' do seu projeto e selecione 'Configurar Projeto'.
• Em 'Detalhes do Projeto', você pode encontrar e copiar o ID do Projeto.
• Certifique-se de ter fornecido este ID de Projeto para o startScanSession método.