Repo brief: markzhai/AndroidPerformanceMonitor

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T07:46:00.677Z · commit ed688391cdf9

Verdict

Mixed — Stale — last commit 3y ago

• 11 active contributors
• Apache-2.0 licensed

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

BlockCanary is a transparent UI-block (jank) detection library for Android that automatically monitors the main Looper's message processing latency and captures stack traces when frames exceed a configurable threshold (typically 16ms). It requires only one line of code to install and automatically surfaces ANR-like events via system notifications without requiring code instrumentation or manifest changes. Gradle multi-module structure: blockcanary-analyzer contains core monitoring logic (LooperMonitor, StackSampler, CpuSampler, BlockInfo), blockcanary-android wraps UI/notification delivery (not shown but inferred from README), and blockcanary-android-no-op provides a compile-time…

Start here

Open these first:

• blockcanary-analyzer/src/main/java/com/github/moduth/blockcanary/LooperMonitor.java — Core monitoring engine that hooks into Android's Looper to detect UI blocks by sampling stack traces and CPU usage
• blockcanary-analyzer/src/main/java/com/github/moduth/blockcanary/BlockCanaryInternals.java — Central orchestrator that manages initialization, lifecycle, and coordination between samplers and interceptors
• blockcanary-android/src/main/java/com/github/moduth/blockcanary/BlockCanary.java — Public API entry point for one-line initialization and configuration in production apps
• blockcanary-analyzer/src/main/java/com/github/moduth/blockcanary/BlockCanaryContext.java — Configuration interface defining sampling thresholds, white-lists, interceptors, and notification handlers
• blockcanary-analyzer/src/main/java/com/github/moduth/blockcanary/internal/BlockInfo.java — Data model encapsulating detected block event with stack traces, CPU metrics, and timing information

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/markzhai/AndroidPerformanceMonitor.git
cd AndroidPerformanceMonitor
./gradlew build

(Gradle wrapper detected; Java 7+ and Android SDK required per implicit gradle.properties).

Daily commands:

This is a library, not an app. To test: integrate into an Android project's Application.onCreate() as shown in README: BlockCanary.install(context, new AppBlockCanaryContext()).start(); then trigger main-thread blocks…

…shortened for this brief.

Key cautions & unknowns

• Stale — last commit 3y ago
• Concentrated ownership — top contributor handles 74% of recent commits
• Looper.setMessageLogging() conflict: if your app or another library already calls getMainLooper().setMessageLogging(), BlockCanary's hook will be overwritten—requires coordination (issue #27 referenced in…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.