Notas de Lançamento do axe DevTools Mobile de 8 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

8 de Outubro de 2024

Not for use with personal data

Versões dos Componentes

  • Android SDK (axe-devtools-android v5.6.0)
  • Analisador Android (axe Accessibility Analyzer v1.9.0)
  • Driver Android Appium (axe-appium-uiautomator2-driver v1.1.0)

Como atualizar: Android SDK, Analisador Android Driver Android Appium

O que há de novo?

Regra de Ação Inacessível

Renomeamos Visualização Acessível Inativa para Ação Inacessível para corresponder à nomenclatura da regra para iOS. Também decidimos marcar esta regra como experimental, para que possamos melhorar a precisão dos resultados para ambas as plataformas.

Correções

  • Atualizações para melhorar o desempenho e a precisão das seguintes regras: Contraste de Cor, Tamanho do Alvo de Toque, Rótulo no Nome, Rótulo na Frente, Nome no Texto Editável e Controle Ativo Aninhado
  • Adicionado o nome da classe da visualização sobreposta aos valores analisados para a regra de Espaçamento do Alvo de Toque para ajudar na depuração
  • Descrições de resultados revisadas para serem mais descritivas e proporcionar melhores orientações sobre como corrigir problemas para as regras Ação Inacessível e Rótulo na Frente
  • Melhorada a estabilidade e a confiabilidade do serviço de acessibilidade. O aplicativo não irá mais solicitar permissões novamente cada vez que for usado
  • Otimização das solicitações de rede para o upload de resultados no painel de controle
  • Melhorado o tratamento de erros de autenticação no Driver Appium

Desativações

Após grande consideração, estamos caminhando para uma implementação simplificada do axe DevTools para Android, o que resultará na desativação futura das APIs XML e Compose. Embora esta transição não ocorra da noite para o dia, estamos incentivando os clientes a mudarem gradualmente para as APIs agnósticas de layout para continuarem a ter suporte e acesso às últimas atualizações.

Problemas Conhecidos

Se você estiver enfrentando algum dos problemas abaixo, entre em contato conosco em helpdesk@deque.com ou support.deque.com. Isso nos permitirá notificá-lo assim que for resolvido ou sobre uma solução temporária, caso não haja nenhuma listada.

important
  • O teste automatizado do axe DevTools Mobile é executado em aplicativos nativos iOS, Android nativo e React Native. Por favor, entre em contato com seu representante Deque para soluções de teste de acessibilidade em sua pilha de tecnologia.
  • Embora você possa obter alguns resultados de visualizações da web ou PDFs renderizados, recomendamos fortemente testar usando axe DevTools para Web ou axe Monitor para os testes de acessibilidade mais completos para a web.

iOS

Erro no Projeto do Analisador & Teste por ID do Pacote na versão 2.8.1

A funcionalidade de testar um aplicativo pelo identificador do pacote foi quebrada na versão 2.8.1, o que resultou em um erro intitulado „Nenhum caminho de aplicativo de destino 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 Analisador iOS.

Falso Positivo: LabelInName e LabelAtFront em SwiftUI & Aplicativos Multiplataforma

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

Regra de Suporte ao Tipo Dinâmico não funcionando com o simulador do 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 inscrito na 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

Ao buscar 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)

Regra de Nome do ImageView Precisa Revisar Resultados para Aplicativos UIKit

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, resultados de problemas de Nome do ImageView em aplicativos UIKit serão relatados como Necessita Revisão. Um relatório de bug foi arquivado com a Apple. (#1633)

Falso Positivo: Em Visualização de Rolagem, Nome no Rótulo, Rótulo na Frente, e Nome da Visualização de Imagem v2.11.0 & NomeControleAtivo

Estamos ativamente trabalhando 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 disponíveis para aqueles que requerem 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 focalizável pelo VoiceOver, e se tiver controles focalizáveis aninhados dentro dele, o ActiveControlName pode relatar um falso positivo no UIImageView. Remover o `accessibilityIdentifier` resolve o problema. Um bug foi enviado para a Apple. (#1633)

Label In Name and Label At Front
Estas duas regras procuram pelo rótulo 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, causando falhas nessas regras. (#1622)

Android

App Analisador: Botão de Ação Flutuante Desaparece

Introduzida com a API 31 (Android 12) está a capacidade de ocultar sobreposições não-sistêmicas. Para utilizar o app axe Analyzer, certifique-se de que essa configuração não esteja ativada. Se optou por utilizar esse 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 app axe Accessibility Analyzer, atualize quaisquer chamadas para o método setHideOverlayWindows(true) para setHideOverlayWindows(false) nas janelas das atividades afetadas.

Captura de Tela Ausente (Caixa Preta) no Painel

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

Falha quando `minifiedEnabled` está definido como verdadeiro

Se minificar a sua build, 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 minificação para suas builds de depuração com axe DevTools implementado. (#729)

Builds com r8 ativado geram um erro

Uma build com r8 ativado pode tentar minificar 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 independentes de layout para continuar recebendo atualizações. Se 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 View inicializada, você chamou AxeDevToolsCompose.setComposeTestRule()?`, por favor, consulte API Compose setTestTag.

Mensagem de log:MlKitContext has not been initialized

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

MAUI: Regra Nome do Texto Editável

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

Android Nativo: Diálogos / Modais Personalizados

Quando estiver implementando diálogos ou modais personalizados que não ampliam 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 funcionem com a tecnologia assistiva conforme desejado.

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 as capturas de tela sejam feitas. Frequentemente, isso ocorre por razões de segurança em sua aplicação de produção. Considere remover esse requisito para seu build de teste para permitir plena funcionalidade no Painel Mobile do axe DevTools.

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 das estruturas. (#1643)