# tencent/matrix architecture

> Architecture diagram of the GitHub repository tencent/matrix, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tencent/matrix
- Repository: https://github.com/tencent/matrix

## Overview

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/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/Matrix.java`](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/Matrix.java) (Matrix SDK), [`matrix/matrix-android/matrix-apk-canary/src/main/java/com/tencent/matrix/apk/ApkChecker.java`](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-apk-canary/src/main/java/com/tencent/matrix/apk/ApkChecker.java) (APK Checker), [`matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/report/Issue.java`](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/report/Issue.java) (Reported Issues), [`matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/StatefulOwner.kt`](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/StatefulOwner.kt) (Lifecycle Owners)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["SDK and Lifecycle"]
  node_matrix["Matrix SDK<br/>[Matrix.java]"]
  node_lifecycle["Lifecycle Owners<br/>[StatefulOwner.kt]"]
  node_lifecycle_thread["Lifecycle Thread"]
  node_supervisor["Process Supervisor"]
  node_supervisor_service["Supervisor Service"]
  node_subordinate["Process Dispatch"]
end

subgraph group_analysis["Package and Heap Analysis"]
  node_apk["APK Checker<br/>[ApkChecker.java]"]
  node_apk_tasks["APK Analysis Tasks"]
  node_apk_results["APK Results"]
  node_hprof["Heap Dump Parser<br/>[engine.cpp]"]
end

subgraph group_monitoring["Android Monitoring"]
  node_resource["Resource Canary"]
  node_trace["Trace Canary"]
  node_sqlite["SQLite Lint<br/>[lint_manager.cc]"]
  node_battery["Battery Canary"]
  node_io["IO Canary"]
  node_opengl["OpenGL Leak Monitor"]
end

subgraph group_native["Native Diagnostics"]
  node_memguard["MemGuard<br/>[SignalHandler.cpp]"]
  node_backtrace["WeChat Backtrace<br/>[WarmUpService.java]"]
end

subgraph group_reporting["Issues and Results"]
  node_sqlite_storage[("SQLite Issue Storage<br/>[IssueStorage.java]")]
  node_issue["Reported Issues<br/>[Issue.java]"]
  node_listener["Plugin Listener"]
end

node_app(("Integrating App"))

node_app -->|"configures"| node_matrix
node_matrix -->|"initializes"| node_lifecycle
node_matrix -->|"initializes"| node_supervisor
node_matrix -->|"notifies"| node_listener
node_lifecycle -.->|"uses"| node_lifecycle_thread
node_supervisor -->|"starts"| node_supervisor_service
node_supervisor_service -->|"dispatches"| node_subordinate
node_app -->|"analyzes APK"| node_apk
node_apk -.->|"runs checks"| node_apk_tasks
node_apk -.->|"produces"| node_apk_results
node_app -.->|"analyzes heap dump"| node_hprof
node_app -->|"monitors resources"| node_resource
node_app -->|"monitors performance"| node_trace
node_app -->|"checks SQL"| node_sqlite
node_sqlite -.->|"stores issues"| node_sqlite_storage
node_app -->|"monitors battery use"| node_battery
node_app -->|"monitors file IO"| node_io
node_app -->|"checks native memory"| node_memguard
node_app -.->|"warms backtrace"| node_backtrace
node_app -.->|"checks GL leaks"| node_opengl
node_resource -.->|"reports"| node_issue
node_sqlite_storage -.->|"persists"| node_issue
node_matrix -.->|"publishes"| node_issue

click node_matrix "https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/Matrix.java"
click node_lifecycle "https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/StatefulOwner.kt"
click node_lifecycle_thread "https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/MatrixLifecycleThread.kt"
click node_supervisor "https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/supervisor/ProcessSupervisor.kt"
click node_supervisor_service "https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/supervisor/SupervisorService.kt"
click node_subordinate "https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/supervisor/ProcessSubordinate.kt"
click node_apk "https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-apk-canary/src/main/java/com/tencent/matrix/apk/ApkChecker.java"
click node_apk_tasks "https://github.com/tencent/matrix/tree/master/matrix/matrix-android/matrix-apk-canary/src/main/java/com/tencent/matrix/apk/model/task"
click node_apk_results "https://github.com/tencent/matrix/tree/master/matrix/matrix-android/matrix-apk-canary/src/main/java/com/tencent/matrix/apk/model/result"
click node_hprof "https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-hprof-analyzer/lib/parser/engine.cpp"
click node_resource "https://github.com/tencent/matrix/tree/master/matrix/matrix-android/matrix-resource-canary/matrix-resource-canary-android/src/main/java/com/tencent/matrix/resource"
click node_trace "https://github.com/tencent/matrix/tree/master/matrix/matrix-android/matrix-trace-canary"
click node_sqlite "https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-sqlite-lint/src/core/lint_manager.cc"
click node_sqlite_storage "https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-sqlite-lint/matrix-sqlite-lint-android-sdk/src/full/java/com/tencent/sqlitelint/behaviour/persistence/IssueStorage.java"
click node_battery "https://github.com/tencent/matrix/tree/master/matrix/matrix-android/matrix-battery-canary"
click node_io "https://github.com/tencent/matrix/tree/master/matrix/matrix-android"
click node_memguard "https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-memguard/src/main/cpp/memguard/util/SignalHandler.cpp"
click node_backtrace "https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-backtrace/src/main/java/com/tencent/matrix/backtrace/WarmUpService.java"
click node_opengl "https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-opengl-leak/src/main/java/com/tencent/matrix/openglleak/detector/OpenglIndexDetectorService.java"
click node_issue "https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/report/Issue.java"
click node_listener "https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/plugin/PluginListener.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_matrix,node_lifecycle,node_lifecycle_thread,node_supervisor,node_supervisor_service,node_subordinate toneBlue
class node_apk,node_apk_tasks,node_apk_results,node_hprof toneAmber
class node_resource,node_trace,node_sqlite,node_battery,node_io,node_opengl toneMint
class node_memguard,node_backtrace toneRose
class node_sqlite_storage,node_issue,node_listener,node_app toneIndigo
```

