Notas de Lançamento do axe DevTools Mobile de 28 de outubro de 2024

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

28 de outubro de 2024

Not for use with personal data

Versões dos Componentes

  • SDK iOS (axeDevToolsXCUI v2.12.6)
  • Analisador iOS (axe-devtools-mobile-analyzer v1.4.4)
  • Driver iOS Appium (axe-appium-xcuitest-driver v1.0.1)

Como atualizar: SDK iOS, Analisador iOS, Driver iOS Appium

Correções

  • O appium driver axexcuitest open-wda comando agora funciona corretamente para ajudar na configuração de dispositivo real para o driver Appium XCUITest
  • Corrigido um problema que fazia o Suporte ao Tipo Dinâmico não funcionar corretamente no iOS 18
  • Melhorias em todas as regras para reduzir o número de resultados enviados para Revisão Necessária
  • Propriedades de Contraste de Cor simplificadas para melhorar a precisão
  • Melhorada a detecção de elementos fora da tela para SwiftUI

Problemas Conhecidos

Se você estiver enfrentando algum dos problemas abaixo, entre em contato conosco em helpdesk@deque.com ou support.deque.com. Assim, poderemos notificá-lo assim que for resolvido ou de uma solução alternativa identificada, caso nenhuma seja listada.

important
  • Testes automatizados do axe DevTools Mobile operam em aplicativos nativos iOS, Android nativo e React Native. Entre em contato com seu representante Deque para soluções de teste de acessibilidade no seu stack tecnológico.
  • Enquanto você pode obter alguns resultados de visualizações web ou PDFs renderizados, recomendamos fortemente o uso do axe DevTools para Web ou axe Monitor para os testes de acessibilidade mais abrangentes para a web.

iOS

Erro no Projeto do Analisador & Teste por ID do Bundle na 2.8.1

A funcionalidade de teste de um aplicativo 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 2.8.2 ou a última versão para resolver o erro. Atualize para a última versão dentro do projeto do Analisador iOS.

Falso Positivo: LabelInName e LabelAtFront em SwiftUI & Apps Multiplataforma

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

Regra de Suporte ao Tipo Dinâmico não funciona com o simulador iOS 15 Pro

Há um problema que afeta o simulador do iPhone 15 Pro que impede a execução da regra de Suporte ao Tipo Dinâmico. Se você estiver optado pela regra de Suporte ao Tipo Dinâmico, não poderá testá-la usando um simulador do iPhone 15 Pro. Um bug foi registrado com a Apple.

Regras contra Controles Aninhados

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

Resultados de Revisão Necessária por Regra de Nome de ImageView para Apps UIKit

Em aplicativos UIKit, uma imagem sem um `accessibilityLabel` não é focável por 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 Necessitando de Revisão. Um relatório de bug foi registrado com a Apple. (#1633)

Falso Positivo: No Scroll View, Label In Name, Label at Front, e Nome do Image View & ActiveControlName v2.11.0

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

In Scroll View
Pode relatar problemas para texto dentro de elementos com comportamento de banner. Para tornar esses elementos disponíveis a quem requer texto maior, use UILargeContentViewer. (#622)

v2.11.0 Image View Name & Active Control Name
Se um UIImageView tiver um `accessibilityIdentifier` configurado mas não for focável por VoiceOver, e tiver controles focáveis aninhados dentro dele, o 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 a etiqueta visível de um controle entre elementos próximos para ajudar a determinar o estado da regra. Em algumas hierarquias de visualização, o texto próximo incorreto pode ser detectado, fazendo com que essas regras falhem. (#1622)

Android

Aplicativo do Analisador: Botão de Ação Flutuante Desaparece

Introduzida com a API 31 (Android 12) está a capacidade de ocultar sobreposições que não são do sistema. Para utilizar o aplicativo do analisador axe, certifique-se de que essa configuração não esteja ativada. Se você optou por usar esse recurso devido aos seus aprimoramentos de segurança, recomendamos deixá-lo desativado para versõ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 qualquer chamada ao método setHideOverlayWindows(true) para setHideOverlayWindows(false) nas janelas de atividades afetadas.

Captura de Tela Ausente (Caixa Preta) no Painel de Controle

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

Falha quando `minifiedEnabled` está configurado como true

Se minimizar 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 suas builds de debug com o axe DevTools implementado. (#729)

Builds com r8 habilitado geram um erro

Uma 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)
    
To resolve this error add the following line to your ProGuard file to keep axeDevTools classes:
keep class com.deque.** { *; }

Mensagem de erro semelhante a:
Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)
ou: No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?

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

Mensagem de log:MlKitContext has not been initialized

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

MAUI: Regra Nome de Texto Editável

Devido a limitações da arquitetura do aplicativo MAUI ao renderizar no ecossistema Android, a regra Nome de Texto Editável aparecerá como Necessita Revisão 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.

Android Nativo: Diálogos / Modais Personalizados

Ao implementar diálogos ou modais personalizados que não estendem os controles nativos, você pode obter resultados para as 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 se comportem conforme desejado com a tecnologia assistiva.

Painel Web

Captura de Tela Ausente

Se a captura de tela estiver ausente na página de detalhes da varredura, seu aplicativo pode estar impedindo que capturas de tela sejam tiradas. Muitas vezes isso é por razões de segurança em sua aplicação de produção. Considere remover esta exigência para sua build de teste para permitir a funcionalidade completa no Painel do axe DevTools Mobile.

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

Alguns nomes de varreduras 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)