h5 intent 调起_H5唤醒App方式汇总

最近在做扫码之后的h5页面唤醒App的功能，牵涉到oemApp等复杂的场景，做下记录

唤醒方式列表URL Schemes

chrome intent

ios UniversalLink / android appLink

常见唤醒媒介iframe

a 标签

window.location

URL Scheme

组成

[scheme:][//authority][path][?query] 比如：tuyasmart://home?test=1

是什么

URL Schemes可以理解为一种特殊的URL用来定位一个应用以及应用内的某个功能，类比网页链接便很容易理解Schemes 表示的是URL中的一个位置 - 最初始的位置，既://之前的字符，比如https://www.apple.com的Schemes就是https

通过URL Schemes, 我们就可以像定位一个网页一样，定位一个应用甚至应用内的某个具体的功能。而定位是哪个应用的，就是Schemes部分。比如短信应用的Schemes就是： sms

我们完全可以按照理解一个网页的URL来理解一个应用的URL

| | 网页(苹果)| 应用(微信)| | 网站首页/打开应用 | https://www.apple.com | weixin:// | | 子页面/具体功能 | https://www.apple.com/mac (Mac应用页) | weixin://dl/moments(朋友圈)|

注意点 - 应用是否支持URL Schemes要看App开发者有没有写那部分的代码了 - URL Schemes 不唯一

使用

使用方式十分简单，就像我们打开一个链接一样，常见的有location.href

iframe

a标签

使用中常见问题及解决方案可能会被app禁掉，比如微信，qq等

ios9+ 禁止掉了iframe方式。

ios及部分安卓浏览器会提示用户是否打开App，并且ios在未安装对应App的时候，会提示“打不开网页，因为该网址无效”

h5无法感知是否唤醒成功

大部分浏览器需要用户手动触发链接，js自动触发无效

针对被app禁止掉的情况，通常会判断是否微信等app环境，然后提示用户浏览器内打开 针对ios9+ iframe 被禁掉的情况，判断下ios版本 针对h5无法感知是否唤醒成功的解决办法是，一段时间之后自动跳转下载页，或者是依赖setTimeout在浏览器进入后台后进程切换导致的时间延迟判断。

Intent

安卓的原生谷歌浏览器从chrome25版本之后就不能通过URL Schemes唤醒安卓应用。要使用谷歌官方提供的intent:预发， 如果唤醒失败，则会跳转到谷歌的应用市场。语法与URL Schemes及其相似，相当于谷歌定制版的URL Schemes，也没用过，就不多说。

IOS Universal Link

简介 Universal Link是在iOS9引入的新功能，通过传统的HTTP链接就可以唤醒app，如果用户没有安装APP，则会跳转到该链接对应的页面，而且在唤醒app的时候没有弹框提示哦。可以说是解决了URL Schemes的大部分问题。

原理及流程 - App开发人员去配置中心配置Associated Domain配置一个支持https的域名，比如app-support.tuyacn.com - 然后 app-support.tuyacn.com/apple-app-site-association或者app-support.tuyacn.com/apple-app-site-association/.well-known/apple-app-site-association要返回app的teamId,bundleId,paths信息

router.get('/apple-app-site-association, (req, res) => {const data = {applinks: {apps: [],details: [{appID: 'teamId.bundleId',paths: ['*']}]}};res.set('Content-Type', 'text/html');

res.send(JSON.stringify(data));

});然后APP安装后首次打开，如果Associated Domain配置了的话，就会去请求app-support.tuyacn.com/apple-app-site-association。系统会根据返回的teamId,bundleId,paths知道当打开app-support.tuyacn.com下的哪些路径的时候唤醒对应的app，比如paths=*的话，就是打开app-support.tuyacn.com下的任意路径都会唤醒app

app那边会收到对应的路径，然后要根据path写逻辑跳转到对应的功能

如何验证配置成功 - 在备忘录中输入配置好的链接，直接点开这个链接(https://app-support.tuyacn.com)，配置好的话会直接跳到app， 或者长按，弹出菜单中会提示在xxx中打开 - 在safari中

常见问题微信等几个App还是给屏蔽了

从9.3.X改版之后，通用链接不支持域内跳转了，跳转前后的两个domain必须是不同的，否则只会safari打开。跨域问题：假设当前网页的地址为 http://yoursite.com/a/http://yoursite.com/b/* 时，系统才会根据关联文件去判断是否要拉起应用。

服务器上apple-app-site-association的更新不会让iOS本地的apple-app-site-association同步更新，即iOS只会在App第一次启动时请求一次，以后除非App更新或重新安装，否则不会在每次打开时请求apple-app-site-association。

Android App Links

安卓App Link的出现原因也是为了优化用户体验，在使用scheme唤醒时会弹出一个对话框提示用户是否打开，并且如果用户勾选了取消之后，可能之后就再也唤醒不了。

安卓App Link的流程和iosUniversal link的类似，iOS中需要配置的app-support.tuyacn.com/apple-app-site-association文件在安卓中叫做app-support.tuyacn.com/.well-known/assetlinks.json，只能放在.well-known下面