I built an on-device overlay to debug Firebase Analytics events (no cable, no logcat)

Description and use

Event Box — открытая библиотека с нативным устройственным ощерным оверлоутером для отладки событий Firebase Analytics без кабеля, logcat или Firebase DebugView. Поддерживает实时 покажет событий, проверки лищих правил Firebase, панель с возможностью перетасания и безопасную работу с kill-switch'ом. Мину

Problem

Checking analytics events on Android usually means plugging in a cable, filtering logcat, or setting up Firebase DebugView. Testers can't easily do that on their own phones, so wrong events (bad names, too many params) often get found after release.

Outcome

Event Box provides an on-device floating bubble overlay that displays Firebase Analytics events in real time with event name, number, time, and params, plus Firebase limit warnings for rule violations, a resizable pannable panel, background overlay mode, and safe-by-design features including a kill switch and timed sessions.

Workflow

• Add the Event Box library dependency via JitPack: implementation("com.github.JpOriginDev:event-box:1.3.0")
• In Application.onCreate(), enable debug mode with OGEventBoxLog.setDebugModeEnabled(BuildConfig.DEBUG).setDebugModeDurationHours(0.5).install(this)
• Enable logging with OGEventBoxLog.setEnabled(context, true) and call OGEventBoxLog.log("purchase", bundle) next to analytics calls
• Alternatively, wrap the analytics SDK once using OGEventBoxAnalytics.wrap() to avoid double logging, where the wrapper sends events to Event Box first then to your SDK

Evidence

Checking analytics events on Android usually means plugging in a cable, filtering logcat, or setting up Firebase DebugView. Testers can't easily do that on their own phones, so wrong events (bad names, too many params) often get found after release.

Source

Event Box is a small open-source library. A floating bubble sits on top of your app. Tap it and a panel shows events as they fire: number, time, name and params.

Source

implementation("com.github.JpOriginDev:event-box:1.3.0") // via JitPack

Source

OGEventBoxLog.setDebugModeEnabled(BuildConfig.DEBUG).setDebugModeDurationHours(0.5).install(this)

Source

any event that breaks a rule (event name length, param count, value length, user property limits) gets a warning icon, and tapping it shows the exact reason.

Source

The Firebase checks are best-effort and may lag behind rule changes.

Source

It is not a no-op in release builds. The panel shows event names and params on screen, which may include user data, so gate it with BuildConfig.DEBUG.

Source