纯 Swift 写成的 HTTP / HTTPS 网络库:Pitaya(火龙果)

jopen 9年前

Pitaya(火龙果) 是一个写给人看的纯 Swift 写成的 HTTP / HTTPS 网络库。从 AlamofireJustHTTP 偷了一些创意和代码。

使用示例

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,大门永远向所有人敞开。

项目主页:http://www.open-open.com/lib/view/home/1451119346339