一种快速简单地认证 Dropbox 用户在您的 iPhone 或 iPad 应用程序的方法。
将 DropboxSimpleOAuth 添加到您的项目中
CocoaPods
CocoaPods 是向项目添加 DropboxSimpleOAuth 的推荐方式。
- 在 Podfile 中添加 DropboxSimpleOAuth:
pod 'DropboxSimpleOAuth'
。 - 通过运行
pod install
安装 pod(s)。 - 使用
#import <DropboxSimpleOAuth/DropboxSimpleOAuth.h>
将 DropboxSimpleOAuth 添加到您的项目中。
Carthage
- 在 Cartfile 中添加
github "rbaumbach/DropboxSimpleOAuth"
。 - 按照指示操作,将动态框架添加到您的目标中。
从 Github 克隆
- 从 github 克隆仓库并直接复制文件,或将其作为 git 子模块添加。
- 将 'Source' 目录中的所有文件添加到您的项目中。
如何使用
- 创建一个
DropboxSimpleOAuthViewController
实例,并传入 Dropbox app key、app secret、client callback URL 以及一个要在DropboxLoginResponse
和NSError
参数下执行的完成块。 - 一旦
DropboxSimpleOAuthViewController
实例被展示(无论是作为一个模态还是添加到导航栈),它将允许用户登录。用户登录后,初始化视图控制器时提供的完成块将被执行。完成块中的参数DropboxLoginResponse
包含了一个 accessToken 以及其他由 Dropbox API 响应提供的已验证用户的登录信息。如果在尝试认证时出现问题,将给出错误。 - 默认情况下,如果认证出现问题,将向用户显示 UIAlertView。要禁用此功能,直接依赖 NSError,请将属性
shouldShowErrorAlert
设置为 NO。 - 注意:即使可以不使用 app key、app secret、client callback 和完成块(以帮助测试)来初始化视图控制器的实例,但在将其显示给用户之前,必须使用视图控制器的属性设置这些数据。
示例用法
// Simplest Example:
DropboxSimpleOAuthViewController
*viewController = [[DropboxSimpleOAuthViewController alloc] initWithAppKey:@"123I_am_a_client_id_567890"
appSecret:@"shhhhhh, I'm a secret"
callbackURL:[NSURL URLWithString:@"http://your.fancy.site"]
completion:^(DropboxLoginResponse *response, NSError *error) {
NSLog(@"My Access Token is: %@", response.accessToken);
}];
[self.navigationController pushViewController:viewController
animated:YES];
// Disable error UIAlertViews Example:
DropboxSimpleOAuthViewController
*viewController = [[DropboxSimpleOAuthViewController alloc] initWithAppKey:@"123I_am_a_client_id_567890"
appSecret:@"shhhhhh, I'm a secret"
callbackURL:[NSURL URLWithString:@"http://your.fancy.site"]
completion:^(DropboxLoginResponse *response, NSError *error) {
NSLog(@"My OAuth Token is: %@", response.accessToken);
}];
viewController.shouldShowErrorAlert = NO;
[self.navigationController pushViewController:viewController
animated:YES];
测试
该项目已设置为使用 Fastlane 来运行规格。
首先,在项目目录下运行 setup.sh 脚本来捆绑所需的 gems 和 CocoaPods
$ ./setup.sh
然后使用 fastlane 在命令行上运行所有规格
$ bundle exec fastlane specs
版本历史
版本历史可以在 发布页面 找到。
建议、请求和反馈
感谢您查看 DropboxSimpleOAuth 用于您的应用内 Dropbox 认证。任何反馈都可以发送至: [email protected]。