- Programming languages: The Android SDK supports and tracks content on any screen developed in Java or Kotlin.
- Android version: we support Android SDK API Level 19 (Android 4.4 - KitKat) and later
- React Native: See our React Native Bridge Documentation
Java versionsSection titled Java versions
This version has been compiled on Java 11 (Bytecode version 55).
Kotlin versionsSection titled Kotlin versions
Contentsquare Android SDK is always compiled with the last Kotlin version.
We use Kotlin Compatibility mode flags to be backward compatible with two previous Kotlin versions and one next version.
If you use a Kotlin version lower than the last one, you must exclude the Kotlin
stdlib from our SDK.
DependenciesSection titled Dependencies
The Contentsquare SDK has a few dependencies. We try to be up-to-date as much as possible to avoid conflict issue.
Handling conflictsSection titled Handling conflicts
We may sometimes have conflicts between your app dependencies VS SDK dependencies. In this case, you can exclude from our SDK any dependency we pull and use your version instead.
Example with excluding Section titled Example with excluding recyclerview dependency
If you have a version of the
recyclerview in your app which is older than the one we use, you can use the following to exclude it in your Gradle file.
By doing this, you skip the
swiperefreshlayout dependencies provided by our SDK.
Dependencies listSection titled Dependencies list
Known limitations and recommendationsSection titled Known limitations and recommendations
Native UI Elements are not supportedSection titled Native UI Elements are not supported
- You capture snapshots but main elements of the screen are not appearing.
- SDK does not log any gesture events when interacting with some native UI elements.
Explanation: Native UI Elements such as Bottom Sheets, Dialogs, Menus are currently not supported by the SDK.
Gestures not attached to the expected view (Layout visibility)Section titled Gestures not attached to the expected view (Layout visibility)
Symptom: In some cases, we found that gestures tracked by the SDK are not attached to the right UI element of the screen. These gestures will be attached to an invisible view.
Explanation: The reason to this is that when the SDK attaches the gesture to a UI element, it generates a path regarding the visibility of the view when traversing the view hierarchy. If a view is visible and it matches the coordinates on where the gesture was performed it will be taken into account. Most of the time, the issue is that a layout is still present in the screen even if there is no content.
Best Practice: When designing your application UI, do not let any layout stray along if is not used. If a layout that contains widgets like progress bar, remember to set its visibility to
INVISIBLE after its purpose is served.