通用说明

GoldRaccoon 是 iOS 组件，用于连接 FTP 服务并执行以下操作：

• 下载文件
• 上传文件
• 删除文件
• 创建目录
• 删除目录
• 列出目录

为什么还需要另一个松鼠？

首先，因为人类需要它。

本项目于 2013 年 6 月 29 日作为 Objective-C Hackathon (http://objectivechackathon.appspot.com/) 的起点开始。

GoldRaccoon 的目标是 BlackRaccoon（它是 WhiteRaccoon 的演进）的进化，可能是处理 iOS 上 FTP 操作的最佳（或至少是少数几个）第三方组件。

我在 2013 年 5 月 fork 了 BlackRaccooon 的公开仓库，并添加了一些改进，这些改进已合并到 BlackRaccoon 的 master 中。尽管 BlackRaccoon 做了它所说的，但我更喜欢对其进行一点清理并使用不同的、更具可扩展性的代码结构。

因此，大多数代码都是由 Valentin Radu 和 Lloyd Sargent 编写的，我（Alberto De Bortoli）添加的主要扩展包括：

• 对前一代代码进行了深度重构；
• 添加了缺失的（并且合理的）代码约定；
• 添加了 GRRequestsManager，用于使用 FIFO 队列管理所有不同类型请求；
• 添加了一个演示项目。

用法

如果你想要使用 CocoaPods（CocoaPods）将此组件添加为 pod，只需将以下行添加到你的 Podfile 中：

pod "GoldRaccoon"

否则

• 将 Sources 文件夹复制到你的项目中；
• 添加 CFNetwork 框架；
• 在你的类中导入 GRRequestsManager.h；
• 添加管理器的属性；

@property (nonatomic, strong) GRRequestsManager *requestsManager;

• 在某个地方设置管理器（使用主机名、用户名和密码）

self.requestsManager = [[GRRequestsManager alloc] initWithHostname:<hostname>
                                                              user:<username>
                                                          password:<password>];

• 可选地，让您的类遵从于 GRRequestsManagerDelegate，实现代理方法（基本上是成功、失败和进度回调）并将此类的实例设置为管理器的代理；

self.requestsManager.delegate = self;

• 使用以下方法将请求添加到管理器：

addRequestForListDirectoryAtPath:
addRequestForCreateDirectoryAtPath:
addRequestForDeleteFileAtPath:
addRequestForDeleteDirectoryAtPath:
addRequestForDownloadFileAtRemotePath:toLocalPath:
addRequestForUploadFileAtLocalPath:toRemotePath:

• 启动管理器；

[self.requestsManager startProcessingRequests];