Repo brief: Tencent/MMKV

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T01:48:01.376Z · commit 5028f5d0467a

Verdict

Mixed — Single-maintainer risk — review before adopting

• Last commit 2w ago
• 5 active contributors
• CI configured
• Tests present

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

What it is

MMKV is an efficient, mmap-based key-value storage framework originally built by WeChat for high-performance mobile applications. It uses memory-mapped files and protobuf encoding to achieve zero-copy persistence with automatic syncing, eliminating the need for explicit sync() or apply() calls. Currently at v2.4.0, it supports Android (API 23+, 64-bit only since v2.0.0), iOS/macOS, Windows, POSIX, and HarmonyOS NEXT. Monorepo structure: Android/MMKV/mmkv/ contains the Android library with JNI bridges (src/main/cpp/native-bridge.cpp, flutter-bridge.cpp), Java wrapper (src/main/java/com/tencent/mmkv/MMKV.java), and AIDL definitions for inter-process communication…

Start here

Open these first:

• Android/MMKV/mmkv/src/main/java/com/tencent/mmkv/MMKV.java — Core entry point for MMKV API; all contributors must understand the public interface and mmap-based storage architecture
• Android/MMKV/mmkv/src/main/cpp/native-bridge.cpp — JNI bridge between Java and native C++ implementation; critical for understanding performance characteristics and…
• Android/MMKV/mmkv/CMakeLists.txt — Build configuration for native libraries; necessary for setting up the compilation pipeline and understanding native…
• Android/MMKV/mmkv/build.gradle — Android module build configuration; defines compilation target, native library integration, and artifact publishing
• Android/MMKV/build.gradle — Root-level build configuration with dependency management and version definitions shared across all modules

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.

Clone and set up Android locally: git clone https://github.com/Tencent/MMKV.git && cd Android/MMKV && ./gradlew build. For production use, add to your Android project via build.gradle: `implementation 'com.tencent:m…

Daily commands:

Android Dev Build: cd Android/MMKV && ./gradlew clean build (incremental builds with ./gradlew build). Run Tests: ./gradlew connectedAndroidTest (requires attached device/emulator). Integration: Import…

…shortened for this brief.

Key cautions & unknowns

• Single-maintainer risk — top contributor 93% of recent commits
• No 32-bit support since v2.0.0: If targeting armv7 or x86, must use v1.3.x LTS. MinSdkVersion = 23: Code assumes Android 6.0+; targeting API <23 will fail at build time. NDK requirement: C++ code requires…
• License evidence is incomplete or ambiguous.
• 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.