ScreenNameViewer

한국어 README

A debug library that overlays the class names of the current Activity and Fragment on the screen.

Overview

ScreenNameViewer overlays class names directly on the screen, allowing you to instantly identify the currently visible Activity or Fragment.

This makes it easier to locate the corresponding code, speeding up debugging and improving development efficiency.

Features

• Real-time class name display: Shows Activity and Fragment class names on screen in real-time
• Automatic lifecycle management: Automatically tracks all Activities and Fragments at the Application level
• Debug-only: Automatically disabled in release builds for safety
• UI customization: Freely configure text size, color, position, etc.
• Memory safe: Prevents memory leaks using WeakReference
• Touch interaction: Touch overlay to show full class name in toast

Installation

Step 1: Add Jitpack repository

Add the Jitpack repository to your project's settings.gradle.kts:

dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven { url = uri("https://jitpack.io") }
}
}

Step 2: Add dependency

Add the library to your module's build.gradle.kts:

dependencies {
implementation 'com.github.DongLab-DevTools:ScreenNameViewer:latestVersion'
}

Requirements

• Android API 21 (Android 5.0) or higher

Usage

Initialize in Application class

Set up once and all Activities and Fragments will be automatically tracked:

classMyApplication : Application() {
overridefunonCreate() {
super.onCreate()
initScreenNameViewer(this) {
settings {
debugModeCondition =BuildConfig.DEBUG
enableCondition =PreferenceManager
.getDefaultSharedPreferences(this@MyApplication)
.getBoolean("debug_overlay_enabled", true)
}
config {
textStyle {
size =12f
color =Color.WHITE
}
background {
color =Color.argb(128, 0, 0, 0)
padding =16
}
position {
topMargin =64
activity =Gravity.TOPorGravity.START
fragment =Gravity.TOPorGravity.END
composeRoute =Gravity.TOPorGravity.END
}
}
}
}
}

Configuration

DSL Configuration

You can configure the library using a simple DSL (Domain Specific Language):

initScreenNameViewer(this) {
settings {
debugModeCondition =BuildConfig.DEBUG
enableCondition =PreferenceManager
.getDefaultSharedPreferences(this@MyApplication)
.getBoolean("debug_overlay_enabled", true)
}
config {
textStyle {
size =12f// Text size
color =Color.WHITE// Text color
}
background {
color =Color.argb(128, 0, 0, 0) // Background color
padding =16// Padding
}
position {
topMargin =64// Top margin
activity =Gravity.TOPorGravity.START// Activity display position
fragment =Gravity.TOPorGravity.END// Fragment display position
composeRoute =Gravity.TOPorGravity.END// Compose Route display position
}
}
}

Configuration Options

• settings: Configure activation conditions

  • debugMode: Debug mode condition
  • enabled: Overlay feature activation condition

• config: Customize overlay appearance

  • textStyle: Text size and color
  • background: Background color and padding
  • position: Margin and display positions for different components

Contributors

Donghyeon Kim

JUNWON LEE