纯 Swift 写成的 HTTP / HTTPS 网络库:Pitaya(火龙果)
jopen
9年前
Pitaya(火龙果) 是一个写给人看的纯 Swift 写成的 HTTP / HTTPS 网络库。从 Alamofire 和 JustHTTP 偷了一些创意和代码。
使用示例
Pita.build(HTTPMethod: .GET, url: "https://httpbin.org/get?hello=Hello%20Pitaya!") .responseJSON { (json, response) -> Void in print(json["args"]["hello"].stringValue) // get "Hello Pitaya!" }
功能
- 支持 Swift Package Manager
- 写给人用的优雅 API
- 支持 HTTP Basic Authorization
- 支持设置 SSL 钢钉,防“中间人攻击”
- 支持设置 HTTP raw body (支持 JSON body)
- 异步、队列
- 快速文件上传
- 内置 JSONNeverDie,完全支持 JSON 数据
- 支持设定 HTTP headers
- 几乎 100% 测试率
环境要求
- iOS 7.0+
- Xcode 6.4 (Swift 1.2) 版: v0.2.3
- Xcode 7 (Swift 2) 版:当前默认版本
安装
Swift Package Manager
The Swift Package Manager 是苹果伴随 Swift 开源而推出的 Swift 语言包管理工具。
编辑你项目的Package.swift:
import PackageDescription let package = Package( name: "YOUR_PROJECT_NAME", targets: [], dependencies: [ .Package(url: "https://github.com/johnlui/Pitaya.git", versions: "1.3.4" ..< Version.max) ] )
Swift Package Manager 依然在开发中,功能不太稳定,建议关注它的 GitHub Page。
Carthage
Carthage 是一个去中心化的 Cocoa 应用程序自动依赖添加工具。
使用以下命令安装 Carthage
$ brew update $ brew install carthage
安装好 Carthage 后,将下列内容加入你项目的 Cartfile:
github "JohnLui/Pitaya"
自动下载、编译 Pitaya:
carthage update
最后,在 general panel 里 的 "Embedded Binaries" 项下点击 "Add Other..." 按钮,Pitaya.framework 已经躺在了./Carthage/Build/iOS目录里。
这种方法目前还不支持 BITCODE,如果需要支持,请直接将 Pitaya.xcodeproj 拖入你的工程。
手动安装
git clone https://github.com/johnlui/Pitaya.git open Pitaya
在打开的 Finder 窗口中把 Pitaya.xcodeproj 拖到 Xcode 你的文件树里。
真机调试还需要额外的一步:打开 PROJECT->TARGETS->[your project name]->General,找到 Embedded Binaries, 点击 +, 选中 Pitaya.framework,点击“Add”即可。
源代码安装
把Source文件夹下的文件拖进你的文件树里即可。
参与开源
欢迎提交 issue 和 PR,大门永远向所有人敞开。