QiitaKit 1.0.0

QiitaKit 1.0.0

测试已测试
语言语言 SwiftSwift
许可 MIT
发布最新发布2018年3月
SPM支持SPM

kyo__hei 维护。



QiitaKit 1.0.0

QiitaKit

Carthage compatible Pod Version Pod Platform Pod License Swift version

Swift编写的QiitaAPIClient(v2),同时支持OAuth认证。

用法

设置

Qiita个人页面注册的应用程序的ClientID和ClientSecret进行设置。

// AppDelegate.swift
import QiitaKit

func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {

    /*
     初期設定を行う

     - parameter clientID:                      登録アプリケーションのClientID
     - parameter clientSecret:                  登録アプリケーションのClientSecret
     - parameter teamDomain(Option):            QiitaTeamのドメイン(Optional)
     - parameter keychainConfiguration(Option): トークンを保存するKeychainの設定
    */
    AuthManager.sharedManager.setup(
       clientID: "xxxxx",
       clientSecret: "xxxxx")

    return true

}

OAuth认证

import QiitaKit

// 認証済み判定
let authorized: Bool = AuthManager.sharedManager.authorized

/*
OAuth認証を行う。認証を行うためのWindowが表示されます

- parameter scopes:      アプリで利用可能なスコープ
   - readQiita:      Qiitaからアクセストークンに紐付いたユーザに関連したデータを読み出す
   - readQiitaTeam:  Qiita:Teamからデータを読み出す
   - writeQiita:     Qiitaにデータを書き込む
   - writeQiitaTeam: Qiita:Teamにデータを書き込む

- parameter redirectURL: 登録アプリケーションで設定したリダイレクト先のURL

- parameter webViewType: OAuth認証を行うWebViewの種類

- parameter completion:  認証後に呼ばれるハンドラ

*/
AuthManager.sharedManager.authorize(withScopes: scopes,
                                    redirectURL: redirectURL,
                                    webViewType: .UIWebView)
{ result in
    switch result {
    case .success:
        // 認証成功

    case .failure(let error):
        // 認証失敗
    }
}

请求

适用于QiitaAPI的各种请求。

import QiitaKit

// 認証中ユーザ情報を取得するリクエストオブジェクト
let request = QiitaAPI.User.GetAuthenticatedUserRequest()

// リクエスト送信
APIClient().send(request) { result in
    switch result {
    case .success(let authenticatedUser):
        print(authenticatedUser)

    case .failure(let error):
        print(error)
    }
}

安装

Carthage

  • github "ykyouhei/QiitaKit" 追加到Cartfile中。
  • 运行carthage update
  • 将生成的QiitaKit.framework链接到项目中的Carthage/Checkouts下面。

CocoaPods

  • 在Podfile中追加pod 'QiitaKit'
  • 运行pod install