Notas de Lançamento do Axe DevTools Mobile de 24 de Outubro de 2024
24 de outubro de 2024
O que há de Novo?
Escaneamentos em Grupo
Agora você pode visualizar e analisar os resultados de um grupo de verificações em conjunto, em vez de revisar verificações individualmente. Essa nova funcionalidade poderosa permite classificar e priorizar questões em várias verificações simultaneamente, agilizando seu fluxo de trabalho ao eliminar a necessidade de baixar JSON e criar relatórios HTML separados para visualizações agregadas. Confira o documentação de Escaneamentos em Grupo para mais informações.
Correções
- Várias correções para melhorar o espaçamento visual e alinhamento
- Propriedades duplicadas removidas na visualização de Inspeção
- Diversas melhorias de acessibilidade
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 estiver resolvido ou de uma solução alternativa identificada caso nenhuma esteja listada.
- O teste automatizado do Axe DevTools Mobile funciona em aplicativos nativos para iOS, Android nativo e React Native. Por favor, contate seu representante Deque para soluções de teste de acessibilidade na sua plataforma de tecnologia.
- Embora você possa obter alguns resultados de visualizações web ou PDFs renderizados, recomendamos fortemente o teste com o Axe DevTools para Web ou Axe Monitor para o teste de acessibilidade mais completo para a web.
iOS
Erro no Projeto Analyzer & Teste por ID de Pacote na versão 2.8.1
A funcionalidade de teste de um aplicativo por identificador de pacote foi interrompida na versão 2.8.1, resultando em um erro intitulado „Caminho do aplicativo alvo não especificado via configuração de teste: ...“. Atualize para a versão 2.8.2 ou para a versão mais recente para resolver o erro. Atualize para a versão mais recente dentro do projeto iOS Analyzer.
Falso Positivo: LabelInName e LabelAtFront em Aplicativos SwiftUI & Cross Platform
Algumas telas podem relatar falsos positivos com LabelInName e LabelAtFront devido a uma propriedade associatedText incorreta encontrada (#1622)
Regra de Suporte a 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 Suporte a Tipo Dinâmico. Se você estiver optado por essa regra, não será possível testá-la usando um simulador de iPhone 15 Pro. Um bug foi registrado com a Apple.
Regras contra Controles Aninhados
Ao procurar 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 da ImageView Precisa de Revisão de Resultados para Aplicativos UIKit
Em aplicativos UIKit, uma imagem sem um `accessibilityLabel` não é focalizável por tecnologia assistiva por padrão.
As propriedades que usamos para verificar focalização da Apple podem ser imprecisas quando um `accessibilityIdentifier` é definido na imagem. Devido a esse comportamento inesperado, resultados para problemas de Nome de ImageView em aplicativos UIKit serão reportados como Necessita Revisão. Um relatório de bug foi registrado com a Apple. (#1633)
Falso Positivo: Em Scroll View, Label In Name, Label at Front, e v2.11.0 Nome de Image 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 disponíveis para aqueles que precisam de texto maior, use UILargeContentViewer. (#622)
v2.11.0 Image View Name & Active Control Name
Se um UIImageView tem um `accessibilityIdentifier` definido, mas não é focalizável pelo VoiceOver, e possui controles focalizá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 pelo 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 pode ser detectado, fazendo com que essas regras falhem. (#1622)
Android
App Analyzer: 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 aplicativo Axe Analyzer, certifique-se de que esta configuração não esteja ativada. Se você optou por utilizar esse recurso para seus aprimoramentos de segurança, recomendamos deixá-lo desativado para compilações de teste interno, onde você pode utilizar 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 todas as chamadas para o 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 para Mobile, certifique-se de que as capturas de tela estejam habilitadas. Recomendamos habilitar capturas de tela em uma versão de depuração ou teste do seu aplicativo que usa dados fictícios para evitar preocupações de segurança. Confira nosso guia para habilitar capturas de tela em aplicativos Android.
Falha quando `minifiedEnabled` está definido como verdadeiro
Se minimizando sua compilação, você verá um erro com um log 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)
Builds com r8 habilitado lançam um erro
Uma build com o 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)
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 você continuar a usar as APIs Compose e encontrar um erro como `Esperado exatamente '1' nó, mas encontrados '2' nós que satisfazem: (éRaiz)` ou `Nenhuma View inicializada, você chamou AxeDevToolsCompose.setComposeTestRule()?`, por favor, consulte a API Compose setTestTag.
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 estiver utilizando inteligência artificial. Regras afetadas incluem Contraste de Cor, Texto Focável e Nome de Elemento Aninhado. (#841)
MAUI: Regra de Nome de Texto de Edição
Devido a limitações da arquitetura de aplicativos MAUI ao renderizar no ecossistema Android, a regra de Nome de Texto de Edição será exibida como Necessita de 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
Quando você estiver implementando diálogos ou modais personalizados que não estendem os controles nativos, você pode obter resultados para visualizações atrás do modal. Neste 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 corretamente com tecnologia assistiva.
Painel Web
Captura de Tela Ausente
Se a captura de tela estiver faltando na página de detalhes da verificação, seu aplicativo pode estar impedindo que capturas de tela sejam tiradas. Frequentemente, isso ocorre por motivos de segurança em seu aplicativo de produção. Considere remover essa exigência para sua compilação de teste para permitir a funcionalidade completa no Painel do Axe DevTools Mobile.
Alguns nomes de verificação Android estão sem formatação
Alguns nomes de verificação 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 versão futura, 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 dos frameworks. (#1643)

