WechatKit

WechatKit

---

Getting Started

• CocoaPods

 pod 'WechatKit'

• Carthage

安裝Carthage

 github "starboychina/WechatKit"

Setting

• 設定URL scheme

  在Xcode中，選擇你的工程設定項，選取「TARGETS」一欄，在「info」標籤欄的「URL type「新增「URL scheme」為你在微信開放平台,註冊的應用程式id

• IOS9以後需要加入weixin到白名單(如圖)

  或以原始碼方式開啟info.plist, 並新增以下內容.

	< key >LSApplicationQueriesSchemes</ key >
	< array >
		< string >wechat</ string >
		< string >weixin</ string >
	</ array >

• AppDelegate的handleOpenURL與openURL方法：

  在AppDelegate.swift中加入import WechatKit

    /// iOS 9 以后将弃用 请用下面的方法 #20
    /// -> NS_DEPRECATED_IOS(4_2, 9_0, "Please use application:openURL:options:") __TVOS_PROHIBITED;
    func application ( _ application : UIApplication , open url : URL , sourceApplication : String ? , annotation : Any ) -> Bool {
        return WechatManager . shared . handleOpenURL ( url )
        // 如需要使用其他第三方可以 使用 || 连接 其他第三方库的handleOpenURL
        // return WechatManager.shared.handleOpenURL(url) || TencentOAuth.HandleOpenURL(url) || WeiboSDK.handleOpenURL(url, delegate: SinaWeiboManager.shared) ......
    } 

    /// iOS 9.0 以后请使用这个方法
    /// Please use this (application:openURL:options:)
    func application ( _ app : UIApplication , open url : URL , options : [ UIApplicationOpenURLOptionsKey : Any ] = [ : ] ) -> Bool {
        return WechatManager . shared . handleOpenURL ( url )
        // 如需要使用其他第三方可以 使用 || 连接 其他第三方库的handleOpenURL
        // return WechatManager.shared.handleOpenURL(url) || TencentOAuth.HandleOpenURL(url) || WeiboSDK.handleOpenURL(url, delegate: SinaWeiboManager.shared) ......
    } 

Usage

• 註冊app

  WechatManager . appid = "微信开放平台,注册的应用程序id "
  WechatManager . universalLink = "微信开放平台,注册的应用程序所对应的 Universal Links "
  WechatManager . appSecret = "微信开放平台,注册的应用程序Secret "

• 檢測微信是否安裝

  WechatManager . shared . isInstalled ( )

• 使用微信登入

  預設會記住openid,以及access_token,在token還在有效期時,調用checkAuth則不會打開微信客戶端,直接使用token和微信伺服器獲取認證信息

    WechatManager . shared . checkAuth { result in
        switch result {
        case . failure ( let errCode ) : //登录失败
            print ( errCode )
        case . success ( let value ) : //登录成功 value为([String: String]) 从微信返回的openid access_token 以及 refresh_token
            print ( value ) //当前是在子线程，如需回到主线程调用 DispatchQueue.main.async { print(value) }
        }
    }

• 取得微信用戶訊息

  WechatManager . shared . getUserInfo { result in
      switch result {
      case . failure ( let errCode ) : //获取失败
          print ( errCode )
      case . success ( let value ) : //获取成功 value为([String: String]) 微信用户基本信息
          print ( value ) //当前是在子线程，如需回到主线程调用 DispatchQueue.main.async { print(value) }
      }
  }

• 登出登入

  由於預設會記住openid,以及access_token,如需要切換使用者則需要登出登入.

 WechatManager . shared . logout ( )

---

• 分享到微信

  WechatManager . shared . shareDelegate = self
  /**
  分享

  - parameter scence:      请求发送场景
  - parameter image:       消息缩略图
  - parameter title:       标题
  - parameter description: 描述内容
  - parameter url:         地址
  - parameter extInfo:     app分享信息(点击分享内容返回程序时,会传给WechatManagerShareDelegate.showMessage(message: String)
  */
  WechatManager . shared . share ( scence : WXScene , image : UIImage ? , title : String , description : String , url : String ? = default , extInfo : String ? = default )

• Delegation

分享Delegation

    //app分享后 点击分享返回时调用
    func showMessage ( message : String ) 

License