MendeleySDK 2.1.4

MendeleySDK 2.1.4

×

测试已测试✗
Lang语言 Obj-CObjective C
许可证 LICENSE
Released最后发布2016年11月

由 Vincent Tourraine 维护。

MendeleySDK 2.1.4

Mendeley API的Objective-C客户端。

MendeleySDK是基于iOS和OS X的Mendeley API客户端，建立在AFNetworking和AFOAuth2Client之上。

Demo app screenshot paper

入门指南

安装

CocoaPods是推荐方式，将MendeleySDK添加到您的项目中。

下面是一个例子Podfile，它会安装MendeleySDK及其依赖库AFOAuth2Client。

platform :ios, '5.0'

pod 'MendeleySDK', '~> 2.1'

应用程序凭据

使用您的应用程序客户端ID，客户端机密和重定向URI调用 clientWithClientID:secret:redirectURI: 来配置您的API客户端（例如在 application:didFinishLaunchingWithOptions: 中）

MDLMendeleyAPIClient *APIClient = [MDLMendeleyAPIClient clientWithClientID:@"###my_client_ID###"
                                                                    secret:@"###my_client_secret###"
                                                               redirectURI:@"###mdl-custom-scheme://oauth?###"];

如果您没有消费者密钥和机密，请访问Mendeley开发者门户并首先注册您应用程序。

OAuth授权流程

一旦配置了API客户端，您需要使用带有 authenticationWebURL 请求的web浏览器。这个页面会确保您的应用程序正确识别，并提示用户输入他的凭证。您可以使用应用程序中的内置 UIWebView，或者打开Safari并使用自定义URL方案截获响应。

登录后，您将获得一个授权码。然后您可以通过调用 validateOAuthCode:success:failure: 来验证此代码，以获取访问和刷新令牌。

截至今天，MendeleySDK不支持公开资源的客户端凭据流。

好的，你现在应该可以开始使用了！您也可以查看示例应用程序，看看事情是如何工作的。

示例

如何创建一个新文档

MDLDocument *document = [[MDLDocument alloc] init];
document.title = @"My Title";
[document createWithClient:self.APIClient success:^(MDLObject *document) {
     /* ... */
} failure:^(NSError *error) {
    /* ... */
}];

如何上传文件

MDLDocument *document;
[document uploadFileWithClient:self.APIClient 
                         atURL:localFileURL
                   contentType:@"application/pdf"
                      fileName:@"file.pdf"
                       success:^(MDLFile *newFile) {
                       /* ... */
                   } 
                   failure:^(NSError *error) {
                   /* ... */
               }];

参考资料

需求

MendeleySDK 需要 Xcode 7.0，并安装 iOS 5.0 或 OS X 10.7 SDK，同时需要 AFOAuth2Client。

致谢

MendeleySDK 由 shazino 开发。

许可

MendeleySDK 根据 MIT 许可。有关更多信息，请参阅 LICENSE 文件。