Developer Documentation

XCUI SDK

1.36.1 - 2026-11-05

  1. Fix: Interactable Role no longer flags links that announce a link role description, and reports fewer false positives on inline links.
  2. Fix: Ignored by Assistive Technology no longer flags a button inside an accessible wrapper that has the same frame.
  3. Fix: When EvincedEngine.testCase is set, reports and scans are named after the running XCTest method, including when evAnalyze() or reportStored() is called from a helper or from tearDown. They used to take the name of the calling function. Dashboard history for these tests now groups by test name. A function: value you pass yourself is kept.
  4. Fix: When report() or reportStored() is called from setUp or tearDown, the baseline file is named after the test method. If that file doesn't exist yet, compare uses the existing file named after setUp or tearDown. Baselines saved from the test body or a helper keep their current names.
  5. Fix: Simulators are reported as virtual devices, including models the SDK doesn't recognize yet. Added device names for iPhone 17, iPhone 17 Pro, iPhone 17 Pro Max, iPhone Air, iPhone 17e, iPhone 18 Pro, iPhone 18 Pro Max, iPhone Duo, iPad Air 11-inch and 13-inch (M4), and iPad Pro 11-inch and 13-inch (M5). An unknown model shows its identifier, for example Simulator (iPhone18,9).

1.36.0 - 2026-10-26

  1. New feature: Needs Review. Issues that need manual review are tagged in HTML and CSV reports and counted separately in the HTML summary. They stay included in automation APIs by default (issues(), hasIssues(), isOk, assert(), hasNewIssues()). Use needsReviewConfig on InitOptions to choose how they are handled: .enabled (default, counted in automation APIs), .reportOnly (shown in saved reports only) or .disabled (removed from results and reports).
  2. New feature: Added Needs Review helpers and filters: Issue.isNeedsReview, needsReviewIssues() and hasNeedsReviewIssues() on reports and App Scanner results, IssueFilter().needsReview() for include and exclude filters and the needsReview parameter on BaselineIgnoreFilter and BaselineIssueFilter.
  3. New validation: Meaningful Button, an LLM-assisted cloud validation that checks whether a button's label describes what happens when it is activated. It runs together with Meaningful Heading when cloud validations are enabled with cloudValidations on InitOptions, and is available as IssueType.meaningfulButton. Its issues are marked Needs Review, so by default they count in issues() and assert(). Set needsReviewConfig.mode to .reportOnly to keep them out.
  4. Improvement: CSV reports have a new "Needs Review" column after "Severity".
  5. Improvement: Label in Name matches words more accurately, which reduces incorrect results.
  6. Improvement: Clearer error when an offline token has expired. The message now tells you to contact support@evinced.com for a new token.
  7. Fix: Added the missing conflictingTraits case to IssueType, so Conflicting Traits issues can be used in IssueFilter and BaselineIgnoreFilter, and their issue type is no longer nil.
  8. Fix: Meaningful Heading now checks headings that are followed directly by a tab bar or navigation bar, which were previously skipped.
  9. Fix: Fixed label detection regressions where far-apart captions on one line were merged into one label, and editable text views were labeled by their own text or placeholder.
  10. Fix: Ignored by Assistive Technology no longer misses buttons whose title text has the same frame as the button, so new issues may appear on such buttons.
  11. Fix: HTML and CSV reports now show Tappable Area sizes with up to two decimal places instead of rounding to whole numbers, so a target just below the minimum size no longer looks like it meets it.
  12. Fix: App Scanner no longer crashes when saving an empty app navigation graph.
  13. Stability improvements.

1.35.0 - 2026-09-01

  1. New validation: Meaningful Heading — LLM-assisted cloud validation that checks whether each heading accurately describes the content that follows it (WCAG 2.4.6). Disabled by default; enable via InitOptions.cloudValidations or per-call on report(), reportStored(), stopAnalyze(), and evReport(). Results are flagged for review as LLM-assisted findings.
  2. New validation: Conflicting Traits for iOS — flags elements whose accessibility traits contradict one another.
  3. Fix: App Scanner crawls hold up better on real apps — the UI settles before capture, and back navigation improves.
  4. Fix: App Scanner long scans are safer — lighter recovery after a crash, and the scan stops if free disk space drops below 1 GB.
  5. Fix: Reduced false positives and false negatives in the Accessible Name, Type in Label, Label in Name, Visible Labels, and Color Contrast rules.
  6. Stability improvements.

1.34.0 - 2026-08-01

  1. Feature: Introduced App Scanner for automated app accessibility scanning.
  2. Stability improvements.

