注意: 将apple-app-site-association文件放到服务器上后, 不需要等待时间, 即可在手机备忘录上长按验证 .
确保 apple-app-site-association 的内容中没有空格和换行符
{ "applinks": { "apps": [], "details": [ { "appID": "DJSQTH886.com.shenrui.new", "paths": [ "*","/app/*"] } ] } }
1 Universal Link 的要求:
需要https的不带端口的域名
2 配置apple-app-site-association
查看创建apple-app-site-association文件
需要注意的几个点:
1. appID格式为: teamid.bundleId, 例如: 9JA89QQLNQ.com.apps
2. paths: 设置有两种: 1. ["*"] 表示通用链接, 即: 只要访问域名就可以打开APP; 2. ["/path1/*"] 表示自定义链接, 即: 必须域名+/path1/ 才可以打开
3. 建议Universal Links配置path,例如/app/*, 避免全域命中Universal Links跳转
{
"applinks": {
"apps": [],
"details": [
{
"appID": "AAAAA.BBBBB",
"paths": ["/path1/*"]
},
{
"appID": "CCCCC.DDDDD",
"paths": ["/path1/*","/path2/*","/path3/*"]
},
{
"appID": "EEEEE.FFFFF",
"paths": ["*"]
}
]
}
}
- 3 将apple-app-site-association上传到服务器
上传 apple-app-site-association文件到域名的根目录和者.well-known子目录下
注意: 访问时能查看到上传的apple-app-site-association文件
访问地址:https://域名/apple-app-site-association
访问地址:https://域名/.well-known/apple-app-site-association
最好根目录和.well-known 目录下都添加
如果使用的是 IIS 服务器,为了让 apple-app-site-association 文件能被访问到,需要 MIME 类型配置。否则会报 404 错误
-
4 Xcode 配置
工程配置中相应功能:targets->Capabilites->Associated Domains,在其中的Domains中填入你想支持的域名,必须以applinks:为前缀。
注意: 域名不能带端口号, 格式为: applinks: + 域名, 例如: applinks:www.baidu.com
注意: 这里的域名最后没有 '/'
image.png 5 获取平台需要的 Universal Link
Universal Links域名为: https://help.wechat.com
网页验证 apple-app-site-association 地址:
https://help.wechat.com/apple-app-site-association
https://help.wechat.com/.well-known/apple-app-site-association
验证 apple-app-site-association 在服务区上配置是否正确: 后面拼接你的domain域名)
https://app-site-association.cdn-apple.com/a/v1/help.wechat.com
Associated Domains为: applinks:help.wechat.com
//配置文件:
{
"appID": "8888888.com.test.SDKSample",
"paths": ["/sdksample/*"]
}
那么在微信开放平台登记以及在openSDK传入的Universal Links正确是:
https://help.wechat.com/sdksample/
测试app-site-association是否成功方案:
使用如下链接:(后面拼接你的domain域名)
https://app-site-association.cdn-apple.com/a/v1/
例如:
https://app-site-association.cdn-apple.com/a/v1/spotify.com
如正常访问到 apple-app-site-association 文件,说明配置成功。