前言:
由于苹果iOS 13系统版本安全升级,为此微信openSDK在1.8.6版本进行了适配。 1.8.6版本支持Universal Links方式跳转,对openSDK分享进行合法性校验。所以微信有关的SDK也要更新,就将微信分享和微信支付升级到了6.9.8版本. 在下面,我将结合微信的文档,简单梳理一下疑惑点....
1: 微信关于openSDK1.8.6的更新说明
2: 微信开放平台移动应用 SDK 更新提醒
3:检测自己的Universal Links是否配置成功
1: 在苹果开发中心Identifiers中配置Associated Domains, 之后把证书在更新一遍即可
2: 在Xcode中使用Associated Domains,如果没有找到,点击下图红框里面的加号,添加即可.
假如我的服务域名是:https://blcokred.com, 即applinks:blcokred.com, 域名必须是https格式
3: 新建apple-app-site-association 文件
文件名必须为apple-app-site-association的json格式文件,文件名不需要添加的后缀。
//命名规则:
//1:appID将处理格式为的链接的应用程序的标识;命名规则:TeamID+Bundle Id (TeamID 可以从开发者中心 -> Membership 中查看);
//2:paths应用程序支持的网站各个部分,以路径字符串数组形式指定。只有这些指定的路径的链接,才能被app所处理, *符号写法代表了可识别域名下所有链接。
{
"applinks": {
"apps": [],
"details": [
{
"appID": "G2A3GGAH67G.cn.wechat.abc",
"paths": ["*"]
}
]
}
}
//3: 上传 apple-app-site-association文件到域名的根目录或者.well-known子目录下;
// 在浏览器中能打开https://域名 或 https://域名/apple-app-site-association
// 或 https://域名/.well-known/apple-app-site-association。
4: 在Xcode中info中配置参数, 添加weixinULAPI、wechat、weixin,如下图
5: 在微信开发者中心设置Universal Links
6: 在AppDelegate里面设置相对应的方法
#define UNIVERSAL_LINK @"https://blcokred.com/"
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[self setWechatSetting];
}
/**
* 设置微信相关信息
*/
-(void) setWechatSetting {
#ifdef DEBUG
/*在register之前打开log, 后续可以根据log排查问题*/
[WXApi startLogByLevel:WXLogLevelDetail logBlock:^(NSString *log) {
NSLog(@"WeChatSDK: %@", log);
}];
#endif
/*注册微信支付*/
[WXApi registerApp:SQ_WECHATPAY_KEY universalLink:UNIVERSAL_LINK];
#ifdef DEBUG
/*调用自检函数(支付或者分享成功之后要删除这个方法,不然会导致会每次打开app都会与微信进行关联)*/
[WXApi checkUniversalLinkReady:^(WXULCheckStep step, WXCheckULStepResult* result) {
NSLog(@"---------%@, %u, %@, %@", @(step), result.success, result.errorInfo, result.suggestion);
}];
#endif
}
打印如下:
app[14232:3095208] ---------0, 1, check passed,
app[14232:3095208] ---------1, 1, check passed,
app[14232:3095208] ---------2, 1, check passed,
app[14232:3095208] ---------3, 1, check passed,
app[14232:3095208] ---------4, 1, check passed,
app[14232:3095208] ---------5, 1, Universal Link check passed. The application is launched by WeChat via Universal Link,
app[14232:3095208] ---------6, 1, All Check Passed!,
如果调用友盟分享的时候,切记
/* 配置微信平台的Universal Links
* 微信和QQ完整版会校验合法的universalLink,不设置会在初始化平台失败
*/
[UMSocialGlobal shareInstance].universalLinkDic = @{@(UMSocialPlatformType_WechatSession):UNIVERSAL_LINK};
重写 AppDelegate 的 handleOpenURL 和 openURL 方法:
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
return [WXApi handleOpenURL:url delegate:self];
}
// 9以后会走这个
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary *)options NS_AVAILABLE_IOS(9_0){
return [WXApi handleOpenURL:url delegate:self];
}
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {
return [WXApi handleOpenURL:url delegate:self];
}
重写AppDelegate或SceneDelegate的continueUserActivity方法
/* 设置Universal Links系统回调 */
-(BOOL) application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray> * _Nullable))restorationHandler {
return [WXApi handleOpenUniversalLink:userActivity delegate:self];
}
/* 适配了SceneDelegate的App,系统将会回调SceneDelegate的continueUserActivity方法,所以需要重写SceneDelegate的该方法 */
- (void)scene:(UIScene *)scene continueUserActivity:(NSUserActivity *)userActivity {
[WXApi handleOpenUniversalLink:userActivity delegate:self];
}
程序要实现和微信终端交互的具体请求与回应,因此需要实现 WXApiDelegate 协议的两个方法:
#pragma mark - WXApiDelegate
//如果第三方程序向微信发送了 sendReq 的请求,那么 onResp 会被回调。sendReq 请求调用后,会切到微信终端程序界面。
//微信支付成功之后,会在此处回调,发个通知给到对应的界面,来接收支付成功之后的页面跳转情况
- (void)onResp:(BaseResp *)resp {
if([resp isKindOfClass:[PayResp class]]){
[[NSNotificationCenter defaultCenter] postNotificationName:sg_kWechatPayResultNoti object:self userInfo:@{@"resp":resp}];
}
}
//是微信终端向第三方程序发起请求,要求第三方程序响应。第三方程序响应完后必须调用 sendRsp 返回。在调用 sendRsp 返回时,会切回到微信终端程序界面。
-(void) onReq:(BaseReq*)reqonReq {
}
7: 还有涉及QQ分享的,可以参考如下官方链接配置
QQ配置校验universallinks