How tencent/matrix works
Matrix is a plugin-based, non-invasive APM for Android and iOS/macOS. On Android, an integrating app configures Matrix and starts monitoring plugins; they detect issues and report results. The Android tree also contains standalone APK analysis, heap-dump analysis, and native backtrace support. The graph preserves the README’s major Android capabilities, but several are represented only at their module path because their runtime wiring was not sampled; documented relationships use the README as evidence.
Main entry points: Matrix.java Matrix SDK · ApkChecker.java APK Checker · Issue.java Reported Issues · StatefulOwner.kt Lifecycle Owners
Components 22
SDK and Lifecycle
- Matrix SDK
matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/Matrix.java - Lifecycle Owners
matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/StatefulOwner.kt - Lifecycle Thread
matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/MatrixLifecycleThread.kt - Process Supervisor
matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/supervisor/ProcessSupervisor.kt - Supervisor Service
matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/supervisor/SupervisorService.kt - Process Dispatch
matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/supervisor/ProcessSubordinate.kt
Package and Heap Analysis
- APK Checker
matrix/matrix-android/matrix-apk-canary/src/main/java/com/tencent/matrix/apk/ApkChecker.java - APK Analysis Tasks
matrix/matrix-android/matrix-apk-canary/src/main/java/com/tencent/matrix/apk/model/task - APK Results
matrix/matrix-android/matrix-apk-canary/src/main/java/com/tencent/matrix/apk/model/result - Heap Dump Parser
matrix/matrix-android/matrix-hprof-analyzer/lib/parser/engine.cpp
Android Monitoring
- Resource Canary
matrix/matrix-android/matrix-resource-canary/matrix-resource-canary-android/src/main/java/com/tencent/matrix/resource - Trace Canary
matrix/matrix-android/matrix-trace-canary - SQLite Lint
matrix/matrix-android/matrix-sqlite-lint/src/core/lint_manager.cc - Battery Canary
matrix/matrix-android/matrix-battery-canary - IO Canary
matrix/matrix-android - OpenGL Leak Monitor
matrix/matrix-android/matrix-opengl-leak/src/main/java/com/tencent/matrix/openglleak/detector/OpenglIndexDetectorService.java
Native Diagnostics
- MemGuard
matrix/matrix-android/matrix-memguard/src/main/cpp/memguard/util/SignalHandler.cpp - WeChat Backtrace
matrix/matrix-android/matrix-backtrace/src/main/java/com/tencent/matrix/backtrace/WarmUpService.java
Issues and Results
- SQLite Issue Storage
matrix/matrix-android/matrix-sqlite-lint/matrix-sqlite-lint-android-sdk/src/full/java/com/tencent/sqlitelint/behaviour/persistence/IssueStorage.java - Reported Issues
matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/report/Issue.java - Plugin Listener
matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/plugin/PluginListener.java
Other components
- Integrating App
Connections 23
- Integrating App → Matrix SDK: configures
README.md - Matrix SDK → Lifecycle Owners: initializes
matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/Matrix.java - Matrix SDK → Process Supervisor: initializes
matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/Matrix.java - Matrix SDK → Plugin Listener: notifies
README.md - Lifecycle Owners → Lifecycle Thread: uses
matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/StatefulOwner.kt - Process Supervisor → Supervisor Service: starts
matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/supervisor/ProcessSupervisor.kt - Supervisor Service → Process Dispatch: dispatches
matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/supervisor/SupervisorService.kt - Integrating App → APK Checker: analyzes APK
README.md - APK Checker → APK Analysis Tasks: runs checks
- APK Checker → APK Results: produces
- Integrating App → Heap Dump Parser: analyzes heap dump
- Integrating App → Resource Canary: monitors resources
README.md - Integrating App → Trace Canary: monitors performance
README.md - Integrating App → SQLite Lint: checks SQL
README.md - SQLite Lint → SQLite Issue Storage: stores issues
- Integrating App → Battery Canary: monitors battery use
README.md - Integrating App → IO Canary: monitors file IO
README.md - Integrating App → MemGuard: checks native memory
README.md - Integrating App → WeChat Backtrace: warms backtrace
- Integrating App → OpenGL Leak Monitor: checks GL leaks
- Resource Canary → Reported Issues: reports
matrix/matrix-android/matrix-resource-canary/matrix-resource-canary-android/src/main/java/com/tencent/matrix/resource/CanaryResultService.java - SQLite Issue Storage → Reported Issues: persists
matrix/matrix-android/matrix-sqlite-lint/matrix-sqlite-lint-android-sdk/src/full/java/com/tencent/sqlitelint/behaviour/persistence/IssueStorage.java - Matrix SDK → Reported Issues: publishes