Compatibility

A newer version of this documentation is available. Switch to the latest version docs.
  • Programming languages: The iOS SDK supports and tracks content on any screen developed in Objective-C or Swift (version >= 4.2).
  • SwiftUI: is officially supported
  • iOS version: starting with SDK 4.17.0 we support iOS 12.4 and later
    • Current Xcode supports simulators on 12.4 and later
    • ReactNative requires a minimum of iOS 12.4
    • All devices released since 2014 can updated to iOS 12.4
    • SFSafariViewController is not supported

Known limitations and recommendations

Section titled Known limitations and recommendations

Snapshot fidelity: Combining Visual Effects with Filters

Section titled Snapshot fidelity: Combining Visual Effects with Filters

Symptom: Some elements of the snapshots may not be visible, such as UITabBar buttons.

Explanation: Our capturing method prevents to capture views when Visual effects are combined with filters. Our tools captures as much as Xcode’s ‘Debug View Hierarchy’ feature. If you want to preview what is going to be rendered, you can use this feature to visualize your screen. Capturing a Snapshot of a UIVisualEffectView.

Gestures not attached to UIImageView

Section titled Gestures not attached to UIImageView

Symptom: When analysing the tap rate on an image, we see 0% when we know it is not possible.

Explanation: By default UIImageView have their isUserInteractionEnabled property set to false (See Apple documentation). This means that the UIImageView won’t receive any input event. All events will be handled by the first parent to have isUserInteractionEnabled set to true (usually the first parent will do).

Workaround: Create a zone on the parent view to get the taps on the image.

UICollectionViewCompositionalLayout TVP lack of consistency

Section titled UICollectionViewCompositionalLayout TVP lack of consistency

Explanation: As explained in the Apple documentation, UICollectionViewCompositionalLayout is a highly dynamic layout creation object. We are not able to ensure TVP value is the same between different usages.

Zoning Limitation in SwiftUI with VStack / LazyVStack

Section titled Zoning Limitation in SwiftUI with VStack / LazyVStack

The current snapshot and gesture tracking capabilities are limited in some cases when SwiftUI with VStack/LazyStack are used. Check the following Help Center article for more information about the symptom, root cause and potential mitigation solutions: I can’t create a zone on a list element on iOS (SwiftUI)