v5.0.2

[5.0.2] - 2024-11-28

Fixed

• An issue where ignored regions were not identified on non-scrolling screens.
• A failure of Target.window() in unit tests without a key window.

v5.0.1

[5.0.1] - 2024-11-21

Fixed

• Test names defaulted to a same name for all tests using the new eyes.test() API
• The waitBeforeCapture check setting was not applied
• Empty loading images on the first page of full-page screenshots

v5.0.0

[5.0.0] - 2024-11-19

Added

This SDK has been expanded with new capabilities, and can now take full-page screenshots from user interface objects in XCTest unit or integration tests, using:

• try await eyes.check(withTag:"my tag" andSettings: Target.window()), (1) (2) or the newer
• try await eyes.test(settings:Target.window()) convenience method, for single open-check-close operations. (3)

Additional features:

• Set ignored regions from UIView elements: Target.window.ignore([someView, someOtherView]).
• Other supported coded regions: .layout(), .strict(), .content().
• Device-independent baselines: run tests from any device (or simulator) and validate screenshots against a single baseline. (4)

Notes:
(1) The new Target.window() API performs asynchronous screenshots on the main UI thread. Invoking test functions must be annotated with @MainActor and async throws.

(2) Screenshots are full-page by default.

• To force a viewport screenshot, use Target.window().fully(false) in the check settings of a single test.
• To force viewport for all tests, set forceFullPageScreenshot = false on the Eyes Configuration object.

(3) The new Eyes.test() API method conveniently opens, checks and closes Eyes, with default names.

• App/test names and tag default to (respectively) the app bundle name, the test suite class name, and the test function name.
• To customize names, invoke Eyes.test() with optional parameters applicationName, testName and/or tag.

(4) By default, screenshots may vary according to the source device (or simulator) that runs the test. To enable device-independent baselines from any source device, normalize the baseline on a single target device size by adding a specific target device on the Eyes Configuration object. Example: configuration.addMultiDeviceTarget(IosMultiDeviceTarget.iPhone12())

Changed

• Eyes.close() now returns a TestResultsSummary object. (In version 4, this API returned a TestResult object).

v4.15.0

[4.15.0] - 2024-10-13

Changed

• Deployment target is now iOS 13

Fixed

• An issue where the clientLang parameter is always set to objc in logEvent

4.14.2

v4.14.2

4.14.1

Fix "'startInfo' is null" start session error on fractional viewport sizes

v4.14.0

[4.14.0] - 2024-05-28

Added

• APPLITOOLS_LATEST_COMMIT_INFO and APPLITOOLS_PARENT_BRANCH_BASELINE_SAVED_BEFORE variables for Eyes branch merging feature
• Log Eyes open (start session) errors to console

Fixed

• Fix zulu time formatting in batch requests
• Use en_US_POSIX locale in Eyes-Date header

4.13.1

Backward compatibility

4.13.0

visionOS

v14.2.0

New method on Eyes: closeAsync() and getAllTestResults().
getAllTestResults() also deletes batches.