MMKV

中文版本请参看这里

MMKV เป็นเฟรมเวิร์กการจัดเก็บคีย์-ค่ามือถือ ที่มีประสิทธิภาพ ขนาดเล็ก ใช้งานง่าย ซึ่งใช้ในแอปพลิเคชัน WeChat ขณะนี้มีให้บริการบน Android , iOS/macOS , Windows , POSIX และ HarmonyOS NEXT

MMKV สำหรับ Android

คุณสมบัติ

• มีประสิทธิภาพ . MMKV ใช้ mmap เพื่อให้หน่วยความจำซิงค์กับไฟล์ และใช้ protobuf เพื่อเข้ารหัส/ถอดรหัสค่า ใช้ประโยชน์จาก Android ให้เกิดประโยชน์สูงสุดเพื่อให้ได้ประสิทธิภาพที่ดีที่สุด

  • การทำงานพร้อมกันหลายกระบวนการ : MMKV รองรับการเข้าถึงแบบอ่าน-อ่านและอ่าน-เขียนระหว่างกระบวนการต่างๆ

• ง่ายต่อการใช้งาน คุณสามารถใช้ MMKV ได้ทุกที่ การเปลี่ยนแปลงทั้งหมดจะถูกบันทึกทันที ไม่ต้อง sync ไม่ต้อง apply การโทร

• เล็ก .

  • ไฟล์จำนวนหนึ่ง : MMKV มีการล็อคกระบวนการ ตัวช่วยเข้ารหัส/ถอดรหัส และตรรกะ mmap และไม่มีอะไรเพิ่มเติม มันเป็นระเบียบจริงๆ
  • ขนาดไบนารีประมาณ 50K : MMKV เพิ่มประมาณ 50K ต่อสถาปัตยกรรมในขนาดแอป และน้อยกว่ามากเมื่อบีบอัด (APK)

เริ่มต้นใช้งาน

การติดตั้งผ่าน Maven

เพิ่มบรรทัดต่อไปนี้ใน build.gradle บนโมดูลแอปของคุณ:

 dependencies {
    implementation ' com.tencent:mmkv:2.0.1 '
    // replace "2.0.1" with any available version
}

สำหรับตัวเลือกการติดตั้งอื่นๆ โปรดดูการตั้งค่า Android

บทช่วยสอนด่วน

คุณสามารถใช้ MMKV ได้ทุกที่ การเปลี่ยนแปลงทั้งหมดจะถูกบันทึกทันที ไม่ต้อง sync ไม่ต้อง apply การโทร
ตั้งค่า MMKV เมื่อเริ่มต้นแอป เช่น คลาส Application ของคุณ เพิ่มบรรทัดเหล่านี้:

 public void onCreate () {
    super . onCreate ();

    String rootDir = MMKV . initialize ( this );
    System . out . println ( "mmkv root: " + rootDir );
    //……
}

MMKV มีอินสแตนซ์ส่วนกลางที่สามารถใช้ได้โดยตรง:

 import com . tencent . mmkv . MMKV ;
    
MMKV kv = MMKV . defaultMMKV ();

kv . encode ( "bool" , true );
boolean bValue = kv . decodeBool ( "bool" );

kv . encode ( "int" , Integer . MIN_VALUE );
int iValue = kv . decodeInt ( "int" );

kv . encode ( "string" , "Hello from mmkv" );
String str = kv . decodeString ( "string" );

MMKV ยังรองรับ การเข้าถึงแบบหลายกระบวนการ สามารถดูบทช่วยสอนแบบเต็มได้ที่นี่ บทช่วยสอน Android

ผลงาน

เมื่อเขียน int แบบสุ่ม 1,000 ครั้ง เราจะได้แผนภูมินี้:

สำหรับข้อมูลการวัดประสิทธิภาพเพิ่มเติม โปรดดูที่การวัดประสิทธิภาพของเรา

MMKV สำหรับ iOS/macOS

คุณสมบัติ

• มีประสิทธิภาพ . MMKV ใช้ mmap เพื่อให้หน่วยความจำซิงค์กับไฟล์ และใช้ protobuf เพื่อเข้ารหัส/ถอดรหัสค่า ใช้ประโยชน์จาก iOS/macOS ให้เกิดประโยชน์สูงสุดเพื่อให้ได้ประสิทธิภาพที่ดีที่สุด

