Notas de Lançamento do axe DevTools Mobile de 31 de Janeiro de 2024
31 de Janeiro de 2024
Versões dos Componentes
- axeDevToolsXCUI v2.9.0
- axe-devtools-android v5.1.0
O que há de novo?
Android
- Adicionamos uma nova regra, Etiqueta na Frente. Esta é uma prática recomendada para WCAG 2.1 - 2.5.3 e garante que o nome acessível de um controle ativo comece com o texto visível do controle. Por exemplo, um botão com o texto visível, "Entrar", e nome acessível, "Entrar para transferir dinheiro", passaria nesta regra. Um botão com o texto visível, "Entrar", e nome acessível, "Toque aqui para entrar", não passaria nesta regra.
- Se você é um cliente de nuvem privada, agora pode usar o Mobile Analyzer para enviar varreduras para sua instância de nuvem privada. Toque em "Configurações Avançadas" na tela de login e insira seu URL de backend antes de fazer login.
iOS
- A configuração do servidor por
AccessTokenfoi descontinuada e será removida em uma versão futura do framework axeDevToolsXCUI. A configuração do servidor agora pode ser feita noAxeDevToolsobjeto. - Se você é um cliente de nuvem privada, agora pode usar o Mobile Analyzer para enviar varreduras para sua instância de nuvem privada. Insira seu URL do servidor backend no
setup.swiftarquivo.
Dashboard
- Adicionamos um novo documento de referência, O que falta testar?. Acesse este documento a partir do link de Ajuda no Dashboard para aprender o que é testado pelo axe DevTools Mobile e revisar exemplos do que precisa ser testado manualmente.
Correções de Bugs
iOS
- Ao testar aplicativos React Native, o nome da varredura agora será definido como o título da tela. Anteriormente, o nome da varredura era definido como "Nenhum título disponível" mesmo quando um título de tela estava presente.
- A busca do ID do Pacote para o Mobile Analyzer agora funcionará com URLs que contêm uma string de consulta.
Android
- Corrigido um problema de acessibilidade com um logotipo no Mobile Analyzer que estava sem uma descrição de conteúdo.
- Melhorada a etiqueta acessível para o Botão de Ação Flutuante do Mobile Analyzer. Agora ele anuncia, "Botão Axe, Toque duas vezes para escanear com o Axe Mobile Analyzer."
Dashboard
- Adicionadas etiquetas mais descritivas aos botões "Exportar" e "Compartilhar" na página de varredura para fornecer mais contexto.
Problemas Conhecidos
Se você estiver enfrentando algum dos problemas abaixo, por favor nos contate em helpdesk@deque.com ou support.deque.com. Então poderemos notificá-lo assim que for resolvido ou de uma solução alternativa identificada caso nenhuma esteja listada.
- O teste automatizado do axe DevTools Mobile é executado nas aplicações nativas iOS, Android nativo e React Native. Por favor, contacte o seu representante Deque para soluções de teste de acessibilidade na sua pilha tecnológica.
- Embora você possa obter alguns resultados de visualizações da web ou PDFs renderizados, recomendamos fortemente o teste usando axe DevTools para Web ou axe Monitor para o teste de acessibilidade mais completo para a web.
axe DevTools Mobile para iOS
Erro no Projeto do Analyzer & Teste por ID do Pacote na versão 2.8.1
A funcionalidade de teste de uma aplicação por identificador de pacote 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 versão mais recente do projeto do iOS Analyzer.
Visualizações fora da tela podem mostrar resultados para aplicativos SwiftUI testados no iOS 17
Com a versão 2.8.0 (Ver Notas de Lançamento), os resultados não são mais relatados em visualizações que não estão visíveis, incluindo fora da tela ou ocultos por outra visualização. Descobrimos que em aplicativos SwiftUI testados no iOS 17, alguns resultados ainda aparecem. (#1383)
Regras de Suporte para Tipo Dinâmico não funcionam com o simulador do iOS 15 Pro
Há um problema que afeta o simulador do iPhone 15 Pro que impede a execução das regras de Suporte para Tipo Dinâmico. Se você está inscrito nas regras de Suporte para Tipo Dinâmico, não poderá testá-las usando um simulador do iPhone 15 Pro. Um bug foi registrado na Apple.
Regras contra Controles Aninhados
Ao analisar 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 na Apple. (#1110)
Falso Positivo: Em Scroll View, ActiveControlName
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 àqueles que precisam de texto maior, use UILargeContentViewer. (#622)
ActiveControlName
Se um UIImageView tiver um `accessibilityIdentifier` configurado mas não for focável pelo VoiceOver, e houver 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 na Apple. (#1226)
Falso Negativo: Nome de Image View, Texto Focável no iOS 13 até iOS 14.8.1
Estamos trabalhando ativamente em correções para os seguintes falsos negativos e atualizaremos esta lista à medida que as correções forem lançadas.
Image View Name
Se um UIImageView tiver um `accessibilityIdentifier` configurado mas não for focável pelo VoiceOver, o ImageViewName pode relatar um falso negativo no UIImageView. Remover o `accessibilityIdentifier` resolve o problema. Um bug foi registrado na Apple. (#1226)
Focusable Text
Elementos marcados como não acessíveis podem relatar resultados inadequados devido a um bug no framework da Apple.
axe DevTools Mobile para Android
Erro ao usar Proguard
Se sua versão de debug ou teste estiver utilizando o Proguard, siga os passos para ignorar Deque nas suas configurações do Proguard.
Erro quando `minifiedEnabled` está configurado como verdadeiro
Se você está reduzindo o tamanho do seu build, verá um erro com um log indicando que um adaptador não pode ser encontrado ao tentar fazer login na biblioteca axe DevTools. Desative a redução de tamanho para seus builds de debug com axe DevTools implementado. (#729)
Builds com r8 habilitado geram um erro
Um build com r8 habilitado pode tentar reduzir o tamanho da 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)
Se você encontrar um erro semelhante a `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)`, por favor, entre em contato conosco em helpdesk@deque.com ou support.deque.com para obter assistência. Em certas condições, podem existir dois nós raiz do Compose ao mesmo tempo.
Dashboard do axe DevTools Mobile
Captura de Tela Ausente
Se a captura de tela estiver ausente na página de detalhes da verificação, seu aplicativo pode estar impedindo que capturas de tela sejam feitas. Muitas vezes isso ocorre por razões de segurança no seu aplicativo de produção. Considere remover esse requisito para o seu build de teste para permitir a funcionalidade completa no Dashboard do axe DevTools Mobile.
Alguns nomes de verificação do Android estão sem formatação
Alguns nomes de verificação 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 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 verificação a partir do painel ou de frameworks. (#1643)