Skip to content

View / XML tracking

cimka-xml tracks taps, long-presses, screens and Activity/Fragment lifecycle without any per-screen code.

implementation("com.cimka:cimka-xml:1.1.1")
Cimka.initialize(this)
CimkaXml.register()

Cimka observes touches on every Activity window and finds the deepest visible view under the finger. Each interaction records:

  • view id (resource entry name), class, text, tag and content description
  • the owning Fragment and the view hierarchy path
  • touch coordinates and the type: CLICK or LONG_PRESS

For EditText fields, the text is logged as *** when clickLogger.maskSensitiveInputs is true (the default).

  • Activities are logged on onResume using the class name without the Activity suffix — CheckoutActivity → Checkout.
  • Fragments are logged on onResume without the Fragment suffix — ProfileFragment → Profile.

activity_created, activity_resumed, activity_paused, activity_destroyed, and the matching fragment_* events (including nested child fragments).

Give important views a stable, readable label so they’re easy to find in the dashboard:

import com.xhonaldo.cimka.xml.R as CimkaR
checkoutButton.setTag(CimkaR.id.cimka_tag, "checkout_cta")

android:tag="checkout_cta" in XML also works; cimka_tag takes priority.

Never log taps on a view (for example a PIN pad):

pinPad.setTag(CimkaR.id.cimka_mask, true)