关于iOS系统的Universal link 添加方式 (详细)

一、关于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 即可。

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

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

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

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

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

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

{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。

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

如果正确则如下图

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乱跳的可能。

以后添加...