12/12/2024 11:37:55

问题描述

Universal Link 配置常见问题：详情查看解决方案

问题原因

解决方案

Universal Link 常见问题解答：

一、
Q：Universal Link 配置时需要的 https 域名指的是什么?

A：https 域名填写业务的官网（需要支持 htpps 协议），以 MSDK Demo 为例：https://docs.itop.qq.com ；

二、
Q：配置 apple-app-site-association 文件中的 TeamID 指的是什么？

A：TeamID 是苹果证书文件中的 TeamIDentifier 参数，查询方式如下：
（1）XCode工程 -> Signing & Capabilities -> Signing;

（2）前往蓝盾证书管理查询；

三、
Q：apple-app-site-association 文件要上传到哪里？

A：apple-app-site-association 文件必须要上传至飞鹰侧填写的 https 域名的根目录，以 MSDK Demo 为例：飞鹰填写 https://docs.itop.qq.com/app/ ，那么文件必须上传至 https://docs.itop.qq.com/apple-app-site-association ，且浏览器打开此路径能正常下载到 apple-app-site-association 文件；

四、
Q：Universal Link 网址路径打开是 404 / 403 正常吗？

A：Universal Link 网址是 App 跳转路径，不是已存在网址，打开 404 / 403 报错是正常的，以 MSDK Demo 为例：飞鹰填写 https://docs.itop.qq.com/app/ ，在浏览器中打开 https://docs.itop.qq.com/app/ 网页报错为正常情况；

五（1）、
Q：飞鹰侧刷新 Universal Link 至 QQ 互联失败。

A：第一， apple-app-site-association 文件的 paths 参数中需要配置 /qq_conn/手QAppID/ ；
第二， apple-app-site-association 文件已上传至 https 域名的根目录；
第三，前两条完成后仍然失败，在一至两小时后重试。

备注：

微信平台是区分微信开平和微信游戏中心，刚注册的游戏都在微信开平，而飞鹰包括IEG所有业务都只对接微信游戏中心，所以新注册的游戏同步ul到微信可能会报错：“找不到该游戏”。
需要将游戏从开平入库到游戏中心，入库操作可以直接拉项目组和业管的同学（具体接口人请咨询 MSDK 助手）。平台审批后再次在飞鹰系统上同步即可。

手Q平台不区分，直接在飞鹰系统上同步即可。

五（2）、
Q：飞鹰侧刷新 Universal Link 至 QQ 互联失败，提示 errcode:30002:0

A：因为业务侧开发者账号在飞鹰上和互联上不一致导致的，多数发生在业务侧单独只修改过一个平台的开发者账号，建议业务侧分别到飞鹰和互联侧核实，如果确实不一致，就需要修改。

联系MSDK助手或者qqconnecthelper(QQ互联及登录咨询)，将飞鹰或者互联侧的开发者账号修改为一致即可。

六、
Q：企业证书一般情况下不具备 Universal Link 功能。

A：第一，企业证书重签采用的是一个 com.tencent.* 的通配符 Bundle ID 对应的证书，该证书不具备 Associated Domains 能力；
第二，蓝盾有具备 Associated Domains 能力的企业证书，但是重签之后 ipa 包的 Bundle ID 与 TeamID 会发生改变，与飞鹰、微信/QQ侧配置的不一致；
目前蓝盾同事已经解决了企业证书开启 Associated Domains 能力，需要蓝盾侧的同事提供支持，相关问题请联系 KeyStore-helper(证书助手) 。
飞鹰侧已支持配置多 Bundle ID，与 Universal Link 配置在同一页面。

七、
Q：QQ分享报错提示 25105。

A：Universal Link 错误，请检查 Universal Link 配置，如果微信是正常的，请检查以下三处：
（1） apple-app-site-association 文件中参数是否有误；
（2）是否使用了企业证书 ipa，如果使用了企业证书，请确认开启了企业证书使用 Universal Link 的能力，请参考第六点；
（3）请确认QQ互联侧 Universal Link 配置信息确实存在且验证无误。

八、
Q：Universal Link 全部配置完成后，XCode工程打包需注意：

A：确保 Build Settings -> Combined ->Signing -> Code Signing Entitlements 中所有打包方式都已经附加了 Entitlements ，否则 Associated Domains 能力未打包进应用包，会导致 Universal Link 无效。