本包包含 Dropbox 同步 API 和 Dropbox 数据存储 API 的 iOS SDK。
同步和数据存储 API 均可作为单个框架提供。Dropbox.framework 的安装说明可在此处找到:这里。
此框架适用于运行 iOS 版本 5.0 或更高版本的设备。您可以使用 Xcode 5 或更高版本构建应用程序。
要了解如何使用数据存储 API 构建第一个应用程序,请遵循数据存储 教程。
还有一个 同步 API 教程,演示如何从 Dropbox 读取和写入文件。
示例目录中有两个 Xcode 项目,展示了如何使用数据存储和文件同步 API。
在 "Files Examples.xcodeproj" 中,您可以找到三个示例应用程序,它们演示了文件同步 API 的基础
HelloDropbox 示例应用程序演示了类似于在线教程的基本功能:列出文件夹,并读取/写入文件。它将结果以文本形式打印到屏幕上。HelloDropbox 需要 iOS 5.0 或更高版本。
Notes 示例应用程序演示了一个使用同步 SDK 构建的便签编辑应用程序。此应用程序演示了如何使用同步 SDK 读取和保存文件,如何使用 API 创建文件和文件夹,以及如何监听文件和文件夹的变化,并在内容发生变化时更新文件或目录内容的视图。Notes 需要 iOS 5.0 或更高版本。
ImageGrid 示例应用程序演示了如何使用文件观察器和 FileStatus 类的更多属性来更新 UI,以响应文件状态的更改。此示例在两个连接到同一 Dropbox 帐户的设备上运行效果最佳,因为它展示了如何在更改发生时对文件状态更改做出响应的应用程序。要使用此应用程序,您需要在图像选择器出现时选择一些照片。在模拟器上,您可以通过从 Safari 中保存它们来获得一些照片。(将图片拖到模拟器中,然后长按并选择保存。)ImageGrid 使用 UICollectionView,需要 iOS 6.0 或更高版本。
您可以从该目录运行以下命令来安装 Xcode docset
cp -R com.dropbox.Dropbox.docset ~/Library/Developer/Shared/Documentation/DocSets
然后重新启动 Xcode 以完成安装。