PDKeychainBindingsController 技术文档

1. 安装指南

环境要求

• macOS 或 iOS 开发环境
• Xcode 5 或更高版本

安装步骤

1. 将 PDKeychainBindingsController 项目文件拖入您的 Xcode 项目中。

2. 在您的项目设置中，确保已勾选 PDKeychainBindingsController 项目的依赖。

3. 在需要使用 PDKeychainBindingsController 的文件中导入头文件：

   #import "PDKeychainBindingsController.h"
   

4. 如果您的项目尚未转换为 ARC (Automatic Reference Counting)，您可以选择继续使用非 ARC 分支，该分支名为 non_ARC。

2. 项目的使用说明

PDKeychainBindingsController 是一个基于 Keychain 的 Cocoa 包装器，旨在使 Mac OSX 和 iOS 的 Keychain 使用尽可能简单。它遵循 KVO (Key-Value Observing) 协议，并且模型基于 NSUserDefaults。

在常规情况下，您通常会调用：

[NSUserDefaults standardUserDefaults]

现在，您可以调用：

[PDKeychainBindings sharedKeychainBindings]

主要功能

• 仅支持字符串类型，因为 Keychain 仅接受字符串。
• 实现 "即时模式"，不支持一次性设置多个值后统一保存。
• 不支持撤销到已保存的值（此功能可以实现，但当前未提供）。

示例

在您的偏好设置界面中，如果有一个 NSSecureTextField，您可以将用户输入的值存储到 Keychain 中，如下所示：

NSString *password = [secureTextField stringValue];
[PDKeychainBindings sharedKeychainBindings].password = password;

3. 项目API使用文档

主要类和方法

PDKeychainBindingsController

• sharedKeychainBindings: 获取单例对象。

PDKeychainBindings

• 属性：password （用于存储字符串类型的密码）。

4. 项目安装方式

PDKeychainBindingsController 可以通过以下两种方式安装到您的项目中：

手动安装

1. 下载 PDKeychainBindingsController 的源代码。
2. 将源代码文件添加到您的 Xcode 项目中。
3. 按照安装指南中的步骤进行配置。

使用 CocoaPods

1. 在您的 Podfile 文件中添加以下行：

   pod 'PDKeychainBindingsController'
   

2. 运行 pod install 命令以安装依赖。

3. 在 Xcode 中打开 .xcworkspace 文件，而不是 .xcodeproj 文件。

通过以上步骤，您可以将 PDKeychainBindingsController 成功集成到您的项目中。