本篇旨在宣导如何配置iOS项目并成功通过Universal Links方式调起(启动或跳转)APP,其他需求请移步微信开放平台技术文档。
首先,要生成一个名叫“apple-app-site-association”的文件,注意没有带后缀名,以什么方式生成都可以,这里介绍使用命令行生成“apple-app-site-association”文件:
cd xxx (注:xxx为生成“apple-app-site-association”所在的目录)
touch apple-app-site-association (注:此为生成文件命令,或者直接执行下面的命令行)
vim apple-app-site-association
键盘输入“i”,进入文件编辑状态,将以下模版复制粘贴到文件中
{
"applinks":{
"details":[
{
"appIDs":["App ID“,”App ID“,”AppID"],
"components":[
{
"#":"no_universal_links",
"exclute":true,
"comment":"Matches any URL whose fragment equals no_universal_links and instructs the system not to open it as a universal link"
},
{
"/":"*",
"comment":""
}
]
}
]
},
"webcredentials":{
"apps":["App ID“,”App ID“,”AppID"]
}
}
注意事项:只有在applinks服务类型下才能注入“details”字典,其他服务类型下不能注入“details”字典,官方说明如下:

编辑好内容后点击键盘ESC键,然后接着输入命令行":wq",最后回车,apple-app-site-association创建完成

上述App ID格式为:<Application Identifier Prefix>.<Bundle Identifier>比如:ABCDE12345.com.example.app
查看App ID方法一:Developer 账号管理中心


方法二:查看xxx.mobileprovision文件,选择文件鼠标右键->显示简介


生成apple-app-site-association关联文件后,将关联文件上传至指定格式的服务器后台目录下(由服务器后台人员完成),即关联文件应该放在域名根目录下的".well-known"目录下,格式为https://<fully qualified domain>/.well-known/apple-app-site-association,例如:https://www.example.com/app/apple-app-site-association或者https://www.example.com/apple-app-site-association,并且该域名必须是支持https协议,没有重定向的

完成以上步骤,接下来就是给App添加关联域名授权。再次登录苹果开发者账号管理中心,找到需要添加授权的App ID,点击进入编辑页,勾选Associated Domains,再点Save保存,如有确认弹窗提示,请点击Confirm(确认)。


然后通过Xcode更新mobileprovision文件,即更新上述保存的文件,Xcode->Perferances...->Account->AppIds->Team&role->Download Manual Profiles


最后打开项目,给项目添加关联域名配置,添加的关联域格式为<service>:<fully qualified domain>,例如applinks:www.example.com



到这里整个配置工作才算完成,但是配置完成并不代表配置成功,我们可以通过官方提供的测试平台去测试我们配置的关联域是否成功,所以接下来我们去测试下我们配置的关联域是否有效,如果有问题可以尽早定位问题并解决问题,不然又是白忙活一场。附上测试入口:Associated Domains Test API

网友评论