Foursquare API v2 for iOS

对 foursquare API v2 的简单 Objective-C 封装。它允许您将 foursquare 集成到您的 iOS 应用程序中。

特性

• 简单、小巧且易于使用
• 使用 Safari 进行身份验证（见下面的未来计划）
• 支持异步请求
• 开源 BSD 许可证

要求

• Xcode 5 或更高版本
• 基础 SDK：iOS 7.0 或更高版本
• 部署目标：iOS 5.0 或更高版本

此库需要您的应用链接到以下框架

• Foundation.framework
• MobileCoreServices.framework
• UIKit.framework

入门指南

1. 注册 API 消费者密钥

   为了获取 oAuth 访问令牌，此库使用 Safari 和自定义 URL 方案将用户带回到您的应用中。例如，FSQDemo 应用使用了 fsqdemo URL 方案。

   

   在创建 BZFoursquare 对象时需要客户端 ID 和回调 URL。

   BZFoursquare *foursquare = [[BZFoursquare alloc] initWithClientID:@"YOUR_CLIENT_ID" callbackURL:@"YOUR_CALLBACK_URL"];
   

2. 安装

   将 BZFoursquare 文件夹中的所有文件复制到您的项目中。

   自动引用计数 (ARC)

   如果您将这个库集成到项目中且启用了 Objective-C 自动引用计数 (ARC)，您需要在所有 BZFoursquare 源文件上设置编译器标志 -fno-objc-arc。在 Xcode 中这样做，请转到活动目标并选择“构建阶段”选项卡。在“编译器标志”列中，为 BZFoursquare 的每个源文件设置 -fno-objc-arc。以下为 FSQDemo 项目的设置。

   

   MobileCoreServices

   您需要将 MobileCoreServices 库添加到您的项目中。在 Xcode 中这样做，请转到活动目标并选择“构建阶段”选项卡。在“链接二进制与库”部分，点击加号按钮并从弹出的对话框中选择 MobileCoreServices。

   

3. 设置自定义 URL 方案

   将自定义URL方案添加到您的项目中。以下为FSQDemo项目的设置。

   

示例应用

此库包含FSQDemo应用，该应用演示了授权，并通过API调用来指导您进行开发。

要构建和运行FSQDemo应用，请在Xcode 5或更高版本中打开FSQDemo项目，并将FOURSQURE_CLIENT_ID设置为您自己的客户端ID。

许可证

针对iOS的Foursquare API v2可在2条款BSD许可证下获取。有关更多信息，请参阅LICENSE文件。

未来计划

• Foursquare原生认证支持