• ง่ายต่อการใช้งาน คุณสามารถใช้ MMKV ได้ทุกที่ ไม่จำเป็นต้องกำหนดค่าใดๆ การเปลี่ยนแปลงทั้งหมดจะถูกบันทึกทันที ไม่จำเป็นต้องซิ synchronize การโทร

• เล็ก .

  • ไฟล์จำนวนหนึ่ง : MMKV มีตัวช่วยเข้ารหัส/ถอดรหัส และตรรกะ mmap และไม่มีอะไรเพิ่มเติม มันเป็นระเบียบจริงๆ
  • ขนาดไบนารีน้อยกว่า 30K : MMKV เพิ่มน้อยกว่า 30K ต่อสถาปัตยกรรมในขนาดแอป และน้อยกว่ามากเมื่อบีบอัด (IPA)

เริ่มต้นใช้งาน

การติดตั้งผ่าน CocoaPods:

1. ติดตั้ง CocoaPods;
2. เปิดเทอร์มินัล cd ไปที่ไดเร็กทอรีโปรเจ็กต์ของคุณ รัน pod repo update เพื่อให้ CocoaPods ทราบถึงเวอร์ชัน MMKV ล่าสุดที่มีอยู่
3. แก้ไข Podfile ของคุณ เพิ่ม pod 'MMKV' ให้กับเป้าหมายแอปของคุณ
4. เรียกใช้ pod install ;
5. เปิดไฟล์ .xcworkspace ที่สร้างโดย CocoaPods
6. เพิ่ม #import <MMKV/MMKV.h> ไปยังไฟล์ต้นฉบับของคุณ เท่านี้ก็เสร็จเรียบร้อย

สำหรับตัวเลือกการติดตั้งอื่นๆ โปรดดูการตั้งค่า iOS/macOS

บทช่วยสอนด่วน

คุณสามารถใช้ MMKV ได้ทุกที่ ไม่จำเป็นต้องกำหนดค่าใดๆ การเปลี่ยนแปลงทั้งหมดจะถูกบันทึกทันที ไม่จำเป็นต้องซิ synchronize การโทร ตั้งค่า MMKV เมื่อเริ่มต้น App ใน -[MyApp application: didFinishLaunchingWithOptions:] เพิ่มบรรทัดเหล่านี้:

- ( BOOL )application:(UIApplication *)application didFinishLaunchingWithOptions:( NSDictionary *)launchOptions {
    // init MMKV in the main thread
    [MMKV initializeMMKV: nil ];

    // ...
    return YES ;
}

MMKV มีอินสแตนซ์ส่วนกลางที่สามารถใช้ได้โดยตรง:

MMKV *mmkv = [MMKV defaultMMKV ];
    
[mmkv setBool: YES forKey: @" bool " ];
BOOL bValue = [mmkv getBoolForKey: @" bool " ];
    
[mmkv setInt32: - 1024 forKey: @" int32 " ];
int32_t iValue = [mmkv getInt32ForKey: @" int32 " ];
    
[mmkv setString: @" hello, mmkv " forKey: @" string " ];
NSString *str = [mmkv getStringForKey: @" string " ];

MMKV ยังรองรับ การเข้าถึงแบบหลายกระบวนการ สามารถดูบทแนะนำแบบเต็มได้ที่นี่

ผลงาน

เมื่อเขียน int แบบสุ่ม 10,000 ครั้ง เราจะได้แผนภูมินี้:

สำหรับข้อมูลการวัดประสิทธิภาพเพิ่มเติม โปรดดูที่การวัดประสิทธิภาพของเรา

MMKV สำหรับ Windows

คุณสมบัติ

• มีประสิทธิภาพ . MMKV ใช้ mmap เพื่อให้หน่วยความจำซิงค์กับไฟล์ และใช้ protobuf เพื่อเข้ารหัส/ถอดรหัสค่า ใช้ประโยชน์จาก Windows ให้เกิดประโยชน์สูงสุดเพื่อให้ได้ประสิทธิภาพที่ดีที่สุด

  • การทำงานพร้อมกันหลายกระบวนการ : MMKV รองรับการเข้าถึงแบบอ่าน-อ่านและอ่าน-เขียนระหว่างกระบวนการต่างๆ

• ง่ายต่อการใช้งาน คุณสามารถใช้ MMKV ได้ทุกที่ การเปลี่ยนแปลงทั้งหมดจะถูกบันทึกทันที ไม่ต้อง save ไม่จำเป็นต้องทำการ sync

