iOS13+ 通用链接（Universal Link）设置解决APP接入微信支付和分享问题

Posted 2023-03-17

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了iOS13+ 通用链接（Universal Link）设置解决APP接入微信支付和分享问题相关的知识，希望对你有一定的参考价值。

参考技术A

最近项目中，微信SDK针对 ios 13系统版本安全性，进行了对应升级，微信SDK版本为openSDK(1.8.6+)。在微信官方介绍中，1.8.6.1 版本开始支持Universal Links方式跳转，对openSDK分享进行合法性校验。
*环境
SDK版本: SDK1.8.6或以上
微信版本: 7.0.7或以上
系统版本: iOS12或以上

1）根据苹果文档配置你应用的Universal Links
微信对Universal Links配置要求
a）Universal Links必须支持https
b）Universal Links配置的paths不能带query参数
c）微信使用Universal Links拉起第三方App时，会在Universal Links末尾拼接路径和参数，因此App配置的paths必须加上通配符/*
1.2 确认App的Universal Links配置成功
微信使用第三方App的Universal Links唤起第三方App时，会在Universal Links末尾拼接路径和参数，因此开发者Universal Links配置必须加上通配符“*”，并测试Universal Links拼接字符串能否唤起app
例如：我微信开发平台配置Universal Links为： https://www.abctest.cn/

appID格式为：TeamID + . + BundleID
TeamID在开发者平台找

2.1注意事项：
自己创建一个名叫 apple-app-site-association的json格式文件，注意文件命不需要添加的后缀。 apple官方参照地址
注意用于在paths 数组中指定网站路径的字符串区分大小写。仅将URL的路径部分用于比较。其他组件（例如查询字符串或片段标识符）将被忽略。
2.2上传apple-app-site-association到服务器(服务器需要支持https)

保存设置，然后重新生成配置文件。

·在 Xcode 中，选择你的工程设置项，选中“TARGETS”一栏，在“info”标签栏下的“URL type“添加“URL scheme”为你所注册的应用程序 id：在“LSApplicationQueriesSchemes“添加weixin 和weixinULAPI（如下图所示）

1：必须在IOS9及以上。
2：当在浏览器中点击Universal Links时，如果这个link和页面是同一个域名，则不走调起，而是当做普通链接在当前浏览器打开。
3：在测试阶段，微信分享或者支付不要打开代理抓包，这样也不走调起.—— 特别注意留心
4：成功调起app后，app的右上角的 state bar有在safari( letv.com )中打开的选项，如果你点击了它，它会跳转到safari，同时系统会认为你选择使用safari打开该域名的链接，而不调起app。以后你再点击该链接，它只会在safari里面跳转。

(1) 在safari页面中，手指往下拉动一下页面，会显示出一个“隐藏”的banner，俗称 smart banner，右侧是一个button：打开（open），点击它，就又会开启app跳转功能。
(2) 把链接粘贴到备忘录中，长按后选择在XXAPP中打开。

iOS Universal Links(通用链接)

简介

什么是Universal Links(通用链接)?
这是iOS9推出的一项功能,如果你的应用支持Universal Links(通用链接),那么就能够方便的通过传统的HTTP链接来启动APP(如果iOS设备上已经安装了你的app,不需要额外做任何判断等), 或者打开网页(iOS设备上没有安装你的app).或许可以更简单点来说明,在iOS9之前,对于从各种从浏览器,Safari、UIWebView或者 WKWebView中唤醒APP的需求,我们通常只能使用scheme.首先是app中注册某个scheme,例如

在网页中,

<a href="kaola://www.kaola.com">打开APP</a>
<!-- 呼叫号码 -->
<a href="tel://13788889999">打开拨号</a>
<a href="sms:1-408-555-1212">打开系统的短信app</a>

但是这种方式有个不好的地方,就是需要提前判断系统中是否安装了能够响应此scheme的app,这个判断,网上很多,例如从浏览器或者Webview 中唤醒APP,如文章所描述的那样,很多网页中的判断是有问题的,经常会出现空白页,跳转不了等.更加悲催的是这种通过scheme方式来打开其它的app的方式,在微信中是被禁用了的.这意味着从微信的app中,是没法打开我们的app的.

Universal Links(通用链接):一条普通的http链接,例如https://yohunl.com/openApp,当你支持通用链接的时候,系统中安装了你的app,那么用户点击链接,就直接进入到你的app中了,无论你是在微信中还是在其它哪里!!! 当你没有安装的时候,你可以去到你指定的页面(你可以直接展示你原来的H5页面,也可以跳转到下载页等).也就是说,用户无需知道你是否安装了app,如果安装了,这条链接就可以进app(进入你app了,你就可以以本地原生页面去展示信息给用户了),没有安装,就直接进原来的h5页面,对用户来说,是一个无缝的过程,非常顺畅!

官方的说明文档

Universal Links(通用链接)的优点

唯一性: 不像自定义的scheme,因为它使用标准的http/https链接到你的web站点,所以它不会被其它的app所声明.另外,Custom URL scheme 因为是自定义的协议，所以在没有安装 app 的情况下是无法直接打开的，而 universal links 本身是一个 HTTP/HTTPS 链接，所以有更好的兼容性
安全:当用户的手机上安装了你的app,那么iOS将去你的网站上去下载你上传上去的说明文件(这个说明文件声明了你的app可以打开哪些类型的http链接).因为只有你自己才能上传文件到你网站的根目录,所以你的网站和你的app之间的关联是安全的.
可变:当用户手机上没有安装你的app的时候,Universal Links也能够工作.如果你愿意,在没有安装你的app的时候,用户点击链接,会在safari中展示你网站的内容.
简单:一个URL链接,可以同时作用于网站和app
私有其它app可以在不需要知道你的app是否安装了的情况下和你的app相互通信.

怎么支持Universal Links(通用链接)

先决条件:

你必须有一个域名,且这个域名的网站需要支持https,然后拥有网站的上传到根目录的权限(这个权限是为了上传一个apple指定的文件)

支持Universal Links(通用链接)

创建一个json格式的命名为apple-app-site-association文件,注意这个文件必须没有后缀名,文件名必须为apple-app-site-association!!!

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "9JA89QQLNQ.com.apple.wwdc",
                "paths": [ "/wwdc/news/", "/videos/wwdc/2015/*"]
            },
            {
                "appID": "ABCD1234.com.apple.wwdc",
                "paths": [ "*" ]
            }
        ]
    }
}

说明:
appID: 这里的组成方式是 teamId.yourapp’s bundle identifier.如上面的 9JA89QQLNQ,ABCD1234都是teamId,这个值从哪来的呢?
它是从的开发者账户的个人中心来的,登陆你的开发者中心
技术分享
com.apple.wwdc是你的方式是 teamId.yourapp’s ,在你的xcode工程中

paths:
根据 paths 键设定一个你的app支持的路径列表,只有这些指定的路径的链接,才能被app所处理,举个例子:如果你的网站是www.yohunl.com,你的path写的是”/support/*”,那么当用户点击www.yohunl.com/support/myDoucument,就可以进入你的app了,相反www.yohunl.com/other 就不会.
path是大小写敏感的!
*号表示任意路径.

上传该文件apple-app-site-association到你的域名所对应的网站的根目录下(其实也不一定是根目录,例如ghost博客站点,就没有根目录一说,它就需要放在相应的主题目录下),这一步是为了苹果能从https://你的域名/apple-app-site-associationxh获取到你上传的apple-app-site-association文件.
上传完后,自己先访问一下,看看是否能够获取到,用我的做例子,https://yohunl.com/apple-app-site-association ,当你点击这个链接,应该是下载apple-app-site-association文件.
验证该文件是否合法,苹果为了方便开发者,提供了一个网页来验证我们编写的这个apple-app-site-association是否合法有效,验证网址,进入网站进行验证
在xcode工程里进行一些配置
首先就是打开工程配置中的Associated Domains打开

在其中的Domains中填入你想支持的域名(这里不是随便填的,是可以支持你需要的Universal Links的域名), 必须以 applinks: 为前缀
例如我的填入的是

applinks:yohunl.com
applinks:www.yohunl.com

苹果将会在合适的时候,从这里填入的域名请求文件apple-app-site-association

注意:当你打开Associated Domains后,xcode会在你的工程中添加.entitlements文件
并且如果你登陆你的开发者中心,可以看到
,这些都是有助于你排除问题的.

到此,你的app就已经可以支持Universal Links(通用链接)了!!!
那么怎么测试呢?

测试Universal Links(通用链接)是否生效

在iOS设备中的备忘录中添加记事本或短信中输入App能识别的链接，然后直接点击此链接,就会直接跳转到你的app了
或是长按,在出现的弹出菜单中第二项是“在’XXX’中打开”，这也代表着成功。
技术分享
或是你将要测试的网址放到safari中一个网页中,然后点击链接,在出现的网页上方,下滑,可以看到有在”XX”应用中打开 (很多教程上说,在safari中直接点击,就会跳转到app,但是经过我实际验证,是不可以的,可能是苹果又调整了一下策略吧)
技术分享
在微信的网页浏览器中,也是可以的,虽然微信屏蔽了所有的custom scheme方式的跳转到其它app,但是Universal Links(通用链接)因为是普通的http链接,由系统直接处理的,微信屏蔽不了,这也就实现了从微信跳转到我们的app!!

工程中添加处理方法

现在用户点击某个链接,直接可以进我们的app了,但是,这不是我们的最终目的,我们的目的是要能够获取到用户进来的链接,根据链接来处理,需要展示给用户的信息

在工程里的 AppDelegate 里实现方法

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray *))restorationHandler
{
    if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
        NSURL *webpageURL = userActivity.webpageURL;
        NSString *host = webpageURL.host;
        if ([host isEqualToString:@"yohunl.com"]) {
            //进行我们需要的处理
        }
        else {
            [[UIApplication sharedApplication]openURL:webpageURL];
        }

    }
    return YES;

}