1、苹果开发者网站上开启Associated Domains服务
登录苹果开发者网站,在Certificates, Identifiers & Profiles页面左侧选择Identifiers,右侧选择对应的App ID,点击进入配置详情页,开启Associated Domains服务;
2、更新Profile文件(配置文件)
在Certificates, Identifiers & Profiles页面左侧选择Profiles,右侧选择对应的配置文件,点击进入,点击Edit进入修改页,直接点击Save,保存后点击Download下载并打开;
3、Xcode配置
Xcode打开项目,进入工程配置,添加Associated Domains项,步骤如图:
4、添加完成后配置applinks域名
注意:
a、必须是https链接,域名要有SSL证书
b、必须外网能访问(可以理解为不用代理直接用流量能访问)
c、将https://替换为applinks:
d、不用/结尾
e、可以给Debug、Release分别配置。
配好后格式如图:(applinks:为前缀,test.uubx.com为域名)
5、创建apple-app-site-association文件
(1)文件名必须为:apple-app-site-association,直接复制
(2)文件不能跟后缀,是纯文本
(3)文件必须放在服务器根目录或者.well-known目录下,这是苹果规定的,具体请教后端的同事
创建步骤:
a、打开系统自带的文本编辑器,进入偏好设置,如图:
b、进入打开和存储,关闭给纯文本文件添加.txt扩展名选项,如图:
c、选择格式,切换为制作纯文本,如图:
d、编辑内容,先复制以下内容到编辑器,并看注释
{"applinks":{"apps":[],"details":[{"appID":"AAAAA.BBBBB","paths":["/path1/*"]},{"appID":"CCCCC.DDDDD","paths":["/path1/*","/path2/*","/path3/*"]},{"appID":"EEEEE.FFFFF","paths":["/*"]}]}}
或者找一些大厂的通用链接下载参考。格式一般为 https://大厂域名/apple-app-site-association 。
注释:
(1)格式是固定的
(2)apps为空就行,不需要更改
(3)支持多个App共用一个apple-app-site-association文件(即一个域名有多个App在使用)
(4)多个App共用,只需要在上述配置details中添加
(5)details为一个list,切记注意格式
(6)details下一个字典为一个App,多个App添加多个字典就行,注意,号隔开
(7)details下字典格式固定,注意别更改
(8)appID格式为:Team ID+.+Bundle Identifier,即上述配置中,AAAAA、CCCCC、EEEEE为Team ID,BBBBB、DDDDD、FFFFF为Bundle Identifier,注意Team ID与Bundle Identifier中间用”.“链接
(9)Team ID查找,登录开发者账号,进入账户,进入会员资格详细信息,找到团队 ID,即为Team ID,如图
(10)paths是一个list,表示路径,一个App可以配置多个path,也可以直接使用/*
(11)/* 表示通用链接,即只要域名正确,可以直接命中,一般不建议直接使用/* ,如配置为/path1/* ,则必须域名+/path1/才能命中
(12)path中的路径是自定义的,但一定要以/* 结尾,切记,切记,切记
e、编辑好内容后,保存文件,切记文件名字必须为apple-app-site-association,如图:
6、上传文件到服务器
将刚才的文件发送给运维同事,让帮忙上传至服务器根目录(IIS为wwwroot文件夹)或者.well-known(用命令创建)目录下,切记,只能这两个目录。
如果web服务器为IIS,并且服务器配置完毕后访问链接一直不通过,可以修改站点MIME类型。修改完毕后点确定即可打开。
拓展名:.
MIME类型:application/octet-stream
如图
7、验证
7.1 验证服务器文件上传是否成功
在服务器上传文件后,通过浏览器是可以正常访问到的。如果文件放在根目录下,链接为:https://test.uubx.com/apple-app-site-association,如果文件放在.well-known目录下,则链接为:
https://test.uubx.com/.well-known/apple-app-site-association(注:https://test.uubx.com/需要替换为你自己的域名)。浏览器打开后,会看到我们刚才配置的apple-app-site-association文件内容,如果不能,则需要查看文件目录是否正确,网络是否支持外网,服务器是否拦截。
7.2 验证Universal Link链接是否配置正确
方法一:打开备忘录,输入https://test.uubx.com/path1/(域名替换为你配置的域名,path1路径替换为你自己配置的路径,如果直接配置的/* 则直接输入域名即可),编辑完成后,长按链接,如果出现在”XXX”中打开,则表示配置成功。如图:
看到在XXX 中打开就是成功了。