APP接入微信支付或分享完整流程


一、准备

1、在微信开放平台注册应用的相关信息，用于获取微信支付或分享需要的WXAppid和UniversalLinks；
2、注册成功之后，你可以看到如图所示相关信息：

获取AppID

获取UniversalLinks

3、拷贝保存至项目本地，这里我分别命名为：WXAppID和WXUniversalLinks。

二、项目配置

1、导入WechatOpenSDK，推荐用Cocoapods方式：

  • 在Podfile文件中加入：pod 'WechatOpenSDK'
  • 执行pod install 或 pod update
  • 注意：命令行下执行 pod search WechatOpenSDK，如显示的 WechatOpenSDK 版本不是最新的，则先执行 pod repo update 操作更新本地 repo 的内容。

2、工程配置

  • 在 Xcode 中，选择你的工程设置项，选中“TARGETS”一栏，在“info”标签栏下的“URL type“添加“URL scheme”为你所注册的应用程序 id：


    Xcode 设置URL Scheme

  • 在Xcode中，选择你的工程设置项，选中“TARGETS”一栏，在 “info”标签栏的“LSApplicationQueriesSchemes“添加weixin 和weixinULAPI（如下图所示）


    添加weixin 和weixinULAPI

  • 打开Associated Domains开关，将Universal Links域名加到配置上


    配置Universal Links

  • 配置apple-app-site-association文件内容，并上传至服务器主域名根目录下，保证线上域名任何请求均可以访问到该文件，apple-app-site-association文件内容示例如下：
1
2
3
4
5
6
7
8
9
10
11
{
    "applinks": {
        "apps": [],
            "details": [
            {
                "appID": "TeamID.BundleID",
                "paths": ["*"]
            }
        ]
    }
}

其中，paths 路径建议设置*通配符；
TeamID为开发者中心的Membership下的Team ID；

获取Team ID

BundleID为Xcode->TARGETS->General->Identity下的配置Bundle ID

获取Bundle ID

三、具体实现（以iOS项目Swift语言为例）

1、在AppDelegate.swift文件的didFinishLaunchingWithOptions方法里注册WXApi:

1
2
3
4
5
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // WXAppID为微信申请的App ID，WXUniversalLinks为微信申请的Universal Links
        WXApi.registerApp(WXAppID, universalLink: WXUniversalLinks)
        return true
    }

2、重写 AppDelegate 的 handleOpenURL 和 openURL 方法：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
// iOS9.0以前使用
func application(_ application: UIApplication, handleOpen url: URL) -> Bool {
     let handleUrlStr = url.absoluteString
     if let handleUrl = URL(string: handleUrlStr) {
         return WXApi.handleOpen(handleUrl, delegate: self)
     }
    return false
}
// iOS9.0及以后推荐使用
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
      let handleUrlStr = url.absoluteString
      if let handleUrl = URL(string: handleUrlStr) {
          return WXApi.handleOpen(handleUrl, delegate: self)
      }
      return false
    }

// 必须实现
func application(_ application: UIApplication, open url: URL, sourceApplication: String?, annotation: Any) -> Bool {
      let handleUrlStr = url.absoluteString
     if let handleUrl = URL(string: handleUrlStr) {
         return WXApi.handleOpen(handleUrl, delegate: self)
     }
    return false
    }

3、重写AppDelegate的continueUserActivity方法：

1
2
3
func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
        return WXApi.handleOpenUniversalLink(userActivity, delegate: self)
    }

4、唤起微信分享：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
        // 这里以发送图片+文字+链接形式（微信卡片形式）
        guard WXApi.isWXAppInstalled() && WXApi.isWXAppSupport() else {
            // 如果未安装微信或者微信版本过低，提示去安装或升级
            // ...
            return
        }
        let sendMessageToWXReq = SendMessageToWXReq()
        sendMessageToWXReq.scene = Int32(场景值：微信好友or朋友圈)
        sendMessageToWXReq.bText = false
        let wxMediaMessage = WXMediaMessage()
        wxMediaMessage.title = "分享标题"
        wxMediaMessage.description = "描述文案"
        if let _ = shareModel.image {
          // 压缩图片，防止图片数据过大导致分享无法成功，这里微信要求大小不能超过64K
          let thumImageData =  UIImage.generateImageData(image: shareModel.image!, maxSize: CGSize(width: 300, height: 300), maxDataSize: 32, reduceFrequency: 0.2)
             if let _ = thumImageData {
                  wxMediaMessage.thumbData = thumImageData as Data?
             }
         }
       let wxWebPage = WXWebpageObject()
       wxWebPage.webpageUrl = "跳转url"
       wxMediaMessage.mediaObject = wxWebPage    
       sendMessageToWXReq.message = wxMediaMessage
        WXApi.send(sendMessageToWXReq)

  • 微信分享成功效果如下：


    分享成功示例

    5、唤起微信支付：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// 数据model用于接收后端返回的唤起微信支付必要参数
let req = PayReq()
/** 商家向财付通申请的商家id */
req.partnerId = model.partnerid
/** 预支付订单 */
req.prepayId = model.prepayid
/** 随机串，防重发 */
req.nonceStr = model.noncestr
/** 时间戳，防重发 */
req.timeStamp = UInt32(model.timestamp)
/** 商家根据财付通文档填写的数据和签名 */
req.package = model.package
/** 商家根据微信开放平台文档对数据做的签名 */
req.sign = model.sign
WXApi.send(req) { (bool) in
    // 返回是否成功唤起微信支付
    debugPrint(bool)
 }

  • 微信支付流程如下图示：


    唤起微信支付页面

    输入密码

    支付成功

    6、分享结果或支付结果回调App：

1
2
3
4
5
6
7
8
9
10
11
// 实现WXApiDelegate代理方法
func onResp(_ resp: BaseResp) {
    guard resp.isKind(of: PayResp.self) else {
         // 微信分享结果回调
         let wxSendResult = resp as! SendMessageToWXResp
         debugPrint(wxSendResult.errCode)
         return
     }
    // 微信支付结果回调
    let payresp = resp as! PayResp
    debugPrint(payresp.errCode)

四、至此，微信分享或支付流程已开发完毕，如有不足，请多指教！谢谢！