README.md

Datadog Integration for Jetpack Compose

Getting Started

To include the Datadog integration for Jetpack Compose in your project, add the following to your application's build.gradle file.

dependencies {
    implementation "com.datadoghq:dd-sdk-android-rum:<latest-version>"
    implementation "com.datadoghq:dd-sdk-android-compose:<latest-version>"
}

Initial Setup

1. Setup RUM monitoring, see the dedicated Datadog Android RUM Collection documentation to learn how.

Navigation for Compose support

If you are migrating your existing app to Jetpack Compose, and use fragment-based Navigation as it is recommended in the guide, continue to use useViewTrackingStrategy with the strategy which suits you best.

If you have an app with only Compose elements, you can add support of view tracking for Navigation for Compose in the following way when NavController is created:

val navController = rememberNavController().apply {
    NavigationViewTrackingEffect(navController = this, trackArguments = ..., destinationPredicate = ...)
}

You also must reject Activities or Fragments, which are hosts of Compose views during useViewTrackingStrategy setup, so that they are not counted as views. Here is an example in case of ActivityViewTrackingStrategy usage:

val configuration = RumConfiguration.Builder(applicationId = applicationId)
    .useViewTrackingStrategy(
        ActivityViewTrackingStrategy(
            trackExtras = ...,
            componentPredicate = object : ComponentPredicate<Activity> {
                override fun accept(component: Activity): Boolean {
                    return component !is MyComposeActivity
                }

                override fun getViewName(component: Activity): String? = null
            })
    )
    ...
    .build()

Action tracking

There is no automated instrumentation support for the action tracking in Jetpack Compose. However, report clicks using trackClick method using this example:

Button(
    onClick = trackClick(targetName = "Open View") { ...click logic... }
    ...
) {
    ...layout...
}

Swipe and scroll events can be reported by using TrackInteractionsEffect. Here is an example of its usage with Modifier.swipeable:

val swipeableState = rememberSwipeableState(...)
val swipeOrientation = Orientation.Horizontal

val interactionSource = remember {
    MutableInteractionSource()
}.apply {
    TrackInteractionEffect(
        targetName = "Item row",
        interactionSource = this,
        interactionType = InteractionType.Swipe(
            swipeableState,
            orientation = swipeOrientation
        ),
        attributes = mapOf("foo" to "bar")
    )
}

Box(
    modifier = Modifier
        .swipeable(
            interactionSource = interactionSource,
            state = swipeableState,
            orientation = swipeOrientation,
            ...
        )
        .offset { IntOffset(swipeableState.offset.value.roundToInt(), 0) }
) {
    ...
}

Contributing

For details on contributing, read the Contributing Guide.

License

Apache License, v2.0