适配Universal Links(微信分享和QQ分享)

前言:
由于苹果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, 之后把证书在更新一遍即可

associatedDomains.png

2: 在Xcode中使用Associated Domains，如果没有找到，点击下图红框里面的加号，添加即可.

a.png

假如我的服务域名是:https://blcokred.com, 即applinks:blcokred.com, 域名必须是https格式

b.png

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，如下图

c.png

5: 在微信开发者中心设置Universal Links

d.png

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<NSString*, id> *)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<id<UIUserActivityRestoring>> * _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

8:服务器上apple-app-site-association的更新不会让iOS本地的apple-app-site-association同步更新，即iOS只会在App第一次启动时请求一次，以后除非App更新或重新安装，否则不会在每次打开时请求apple-app-site-association, 如果要更新这个时候，恰好本地也有微信分享和微信支付，这个更改对微信支付没有任何影响，但是对微信分享会有影响，建议新版本上线之后，在到微信开发平台更新新的Universal Links，如果提前更新了，会造成分享失败