Bas quadrat

Bas quadrat是一个用Swift编写的捷报API包装器。

功能

• 支持iOS和OSX。
• 涵盖所有API端点。
• 为两个平台实现了授权流程。
• 在iOS上实现原生授权。
• 图片下载/上传。
• 图片缓存。
• 支持多个账户。

安装

嵌入式框架（iOS 8.0+）

1. 将Bas quadrat作为子模块添加。git submodule add [email protected]:.Constantine-Fry/das-quadrat.git
2. 将Quadrat.xcodeproj拖放到您的项目中。该项目有两个目标：Quadrat.framework用于OSX项目，QuadratTouch.framework用于iOS项目。
3. 在“构建阶段”->“目标依赖项”中添加新目标。
4. 点击面板左上角的+按钮，选择“新复制文件阶段”。
   • 将新阶段重命名为“复制框架”。
   • 将“目标”设置为“ frameworks”。
5. 将Quadrat框架添加到这个阶段。
6. 这里是图片，以可视方式显示结果。
7. 请阅读Wiki以获取详细信息。

您可以直接将源代码文件添加到您的项目中以支持iOS 7.0。

使用

设置会话

let client = Client(clientID:       "FOO.................FOO",
                    clientSecret:   "BAR.................BAR",
                    redirectURL:    "testapp123://foursquare")
var configuration = Configuration(client:client)
Session.setupSharedSessionWithConfiguration(configuration)

let session = Session.sharedSession()

搜索请求

var parameters = [Parameter.query:"Burgers"]
parameters += self.location.parameters()
let searchTask = session.venues.search(parameters) {
    (result) -> Void in
    if let response = result.response {
        self.venues = response["venues"] as [JSONParameters]?
        self.tableView.reloadData()
    }
}
searchTask.start()

多请求

let task1 = self.quadratSession.users.get()
let task2 = self.quadratSession.users.friends(userId: "self", parameters: nil)

let multiTask = self.quadratSession.multi.get([task1, task2]){
    (responses) -> Void in
    println(responses)
}
multiTask.start()

原生授权

如果安装了实际的Foursquare应用程序，库将尝试通过原生方式进行授权。它将在应用程序中对授权进行切换，并在成功后切换回您的应用程序。目前，在Foursquare应用程序中没有机制将应用程序切换回应用程序，如果用户从那里取消授权，因此如果用户选择取消授权，则需要手动返回到您的应用程序。

如果用户的设备上未安装Foursquare应用，则您的应用将显示一个模态视图控制器，其中包含一个UIWebView，该WebView将显示基于网络的授权屏幕。这个过程不会离开您的应用，并且可以取消以返回上一个屏幕。

在iOS9中，应用必须声明它想要检查的URL方案，这是通过使用canOpenURL:来完成的。要启用与Foursquare应用的本地授权，您必须将foursquareauth添加到项目中的info.plist文件中的LSApplicationQueriesSchemes数组中。

要求

Swift 2.0 / iOS 8.0+ / Mac OS X 10.9+

许可证

BSD 2-Clause许可证。详细信息请参阅License.txt。

波恩，2014年12月。