Day26 Data Storage in iOS 02 - Keychain & Property list (Plists)

Keychain

Apple Keychain 是一个非常流行且功能强大的 Swift 工具，每个 iOS 和 MacOS 用户都在使用。 它可用於保存密码、安全笔记、证书等。总的来说，Keychain 是一个加密数据库，具有相当复杂和强大的 API，当您需要保存敏感的用户数据（例如密码）时，请使用Keychain。

范例 :

struct KeychainItemStorable {
    let service: String
    let account: String
}
extension KeychainItemStorable {
    enum Error: Swift.Error {
        case passwordNotFound
        case unknownError(String)
        case invalidData
    }
    func readPassword() throws -> String {
        var query: [String : Any] = [:]
        query[kSecClass as String] = kSecClassGenericPassword
        query[kSecAttrService as String] = service
        query[kSecAttrAccount as String] = account as AnyObject?
        query[kSecMatchLimit as String] = kSecMatchLimitOne
        query[kSecReturnAttributes as String] = kCFBooleanTrue
        query[kSecReturnData as String] = kCFBooleanTrue
        
        // Try to fetch the existing keychain item that matches the query.
        var queryResult: AnyObject?
        let status = withUnsafeMutablePointer(to: &queryResult) {
            SecItemCopyMatching(query as CFDictionary, UnsafeMutablePointer($0))
        }
        switch status {
        case noErr:
            guard let items = queryResult as? [String: Any],
                let valueData = items[kSecValueData as String] as? Data,
                let valueString = String(data: valueData, encoding: .utf8) else
            { throw Error.invalidData }
            return valueString
        case errSecItemNotFound:
            throw Error.passwordNotFound
        default:
            throw Error.unknownError(status.description)
        }
    }
}

优点 :

• 保存在钥匙串中的所有项目都是加密的（钥匙串是iOS中最安全的数据持久层）
• 有很多开源且好用的 Swift API 的wrappers
• Thread safety

Property list (Plists) in Swift

Plist 文件允许使用键/值约定存储序列化对象。 在 macOS 和 iOS 应用程序中，plist 最常见的用法示例是存储应用程序设置值的 Info.plist 文件。 在 Info.plist 中，我们可以找到应用程序名称、版本号、所需权限信息、Facebook 应用程序信息等。 在我们所有使用 Firebase 的 iOS 应用程序模板中实现的 .plist 文件的另一个示例是 GoogleService -Info.plist 文件，其中包含用户身份验证和数据库访问所需的所有 Firebase API 密钥

在 plist 文件中，您可以存储基本型态资料，例如：

• Strings
• Numbers (Int, Floats)
• Bools
• Dates (ISO 8601 formatted string)
• Data (NSData, for Objective-C folks)
• Arrays
• Dictionaries

可以使用 Bundle.main.infoDictionary 读取存储在应用程序的 Info.plist 文件中的信息。

如下所示：

let bundleIdentifire = Bundle.main.infoDictionary[kCFBundleIdentifierKey] as? String

范例：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>FirstName</key>
  <string>John</string>
  <key>SecondName</key>
  <string>Doe</string>
  <key>Age</key>
  <string>24</string>
</dict>
</plist>

class PlistReader {
    func read(fileNamed: String) throws -> [String: Any] {
        guard let path = bundle.path(forResource: fileNamed, ofType: "plist"),
            let plistData = FileManager.default.contents(atPath: path) else {
                throw Error.fileMissing
        }
        var format = PropertyListSerialization.PropertyListFormat.xml
        return try PropertyListSerialization.propertyList(from: plistData,
                                                          options: .mutableContainersAndLeaves,
                                                          format: &format) as! [String: Any]
    }
}