基本的配置网上都有文章,这里主要说下配置完成后,遇到的奇葩问题。
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说最好使用老版本的。