Notas de Lançamento do Axe DevTools Mobile - 20 de fevereiro de 2025

Uma configuração no iOS Analyzer 1.4.7 impede a execução dos escaneamentos, retornando a mensagem "Teste Falhou". Para executar escaneamentos em um dispositivo físico, atualize para o projeto mais recente do iOS Analyzer.

A funcionalidade com teste de uma aplicação por 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 versão mais recente para resolver o erro. Atualize para a versão mais recente dentro do projeto do iOS Analyzer.

Passar algumas aplicações 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 o projeto mais recente do iOS Analyzer.Atualize para o SDK do iOS mais recente.

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

Há um problema que afeta o simulador do iPhone 15 Pro que impede a regra de Suporte a Tipo Dinâmico de ser executada. Se você estiver inscrito na regra de Suporte a Tipo Dinâmico, não será possível testá-la usando um simulador do iPhone 15 Pro. Um bug foi registrado com a Apple.

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

Em aplicativos UIKit, uma imagem sem um `accessibilityLabel` não é focalizável com tecnologia assistiva por padrão.
As propriedades que usamos para verificar a focalização da Apple podem ser imprecisas quando um `accessibilityIdentifier` é definido na imagem. Devido a esse comportamento inesperado, os resultados para problemas de Nome de ImageView em aplicativos UIKit serão reportados como Necessário Revisar. Um relatório de erro foi enviado para a Apple. (#1633)

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

In Scroll View
Pode reportar problemas para textos dentro de elementos que se comportam como banner. Para tornar esses elementos acessíveis a quem necessita de texto maior, use UILargeContentViewer. (#622)

v2.11.0 Image View Name & Active Control Name
Se um UIImageView tem um `accessibilityIdentifier` definido, mas não é focalizável pelo VoiceOver, e possui controles focalizá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
Essas duas regras procuram pelo 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 incorreto próximo pode ser detectado, fazendo com que essas regras falhem. (#1622)

A regra de Espaçamento do Alvo de Toque atualmente não está funcionando em nenhum componente deslizante que foi escrito em Jetpack Compose. Nenhuma ação pode ser tomada no momento. No entanto, uma correção está chegando em breve!

No Android API 30, um dos locais onde tentamos salvar resultados localmente tem um erro de permissão. O resultado ainda será salvo como um arquivo JSON, apesar de esse 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 cross-platform, podemos obter resultados inesperados quando itens em uma visualização de rolagem estão parcialmente fora da tela. Para testar um elemento em termos de acessibilidade, certifique-se de que ele esteja totalmente na tela antes de realizar a varredura.

Introduzida com a API 31 (Android 12) está a capacidade de ocultar sobreposições não-sistema. Para utilizar o app Axe Analyzer, certifique-se de que esta configuração não esteja ativada. Se você optou por utilizar este recurso para melhorias de segurança, recomendamos deixá-lo desativado para versões de teste internas, onde pode utilizar 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 app Axe Accessibility Analyzer, atualize todas as chamadas para o método setHideOverlayWindows(true) para setHideOverlayWindows(false) nas janelas das atividades afetadas.

Para desbloquear toda a funcionalidade do Axe DevTools para Mobile, certifique-se de que capturas de tela estejam habilitadas. Recomendamos habilitar capturas de tela em uma versão de depuração ou teste do seu aplicativo que usa dados simulados para evitar preocupações de segurança. Confira nosso guia para habilitar capturas de tela em aplicativos Android.

Se estiver minimizando seu build, verá um crash com um log de erro informando que um adaptador não pôde ser encontrado ao tentar acessar a biblioteca do Axe DevTools. Desative a minimização para seus builds de depuração com o Axe DevTools implementado. (#729)

Um build com r8 habilitado pode tentar minimizar a biblioteca axeDevTools, resultando em um 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)
    

As APIs Compose estão obsoletas, por favor, use as APIs agnósticas de layout para continuar recebendo atualizações. Se você continuar a usar as APIs Compose e encontrar um erro como "Esperado exatamente '1' nó, mas encontrado '2' nós que satisfazem: (isRoot)" ou "Nenhuma Visualização inicializada, você chamou AxeDevToolsCompose.setComposeTestRule()?", por favor, consulte API Compose setTestTag.

Se você encontrar esta mensagem, alguns resultados de regra podem não retornar como esperado quando essa regra estiver utilizando inteligência artificial. As regras afetadas incluem Contraste de Cor, Texto Focalizável e Nome de Elemento Aninhado. (#841)

Devido a limitações da arquitetura de aplicativos MAUI ao renderizar no ecossistema Android, a regra de Nome do Texto de Edição será exibida como Necessário Revisar no painel quando uma falha for suspeitada para a versão do SDK 5.5.0 e superior. Por favor, confirme o comportamento correto manualmente para este caso.

Quando você está implementando diálogos ou modais personalizados que não estendem os controles nativos, você pode obter resultados para visualizações por trás do modal. Nesse caso, recomendamos não executar nossa ferramenta contra esses modais ou diálogos personalizados e, em vez disso, verificá-los manualmente para garantir que se comportem com a tecnologia assistiva conforme desejado.

Se a captura de tela estiver ausente na página de detalhes da verificação, seu aplicativo pode estar impedindo a captura de telas. Muitas vezes, isto é por motivos de segurança na sua aplicação de produção. Considere remover este requisito para sua versão de teste para permitir a funcionalidade completa no Painel do Axe DevTools Mobile.

• Android - FLAG_SECURE

Alguns nomes de scan do Android que são padronizados para o título da tela aparecerão como o nome completo da classe, incluindo o identificador do pacote. Em uma versão futura, isso será resolvido para que o título da tela seja formatado em um nome mais legível. Como solução alternativa, você pode definir o nome do scan a partir do painel ou das estruturas. (#1643)