Universal Links通用链接 使用指南

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

openinstall帮你实现的部分产品功能

web页一键拉起AppApp和微信、QQ等第三方登录分享间的拉起
集成需集成openinstall iOS客户端SDK、web端SDK需集成微信、QQ等第三方SDK
数据可携带自定义参数，客户端由openinstall SDK处理回调的数据没有自定义参数，客户端由微信和QQ SDK处理回调的数据
校验集成SDK后，需要打包ipa上传openinstall后台校验关联域名配置情况需要打包ipa上传openinstall后台校验关联域名配置情况，然后在微信或QQ后台进行universallinks校验
openinstall后台配置后台【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中配置好openinstall提供的 关联域名（Associated Domains）（关联域名可配置多个不会相互影响）。

开启服务

添加associatedDomains

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

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

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    //向微信注册
    //yourAppkey从openinstall后台获取
    [WXApi registerApp:APP_ID universalLink:@"https://yourAppkey.openinstall.io/ulink/"];
    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包上传至openinstall后台，自动校验参数配置。

检查配置

4）openinstall后台中开启相关服务

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

openinstall后台

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

openinstall后台

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

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

wx后台

qq后台