DefaultsKit

简体中文

DefaultSkit是一个轻巧的Swift库，它以Codable为基础，为UserDefaults提供简单，强烈键入和紧凑的包装器。代码少于100行，它既易于使用又高效。

安装>> instructions <<

用法

实例化或获得Defaults的shared实例

 let defaults = Defaults ( ) // or Defaults.shared

然后：

// Define a key
let key = Key < String > ( " someKey " )

// Set a value
defaults . set ( " Codable FTW ? " , for : key )

// Read the value back
defaults . get ( for : key ) // Output: Codable FTW ?

检查键是否具有值：

if defaults . has ( key ) {
    // Do your thing
}

如果您只需要知道存在键/值对而没有实际使用该值，请使用has()方法而不是可选的get(for:key) 。对于复杂的对象，它将防止任何不必要的避难所化。

隐式成员表达

您可以通过扩展DefaultsKey来找到钥匙的便利包装器。这允许您使用隐式成员表达式：

// Extend with a custom key
extension DefaultsKey {
    static var someKey : Key < Int > { Key ( " someKey " ) }
}

// Then use it like this
defaults . set ( " Some key " , for : . someKey )
defaults . get ( for : . someKey ) // Output: Some key

复杂对象

要存储复杂的对象，只需符合代码协议：

 struct Person : Codable {
    let name : String
    let age : Int
}

然后：

// Create a key
let key = Key < Person > ( " personKey " )

// Get an instance of your Codable conforming enum, struct or class
let person = Person ( name : " Bonnie Greenwell " , age : 80 )

// Set the value
defaults . set ( person , for : key )

最后：

// Read it back
let person = defaults . get ( for : key )
person ? . name // Bonnie Greenwell
person ? . age  // 80

嵌套对象

您也可以使用嵌套对象符合Codable协议：

 enum Pet : String , Codable {
    case cat
    case dog
}

struct Person : Codable {
    let name : String
    let pets : [ Pet ]
}

// Get a Codable conforming instante
let person = Person ( name : " Claire " , pets : [ . cat ] )

// Set the value
defaults . set ( person , for : key )

// And read it back
let person = defaults . get ( for : key )
person ? . name        // Claire
person ? . pets . first  // cat

执照

DefaultSkit按MIT许可发布。有关详细信息，请参见许可证。

把招工广告

评论/翻译readme.zh-cn.md到中文

中文是世界上排名第一的语言，我很想让默认设备更具包容性，不幸的是我不会说中文。如果您知道中文，并且想提供帮助，请参阅第1期

谢谢