axe DevTools Mobile Notas de Lançamento de 13 de dezembro de 2023
13 de dezembro de 2023
Versões dos Componentes
- axeDevToolsXCUI v2.8.2
- axe-devtools-android v5.0.0
O que há de novo?
Android
- Agora você pode adicionar tags às suas análises a partir do aplicativo Mobile Analyzer. Otimize seu processo adicionando tags antes de analisar, em vez de adicionar tags posteriormente no Mobile Dashboard.
- Para layouts do Jetpack Compose, agora reconheceremos o valor de um "onClickLabel" como a descrição de conteúdo de uma view. Isso significa que regras que exigem uma descrição de conteúdo, como Nome da Visualização Ativa, não falharão na ausência de uma descrição se um onClickLabel estiver presente.
- Mudança Impactante - Removemos o Botão de Ação Flutuante (FAB) da biblioteca Android.
- Se você estiver usando o Botão de Ação Flutuante embutido para testes manuais, continue usando a versão 4.3.0 ou inferior do axe-devtools-android, ou mude para o Mobile Analyzer para testar seu aplicativo sem incorporar nenhum código e ter acesso ao conjunto de regras mais atualizado.
- Se você estiver usando o Botão de Ação Flutuante embutido para testes automatizados com Appium, continue a usar a versão 4.3.0 ou inferior do axe-devtools-android. Em breve, lançaremos um plugin para Appium, momento em que não será mais necessário incorporar o Botão de Ação Flutuante em seu aplicativo para realizar testes com Appium.
Correções de Bugs
iOS
- Corrigido um problema onde o Mobile Analyzer estava travando ao ser usado com a versão 2.8.1 do framework XCUI.
- Corrigida a regra Label In Name para que não seja mais aplicada em views sem texto visível, como botões contendo apenas um ícone.
Android
- Corrigida uma questão de acessibilidade com um botão no Mobile Analyzer que era muito pequeno.
Painel
- Correções de acessibilidade para contraste de cores, texto sobreposto/cortado, um rótulo de grupo de caixas de seleção ausente, botões com o mesmo nome mas ações diferentes e links com o mesmo texto mas destinos diferentes.
- Agora você pode destacar e copiar o texto exibido dentro da Hierarquia de Visualização ao usar o recurso Inspecionar na página de detalhes da análise.
Problemas Conhecidos
Se você estiver enfrentando algum dos problemas abaixo, por favor, entre em contato conosco pelo helpdesk@deque.com ou support.deque.com. Assim, poderemos notificá-lo assim que for resolvido ou de uma solução alternativa identificada, se nenhuma estiver listada.
- Os testes automatizados do axe DevTools Mobile são executados em aplicativos nativos iOS, Android nativo e React Native. Por favor, entre em contato com seu representante Deque para soluções de testes de acessibilidade em sua pilha de tecnologia.
- Embora você possa obter alguns resultados de visualizações web ou PDFs renderizados, recomendamos fortemente testar usando o axe DevTools para Web ou axe Monitor para os testes de acessibilidade mais abrangentes para a web.
axe DevTools Mobile para iOS
Erro no Projeto Analyzer & Testes por ID de Pacote em 2.8.1
A funcionalidade de testar um aplicativo pelo identificador de pacote foi quebrada na versão 2.8.1, resultando em um erro intitulado “Nenhum caminho de aplicativo alvo especificado através da configuração de teste: ...“. Atualize para a versão 2.8.2 ou a mais recente para resolver o erro. Atualize para a mais recente dentro do projeto do iOS Analyzer.
Visualizações fora da tela podem mostrar resultados para apps 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 aquelas fora da tela ou ocultas por outra visualização. Descobrimos que em aplicações SwiftUI testadas no iOS 17, alguns resultados ainda são mostrados. (#1383)
A regra Suporte a Tipos Dinâmicos não funciona com o simulador iOS 15 Pro
Há um problema que afeta o simulador do iPhone 15 Pro impedindo a execução da regra Suporte a Tipos Dinâmicos. Se você estiver inscrito na regra Suporte a Tipos Dinâmicos, não poderá testá-la usando um simulador do iPhone 15 Pro. Um bug foi enviado para a Apple.
Regras contra Controles Aninhados
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 enviado para a Apple. (#1110)
Falso Positivo: Em Scroll View, NomeDoControleAtivo
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 o texto dentro de elementos que se comportam como banner. Para tornar esses elementos disponíveis para aqueles que requerem texto maior, use UILargeContentViewer. (#622)
ActiveControlName
Se uma UIImageView tiver um `accessibilityIdentifier` definido, mas não for focável pelo VoiceOver, e tiver controles focáveis aninhados dentro dela, NomeDoControleAtivo pode relatar um falso positivo na UIImageView. Remover o `accessibilityIdentifier` resolve o problema. Um bug foi enviado para a Apple. (#1226)
Falso Negativo: Nome da Visualização de Imagem, Texto Focalizável no iOS 13 até o 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 liberadas.
Image View Name
Se um UIImageView tiver um `accessibilityIdentifier` definido mas não for focalizável pelo VoiceOver, o ImageViewName pode relatar um falso negativo no UIImageView. Remover o `accessibilityIdentifier` resolve o problema. Um bug foi registrado com a Apple. (#1226)
Focusable Text
Elementos marcados como não acessíveis podem relatar resultados incorretos devido a um bug no framework da Apple.
axe DevTools Mobile para Android
Falha ao usar Proguard
Se a sua compilação de depuração ou teste estiver utilizando o Proguard, siga os passos para ignorar Deque nas suas configurações do Proguard.
Falha quando `minifiedEnabled` está definido como verdadeiro
Se você estiver minimizando sua compilação, 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 compilações de depuração com axe DevTools implementado. (#729)
Erros ao Compilar com Projeto Java8 e axe DevTools Android 3.1.0
Tente os seguintes imports:
implementation 'androidx.core:core-ktx:1.9.0' implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.6.4' implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.6.4'After importing the above library, if you see errors related to minSDK version for core-ktx library try the following in your project’s Android Manifest:
<uses-sdk tools:overrideLibrary="androidx.core" />
Compilações com r8 ativado geram um erro
Uma compilação com r8 ativado 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)
Se você encontrar um erro do tipo `Esperado exatamente '1' nó, mas foram encontrados '2' nós que satisfazem: (isRoot)`, por favor, entre em contato conosco em helpdesk@deque.com ou support.deque.com para assistência. Em certas condições, pode haver dois nós raiz do Compose existentes ao mesmo tempo.
Painel do axe DevTools Mobile
Captura de Tela Ausente
Se a captura de tela estiver faltando na página de detalhes da análise, seu aplicativo pode estar impedindo que capturas de tela sejam tiradas. Muitas vezes isso ocorre por razões de segurança em seu aplicativo de produção. Considere remover esse requisito para sua compilação de teste para permitir a plena funcionalidade no Painel do axe DevTools Mobile.
Alguns nomes de análise do Android estão sem formatação
Alguns nomes de análise 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 análise no painel ou frameworks. (#1643)