500px-iOS-api 1.0.5

500px-iOS-api 1.0.5

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

未声明的所有者 维护。



  • Ash Furrow 和 Paddy O'Brien

为 Objective-C 写一个 500px API 的包装器,以便开发者更容易地编写针对此出色服务的应用。

仍在进行中;我只是在业余时间做这个。它目前支持从 500px API 读取并检索照片、用户、收藏、关注者等。请参阅API 文档 获取更多信息。

要求

此项目需要 LLVM 4.0+ 和 Xcode 4.5+,并使用 ARC 进行编译。

如何使用

转到您的 Xcode 项目目录,并输入以下内容

git submodule init
git submodule add git://github.com/500px/500px-iOS-api.git

submodule 下载完成后,将新的 Xcode 项目拖放到您现有的项目中。

Drag and drop subproject

现在已添加子项目,我们需要将其链接。扩展子项目的 Products 文件夹,并将 libPXAPI.a 文件拖放到项目详情编辑器中“链接二进制与库”列表中的项目。

Drag and drop the library to be linked against

在“构建设置”下,添加额外的链接器标志 -ObjC

Additional linker flag

现在您已将库链接到,您几乎完成了!无论您在哪里想要使用 500px API,都确保您导入 PXAPI.h 文件

#import <PXAPI/PXAPI.h>

在您的项目的构建设置中,找到“头文件搜索路径”并添加 $(SRCROOT) 并勾选表示递归搜索的框。

注意:如果您的项目路径包含空格,您必须将 $(SRCROOT)(以及所有其他自定义搜索路径)放在引号中。

Header Search Path

在您的应用程序代理的 application:didFinishLaunchingWithOptions: 方法中,添加以下行以设置您的消费者密钥和消费者密钥

[PXRequest setConsumerKey:@"__CHANGE_ME__" consumerSecret:@"__CHANGE_ME__"];

转到500px 应用程序页面 以注册您的消费者密钥和密钥。

使用此库有两种方法。第一种是使用 PXAPIHelper 类方法生成用于直接使用的 NSURLRequest 对象(无论是使用 NSURLConnection 还是 ASIHTTPRequest)。另一种方法是使用内置的 PXRequest 类方法创建对 500px API 的请求;它们提供在请求返回后执行的完成块,并且它们还向默认的 NSNotificationCenter 发送通知。

测试

库目前有一套运行在实时 500px API 上的集成测试。为了运行这些测试,您必须替换 PXIntegrationTests.h 中的以下值。

#define kUserNameForAuthentication  @"__CHANGE_ME__"
#define kPasswordForAuthentication  @"__CHANGE_ME__"

#define kPXAPIConsumerKey       @"__CHANGE_ME__"
#define kPXAPIConsumerSecret    @"__CHANGE_ME__"

还有一些单元测试。OCMock 令人遗憾的是不允许我们测试类方法,所以单元测试的范 围有限。然而,在单元测试和集成测试之间,覆盖率相当好。