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首次安装和安装后打开实现参数传递功能。

快速实现:需要集成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后台