• เล็ก .

  • ไฟล์จำนวนหนึ่ง : MMKV มีการล็อคกระบวนการ ตัวช่วยเข้ารหัส/ถอดรหัส และตรรกะ mmap และไม่มีอะไรเพิ่มเติม มันเป็นระเบียบจริงๆ
  • ขนาดไบนารี่ประมาณ 10K : MMKV เพิ่มขนาดแอปพลิเคชันประมาณ 10K และน้อยกว่ามากเมื่อบีบอัด

เริ่มต้นใช้งาน

การติดตั้งผ่านแหล่งที่มา

1. รับซอร์สโค้ดจากที่เก็บ git:

    git clone https://github.com/Tencent/MMKV.git
   

2. เพิ่ม Core/core.vcxproj ให้กับโซลูชันของคุณ

3. เพิ่มโปรเจ็กต์ MMKV ลงในการขึ้นต่อกันของโปรเจ็กต์ของคุณ

4. เพิ่ม $(OutDir)include ให้กับ C/C++ ของโปรเจ็กต์ของคุณ -> General -> Additional Include Directories ;

5. เพิ่ม $(OutDir) ให้กับ Linker ของโปรเจ็กต์ของคุณ -> General -> Additional Library Directories ;

6. เพิ่ม mmkv.lib ให้กับ Linker ของโปรเจ็กต์ของคุณ -> Input -> Additional Dependencies ;

7. เพิ่ม #include <MMKV/MMKV.h> ลงในไฟล์ต้นฉบับของคุณ เท่านี้ก็เสร็จเรียบร้อย

บันทึก:

1. MMKV ได้รับการคอมไพล์ด้วยรันไทม์ MT/MTd ตามค่าเริ่มต้น หากโปรเจ็กต์ของคุณใช้ MD/MDd คุณควรเปลี่ยนการตั้งค่าของ MMKV ให้ตรงกับโปรเจ็กต์ของคุณ ( C/C++ -> Code Generation -> Runtime Library ) หรือในทางกลับกัน
2. MMKV ได้รับการพัฒนาด้วย Visual Studio 2017 เปลี่ยน Platform Toolset หากคุณใช้ Visual Studio เวอร์ชันอื่น

สำหรับตัวเลือกการติดตั้งอื่นๆ โปรดดูที่ การตั้งค่า Windows

บทช่วยสอนด่วน

คุณสามารถใช้ MMKV ได้ทุกที่ การเปลี่ยนแปลงทั้งหมดจะถูกบันทึกทันที ไม่ต้อง sync ไม่ต้อง save การโทร
ตั้งค่า MMKV เมื่อเริ่มต้น App พูดใน main() เพิ่มบรรทัดเหล่านี้:

# include < MMKV/MMKV.h >

int main () {
    std::wstring rootDir = getYourAppDocumentDir ();
    MMKV::initializeMMKV (rootDir);
    // ...
}

MMKV มีอินสแตนซ์ส่วนกลางที่สามารถใช้ได้โดยตรง:

 auto mmkv = MMKV::defaultMMKV();

mmkv-> set ( true , " bool " );
std::cout << " bool = " << mmkv-> getBool ( " bool " ) << std::endl;

mmkv-> set ( 1024 , " int32 " );
std::cout << " int32 = " << mmkv-> getInt32 ( " int32 " ) << std::endl;

mmkv-> set ( " Hello, MMKV for Windows " , " string " );
std::string result;
mmkv-> getString ( " string " , result);
std::cout << " string = " << result << std::endl;

MMKV ยังรองรับ การเข้าถึงแบบหลายกระบวนการ สามารถดูบทช่วยสอนแบบเต็มได้ที่นี่ Windows Tutorial

MMKV สำหรับ POSIX

คุณสมบัติ

• มีประสิทธิภาพ . MMKV ใช้ mmap เพื่อให้หน่วยความจำซิงค์กับไฟล์ และใช้ protobuf เพื่อเข้ารหัส/ถอดรหัสค่า ใช้ประโยชน์จาก POSIX ให้เกิดประโยชน์สูงสุดเพื่อให้ได้ประสิทธิภาพที่ดีที่สุด

  • การทำงานพร้อมกันหลายกระบวนการ : MMKV รองรับการเข้าถึงแบบอ่าน-อ่านและอ่าน-เขียนระหว่างกระบวนการต่างๆ

