EasyStash项目安装与配置指南

1. 项目基础介绍

EasyStash 是一个易于使用的轻量级持久化框架，用 Swift 语言编写。它通过简单的抽象层封装了 NSCache 和 FileManager，从而简化了对象的保存和加载工作。目前，EasyStash 不包含复杂的异步操作、过期处理或缓存策略，仅提供保存和加载功能。

2. 关键技术和框架

• 编程语言：Swift 5
• 平台支持：iOS, macOS, tvOS, watchOS
• 关键技术：使用 Codable 协议进行对象序列化与反序列化，JSONEncoder 和 JSONDecoder 用于数据的编解码。
• 框架：无特定框架依赖，使用的是原生 Swift API。

3. 安装和配置

准备工作

在开始安装之前，请确保您的开发环境满足以下要求：

• Xcode 11.0 或更高版本
• Swift 5.0 或更高版本
• macOS 10.14 或更高版本

安装步骤

通过 CocoaPods 安装

1. 打开您的 Xcode 项目所在的文件夹。
2. 使用文本编辑器打开 Podfile 文件。
3. 在 Podfile 中添加以下行：

   pod 'EasyStash'
   

4. 保存并关闭 Podfile 文件。
5. 在终端中，导航到包含 Podfile 的目录。
6. 运行以下命令安装 EasyStash：

   pod install
   

7. 安装完成后，关闭 Xcode 项目，然后使用新生成的 .xcworkspace 文件打开项目。

通过 Carthage 安装

1. 打开您的 Xcode 项目所在的文件夹。
2. 使用文本编辑器打开 Cartfile 文件。
3. 在 Cartfile 中添加以下行：

   github "onmyway133/EasyStash"
   

4. 保存并关闭 Cartfile 文件。
5. 在终端中，导航到包含 Cartfile 的目录。
6. 运行以下命令安装 EasyStash：

   carthage update
   

7. 在 Xcode 中，添加对生成的 EasyStash.framework 的引用。

通过 Swift Package Manager 安装

1. 打开 Xcode，创建一个新的 Swift 项目或打开现有项目。
2. 选择 “File” > “Swift Packages” > “Add Package Dependency”。
3. 输入以下 URL 以添加 EasyStash 依赖项：

   https://github.com/onmyway133/EasyStash.git
   

4. 选择版本号（例如 “1.1.8”）。
5. 点击 “Next” 并按照指示完成安装。
6. 在 Xcode 的项目设置中，确保目标依赖了 EasyStash 包。

以上步骤将帮助您成功安装 EasyStash。安装后，您可以按照项目文档中的示例代码，开始使用 EasyStash 进行数据持久化操作。