DropboxSimpleOAuth 0.2.1

DropboxSimpleOAuth 0.2.1

测试已测试
Lang语言 Obj-CObjective C
许可证 MIT
Released最后发布2019年7月

rbaumbachRyan Baumbach 维护。



 
依赖
SimpleOAuth2= 0.1.5
MBProgressHUD>= 0.9
 

  • Ryan Baumbach

DropboxSimpleOAuth Bitrise Cocoapod Version Carthage Compatible Cocoapod Platform License

一种快速简单地认证 Dropbox 用户在您的 iPhone 或 iPad 应用程序的方法。

iPhone 7 Screenshot iPad Pro 9.7 Screenshot

将 DropboxSimpleOAuth 添加到您的项目中

CocoaPods

CocoaPods 是向项目添加 DropboxSimpleOAuth 的推荐方式。

  1. 在 Podfile 中添加 DropboxSimpleOAuth:pod 'DropboxSimpleOAuth'
  2. 通过运行 pod install 安装 pod(s)。
  3. 使用 #import <DropboxSimpleOAuth/DropboxSimpleOAuth.h> 将 DropboxSimpleOAuth 添加到您的项目中。

Carthage

  1. 在 Cartfile 中添加 github "rbaumbach/DropboxSimpleOAuth"
  2. 按照指示操作,将动态框架添加到您的目标中。

从 Github 克隆

  1. 从 github 克隆仓库并直接复制文件,或将其作为 git 子模块添加。
  2. 将 'Source' 目录中的所有文件添加到您的项目中。

如何使用

  • 创建一个 DropboxSimpleOAuthViewController 实例,并传入 Dropbox app key、app secret、client callback URL 以及一个要在 DropboxLoginResponseNSError 参数下执行的完成块。
  • 一旦 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]