• ง่ายต่อการใช้งาน คุณสามารถใช้ MMKV ได้ทุกที่ การเปลี่ยนแปลงทั้งหมดจะถูกบันทึกทันที ไม่ต้อง save ไม่จำเป็นต้องทำการ sync

• เล็ก .

  • ไฟล์จำนวนหนึ่ง : MMKV มีการล็อคกระบวนการ ตัวช่วยเข้ารหัส/ถอดรหัส และตรรกะ mmap และไม่มีอะไรเพิ่มเติม มันเป็นระเบียบจริงๆ
  • ขนาดไบนารี่ประมาณ 7K : MMKV เพิ่มขนาดแอปพลิเคชันประมาณ 7K และน้อยกว่ามากเมื่อบีบอัด

เริ่มต้นใช้งาน

การติดตั้งผ่าน CMake

1. รับซอร์สโค้ดจากที่เก็บ git:

    git clone https://github.com/Tencent/MMKV.git
   

2. แก้ไข CMakeLists.txt ของคุณ เพิ่มบรรทัดเหล่านั้น:

    add_subdirectory (mmkv/POSIX/src mmkv)
   target_link_libraries (MyApp
       mmkv)

3. เพิ่ม #include "MMKV.h" ลงในไฟล์ต้นฉบับของคุณ เท่านี้ก็เสร็จเรียบร้อย

สำหรับตัวเลือกการติดตั้งอื่นๆ โปรดดูการตั้งค่า POSIX

บทช่วยสอนด่วน

คุณสามารถใช้ MMKV ได้ทุกที่ การเปลี่ยนแปลงทั้งหมดจะถูกบันทึกทันที ไม่ต้อง sync ไม่ต้อง save การโทร
ตั้งค่า MMKV เมื่อเริ่มต้น App พูดใน main() เพิ่มบรรทัดเหล่านี้:

# include " MMKV.h "

int main () {
    std::string rootDir = getYourAppDocumentDir ();
    MMKV::initializeMMKV (rootDir);
    // ...
}

MMKV มีอินสแตนซ์ส่วนกลางที่สามารถใช้ได้โดยตรง:

 auto mmkv = MMKV::defaultMMKV();

mmkv-> set ( true , " bool " );
std::cout << " bool = " << mmkv-> getBool ( " bool " ) << std::endl;

mmkv-> set ( 1024 , " int32 " );
std::cout << " int32 = " << mmkv-> getInt32 ( " int32 " ) << std::endl;

mmkv-> set ( " Hello, MMKV for Windows " , " string " );
std::string result;
mmkv-> getString ( " string " , result);
std::cout << " string = " << result << std::endl;

MMKV ยังรองรับ การเข้าถึงแบบหลายกระบวนการ สามารถดูบทช่วยสอนแบบเต็มได้ที่นี่ POSIX Tutorial

MMKV สำหรับ HarmonyOS ถัดไป

คุณสมบัติ

• มีประสิทธิภาพ . MMKV ใช้ mmap เพื่อให้หน่วยความจำซิงค์กับไฟล์ และใช้ protobuf เพื่อเข้ารหัส/ถอดรหัสค่า ใช้ประโยชน์สูงสุดจากแพลตฟอร์มดั้งเดิมเพื่อให้ได้ประสิทธิภาพที่ดีที่สุด

  • การทำงานพร้อมกันหลายกระบวนการ : MMKV รองรับการเข้าถึงแบบอ่าน-อ่านและอ่าน-เขียนระหว่างกระบวนการต่างๆ

• ง่ายต่อการใช้งาน คุณสามารถใช้ MMKV ได้ทุกที่ การเปลี่ยนแปลงทั้งหมดจะถูกบันทึกทันที ไม่ต้อง sync ไม่ต้อง flush การโทร

• เล็ก .

  • ไฟล์จำนวนหนึ่ง : MMKV มีการล็อคกระบวนการ ตัวช่วยเข้ารหัส/ถอดรหัส และตรรกะ mmap และไม่มีอะไรเพิ่มเติม มันเป็นระเบียบจริงๆ
  • ขนาดไบนารีประมาณ 600K : MMKV เพิ่มประมาณ 600K ต่อสถาปัตยกรรมในขนาดแอป และน้อยกว่ามากเมื่อบีบอัด (HAR/HAP)

