Tagging Viewer

Hex.pm

This simple library lets you visualize live on-screen all the tagging that is occurring in your application.

This helps debug your tagging implementation.

Download

It’s available on Schibsted Artifactory:

dependencies {
  debugImplementation 'com.adevinta.android:taggingviewer:+'
  releaseImplementation 'com.adevinta.android:taggingviewer-no-op:+'
}

(Check for latest version in GitHub releases)

1. Register trackings

class MyCustomTracker {

  fun trackScreen(screenName: String) {
    // Fabric, Firebase, etc...
    TaggingViewer.tagScreen(screenName)
  }

  fun trackClick(clickName: String) {
    // Fabric, Firebase, etc...
    TaggingViewer.tagClick(clickName)
  }
  
  fun trackEvent(eventName: String) {
    // Fabric, Firebase, etc...
    TaggingViewer.tagEvent(eventkName)
  }
}

2. Display trackings

Whenever you want to show the tracked information enable the overlay from any Activity:

TaggingViewer.enableOverlay(context)

Alternatively, you can open a detailed screen with all tracked events and their extra information:

TaggingViewer.showDetailedActivity(context)

3. Styling

We are definitely not designers but we try our best. If you don’t feel comfortable with the proposed design you only have to override the following colors in your app to make it beautiful and show your colleagues how much sense of art you do have!

<color name="tgv_item_tracking_shadow_color">#fff</color>
<color name="tgv_item_tracking_name_background_color">#C4FFFFFF</color>
<color name="tgv_item_tracking_name_text_color">#000</color>
<color name="tgv_item_tracking_indicator_background_color">#89ffffff</color>
<color name="tgv_item_separator_tracking_name_background_color">#89000000</color>
<color name="tgv_view_background_color">#00000000</color>
<color name="tgv_item_tracking_event_indicator_color">#FFA000</color>
<color name="tgv_item_tracking_screen_indicator_color">#303F9F</color>
<color name="tgv_item_tracking_click_indicator_color">#388E3C</color>
<color name="tgv_detail_background">#F1F1F1</color>
<color name="tgv_detail_timeline_line">#B1B1B1</color>

Remember: You just have to define the color with the same name in your app and you are done!

Contributing

If you find it useful and need more features or want to improve it, feel free to send a PR!

GitHub

View Github