## Components

### SDK and Lifecycle

- [Matrix SDK](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/Matrix.java): `matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/Matrix.java`
- [Lifecycle Owners](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/StatefulOwner.kt): `matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/StatefulOwner.kt`
- [Lifecycle Thread](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/MatrixLifecycleThread.kt): `matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/MatrixLifecycleThread.kt`
- [Process Supervisor](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/supervisor/ProcessSupervisor.kt): `matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/supervisor/ProcessSupervisor.kt`
- [Supervisor Service](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/supervisor/SupervisorService.kt): `matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/supervisor/SupervisorService.kt`
- [Process Dispatch](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/supervisor/ProcessSubordinate.kt): `matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/supervisor/ProcessSubordinate.kt`

### Package and Heap Analysis

- [APK Checker](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-apk-canary/src/main/java/com/tencent/matrix/apk/ApkChecker.java): `matrix/matrix-android/matrix-apk-canary/src/main/java/com/tencent/matrix/apk/ApkChecker.java`
- [APK Analysis Tasks](https://github.com/tencent/matrix/tree/master/matrix/matrix-android/matrix-apk-canary/src/main/java/com/tencent/matrix/apk/model/task): `matrix/matrix-android/matrix-apk-canary/src/main/java/com/tencent/matrix/apk/model/task`
- [APK Results](https://github.com/tencent/matrix/tree/master/matrix/matrix-android/matrix-apk-canary/src/main/java/com/tencent/matrix/apk/model/result): `matrix/matrix-android/matrix-apk-canary/src/main/java/com/tencent/matrix/apk/model/result`
- [Heap Dump Parser](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-hprof-analyzer/lib/parser/engine.cpp): `matrix/matrix-android/matrix-hprof-analyzer/lib/parser/engine.cpp`

### Android Monitoring

- [Resource Canary](https://github.com/tencent/matrix/tree/master/matrix/matrix-android/matrix-resource-canary/matrix-resource-canary-android/src/main/java/com/tencent/matrix/resource): `matrix/matrix-android/matrix-resource-canary/matrix-resource-canary-android/src/main/java/com/tencent/matrix/resource`
- [Trace Canary](https://github.com/tencent/matrix/tree/master/matrix/matrix-android/matrix-trace-canary): `matrix/matrix-android/matrix-trace-canary`
- [SQLite Lint](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-sqlite-lint/src/core/lint_manager.cc): `matrix/matrix-android/matrix-sqlite-lint/src/core/lint_manager.cc`
- [Battery Canary](https://github.com/tencent/matrix/tree/master/matrix/matrix-android/matrix-battery-canary): `matrix/matrix-android/matrix-battery-canary`
- [IO Canary](https://github.com/tencent/matrix/tree/master/matrix/matrix-android): `matrix/matrix-android`
- [OpenGL Leak Monitor](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-opengl-leak/src/main/java/com/tencent/matrix/openglleak/detector/OpenglIndexDetectorService.java): `matrix/matrix-android/matrix-opengl-leak/src/main/java/com/tencent/matrix/openglleak/detector/OpenglIndexDetectorService.java`

### Native Diagnostics

- [MemGuard](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-memguard/src/main/cpp/memguard/util/SignalHandler.cpp): `matrix/matrix-android/matrix-memguard/src/main/cpp/memguard/util/SignalHandler.cpp`
- [WeChat Backtrace](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-backtrace/src/main/java/com/tencent/matrix/backtrace/WarmUpService.java): `matrix/matrix-android/matrix-backtrace/src/main/java/com/tencent/matrix/backtrace/WarmUpService.java`

### Issues and Results

- [SQLite Issue Storage](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-sqlite-lint/matrix-sqlite-lint-android-sdk/src/full/java/com/tencent/sqlitelint/behaviour/persistence/IssueStorage.java): `matrix/matrix-android/matrix-sqlite-lint/matrix-sqlite-lint-android-sdk/src/full/java/com/tencent/sqlitelint/behaviour/persistence/IssueStorage.java`
- [Reported Issues](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/report/Issue.java): `matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/report/Issue.java`
- [Plugin Listener](https://github.com/tencent/matrix/blob/master/matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/plugin/PluginListener.java): `matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/plugin/PluginListener.java`

### Other components

- **Integrating App**

## Connections

- Integrating App → Matrix SDK: configures (evidence: `README.md`)
- Matrix SDK → Lifecycle Owners: initializes (evidence: `matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/Matrix.java`)
- Matrix SDK → Process Supervisor: initializes (evidence: `matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/Matrix.java`)
- Matrix SDK → Plugin Listener: notifies (evidence: `README.md`)
- Lifecycle Owners → Lifecycle Thread: uses (evidence: `matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/StatefulOwner.kt`)
- Process Supervisor → Supervisor Service: starts (evidence: `matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/supervisor/ProcessSupervisor.kt`)
- Supervisor Service → Process Dispatch: dispatches (evidence: `matrix/matrix-android/matrix-android-lib/src/main/java/com/tencent/matrix/lifecycle/supervisor/SupervisorService.kt`)
- Integrating App → APK Checker: analyzes APK (evidence: `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 (evidence: `README.md`)
- Integrating App → Trace Canary: monitors performance (evidence: `README.md`)
- Integrating App → SQLite Lint: checks SQL (evidence: `README.md`)
- SQLite Lint → SQLite Issue Storage: stores issues
- Integrating App → Battery Canary: monitors battery use (evidence: `README.md`)
- Integrating App → IO Canary: monitors file IO (evidence: `README.md`)
- Integrating App → MemGuard: checks native memory (evidence: `README.md`)
- Integrating App → WeChat Backtrace: warms backtrace
- Integrating App → OpenGL Leak Monitor: checks GL leaks
- Resource Canary → Reported Issues: reports (evidence: `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 (evidence: `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
