美文网首页iOS开发(OC)
适配Universal Links(微信分享和QQ分享)

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

作者: 张付东 | 来源:发表于2020-04-22 17:06 被阅读0次

    前言:
    由于苹果iOS 13系统版本安全升级,为此微信openSDK在1.8.6版本进行了适配。 1.8.6版本支持Universal Links方式跳转,对openSDK分享进行合法性校验。所以微信有关的SDK也要更新,就将微信分享和微信支付升级到了6.9.8版本. 在下面,我将结合微信的文档,简单梳理一下疑惑点....
    1: 微信关于openSDK1.8.6的更新说明
    2: 微信开放平台移动应用 SDK 更新提醒

    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
    }
    

    如果调用友盟分享的时候,切记

        /* 配置微信平台的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

    相关文章

      网友评论

        本文标题:适配Universal Links(微信分享和QQ分享)

        本文链接:https://www.haomeiwen.com/subject/hsolmhtx.html