iOS Universal Link问题

基本的配置网上都有文章，这里主要说下配置完成后，遇到的奇葩问题。

1. 配置多个applinks后，其中有一个失效了。

比如在Associate Domains中设置了applinks:api.example.com和applinks:apitest.example.cn，一个用于线上环境，一个用于测试环境。

发现在备忘录中，长按https://api.example.com直接打开了浏览器，不会跳转到app，而https://apitest.example.cn则可以。

首先，在iOS14之前，苹果是通过首次安装app的时候，手机请求的这两个域名下的apple-app-site-association文件的。这个时候通过charles抓包工具就可以看到。

然而，在iOS14之后，苹果是通过它自己的CDN服务器去请求的，并且按照文档，是在安装的24小时内请求（实测没有那么大的延迟），一周刷新缓存一次（CDN服务器会自动去根域名下请求）。

那么如何验证CDN请求到了资源呢？
可以在浏览器输入https://app-site-association.cdn-apple.com/a/v1/YourDomain这个链接查看，如果返回了apple-app-site-association的内容，表示已经成功。

这里的YourDomain需要替换成你自己配置的applinks。

我遇到的问题即是替换为线上环境后，请求失败。

2. 分析原因

通过在终端输入curl -v https://app-site-association.cdn-apple.com/a/v1/YourDomain，可以看到详细的网络信息。

一般情况下，通过这个链接去连接苹果CDN服务器是通的，问题在于在目录a/v1下，是否有对应的JSON文件。

> GET /a/v1/YourDomain HTTP/1.1
> Host: app-site-association.cdn-apple.com
> User-Agent: curl/7.64.1
> Accept: */*
>
< HTTP/1.1 404 Not Found
< Content-Type: applicaiton/octet-stream
< Content-Length: 0
< Connection: keep-alive
< Server: nginx
< Date: Fri, 07 Jan 2022 12:005:41 GMT
< ...
< Apple-Failure-Details: {"status":"405 Not Allowed"}
< Apple-From: https://api.example.com/.well-known/apple-app-site-association
...

根据以上错误，我们推测是CDN服务器请求我们的服务器时，返回了405导致的。

3. 解决问题

联系后台排查，联系运维排查，最终发现，是因为运维为了安全考虑，墙了大部分外网ip，导致苹果CDN服务器无法请求成功。

最终，运维对https://api.axample.com/.well-known这个目录做了处理，开放了权限。再次使用curl -v https://app-site-association.cdn-apple.com/a/v1/api.example.com请求确实也成功了。

4. 其他的坑

4.1 apple-app-site-association文件格式发生变化

以前是:

{
  "applinks": {
    "apps": [
      
    ],
    "details": [
      {
        "appID": "xxxxxxx",
        "paths": [
          "*"
        ]
      }
    ]
  }
}

后面变为了:

{
  "applinks": {
    "details": [
      {
        "appIDs": [
          "xxxxxxx"
        ],
        "components": [
          {
            "/": "*",
            "comment": "Matches any URL path"
          }
        ]
      }
    ]
  }
}

至于什么版本，什么时候变得，没有找到。为了兼容，最好使用以前的版本。

4.2 QQ无法分享

这需要在QQ后台配置Universal Link并且校验通过。而且貌似QQ不认新的文件格式，这也是为什么4.1说最好使用老版本的。