Auto Capture

​

SDK Configuration

val userpilot = Userpilot(context, "<APP_TOKEN>") {
    enableScreenAutoCapture = true
    enableInteractionAutoCapture = true
    enableInteractionTextCapture = true
    enableInteractionAccessibilityLabelCapture = true
    enableInteractionValueCapture = false
    uiFramework = UiFramework.Compose // or UiFramework.View
}

​

Gradle Plugin Configuration

plugins {
    id("com.userpilot.plugin") version "<latest_version>"
}

userpilot {
    enabled.set(true)
    viewEnabled.set(true)
    composeEnabled.set(true)
    composeHierarchy {
        row.set(true)
        column.set(false)
        box.set(false)
        card.set(true)
        surface.set(true)
    }
    logging.set(false)
}

​

Android View Capture

​

View Screen Tracking

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import androidx.fragment.app.Fragment
import com.userpilot.autoCapture.view.apis.userpilotIgnoreScreen

class DetailsHostActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        userpilotIgnoreScreen = true
    }
}

class DetailsPaneFragment : Fragment() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        userpilotIgnoreScreen = true
    }
}

• Clicks and long clicks
• Clickable spans
• Dialog and bottom-sheet presentation
• Dialog button clicks
• Adapter item clicks and selections
• Text changes
• CompoundButton, SeekBar, Slider, RangeSlider, date picker, and time picker changes

​

Improving Android Autocapture

​

View Privacy Helpers

• Userpilot.redactText(view)
• Userpilot.ignoreInteractions(view)
• Userpilot.overrideTargetText(view, title)
• Userpilot.clearTargetTextOverride(view)
• Userpilot.enableCompoundButtonValueChangeCapture(compoundButton)
• Userpilot.disableCompoundButtonValueChangeCapture(compoundButton)
• Userpilot.setShouldCaptureValueOnInteractionChangeEvents(shouldCaptureValue)

android:tag="userpilotIgnoreInteractions"
android:tag="userpilotRedactText"

​

Compose Capture

• Clickable and combined-clickable taps
• Toggleable, checkbox, switch, radio button, and icon toggle changes
• Selectable items, tabs, navigation items, chips, and dropdown menu items
• Text field changes, debounced per field holder
• Slider, date picker, and time picker changes
• Dialog, alert dialog, modal bottom sheet, and exposed dropdown presentation

​

Limitations

• Material2 Compose components are intentionally not instrumented. Use Material3 — the wrappers are tuned for Material3 1.3.+ and are expected to work with Material3 1.1.0+. Apps pinned to Material3 below 1.1.0 may see missing or misbehaving Compose instrumentation. Plain foundation controls (BasicTextField via the String and TextFieldValue overloads) are covered regardless of Material version.
• Compose screen tracking is opt-in. Activities and Fragments are tracked automatically when enableScreenAutoCapture = true via the same Activity / Fragment lifecycle pipeline that View auto capture uses. Compose-driven screens require one of the explicit helpers: UserpilotComposeNavigationTracker(navController), UserpilotComposeNavigationTracker(backStack = ...), or Modifier.userpilotScreen("title") (see Compose Screen Tracking). There is no automatic route-name detection — pick one of these wrappers per nav graph or per screen.
• Custom-built Compose components are not auto-instrumented. The Gradle plugin rewrites known foundation / Material3 call sites (Modifier.clickable, Modifier.toggleable, Button, Checkbox, ModalBottomSheet, etc.). A composable that implements its own interaction handling without going through those primitives won’t be captured. Use the supported building blocks to inherit auto capture for free.

​

Compose Screen Tracking

@Composable
fun App() {
    val navController = rememberNavController()

    UserpilotComposeNavigationTracker(
        navController = navController,
        screenNameResolver = { route -> route.substringAfterLast(".") },
        screenFilter = { route -> !route.startsWith("debug") },
    )
}

sealed class Screen {
    data object Home : Screen()
    data class Product(val id: Int) : Screen()
    data object Debug : Screen()
}

@Composable
fun App() {
    val backStack = remember { mutableStateListOf<Screen>(Screen.Home) }

    UserpilotComposeNavigationTracker(
        backStack = backStack,
        screenNameResolver = { key ->
            when (key) {
                Screen.Home -> "Home"
                is Screen.Product -> "Product ${key.id}"
                Screen.Debug -> "Debug"
            }
        },
        screenFilter = { key -> key !is Screen.Debug },
    )
}

@Composable
fun ProfileScreen() {
    Column(
        modifier = Modifier
            .fillMaxSize()
            .userpilotScreen(screenTitle = "Profile"),
    ) {
        // screen content
    }
}

​

Compose Privacy Helpers

UserpilotIgnoreInteractions {
    SensitiveSettings()
}

UserpilotRedactText {
    ProfileForm()
}

UserpilotIgnoreInteractions {
    SensitiveSettings()

    UserpilotIgnoreInteractions(ignore = false) {
        // captured normally, even though the outer scope opts out
        FeedbackPrompt()
    }
}

Button(
    modifier = Modifier.userpilotIgnoreInteractions(),
    onClick = onClick,
) {
    Text("Internal action")
}

TextField(
    modifier = Modifier.userpilotRedactText(),
    value = value,
    onValueChange = onValueChange,
)

UserpilotRedactText {
    ProfileForm()
    // The job title is product copy, not PII — keep it captured.
    Text(
        text = "Senior Engineer",
        modifier = Modifier.userpilotRedactText(redact = false),
    )
}

​

Runtime Controls

Userpilot.stopAutoCapture()

// ... sensitive flow ...

Userpilot.resumeAutoCapture()