Box iOS SDK

此 SDK 可以使您轻松地在 iOS 项目中使用 Box 的 内容 API。

开发者设置

• 确保您已安装最新版本的 Xcode。
• 我们建议您使用 CocoaPods 将 SDK 导入到您的项目中。CocoaPods 是一个简单但功能强大的依赖关系管理工具。如果您还没有使用 CocoaPods，它非常容易开始使用。

快速入门

步骤 1：添加到 Podfile

pod 'box-ios-sdk'

步骤 2：安装

pod install

步骤 3：导入

#import <BoxContentSDK/BOXContentSDK.h>

步骤 4：设置从 创建您的应用 所获得的 Box 客户端 ID 和客户密钥。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  // The UIApplicationDelegate is a good place to do this.
  [BOXContentClient setClientID:@"your-client-id" clientSecret:@"your-client-secret"];
}

步骤 5：验证用户

// This will present the necessary UI for a user to authenticate into Box
[[BOXContentClient defaultClient] authenticateWithCompletionBlock:^(BOXUser *user, NSError *error) {
  if (error == nil) {
    NSLog(@"Logged in user: %@", user.login);
  }
} cancelBlock:nil];

示例应用

示例应用可以在 BoxContentSDKSampleApp 文件夹中找到。该示例应用演示了如何验证用户，并管理用户的文件和文件夹。

要执行示例应用：步骤 1：安装 Pods

cd BoxContentSDKSampleApp
pod install

步骤 2：打开 Workspace

open BoxContentSDKSampleApp.xcworkspace

测试

可以在 'BoxContentSDKTests' 目标中找到测试。使用 Xcode 执行测试。Travis CI 也将执行对仓库的拉取请求数和推送测试。

文档

您可以在 doc 目录中找到指南和教程。

• 应用设置
• 身份验证
• 开发者版本（App 用户）
• 文件
• 文件夹
• 元数据
• 评论
• 协作
• 事件
• 搜索
• 用户

贡献

请参阅 CONTRIBUTING 了解如何贡献。

版权和许可证

版权所有2015 Box, Inc。保留所有权利。

受Apache许可证第2版本的许可（以下简称“许可证”）；除非遵守许可证或书面同意，否则不得使用此文件。您可以在以下地址获取许可证副本：

https://apache.ac.cn/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则在许可证下分发软件的基础是“现状”，不提供任何形式（无论是明示的还是暗示的）的保证或条件。有关许可下权限和限制的具体语言，请参阅许可证。