Foursquare API v2 iOS 封装库使用文档

本文档旨在帮助开发者安装和使用 Foursquare API v2 的 iOS 封装库，详细介绍安装指南、使用说明以及 API 使用文档。

1. 安装指南

注册 API 消费者密钥

首先，您需要在 Foursquare 注册以获取 API 消费者密钥。该库使用 Safari 和自定义 URL Scheme 将用户引导回您的应用。

例如，FSQDemo 应用使用 fsqdemo URL Scheme。

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

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

安装

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

自动引用计数 (ARC)

如果您的项目启用了 Objective-C 自动引用计数 (ARC)，则需要为所有 BZFoursquare 源文件设置 -fno-objc-arc 编译器标志。在 Xcode 中，选择活动目标并选择“构建阶段”选项卡。在“编译器标志”列中，为每个 BZFoursquare 源文件设置 -fno-objc-arc。

MobileCoreServices

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

设置自定义 URL Scheme

将自定义 URL Scheme 添加到您的项目中。

2. 项目使用说明

本项目提供了 Foursquare API v2 的 Objective-C 封装，支持异步请求，易于集成到 iOS 应用中。

示例应用

库中包含一个名为 FSQDemo 的示例应用，演示了授权和 API 调用的方法，以帮助您进行开发。

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

3. 项目 API 使用文档

本项目提供的 API 使用文档请参考以下示例：

// 示例代码
BZFoursquare *foursquare = [[BZFoursquare alloc] initWithClientID:@"YOUR_CLIENT_ID" callbackURL:@"YOUR_CALLBACK_URL"];

4. 项目安装方式

请按照以下步骤安装本项目：

1. 注册 Foursquare API 消费者密钥。
2. 将 BZFoursquare 文件夹中的所有文件复制到您的项目中。
3. 设置编译器标志和链接库。
4. 添加自定义 URL Scheme。

通过上述步骤，您可以轻松地将 Foursquare API v2 集成到您的 iOS 应用中。