عن المشروع

MMKV هو إطار عمل لتخزين القيم والمفاتيح على الأجهزة المحمولة، طوّره WeChat ونشرته Tencent بموجب رخصة BSD 3-Clause. يُوصف بأنه فعّال وصغير وسهل الاستخدام، ويتوفر على Android وiOS/macOS وWindows وPOSIX وHarmonyOS NEXT، مع دعم تجريبي لـ Kotlin Multiplatform يستهدف Android وiOS. التصميم الأساسي: يستخدم MMKV تقنية mmap لمزامنة الذاكرة مع الملفات، وprotobuf لتشفير وفك تشفير القيم. تُحفظ التغييرات فورًا، لذا لا حاجة لاستدعاءات sync أو apply أو save أو synchronize. يدعم الوصول المتزامن للقراءة-القراءة والقراءة-الكتابة بين العمليات. يذكر المشروع حجمًا ثنائيًا صغيرًا: حوالي 50 كيلوبايت لكل بنية على Android، وأقل من 30 كيلوبايت على iOS/macOS، وحوالي 10 كيلوبايت على Windows، وحوالي 7 كيلوبايت على POSIX، وحوالي 600 كيلوبايت على HarmonyOS NEXT، مع أحجام أصغر عند التعبئة. إعداد المنصات: يُثبَّت Android عبر Maven باستخدام التبعية com.tencent:mmkv؛ ومن الإصدار v2.0.0 لم يعد يتم دعم البنيات 32-بت ومستويات API 21-22، مع تقديم سلسلة v1.3.x كإصدار LTS لهذه الحالات. يستخدم iOS/macOS CocoaPods مع pod باسم MMKV. يُبنى Windows من المصدر باستخدام ملفات مشروع Visual Studio. يتكامل POSIX عبر CMake. يُثبَّت HarmonyOS NEXT عبر OHPM باسم @tencent/mmkv. تُضاف Kotlin Multiplatform كـ com.tencent:mmkv-kmp في تبعيات commonMain. الاستخدام: بعد تهيئة MMKV مع دليل جذر عند بدء التطبيق، يتوفر مثيل عام افتراضي. توفر الواجهة البرمجية طرق encode/set و decode/get مخصصة للأنواع bool وint32 وint64 وstring وbytes عبر المنصات المدعومة. الوصول متعدد العمليات مدعوم وموثق في دروس تعليمية خاصة بكل منصة. يحتوي README على روابط لصفحات wiki للإعداد والدروس والقياسات والأسئلة الشائعة، بالإضافة إلى سجل التغييرات ودليل المساهمة ومدونة قواعد السلوك. يذكر أن MMKV لا يحصل على معلومات شخصية أو يجمعها أو يرفعها.