为 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 项目拖放到您现有的项目中。
现在已添加子项目,我们需要将其链接。扩展子项目的 Products 文件夹,并将 libPXAPI.a
文件拖放到项目详情编辑器中“链接二进制与库”列表中的项目。
在“构建设置”下,添加额外的链接器标志 -ObjC
。
现在您已将库链接到,您几乎完成了!无论您在哪里想要使用 500px API,都确保您导入 PXAPI.h
文件
#import <PXAPI/PXAPI.h>
在您的项目的构建设置中,找到“头文件搜索路径”并添加 $(SRCROOT)
并勾选表示递归搜索的框。
注意:如果您的项目路径包含空格,您必须将 $(SRCROOT)
(以及所有其他自定义搜索路径)放在引号中。
在您的应用程序代理的 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 令人遗憾的是不允许我们测试类方法,所以单元测试的范 围有限。然而,在单元测试和集成测试之间,覆盖率相当好。