使用 DropboxSDK 开始使用 OSX

要求： 1. 您需要版本 5.1 或更高的 Xcode。2. 您需要在 https://dropbox.com/developers/apps 上注册您的应用程序。您应该有一个应用程序密钥和密钥。

注意：该 SDK 专为与 10.7 及以上版本的 OSX 操作系统一起使用而设计。

构建和运行示例应用程序：1. 打开 examples/DBRouletteOSX/DBRouletteOSX.xcodeproj 中的项目文件。2. 在 AppDelegate.m 中的 applicationDidFinishLaunching: 填写 appKey、appSecret 和 root 的值。3. 在文件浏览器中右键单击 DBRouletteOSX-Info.plist 并选择 "打开方式" -> "源代码"。将文件中的 APP_KEY 替换为您的应用程序密钥。4. 构建和运行应用程序。运行后，请确保您可以使用应用程序登录并查看照片而不会出错。如果有完全的 Dropbox 访问权限，示例应用程序将查找您的 Dropbox 的照片文件夹，如果没有 App 文件夹访问权限，将查找您的应用程序的 App 文件夹。

如果您无法在获取错误的情况下运行应用程序，请确保您的应用程序密钥和应用程序密钥是正确的。

将 DropboxOSX 框架添加到您的项目中：在您可以使用 Dropbox API 在应用程序中之前，您需要将框架添加到您的项目中。

1. 在 Xcode 中打开您的项目。
2. 在左窗格的文件选项卡中右键单击您的项目，然后选择 "将文件添加到 ''"。
3. 导航到您解压缩 Dropbox SDK 的位置，并选择 DropboxOSX.framework 子文件夹。
4. 选择 "将项目添加到目标组文件夹中"。
5. 按下添加按钮。
6. 确保您已将 Security.framework 添加到您的项目中。在 Xcode4 中，选择文件浏览器中的项目文件，选择您的目标，然后选择 "构建 phases" 子选项卡。在 "链接二进制与库" 下，按 "+" 按钮，选择 Security.framework，然后按添加。
7. 同样，在 "构建 phases" 子选项卡中，在右上角的底部单击 "添加 Build Phase" 按钮，然后选择 "添加 Copy Files"。在创建的新 build phase 中，单击 "+" 按钮，并将 DropboxOSX.framework 添加到要复制到 Resources 文件夹中。
8. 构建和运行您的应用程序。在这个时候，您应该没有任何编译失败或警告，并且能够成功运行您的应用程序。

身份验证：现在您已添加框架，下一步是进行身份验证，这将允许您对 Dropbox API 发出请求。

1. 设置共享的 DBSession 对象。为此，在 AppDelegates applicationDidFinishLaunching: 方法中使用 -[DBSession initWithAppKey:appSecret:root:] 构造函数创建 DBSession 对象。您需要在 https://dropbox.com/developers/apps 上找到您的应用程序中填充应用程序密钥、密钥和根的相应值。

   创建会话后，您可以使用 +[DBSession setSharedSession] 将它设置为共享会话。同时确保您已导入 SDK

   导入

2. 在您的plist文件中添加一个用于db-APP_KEY的URL处理器，其中APP_KEY是您包含在DBSession对象中的应用密钥。如果您的应用程序没有注册任何URL处理器，添加它们的最简单方法是
   • 右键单击您的plist文件，选择"以" -> "源代码"。
   • 将以下代码粘贴到文件中：CFBundleURLTypes CFBundleURLName Dropbox SDK CFBundleURLSchemes db-APP_KEY
   • 将APP_KEY替换为您的应用程序密钥
3. 注册

4. 将DBAuthHelperOSX集成到用户链接Dropbox账户的控制器中（这是在示例应用程序DBRouletteOSX的AppDelegate.m中完成的）。这涉及到三个步骤

   • #import

   • 在您使用认证辅助程序（例如在控制器创建时）之前，您需要像这样订阅DBAuthHelperOSXStateChangedNotification：[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(authHelperStateChangedNotification:) name:DBAuthHelperOSXStateChangedNotification object:[DBAuthHelperOSX sharedHelper]];

     在您authHelperStateChangedNotification:方法中，您应更新链接状态的当前状态。请查看DBRouletteOSX中的-[AppDelegate authHelperStateChangedNotification:]以获取示例。

   • 当用户启动连接过程时，调用：[[DBAuthHelperOSX sharedHelper] authenticate];

   一旦您收到DBAuthHelperOSXStateChangedNotification，并且[[DBSession sharedSession] isLinked]为YES，您就可以开始调用API了。

加载数据和文件夹：有关使用API进行调用更多信息，请查看我们在线教程，iOS的https://dropbox.com/developers/start/files#ios。一旦您认证了iOS和OS X SDK，这些是相同的。