axe DevTools Mobile January 31, 2024 Release Notes
January 31, 2024
Component Versions
- axeDevToolsXCUI v2.9.0
- axe-devtools-android v5.1.0
What's New?
Android
- We added a new rule, Label at Front. This is a best practice for WCAG 2.1 - 2.5.3 and ensures an active control's accessible name begins with the visible text of the control. For example, a button with visible text, "Log in", and accessible name, "Log in to transfer money", would pass this rule. A button with visible text, "Log in", and accessible name, "Tap here to log in", would not pass this rule.
- If you are a private cloud customer, you can now use the Mobile Analyzer to send scans to your private cloud instance. Tap "Advanced Settings" on the login screen and enter your backend URL before logging in.
iOS
- Server configuration by
AccessToken
has been deprecated and will be removed in a future version of the axeDevToolsXCUI framework. Server configuration can now be done on theAxeDevTools
object. - If you are a private cloud customer, you can now use the Mobile Analyzer to send scans to your private cloud instance. Enter your backend server URL in the
setup.swift
file.
Dashboard
- We added a new reference document, What's left to test?. Access this document from the Help link on the Dashboard to learn what’s tested by axe DevTools Mobile and review examples of what's left to test manually.
Bug Fixes
iOS
- When testing React Native apps, the scan name will now be set to the screen title. Previously, the scan name was set to "No title available" even when a screen title was present.
- The Bundle ID lookup for the Mobile Analyzer will now work with URLs that contain a query string.
Android
- Fixed an accessibility issue with a logo in the Mobile Analyzer which was missing a content description.
- Improved the accessible label for the Mobile Analyzer's Floating Action Button. It now announces, "Axe button, Double-tap to scan with Axe Mobile Analyzer."
Dashboard
- Added more descriptive labels to the "Export" and "Share" buttons on the scan page to provide more context.
Known Issues
If you're experiencing any of the below issues, please contact us at helpdesk@deque.com or support.deque.com. We will then be able to notify you once it's resolved or of an identified workaround if none is listed.
- axe DevTools Mobile automated testing runs on native iOS, native Android, and React Native applications. Please contact your Deque representative for accessibility testing solutions on your tech stack.
- While you may get some results from web views or rendered PDFs, we highly recommend testing using axe DevTools for Web or axe Monitor for the most comprehensive accessibility testing for the web.
axe DevTools Mobile for iOS
Error in Analyzer Project & Testing by Bundle ID in 2.8.1
Functionality with testing an application by bundle identifier was broken in version 2.8.1 which resulted in an error titled "No target application path specified via test configuration: ...". Update to 2.8.2 or the latest version to resolve the error. Update to the latest within the iOS Analyzer project.
Views off-screen may show results for SwiftUI apps tested in iOS 17
With version 2.8.0 (View Release Notes), results are no longer reported on views that are not visible, including off-screen or hidden by another view. We've discovered in SwiftUI applications being tested in iOS 17, some results still show. (#1383)
Supports Dynamic Type rule not working with iOS 15 Pro simulator
There is an issue affecting the iPhone 15 Pro simulator that prevents the Supports Dynamic Type rule from running. If you are opted in to the Supports Dynamic Type rule, you will not be able to test it using an iPhone 15 Pro simulator. A bug has been filed with Apple.
Rules against Nested Controls
While looking at an improvement for our rules, we found that in XCTest, nested controls are not returned in the accessibility tree. A bug has been filed with Apple. (#1110)
False Positive: In Scroll View, ActiveControlName
We are actively working on fixes for the following false positives and will update this list as fixes are released.
In Scroll View
May report issues for text within banner-behaving elements. To make these elements available to those that require larger text, use UILargeContentViewer
. (#622)
ActiveControlName
If an UIImageView has an `accessibilityIdentifier` set but is not focusable by VoiceOver, and it has focusable controls nested within it, ActiveControlName may report a false positive on the UIImageView. Removing the `accessibilityIdentifier` resolves the issue. A bug has been filed with Apple. (#1226)
False Negative: Image View Name, Focusable Text in iOS 13 through iOS 14.8.1
We are actively working on fixes for the following false negatives and will update this list as fixes are released.
Image View Name
If an UIImageView has an `accessibilityIdentifier` set but is not focusable by VoiceOver, ImageViewName may report a false negative on the UIImageView. Removing the `accessibilityIdentifier` resolves the issue. A bug has been filed with Apple. (#1226)
Focusable Text
Elements marked as non-accessibility elements may report improper results due to a bug in Apple's framework.
axe DevTools Mobile for Android
Crash when using Proguard
If your debug or test build is utilizing Proguard, follow the steps to ignore Deque in your Proguard settings.
Crash when `minifiedEnabled` is set to true
If minifying your build, you'll see a crash with an error log reporting an adapter could not be found when trying to login to the axe DevTools library. Disable minify for your debug builds with axe DevTools implemented. (#729)
Errors Compiling with Java8 Project and axe DevTools Android 3.1.0
Try the following 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" />
Builds with r8 enabled throw an error
A build with r8 enabled may attempt to minify the axeDevTools library resulting in an error similar to:
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.** { *; }
Error message similar to:
Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)
If you encounter an error along the lines of `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)`, please contact us at helpdesk@deque.com or support.deque.com for assistance. Under certain conditions, there may be two Compose root nodes existing at the same time.
axe DevTools Mobile Dashboard
Missing Screenshot
If the screenshot is missing from the scan details page, your app may be preventing screenshots from being taken. Often this is for security reasons in your production application. Consider removing this requirement for your testing build to allow for full functionality in the axe DevTools Mobile Dashboard.
Some Android scan names are unformatted
Some Android scan names that are defaulted to the screen title will appear as the full class name including the bundle identifier. In a future release, this will be resolved so that the screen title is formatted into a more readable name. As a workaround, you can set the scan name from the dashboard or frameworks. (#1643)