Notas da versão do axe DevTools Mobile de 21 de maio de 2025

Our Color Contrast rule depends on Machine Learning to detect text, which ensures that the text being scanned is visible to users of your application. In cases where the text contained in a view is the same color as the background, our Machine Learning algorithm is unable to detect if any text is present, so the Color Contrast rule does not run on this view.

Uma configuração no iOS Analyzer 1.4.7 impede que as varreduras sejam executadas, retornando a mensagem "Teste Falhou". Para executar varreduras em um dispositivo físico, atualize para a versão mais recente do projeto iOS Analyzer.

A funcionalidade de testar um aplicativo pelo identificador de pacote foi quebrada na versão 2.8.1, resultando em um erro intitulado "Nenhum caminho de aplicativo alvo especificado via configuração de teste: ...". Atualize para a versão 2.8.2 ou a última versão para resolver o erro. Atualize para a versão mais recente dentro do projeto iOS Analyzer.

Escanear alguns aplicativos com esta versão do analyzer e SDK resultaria em um erro "Não foi possível serializar AxeResult". Atualize para a versão mais recente para resolver o erro. Atualize para a versão mais recente do projeto iOS Analyzer.Atualize para a versão mais recente do SDK iOS.

Algumas telas podem relatar falsos positivos com LabelInName e LabelAtFront devido a uma propriedade associatedText incorreta ser encontrada (#1622)

Há um problema afetando o simulador do iPhone 15 Pro que impede que a regra de Suporte ao Tipo Dinâmico seja executada. Se você optou pela regra de Suporte ao Tipo Dinâmico, não poderá testá-la usando o simulador do iPhone 15 Pro. Um bug foi reportado para a Apple.

Ao procurar uma melhoria para nossas regras, descobrimos que no XCTest, os controles aninhados não são retornados na árvore de acessibilidade. Um bug foi reportado para a Apple. (#1110)

Nos aplicativos UIKit, uma imagem sem um `accessibilityLabel` não é focável com tecnologia assistiva por padrão.
As propriedades que usamos para verificar a focabilidade da Apple podem ser imprecisas quando um `accessibilityIdentifier` é definido na imagem. Devido a este comportamento inesperado, os resultados das questões de Nome do ImageView nos aplicativos UIKit serão relatados como Necessitando de Revisão. Um relatório de bug foi feito para a Apple. (#1633)

Estamos trabalhando ativamente em correções para os seguintes falsos positivos e atualizaremos esta lista conforme as correções forem liberadas.

In Scroll View
Pode relatar problemas para texto dentro de elementos que se comportam como faixas. Para tornar esses elementos disponíveis para aqueles que necessitam de texto maior, use UILargeContentViewer. (#622)

v2.11.0 Image View Name & Active Control Name
Se um UIImageView tiver um `accessibilityIdentifier` definido mas não for focável pelo VoiceOver, e tiver controles focáveis aninhados dentro dele, o ActiveControlName pode reportar um falso positivo no UIImageView. Remover o `accessibilityIdentifier` resolve o problema. Um bug foi reportado para a Apple. (#1633)

Label In Name and Label At Front
Estas duas regras procuram o rótulo visível de um controle entre elementos próximos para ajudar a determinar o status da regra. Em algumas hierarquias de visualização, o texto próximo incorreto pode ser detectado, fazendo com que estas regras falhem. (#1622)

Nossa regra de Contraste de Cor depende de aprendizado de máquina para detectar texto, o que garante que o texto analisado seja visível para os usuários do seu aplicativo. Em casos onde o texto contido em uma visualização é da mesma cor que o fundo, nosso algoritmo de aprendizado de máquina não consegue detectar se há algum texto presente, então a regra de Contraste de Cor não é executada nessa visualização.

Aplicativos escritos em XML que utilizam o recurso de texto sugestivo podem ver falsos positivos com a regra EditTextName . O texto sugestivo não foi introduzido até o Android 8 (SDK 26). Usar este elemento em seu aplicativo XML atribuirá o texto sugestivo ao valor do campo de entrada de texto. Versões mais recentes do Android estão melhor equipadas para tornar essa experiência acessível.

Para superar este problema, nossa primeira recomendação é executar seus testes em versões mais recentes do Android. Se for importante que o aplicativo seja acessível em versões anteriores do Android, no entanto, você pode considerar evitar o uso do recurso hintText , pois não é oficialmente suportado.

Você pode ver resultados para visualizações que estão ocultas atrás de outras visualizações na tela. Estas visualizações ocultas não estão acessíveis para tecnologia assistiva, mas o axe DevTools Mobile ainda as relata como problemas.

Estamos trabalhando em uma solução para este problema complexo. Enquanto isso, se o TalkBack não puder alcançar essas visualizações, você pode desconsiderar as questões correspondentes. Elas não precisam de correção para garantir a acessibilidade.

A detecção de texto do ML Kit é necessária em muitas das regras do axe DevTools Mobile para garantir a precisão dos resultados. A biblioteca ML Kit deve ser importada automaticamente ao referenciar o axe DevTools Mobile em seus testes automatizados Espresso ou UIAutomator. Em alguns casos, no entanto, a importação automática não acontece e você verá o seguinte erro no logcat:

Axe DevTools Android: Error while running mlKit Text Detection: MlKitContext has not been initialized.

Para superar este problema, você deve importar a biblioteca ML Kit manualmente em seu projeto. No arquivo build.gradle do seu aplicativo, adicione o seguinte em dependências:

implementation 'com.google.mlkit:text-recognition:16.0.1'

A regra de Espaçamento de Alvo de Toque não está sendo executada em nenhum componente de controle deslizante escrito em Jetpack Compose. Nenhuma ação pode ser tomada no momento. No entanto, uma correção está a caminho!

No Android API 30, um dos locais onde tentamos salvar os resultados localmente apresenta um erro de permissões. O resultado ainda será salvo como um arquivo JSON, apesar deste erro ser exibido. O erro pode ser suprimido comentando o código no seguinte bloco:

def clearDirectoryTask = task('clearDirectoryTask', type: Exec, group: 'reporting') {
    executable "${android.getAdbExecutable().toString()}"
    args 'shell', 'rm', '-r', '/storage/emulated/0/Documents/AxeTestCases'
//    finalizedBy {
//        fetchAndroidFolderAxeReportsTask
//    }
}

Em alguns aplicativos híbridos e multiplataforma, podemos retornar resultados inesperados quando itens em uma visualização de rolagem estão parcialmente fora da tela. Para testar um elemento em busca de acessibilidade, certifique-se de que ele está totalmente visível na tela antes de realizar a varredura.

Introduzido com a API 31 (Android 12) está a capacidade de ocultar sobreposições não-sistema. Para utilizar o aplicativo axe Analyzer, certifique-se de que esta configuração não está ativada. Se você optou por utilizar este recurso por suas melhorias de segurança, recomendamos deixá-lo desativado para builds de teste internos onde você pode usar dados de teste com segurança e eliminar preocupações de segurança dessa forma. Note: this setting does not affect Google's accessibility scanner app as it's considered a system overlay.

Para utilizar o aplicativo axe Accessibility Analyzer, atualize quaisquer chamadas para o método setHideOverlayWindows(true) nas janelas de atividade afetadas. setHideOverlayWindows(false) Captura de Tela Ausente (Caixa Preta) no Painel

habilitar capturas de tela em apps Android. Falha quando `minifiedEnabled` está definido como true

Builds com r8 habilitado geram um erro

Mensagem de erro similar a:

Caused by: java.lang.NullPointerException: throw with null exception
at g.b.b.a$a.a(Unknown Source:1)
at g.b.b.a$a.a(Unknown Source:0)
at g.b.b.a.a(AccessToken.java:190)
    

APIs agnósticas a layout para continuar recebendo atualizações. Se você continuar usando as APIs Compose e encontrar um erro como `Esperado exatamente '1' nó, mas encontrado '2' nós que satisfazem: (isRoot)` ou `Nenhuma View inicializada, você chamou AxeDevToolsCompose.setComposeTestRule()?`, consulte API Compose setTestTag .Mensagem de log:

MAUI: Regra Nome do Texto Editável

Android Nativo: Diálogos/Modais Personalizados

Painel Web

Android - FLAG_SECURE

• Alguns nomes de varreduras Android estão sem formatação

Some Android scan names that are defaulted to the screen title will appear as the full class name including the bundle identifier. In a future release, this will be resolved so that the screen title is formatted into a more readable name. As a workaround, you can set the scan name from the dashboard or frameworks. (#1643)