Notas de Lançamento do axe DevTools Mobile de 14 de agosto de 2024

Funcionalidade com teste de uma aplicação por identificador de bundle foi quebrada na versão 2.8.1, o que resultou em um erro intitulado "Nenhum caminho de aplicação 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 última versão dentro do projeto iOS Analyzer.

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

Há um problema que afeta o simulador iPhone 15 Pro que impede a execução da regra Supports Dynamic Type. Se você estiver inscrito na regra Supports Dynamic Type, não poderá testá-la usando um simulador do iPhone 15 Pro. Um bug foi registrado com a Apple.

Ao observar 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 é 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 esse comportamento inesperado, os resultados para problemas de Nome de ImageView em aplicativos UIKit serão relatados como Necessita 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 banner. Para tornar esses elementos disponíveis para aqueles que necessitam de textos maiores, use UILargeContentViewer. (#622)

v2.11.0 Image View Name & ActiveControlName
Se uma UIImageView tiver um `accessibilityIdentifier` definido, mas não for focável pelo VoiceOver, e tiver controles focáveis aninhados, o ActiveControlName pode relatar um falso positivo na UIImageView. Remover o `accessibilityIdentifier` resolve o problema. Um bug foi registrado com a Apple. (#1633)

Label In Name and Label At Front
Essas 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 incorreto próximo pode ser detectado, fazendo com que essas regras falhem. (#1622)

Para desbloquear todas as funcionalidades do axe DevTools para Mobile, certifique-se de que as capturas de tela estejam habilitadas. Recomendamos ativar capturas de tela em uma versão de depuração ou teste do seu aplicativo que use dados simulados para evitar problemas de segurança. Confira nosso guia para habilitar capturas de tela em aplicativos Android.

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

Uma compilação 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)
    

Se você encontrar um erro do tipo `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` ou `No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?`, por favor consulte Compose setTestTag API.

Se você encontrar essa mensagem, alguns resultados de regra podem não retornar conforme o esperado quando essa regra utilizar inteligência artificial. Regras afetadas incluem Contraste de Cor, Texto Focável e Nome de Elemento Aninhado. (#841)

Devido a limitações da arquitetura de aplicativos MAUI no ecossistema Android, a regra de Nome de Texto Editável aparecerá como Necessita Revisão no painel quando uma falha for suspeita para a versão SDK 5.5.0 e 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 atrá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 como 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 é por razões de segurança em seu aplicativo de produção. Considere remover esse requisito para sua build de teste para permitir a funcionalidade completa no Painel de Controle do axe DevTools Mobile.

• Android - FLAG_SECURE

Alguns nomes de varredura 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 futura versão, 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 frameworks. (#1643)

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

Active View Name
Devido a limitações nas informações disponíveis através da plataforma Appium, identificamos um falso positivo para Nome da Visualização Ativa ao usar a labeledBy propriedade para fornecer um rótulo para um elemento de botão.

Touch Target Spacing on iOS platform for SwiftUI & React Native apps
Controles maiores podem falhar no Espaçamento de Alvo de Toque quando são maiores que o requisito mínimo de 24pt x 24pt. (#411)

Você pode ver resultados contraditórios para esta nova regra ao escanear aplicativos React Native na plataforma Android. Algumas visualizações terão um elemento de botão aninhado resultando em falha para o botão pai, mas sucesso no botão filho. (#407)

Devido a limitações nas informações disponíveis através da plataforma Appium, identificamos que as regras Etiqueta No Nome & Etiqueta Na Frente não podem ser executadas para aplicativos desenvolvidos com React Native. Estamos explorando soluções e esperamos uma correção em uma futura versão.

Às vezes, a propriedade de origem da página Appium precisa de tempo extra para ser atualizada entre as varreduras. Se isso acontecer, você verá a hierarquia de visualização da tela anterior ao usar o recurso de inspeção no painel. Para corrigir, adicione um pequeno tempo de espera antes de chamar a API de origem da página para acionar a verificação de acessibilidade. Exemplo:

            await driver.pause(1000);
            const result = await driver.getPageSource();
        

Devido a limitações nas informações disponíveis através da plataforma Appium, identificamos que a regra Nome de Visualização de Imagem não consegue testar com precisão os critérios de sucesso para imagens decorativas no Android. Resultados para imagens sem um nome acessível serão exibidos como 'Necessita Revisão' no painel para uma análise mais aprofundada.