1.33.0 - 2026-06-18

  1. New validation: Screen Orientation (iOS, WCAG 1.3.4) - detects apps that lock content to a single orientation. Disabled by default, see more details here.
  2. New validation: Ignored By Assistive Technology (iOS) - detects elements that are incorrectly hidden from VoiceOver and other assistive technologies.
  3. Fix: Session names in Continuous Mode incorrectly showing setUpWithError() instead of the actual test method name on the Platform.
  4. Fix: False positive in Visible Labels for SwiftUI Toggle.
  5. Fix: Missing violations for elements in WebView content and unlabeled actionable nodes.
  6. Fix: Visible Labels layout calculation for horizontal gap on iOS.
  7. Improvement: Improved Instruction in Name validation accuracy.
  8. Stability improvements.

1.32.1 - 2026-03-19

  1. Improved Label in Name, Accessible Name and Alternative Text validations.
  2. Stability improvements.

1.32.0 - 2026-02-26

  1. New: Added support for an enhanced mobile platform with a refreshed, more intuitive UI.
  2. Stability improvements.

1.31.9 - 2026-02-12

  1. Stability improvements.

1.31.8 - 2026-02-09

  1. Fixed report attachment file extensions when custom report names contain dots.
  2. Stability improvements.

1.31.7 - 2026-01-28

Release notes:

  1. New feature: configurable compliance mapping, including WCAG, EAA, and Section 508.
  2. Fix: Tappable Area issues on iOS now use pt (instead of dp) in metadata.
  3. Stability improvements.

1.31.6 - 2026-01-19

Release notes:

  1. Improved label validation accuracy.
  2. Added Flutter support.
  3. Stability improvements.

1.31.4 - 2025-11-10

Release notes:

  1. Improved Label in Name, Color Contrast and Invalid Range Values validations.
  2. Stability improvements.

1.31.3 - 2025-10-21

Release notes:

  1. Label in Name validation improvement
  2. Baseline IgnoreFilter creation ergonomics improvement
  3. Deprecated validations: Label Capitalization, Sentence-Like Label, Colliding Controls, Accessibility Not Enabled

1.31.2 - 2025-10-06

Release notes:

  1. Improved Accessible Name and Label In Name validations.
  2. Stability improvement.
  3. Initial release of ios-xcuitest-baseline-exporter (1.0.0), a Swift-based command-line tool that streamlines the extraction of baseline JSON files from Xcode .xcresult bundles into your Xcode project.

1.31.1 - 2025-09-18

Release notes:

  1. Improve elements detection for non-visible components.

1.31.0 - 2025-09-16

Release notes:

  1. Baseline Comparison Enhancements: Introduce new baseline flow, enhance IgnoreFilters capabilities, and Automate test failure logic.

1.30.0 - 2025-09-09

Release notes:

  1. Added support for React Native.
  2. Increased minimum iOS deployment target to 15.0.

1.29.0 - 2025-07-28

Release notes:

  1. Added Baseline Report Comparison: You can now compare the results of your latest accessibility scan against a predefined baseline report, making it easier to identify a11y regressions and track changes over time.
  2. Added Visible Label Validation: New validation that checks whether elements requiring user input have a visible label.
  3. Stability improvement.

1.28.0 - 2025-06-25

Release notes:

  1. Stability improvement.

1.27.0 - 2025-06-15

Release notes:

  1. Stability improvement.
  2. Upgraded the integrated WDA (WebDriverAgent) to the latest version for improved compatibility and ongoing enhancements.

1.26.4 - 2025-05-14

Release notes:

  1. Added support for filtering issues by the Overlapping Controls type.
  2. Stability improvement.

1.26.3 - 2025-04-29

Release notes:

  1. Improve Duplicate Name validation.
  2. Improve Detection of Color Contrast.
  3. Improve Detection of duplicated elements.
  4. Enhance cell-based validations.
  5. Stability improvement.

1.26.2 - 2025-03-25

Release notes:

  1. Improved stability of WebView content validations.

1.26.1 - 2025-03-10

Release notes:

  1. Stability improvement.

1.26.0 - 2025-02-04

Release notes:

  1. Added support if the Target Application is not specified in the UITest target;
  2. Stability improvement.

1.25.0 - 2025-01-27

Release notes:

  1. Added AA Validation support for Tappable area;
  2. Added Export CSV report;
  3. Stability improvement.

1.24.0 - 2024-11-19

Release notes:

  1. Added Invalid Range Values validation;
  2. Stability improvement.

1.23.2 - 2024-11-01

Release notes:

  1. Stability improvement.

1.23.1 - 2024-10-17

Release notes:

  1. Updated open source software license information;
  2. Stability improvement.

1.23.0 - 2024-10-02

Release notes:

  1. Introduced save report strategy feature;
  2. Stability improvement and bug fix.

1.22.1 - 2024-09-04