เริ่มต้นใช้งาน

การติดตั้งผ่าน OHPM:

ohpm install @tencent/mmkv

บทช่วยสอนด่วน

คุณสามารถใช้ MMKV ได้ทุกที่ การเปลี่ยนแปลงทั้งหมดจะถูกบันทึกทันที ไม่ต้อง sync ไม่ต้อง apply การโทร
ตั้งค่า MMKV เมื่อเริ่มต้นแอป พูดฟังก์ชัน EntryAbility.onCreate() ของคุณ แล้วเพิ่มบรรทัดเหล่านี้:

 import { MMKV } from '@tencent/mmkv' ;

export default class EntryAbility extends UIAbility {
  onCreate ( want : Want , launchParam : AbilityConstant . LaunchParam ) : void {
    let appCtx = this . context . getApplicationContext ( ) ;
    let mmkvRootDir = MMKV . initialize ( appCtx ) ;
    console . info ( 'mmkv rootDir: ' , mmkvRootDir ) ;
    ……
  }

MMKV มีอินสแตนซ์ส่วนกลางที่สามารถใช้ได้โดยตรง:

 import { MMKV } from '@tencent/mmkv' ;
    
let mmkv = MMKV . defaultMMKV ( ) ;
mmkv . encodeBool ( 'bool' , true ) ;
console . info ( 'bool = ' , mmkv . decodeBool ( 'bool' ) ) ;
    
mmkv . encodeInt32 ( 'int32' , Math . pow ( 2 , 31 ) - 1 ) ;
console . info ( 'max int32 = ' , mmkv . decodeInt32 ( 'int32' ) ) ;
    
mmkv . encodeInt64 ( 'int' , BigInt ( 2 ** 63 ) - BigInt ( 1 ) ) ;
console . info ( 'max int64 = ' , mmkv . decodeInt64 ( 'int' ) ) ;
    
let str : string = 'Hello OpenHarmony from MMKV' ;
mmkv . encodeString ( 'string' , str ) ;
console . info ( 'string = ' , mmkv . decodeString ( 'string' ) ) ;

let arrayBuffer : ArrayBuffer = StringToArrayBuffer ( 'Hello OpenHarmony from MMKV with bytes' ) ;
mmkv . encodeBytes ( 'bytes' , arrayBuffer ) ;
let bytes = mmkv . decodeBytes ( 'bytes' ) ;
console . info ( 'bytes = ' , ArrayBufferToString ( bytes ) ) ;

อย่างที่คุณเห็น MMKV นั้นค่อนข้างใช้งานง่าย สำหรับเอกสารฉบับเต็ม โปรดดูบทช่วยสอน HarmonyOS NEXT

ใบอนุญาต

MMKV ได้รับการเผยแพร่ภายใต้ใบอนุญาต BSD 3-Clause สำหรับรายละเอียด โปรดดูที่ LICENSE.TXT

เปลี่ยนบันทึก

ตรวจสอบ CHANGELOG.md เพื่อดูรายละเอียดประวัติการเปลี่ยนแปลง

มีส่วนร่วม

หากคุณสนใจที่จะมีส่วนร่วม โปรดดูที่ CONTRIBUTING.md และเข้าร่วมแผน Tencent OpenSource ของเราด้วย

เพื่อให้ชัดเจนว่าสิ่งที่คาดหวังจากสมาชิกของเรา MMKV ได้นำหลักปฏิบัติที่กำหนดโดย Contributor Covenant ซึ่งใช้กันอย่างแพร่หลาย และเราคิดว่ามันสะท้อนถึงคุณค่าของเราได้ดี สำหรับข้อมูลเพิ่มเติม โปรดดูหลักจรรยาบรรณ

คำถามที่พบบ่อยและข้อเสนอแนะ

ตรวจสอบคำถามที่พบบ่อยก่อน หากมีคำถามใดๆ อย่าลังเลที่จะสร้างปัญหา

กฎการคุ้มครองข้อมูลส่วนบุคคล

ความเป็นส่วนตัวของผู้ใช้ถือเป็นเรื่องสำคัญอย่างยิ่ง: MMKV ไม่ได้รับ รวบรวม หรืออัปโหลดข้อมูลส่วนบุคคลใด ๆ โปรดดูกฎการคุ้มครองข้อมูลส่วนบุคคลของ MMKV SDK สำหรับรายละเอียด