OpenBMB/MiniCPM-V-Apps harmonyos-v2.2

HarmonyOS v2.2

Repository: OpenBMB/MiniCPM-V-Apps

Tag: harmonyos-v2.2

Published: 2026-05-25T16:49:51Z

Prerelease: no

Release notes:

MiniCPM-V Demo for HarmonyOS NEXT — v2.2

Two-step jump (v2.0 → v2.2) to re-sync HarmonyOS with iOS / Android, plus the MiniCPM5-1B download-source switch. Recommended upgrade for everyone on v2.0.

What's new (vs v2.0)

📦 MiniCPM5-1B download source switched to OpenBMB official HF / ModelScope

• Before: pre-release Huawei OBS direct link (MiniCPM5-0.9B-Q4_K_M.gguf).
• Now: races huggingface.co/openbmb/MiniCPM5-1B-GGUF and modelscope.cn/OpenBMB/MiniCPM5-1B-GGUF — same HF + MS racing as the V4.6 model.
• The user-facing model name is now MiniCPM5-1B (Q4_K_M) (was MiniCPM5 0.9B), matching the public release.
• Existing v2.0 users with a MiniCPM5-0.9B-Q4_K_M.gguf on disk will see it auto-renamed to MiniCPM5-1B-Q4_K_M.gguf; the downstream integrity check then either accepts the bytes or quietly re-downloads the canonical file (~656 MB).

🇨🇳 Runtime zh / en language switch

• Toggle between Chinese and English inside Model Management without changing the device locale.

🖼 Image decoding fix (`#11`)

• createPixelMap now uses desiredSize instead of the bugged sampleSize path on certain HarmonyOS versions, fixing photo previews that used to silently fail to decode.
• Added explicit pixelMap.release() cleanup in finally blocks to prevent the ImageSource leak under heavy use.

🚀 Launch crash fix (`#16`)

• CMakeLists.txt now writes .so outputs into the same directory hvigorw expects, so the .so.0 symlinks survive HAP packaging — fixes the immediate launch crash some users hit on v2.0.

⚡ Prefill prompt race fix (`#18`)

• sendUserPrompt state check moved inside the engine's serial queue, so user prompts sent while prefillVideoFrames is still running are queued instead of silently dropped (fixes the "second video question gets no answer" issue).

🧠 Image-slice cap & model_version knob

• Re-enabled mtmd_set_image_max_slice_nums to keep prefill latency bounded on long photos.
• MiniCPM-V-4.6 prompt template branching via the native model_version knob (same code path now on iOS / Android / HarmonyOS).

Requirements (unchanged)

• HarmonyOS NEXT, API 12 or later (e.g. nova 14 Vitality / Mate 60 / Pura 70)
• 64-bit ARM (arm64-v8a)
• ≥ 6 GB RAM recommended (≥ 8 GB for MiniCPM-V 2.6)

Install

\\\bash hdc install MiniCPM-V-demo-HarmonyOS-v2.2.hap \\\

Then open the app → Model Manager → Download (HF + MS race kicks in automatically).

Build info

• \versionName\ = \2.2\, \versionCode\ = \7\
• bundleName: \com.openbmb.minicpmv\

Verify

• MD5: \1e47d07066ed994ee6bc3229582c9a85\
• Size: ~28 MB

See DOWNLOAD.md for the full install guide.