Notas de Lançamento do axe DevTools Mobile em 19 de novembro de 2024

A funcionalidade de teste de um aplicativo pelo identificador do pacote foi quebrada na versão 2.8.1, resultando em um erro com o título "Caminho do aplicativo de destino não especificado via configuração de teste: ...". Atualize para 2.8.2 ou a versão mais recente para resolver o erro. Atualize para a versão mais recente no projeto iOS Analyzer.

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

Há um problema que afeta o simulador do iPhone 15 Pro que impede que a regra de Suporte a Tipos Dinâmicos seja executada. Se você optou pela regra de Suporte a Tipos Dinâmicos, não poderá testá-la usando um simulador do iPhone 15 Pro. Um bug foi registrado com a Apple.

Enquanto analisávamos 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 `accessibilityLabel` não é focável com tecnologia assistiva por padrão.
As propriedades que usamos para verificar a capacidade de foco da Apple podem ser imprecisas quando um `accessibilityIdentifier` é definido na imagem. Devido a esse comportamento inesperado, os resultados para problemas com o Nome do ImageView em aplicativos UIKit serão relatados como Precisam de Revisão. Um relatório de bug foi registrado com a Apple. (#1633)

Estamos trabalhando ativamente em correções para os seguintes falsos positivos e atualizaremos esta lista à medida que as correções forem lançadas.

In Scroll View
Pode relatar problemas para texto dentro de elementos que se comportam como banners. Para tornar esses elementos acessíveis para aqueles que precisam 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 ele tiver controles focáveis aninhados, ActiveControlName pode relatar um falso positivo no UIImageView. Remover o `accessibilityIdentifier` resolve o problema. Um bug foi registrado com 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, causando falhas nessas regras. (#1622)

Introduzido na API 31 (Android 12) está a capacidade de ocultar sobreposições não-sistema. Para utilizar o aplicativo axe Analyzer, certifique-se de que essa configuração não esteja ativada. Se você optou por utilizar este recurso por seus aprimoramentos de segurança, recomendamos deixá-lo desativado para compilações de teste internas, 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) para setHideOverlayWindows(false) nas janelas de atividades afetadas.

Para desbloquear a funcionalidade completa do axe DevTools para Mobile, certifique-se de que as capturas de tela estão habilitadas. Recomendamos ativar 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 ativar capturas de tela em aplicativos Android.

Se estiver minimizando sua build, você verá uma falha com um log de erro relatando que um adaptador não pôde ser encontrado ao tentar fazer login na biblioteca axe DevTools. Desative a minimização para seus builds de depuração com axe DevTools implementado. (#729)

Um build com r8 habilitado pode tentar minimizar a biblioteca axeDevTools resultando em um erro semelhante 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 usando as APIs Compose e encontrar um erro do tipo `Era esperado exatamente '1' nó, mas foram encontrados '2' nós que satisfazem: (isRoot)` ou `Nenhuma View inicializada, você chamou AxeDevToolsCompose.setComposeTestRule()?`, consulte API Compose setTestTag.

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

Devido a limitações da arquitetura de aplicativos MAUI ao renderizar no ecossistema Android, a regra de Nome de Texto Editável aparecerá como Necessita Revisão no painel quando uma falha for suspeitada para a versão 5.5.0 do SDK ou superior. Por favor, confirme o comportamento correto manualmente para este caso.

Ao implementar 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 eles funcionem com a tecnologia assistiva conforme desejado.

Se a captura de tela estiver ausente da página de detalhes da verificação, seu aplicativo pode estar impedindo que capturas de tela sejam tiradas. Muitas vezes, isso ocorre por razões de segurança em sua aplicação de produção. Considere remover este requisito para sua build de testes para permitir funcionalidade completa no Painel Mobile do axe DevTools.

• Android - FLAG_SECURE

Alguns nomes de varredura do Android que são definidos por padrão como 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 da varredura a partir do painel ou dos frameworks. (#1643)