Skip to content

Latest commit

 

History

History
136 lines (98 loc) · 4.19 KB

README_ZH.md

File metadata and controls

136 lines (98 loc) · 4.19 KB
Raw

MMKV-KTX

English | 中文

License

结合了 Kotlin 属性委托的特性，使得 MMKV 更加灵活易用。

Features

  • 自动初始化 MMKV ；
  • 用属性名作为键名，无需声明大量的键名常量；
  • 可以确保类型安全，避免类型或者键值不一致导致的异常；

用法

📝 >> 使用文档 <<

快速入门

在根目录的 build.gradle 添加:

allprojects {
    repositories {
        //...
        maven { url 'https://www.jitpack.io' }
    }
}

在模块的 build.gradle 添加依赖：

dependencies {
    implementation 'com.github.DylanCaiCoding:MMKV-KTX:1.2.16'
}

让一个类继承 MMKVOwner 类，即可在该类使用 by mmkvXXXX() 函数将属性委托给 MMKV，例如：

object SettingsRepository : MMKVOwner(mmapID = "settings") {
  var isNightMode by mmkvBool()
  var language by mmkvString(default = "zh")
}

如果已经有了父类继承不了，那就实现 IMMKVOwner by MMKVOwner(mmapID)，比如：

object SettingsRepository : BaseRepository(), IMMKVOwner by MMKVOwner(mmapID = "settings") {
  // ...
}

不管哪种都要确保每个 mmapID 不重复，只有这样才能 100% 确保类型安全！！！

设置或获取属性的值会调用对应的 encode() 或 decode() 函数，用属性名作为键名。比如：

if (SettingsRepository.isNightMode) {
  // do some thing
}

SettingsRepository.isNightMode = true

支持以下类型：

函数 默认值
mmkvInt() 0
mmkvLong() 0L
mmkvBool() false
mmkvFloat() 0f
mmkvDouble() 0.0
mmkvString() /
mmkvStringSet() /
mmkvBytes() /
mmkvParcelable() /

支持用 mmkvXXXX().asLiveData() 函数将属性委托给 LiveData，例如：

object SettingRepository : MMKVOwner(mmapID = "settings") {
  val isNightMode by mmkvBool().asLiveData()
}

SettingRepository.isNightMode.observe(this) {
  checkBox.isChecked = it
}

SettingRepository.isNightMode.value = true

可以用 kv 对象进行删除值或清理缓存等操作，例如：

kv.removeValueForKey(::language.name) // 建议修改了默认值才移除 key，否则赋值操作更简洁
kv.clearAll()

更多进阶用法请查看使用文档。

更新日志

Releases

作者其它的库

库 简介
Longan 可能是最好用的 Kotlin 工具库
LoadingStateView 深度解耦标题栏或加载中、加载失败、无数据等缺省页
ViewBindingKTX 最全面的 ViewBinding 工具
Tracker 基于西瓜视频的责任链埋点思路实现的轻量级埋点框架

License

Copyright (C) 2021. Dylan Cai

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.