一、准备
1、在微信开放平台注册应用的相关信息,用于获取微信支付或分享需要的WXAppid和UniversalLinks;
2、注册成功之后,你可以看到如图所示相关信息:
获取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文件内容示例如下:
{
"applinks": {
"apps": [],
"details": [
{
"appID": "TeamID.BundleID",
"paths": ["*"]
}
]
}
}
其中,paths 路径建议设置*
通配符;
TeamID为开发者中心的Membership下的Team ID;
BundleID为Xcode->TARGETS->General->Identity下的配置Bundle ID
获取Bundle ID
三、具体实现(以iOS项目Swift语言为例)
1、在AppDelegate.swift文件的didFinishLaunchingWithOptions方法里注册WXApi:
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 方法:
// 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方法:
func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
return WXApi.handleOpenUniversalLink(userActivity, delegate: self)
}
4、唤起微信分享:
// 这里以发送图片+文字+链接形式(微信卡片形式)
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、唤起微信支付:
// 数据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:
// 实现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)
网友评论