多端应用 Universal Link 配置

WARNING

请注意，当前域名 https://dev.weixin.qq.com/docs/framework 文档已不维护，请前往微信文档中心open in new window 找到对应的新文档继续使用

  • Universal Link 是 Apple 在 iOS 9 推出的一种能够方便的通过传统 HTTPS 链接来拉起APP的功能
  • 即，如果你的 App 支持 Universal Link，那么用户点击这个链接时可以跳转到你的网站并获得无缝重定向到对应的 APP，且不需要通过Safari浏览器。如果你的应用不支持的话，则会在Safari中打开该链接。
  • 基于多端框架开发 iOS 应用的 Bundle Id 和 Universal Link 均是来源于微信开放平台的移动应用，即在创建移动应用的时候开发者需填写Bundle Id 和 Universal Link，本文将解释移动应用 Universal Link 的用途以及相关验证方式。

1、为什么需要配置 Universal Link

  • 如果你的 iOS 应用无需用到微信能力（如微信分享、微信登录、微信支付等），那么，可以随便配置 Universal Link 都可以，即无需填写一个真正可用的 Universal Link
  • 反之，如果你的 iOS 应用用到微信能力（如微信分享、微信登录、微信支付等），那么，可以就必须配置一个可用的 Universal Link，确保从你的 App 跳到微信 App后可以正常返回你的 App。

2、如何验证配置的 Universal Links 是有效的

  • 微信使用第三方 App 的 Universal Links 唤起第三方 App 时，会在 Universal Links 末尾拼接路径和参数，因此开发者 Universal Links 配置必须加上通配符，并测试 Universal Links 拼接字符串能否唤起 App
  • 即，建议Universal Links配置path，例如/app/*, 避免全域命中 Universal Links跳转
  • 按照上面的规则完成配置后，可通过下方的方式验证是否生效

1） 在 Safari 输入 Universal Links(包括完整路径)+随机字符串(例如: abc)

  • 例如以 https://help.wechat.com/sdksample/ 为例子，
  • 在Safari的Universal Links：https://help.wechat.com/sdksample/abc

2）下拉页面检查是否有打开 app的入口提示(如下图)

3、如果 Universal Links 失效了会有什么影响

  • 当用户首次使用微信发起分享时，将会出现如下交互流程：从App拉起微信-出现“正在连接”页面-返回App-重新打开微信。以上是新的安全验证流程，每个用户在首次使用时会出现上述跳转**
  • 然而非首次分享也都一直出现了二次跳转的行为，则是微信 App 这边无法通过开发者的 App 提供的 Universal Links返回导致，也就是说开发者在移动应用配置的 Universal Links 不生效了，需安装上述步骤 2 的指引检查 Universal Links配置**