純 Swift 寫成的 HTTP / HTTPS 網絡庫：Pitaya(火龍果)

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，大門永遠向所有人敞開。

項目主頁：http://www.baiduhome.net/lib/view/home/1451119346339