当前位置: 代码迷 >> 综合 >> 微信分享iOS Universal Link配置说明
  详细解决方案

微信分享iOS Universal Link配置说明

热度:108   发布时间:2023-09-27 23:02:09.0

说明:写此文章的目的是记录配置iOS Universal Link出现的问题,给我一样的新手一点参考而已。

由于iOS 13系统版本的安全升级,官方微信SDK从1.8.6改版,支持*Universal Link*模式跳转,分享时校验合法性,如果不配置Universal Link或者配置错误,微信分享时就出线二次跳转等现象。

至于什么是Universal Link?它的作用是什么,请自行问度娘。

以下就是配置Universal Link的相关步骤:

一、在Apple开发者中心配置Associated Domains

        1、登录苹果开发者中心,找到对应项目的APPID,如下图:

微信分享iOS Universal Link配置说明微信分享iOS Universal Link配置说明

微信分享iOS Universal Link配置说明 

        2、自己申请一个HTTPS的域名,切记这个域名一定要是https的,且域名中不能带有下划线“_”,横线"-"等特殊字符,否则后面分享分享时还是会二次跳转且在苹果开发者中心验证不会通过,切记切记。(就是这个原因折腾了我好久)

三、配置指定的Universal Link文件(apple-app-site-association) 

 创建一个内容为json格式的文件,苹果将会在合适的时候,从我们在项目中填入的域名请求这个文件,一般是在安装app的时候会自动下载,后面便不会更新,所以更换了universal link 域名,一定要删除app后重新下载才会更新。这个文件名必须为apple-app-site-association,切记没有后缀名,文件格式如下:

微信分享iOS Universal Link配置说明

 appID:我理解为识别您app的唯一标识,组成方式是TeamID.BundleID(就是上面配置Associated Domains记录的两个值)

paths:app支持的路径列表,只有指定的这些路径,才能被app所处理,一定是以*结尾的。“*”代表了可识别域名下所有链接(一般我喜欢直接“*”,其实最好还是配置一下指定链接,不容易出错)。

三、将你配置好的指定文件apple-app-site-association,上传到你申请的那个https域名的根目录喜下或者.well-known目录下,app在请求下载这个文件时优先从.well-known下载,如果请求不到文件,才会从根目录下载。然后从浏览器中访问此文件,看能否打开,如下图:

微信分享iOS Universal Link配置说明

而且苹果为了方便开发者,提供了一个网页来验证我们编写的这个apple-app-site-association是否合法有效,进入验证网址进行验证: 

微信分享iOS Universal Link配置说明

如果是返回的信息如下,如说明域名不合法或者配置文件有问题,请仔细检查。

微信分享iOS Universal Link配置说明 

 四、在您的项目中配置Associated Domains,如下图

 微信分享iOS Universal Link配置说明

 项目Associated Domains,点击+进行添加,一定是以applinks开头加上你的域名,比如你申请的域名为https://www.example.com/,那个项目Associated Domains就为applinks:www.example.com.

五、在的微信开发者中心,进行配置

登录微信开发者中心,找到配置一栏进行相关信息的填写,如下图:

微信分享iOS Universal Link配置说明

这里特别说明一下此处Universal Links的配置,如果你申请的域名为https://www.example.com,配置文件中的paths为“/ios/*”,那么微信的 Universal Links就填写https://www.example.com/ios/,如果paths只有一个“*”,这里就填写https://www.example.com/,注意一定要以“/”结尾

六、在项目中进行微信的相关配置,如下图:

微信分享iOS Universal Link配置说明

微信分享iOS Universal Link配置说明微信的配置请参考微信官方文档 

 如果你项目中微信分享不出现二次跳转(首次分享还是会出现二次跳转),在苹果手机浏览器中输入你配置的Universal Links域名信息能打开对应的app(必须安装了此app),说明配置成功 。

以上就是ios universal link 以及微信的相关配置,谢谢。

  相关解决方案