唤起 App

2021-07-24 07:33:14

判断浏览器，动态加载对应浏览器的下载逻辑
通过 universal link、URL Scheme、a 标签、iframe 几种方式找出最适合这个浏览器的唤起方式。
如果下载了 App，就会走打开逻辑，如果没有下载则走下载逻辑。
如果已知不能唤起的浏览器引导其它浏览器打开

通用链接（universal link）

通用链接 universal link 是 IOS 9.0 版本以上才可以使用的新的特性。此特性类似于深层链接，并能够方便地通过打开一个 https 链接来直接启动您的客户端应用(手机有安装 App)。对比起以往所使用的 URL Scheme, 这种新特性在实现 web-app 的无缝链接时能够提供极佳的用户体验。

体验一下通用链接

我们可以来体验一下，左边的是通用链接 universal link方式，右边是 URL Scheme 方式。

左边可以直接将 App 打开，而右边需要确认是否打开才可以。

解决的bug：在 ios 12.3 版本之后，Safari 会有一个 bug，就是 URL Scheme 跟 download App 先后一起使用的话，会同时唤起 App 然后再进入 App store，体验极差。使用 universal link 可以完美解决这个问题。

通用链接配置

必须在根目录下或者域名/.well-known 下面。注意 域名不要使用业务域名添加配置文件，必须要跨域使用，否则会会不能唤起App，直接打开页面。

访问链接 我们假设有三个 App，分别是 appa、appb、appc，我们通过访问 https://jump.test.com/appa/index.html 就可以唤起 appa 了。
配置下载页 如果没有安装 appa 的话就会跳转到一个 404 页面，因为我们这个页面 https://jump.test.com/appa/index.html 其实并不存在，所以我们需要将这个页面在 nginx 代理到一个下载页面。
疑问 那么你可能有一个疑问，我如果唤起来 app 之后这个页面会不会跳转到下载页呢？答案是不会的，如果唤起了 app 就不会继续跳转页面了，只有在唤不起来的时候才会进入下载页。

apple-app-site-association 配置

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "ABCD.com.aaa.appa",
        "paths": ["appa/*"]
      },
      {
        "appID": "ABCD.com.aaa.appb",
        "paths": ["appb/*"]
      },
      {
        "appID": "ABCD.com.aaa.appc",
        "paths": ["appc/*"]
      },
      {
        "appID": "ABCD.com.aaa.*",
        "paths": ["*"]
      }
    ]
  }
}

通用链接的优缺点：

优点：提供极佳的用户体验，使用起来也非常方便，解决了同时唤起 app 跟 app store 的问题
缺点：只有在 ios 9 版本之上才能使用，个别浏览器不支持有兼容性问题

URL Scheme 方式

用法

根据协议来判断是哪个 app 唤起。

location.href = "testa://test.aaa.com/home";

判断是否唤起 app

因为唤起 app 并没有回调让我们知道唤起了 app，所以我们只能通过监听页面是否隐藏来实现判断是否唤起 app 的逻辑。当然这种做法还是有很大缺陷的，比如低端机型唤起速度很慢，高端机型要快得多，所以 delay 的时间要设置一个可以接受的值，我们暂时定的是 2500。还有如果用户没有安装 app，也会有 2500 的延时才能安装。

const timer = setTimeout(() => {
  this.__download(options);
}, options.delay);

const visibilitychange = function() {
  const tag = document.hidden || document.webkitHidden;
  tag && clearTimeout(timer);
};

document.addEventListener("visibilitychange", visibilitychange, false);
document.addEventListener("webkitvisibilitychange", visibilitychange, false);
window.addEventListener(
  "pagehide",
  function() {
    clearTimeout(timer);
  },
  false
);

URL Scheme 的优缺点：

优点 1. 兼容性好，大部分机型都能兼容 2. 使用方便
缺点 1. 不能判断是否已经下载了 app，需要自己写逻辑判断 2. 用户体验不如通用链接的方式。

a 标签跟 iframe 方式

这两种方式都是通过创建元素，通过元素属性的特性来做的

a 标签

const a = document.createElement("a");
a.setAttribute("href", __SCHEMA_PATH);
a.click();

iframe

const ifr = document.createElement("iframe");
iframe.src = path;
ifr.src = nativeUrl;
ifr.style.cssText = "display:none;border:0;width:0;height:0;";
document.body.appendChild(ifr);
setTimeout(function() {
  document.body.removeChild(ifr);
}, 1000);

优缺点

优点 在个别场景中如果发现唤起 app 有问题，可以尝试这两种。
缺点 iframe 基本上已经被废弃了，a 标签测试结果只在个别机型中可用。

总结

微信 必须配置白名单，或者使用 universal link 也可以在 ios 唤起，表现形式有一点差别

const wxconfig = {
  debug: false,
  appId: conf.appId, // 公众号的 appid
  timestamp: conf.timestamp,
  nonceStr: conf.noncestr,
  signature: conf.signature,
  beta: true,
  jsApiList: ["launchApplication", "getInstallState"]
};
(window.wx && window.wx.config(wxconfig)) || (window.wxconfig = wxconfig);

百度浏览器必须用 universal link 方式才能在 IOS 唤起
qq 在 ios 要使用 a 标签 的方式，即使通用链接的方式也不能将其唤起

if (isIOS) {
  const a = document.createElement("a");
  a.setAttribute("href", __SCHEMA_PATH);
  return a.click();
}
location.href = __SCHEMA_PATH;

微博，测试京东跟淘宝都可以调起，猜测是设置了白名单，目前没有找到好的办法，只能引导到其它浏览器中打开