一、关于Universal Link

        Universal Link 是苹果在iOS9 中新增的新特性之一,类似于深层链接,可以更简单快速的通过打开一个通用的https链接来直接启动客户端app应用,在实现web-app的无缝链接时能提供极佳的用于体验。

        与传统的URL Scheme作为对比,使用Universal Link可以通过点击链接直接跳转对应APP,不需要通过Sarafi浏览器。如果应用不支持的话,则会在Sarafi中打开该链接。


二、Universal Link的好处

        · 唯一性:不像自定义的URL Scheme,Universal Link使用的是标准的HTTPS协议链接到你的web站点,所以其他APP应用不需要声明。而且URL Scheme是自定义协议,所以必须要求用户安装了app才能实现跳转。

        · 灵活:当用户没有安装APP时,Universal Link可以在Sarafi中展示网站的内容。        

        · 安全:当用户安装了APP时,系统会去网站的根目录下GET你上传的配置说明文件(说明文件后文会提到),这样你的网站与APP之间的关联是安全的。

        · 私有性:其他APP不需要知道你的APP的安装情况。


三、Universal Link 配置过程(以QQ和微信为例)

1、准备好一个支持HTTPS的域名,且有上传到根目录的权限。

eg:https://www.example.com

2、对应证书及描述文件配置生成

        1)进入苹果开发者中心,找到对应App ID后进入后台配置,在Application Services里面勾选Associated Domains,dis和dev证书都勾选。

        2)在描述文件生成过程中勾选该证书,生成PP文件即可。

3、Xcode对应配置

        1)进入工程配置界面,选择Signing&Capabilities栏目。选择对应描述文件后,左上角添加Capability。在弹出来的浮窗中点击Associated Domains 即可。

iOS 更换Universallink iphone universal link_App

 

        2) 在下面的Associated Domains 栏目中添加Domains: applinks:www.example.com。

iOS 更换Universallink iphone universal link_iOS 更换Universallink_02

 

         tips:此步骤对应于Xcode 11以上版本,以下版本直接在Capabilities条目下找到Associated Domains 开关打开填入即可。


4、配置指定说明文件:apple-app-site-association

        配置Universal Link 需要在服务器根目录上传一个指定的说明文件——apple-app-site-association。

        苹果系统会在合适的时候想填入的https域名发起GET请求,请求这个说明文件。切记这个说明文件不能有任何后缀!!!

        apple-app-site-association文件填写如下:

iOS 更换Universallink iphone universal link_Universal_03

 

{appID}为你在对应后台上的appid。

"appID" 由2部分组成 Teamid.Bundleid。

当文件配置好后,上传到你填写的域名的根目录下即可。

5、在对应移动后台上进行配置

        这一步比较简单,即在微信、QQ后台上填写正确的信息。包括bundle id  universal link 等。注意填写universal link的时候,只需要host即可。当然这里要注意的是,有些平台会在你填写的域名后面自动加上一些路径,比如qq平台,会在www.example.com/qq_conn/{appID},而微信却不会,这里后台填写的universal link最终结果一定要和你的网页上存放的AASA文件对应,不然实际上universal link是失效的,走的仍然是URL Scheme。

经过以上配置步骤Universal Link就配置完成了!


四、如何查验配置不成功的一些方法和一些本人遇到的错误

1、apple-app-site-association文件位置错误:可以通过苹果官方给的链接工具进行查验 App Search API Validation Tool

进入网站后输入自己配置的universal link 域名,点击Test URL。

iOS 更换Universallink iphone universal link_Universal_04

 

搜寻不到说明文件会提示报错 Error cannot parse app site association 如图

iOS 更换Universallink iphone universal link_iOS 更换Universallink_05

 

如果正确则如下图

iOS 更换Universallink iphone universal link_iOS 更换Universallink_06

 

tips: Error no apps associated with url 这个错误可以无视。

2、我已经正确配置说明文件,但是universal link还是不起作用

当我们在web中输入https://www.example.com/apple-app-site-association 能看到我们的json文件内容时,却发现app还是无法进行universal link的跳转。那么可能有2个可能

        1)  从app跳转到qq、微信的步骤出错。

        2)  从qq、微信跳转回app出错。

当我们配置好Associated Domains后,在设备第一次启动app的时候,苹果系统会向我们填写的domain发送Http Get请求来获取说明文件,所以我们可以通过Charles抓包来分析问题。如果抓包成功获取到了说明文件,那么就在备忘录中填写一个可以跳转回我们App的universal link(注意,链接填写一定要符合自己说明文件里填写的路径paths,不然是无效的),如果可以成功跳转App,则说明问题出在1)上。如果抓包发现获取失败,打开手机控制台日志,过滤条件输入swcd,我们能看到完整的系统对www.example.com/apple-app-site-association的网络请求过程,里面会有报错信息,根据这些信息可以进行相应的调试,例如有kAuthenticationErr的认证问题,kAuthenticationTimedout的网络超时问题等等。

至于问题1) 多半出在后台配置写入错误的情况,或者是类似于qq后台需要点击验证universal link,其他的什么问题暂时没遇到过。

至于Charles抓包过程,这里就不详细说明了。

五、一些自己遇到的问题汇总

1. QQ分享在iOS13系统上必须添加Universal Link  不然会报设备未授权错误。微信分享不加的话,会从底部系统再次发起URL Scheme请求,结果就是发生APP二次跳转。

2. 当网络不好时会发生跳转失败。

3. 包名一定要填对,不然会报应用未授权错误。

4. teamID注意了 一定要填对。

5. QQ的分享,后台配置好universal link 后要点击验证。验证通过后才能从自己的app跳到QQ。

6. 如果同一域名下有多个App进行关联,一定要在AASA文件中分好路径,切忌使用'*',不然会造成App乱跳的可能。