Universal Links通用链接 使用指南

本文档主要介绍：iOS开发者如何通过Open-APP来快速实现universal links功能，以及几种主要的使用方式。

Open-APP帮你实现的部分产品功能

web页一键拉起App App和微信、QQ等第三方登录分享间的拉起
集成 需集成Open-APP iOS客户端SDK、web端SDK 需集成微信、QQ等第三方SDK
数据 可携带自定义参数，客户端由Open-APP SDK处理回调的数据 没有自定义参数，客户端由微信和QQ SDK处理回调的数据
校验 集成SDK后，需要打包ipa上传Open-APP后台校验关联域名配置情况 需要打包ipa上传Open-APP后台校验关联域名配置情况，然后在微信或QQ后台进行universallinks校验
Open-APP后台配置 后台【iOS配置】中需要开启通用链接开关 在后台【iOS配置】中开启通用链接开关，获取微信universallinks链接，填入QQ互联的APPID并获取universallink host

一、web页一键拉起App

web页一键拉起App，并传递自定义的参数

使用场景如一键拉起到App直播间或指定页面，可实现web页和App端无缝衔接，与App传参安装一起使用，可在App首次安装和安装后打开实现参数传递功能。

快速实现： 需要集成 IOS集成指南，web集成指南

二、微信、QQ等第三方登录分享的拉起

使用第三方登录和分享时，用于替代scheme，实现当前App和微信、QQ等App间的拉起功能

快速实现：
1）苹果开发者后台开启通用链接服务，Xcode中配置好Open-APP提供的 关联域名（Associated Domains）（关联域名可配置多个不会相互影响）。

开启服务

添加associatedDomains

2）编写微信SDK、QQ互联SDK的universal links相关代码。

参考官方文档：微信文档、QQ Universal Links回调处理

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    //向微信注册
    //yourAppkey从Open-APP后台获取
    [WXApi registerApp:APP_ID universalLink:@"https://yourAppkey.openinstall.io/ulink_wx/"];
    return YES;
}

//universal links回调处理写法
-(BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler{
    //openinstall的Universal Link回调处理接口
    //[OpenInstallSDK continueUserActivity:userActivity];

    //QQ的Universal Link回调处理接口
    if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) { 
        NSURL *url = userActivity.webpageURL; 
        if (url && [TencentOAuth CanHandleUniversalLink:url]) {
            // 兼容[QQApiInterface handleOpenURL:delegate:]的接口回调能力 
            [QQApiInterface handleOpenUniversallink:url delegate:(id<QQApiInterfaceDelegate>) [QQApiShareEntry class]]; 
            return [TencentOAuth HandleUniversalLink:url]; 
        } 
    } 

    //微信的Universal Link回调处理接口
    return [WXApi handleOpenUniversalLink:userActivity delegate:self];
}

3）打ipa包上传至Open-APP后台，自动校验参数配置。

检查配置

4）Open-APP后台中开启相关服务

开启通用链接总开关，如果要使用QQ互联登录/分享的universalLink功能，则必须填入QQ互联的APPID，并点击保存按钮（用于配置AASA文件），如图。

Open-APP后台

检查配置是否生效的方法：
可打开浏览器，输入https://{yourAppkey}.openinstall.io/apple-app-site-association，正确展示如图所示

Open-APP后台

5）微信、QQ开发者后台校验工作
在Open-APP后台【iOS集成】-【iOS配置】中，获取微信对应的universal links、QQ对应的universalLink host，填入微信、QQ开发者后台进行校验工作。

校验参考文档：
微信校验Universal Links微信校验Universal Links
QQ校验Universal Links QQ校验Universal Links

wx后台

qq后台