DefaultsKit

简体中文

DefaultSkit es una biblioteca Swift liviana que se basa en Codable para ofrecer un envoltorio simple , fuertemente tipado y compacto para UserDefaults. Con menos de 100 líneas de código, es fácil de usar y altamente eficiente.

Instalación >> instructions <<

Uso

Instanciar o obtener una instancia shared de Defaults

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

Entonces:

// 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 ?

Compruebe si una clave tiene un valor:

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

Si solo necesita saber que existe un par de clave/valor, sin usar el valor , use el método has() en lugar del get(for:key) . Para objetos complejos, evitará cualquier deserialización innecesaria.

Expresión de miembro implícito

Puede encontrar un envoltorio de conveniencia para sus claves extendiendo DefaultsKey . Esto le permite usar la expresión de miembro implícito:

// 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

Objetos complejos

Para almacenar un objeto complejo simplemente ajustado al protocolo codible:

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

Entonces:

// 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 )

Y finalmente:

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

Objetos anidados

También puede usar objetos anidados siempre que se ajusten al protocolo 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

Licencia

DefaultSkit se publica bajo la licencia MIT. Vea la licencia para más detalles.

Se busca ayudante

Revisar/traducir readMe.zh-cn.md al chino

El chino es el idioma hablado #1 en el mundo y me encantaría que el valor predeterminado sea más inclusivo, desafortunadamente no hablo chino. Si conoce chino y desea ayudar, consulte el número 1

Gracias