Release notes:

  1. Improved Tappable Area validation for inline links cases;
  2. Stability improvement and bug fix.

1.22.0 - 2024-08-22

Release notes:

  1. Introduced EarlGrey 2.0 support for continuous mode;
  2. Changed Tappable Area validation severity type from “Best Practice” to “Serious”;
  3. Stability improvement and bug fix.

1.21.0 - 2024-08-07

Release notes:

  1. Added no issues report as a part of public API;
  2. Fixed Accessible Name Starts with Label;
  3. Fixed hiding HTML header tags;
  4. Fixed HTML report logo for iframes.

1.20.0 - 2024-07-30

Release notes:

  1. Added Label In Name validation;
  2. Added Accessible Name Starts With Label validation;
  3. Added Conflicting Type In Label validation.

1.19.2 - 2024-07-05

Release notes:

  1. Stability improvement and bug fix.

1.19.1 - 2024-06-06

Release notes:

  1. Stability improvement and bug fix.

1.19.0 - 2024-04-30

Release notes:

  1. Added export of a list of all scanned elements that do not have accessibility issues;
  2. Stability improvement and bug fix.

1.18.3 - 2024-04-01

Release notes:

  1. Improved the color contrast validation logic.

1.18.1 - 2024-03-27

Release notes:

  1. Improved the new HTML representation;
  2. Improved the special characters validation;
  3. Stability improvement and bug fix.

1.18.0 - 2024-03-14

Release notes:

  1. Added improved HTML reports.

1.17.0 - 2024-03-06

Release notes:

  1. Added new validations - Dynamic Fonts and Text Clipped;
  2. Improved Alternative Text validation logic;
  3. Stability improvement and bug fix.

1.16.0 - 2024-02-29

Release notes:

  1. Stability improvement and bug fix.

1.15.0 - 2024-01-15

Release notes:

  1. Introduced the deduplication feature for the continuous mode.

1.14.0 - 2023-12-27

Release notes:

  1. Added uploading report feature to Evinced Platform.

1.13.0 - 2023-12-18

Release notes:

  1. Stability improvement and bug fix.

1.12.0 - 2023-10-27

Release notes:

  1. Excluded keyboard for accessibility validations;
  2. Added export of meaningful accessibility labels.

1.11.2 - 2023-09-20

Release notes:

  1. Added a new validation (instruction in name);
  2. Fixed isAccessibilityElement = false not being recognized;
  3. Stability improvement.

1.11.1 - 2023-05-30

Release notes:

  1. Fixed meaningful accessible names and meaningful alternative text logic.

1.11.0 - 2023-05-25

Release notes:

  1. Added validation criteria to JSON and HTML output reports.

1.10.0 - 2023-05-16

Release notes:

  1. Improving algorithms using OCR technology.

1.9.0 - 2023-05-05

Release notes:

  1. Add new alternative text validation support;
  2. Fixed iPadOS support issues;
  3. Fixed filter issues;
  4. Stability improvement.

1.8.0 - 2022-12-27

Release notes:

  1. Options to make report name as a function name;
  2. The reportStored() method returns a list of reports;
  3. Stability improvement and bug fix.

1.7.0 - 2022-09-16

Release notes:

  1. Ability to save screenshot into file;
  2. New functionality added for ability to trace from where report()/analyze() was called;
  3. stopAnalyze() now creates report of display in continuous mode;
  4. Stability improvement and bug fix.

1.6.0 - 2022-08-19

Release notes:

  1. Change log file is added;
  2. Color Contrast rule configuration is introduced in rule-config;
  3. Additional options to customize SDK behavior is introduced;
  4. Stability improvement and bug fix.

1.5.0 - 2022-07-23

Release notes:

  1. Customize report name.

1.4.0 - 2022-07-12

Release notes:

  1. Adding RuleConfig options to manage the ability to disable/enable a11y rules and their customization as well;
  2. API change: move screenshotOptions to InitOptions.

1.3.1 - 2022-06-28

Release notes:

  1. Stability improvement and bug fix.

1.3.0 - 2022-05-09

Release notes:

  1. Continuous Mode is introduced;
  2. Issue filtering with recursion;
  3. Added Severities and issue types enums;
  4. Drop Objective C support;
  5. Few fixes.

1.1.4 - 2022-02-08

Release notes:

  1. Stability improvement and bug fix.

1.1.3 - 2021-12-16

Release notes:

  1. Stability improvement and bug fix.

1.1.2 - 2021-11-23

Release notes:

  1. Stability improvement and bug fix.

1.1.1 - 2021-10-28

Release notes:

  1. Stability improvement and bug fix.

1.0.0 - 2021-09-12

Release notes:

  1. XCUI SDK for automated accessibility testing has been released.