📖 Przegląd

Debug Overlay to wizualny debugger reklam wyświetlający metryki i eventy w czasie rzeczywistym. Idealny do testowania i debugowania podczas developmentu.

🚀 Instalacja

W klasie Application
class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()

        ADict.init(this, BuildConfig.DEBUG)

        // Instalacja Debug Overlay
        ADict.ADS.DebugOverlay.install(
            application = this,
            cfg = DebugOverlay.Config(
                startVisible = true,        // Czy widoczny na starcie
                startCollapsed = false,     // Czy zwinięty na starcie
                showInRelease = false,      // Czy pokazywać w release
                refreshMs = 500,            // Interwał odświeżania (ms)
                maxEventLines = 12          // Max linii eventów
            )
        )
    }
}

⚙️ Konfiguracja

ParametrTypDomyślnieOpis
startVisibleBooleantrueCzy widoczny na starcie
startCollapsedBooleanfalseCzy zwinięty na starcie
showInReleaseBooleanfalseCzy pokazywać w release build
refreshMsLong500Interwał odświeżania metryk
maxEventLinesInt12Maksymalna liczba linii eventów

🎮 Sterowanie programowe

API
// Pokaż
ADict.ADS.DebugOverlay.show()

// Ukryj
ADict.ADS.DebugOverlay.hide()

// Przełącz widoczność
ADict.ADS.DebugOverlay.toggleVisibility()

// Zwiń wszystkie sekcje
ADict.ADS.DebugOverlay.collapseAll()

// Rozwiń wszystkie sekcje
ADict.ADS.DebugOverlay.expandAll()

// Przełącz zwinięcie
ADict.ADS.DebugOverlay.toggleCollapsedAll()

📊 Co wyświetla

💡 Dobre praktyki

✅ Zalecenia:
Shake to toggle
// Użyj biblioteki ShakeDetector lub własnej implementacji
shakeDetector.setOnShakeListener {
    ADict.ADS.DebugOverlay.toggleVisibility()
}