浏览器中唤起Native App

开发 前端
前段时间遇到一个小需求:要求在分享出来的h5页面中,有一个立即打开的按钮,如果本地安装了我们的app,那么点击就直接唤起本地app,如果没有安装,则跳转到下载。

浏览器中唤起Native App

前段时间遇到一个小需求:要求在分享出来的h5页面中,有一个立即打开的按钮,如果本地安装了我们的app,那么点击就直接唤起本地app,如果没有安装,则跳转到下载。

因为从来没有做过这个需求,因此这注定是一个苦逼的调研过程。

我们最开始就面临2个问题:一是如何唤起本地app,二是如何判断浏览器是否安装了对应app。

如何唤起本地app

首先,想要实现这个需求,肯定是必须要客户端同学的配合才行,因此我们不用知道所有的实现细节,我们从前端角度思考看这个问题,需要知道的一点是,ios与Android都支持一种叫做schema协议的链接。比如网易新闻客户端的协议为

  1. newsapp://xxxxx 

当然,这个协议不需要我们前端去实现,我们只需要将协议放在a标签的href属性里,或者使用location.href与iframe来实现激活这个链接。而location.href与iframe是解决这个需求的关键。

在ios中,还支持通过smart app banner来唤起app,即通过一个meta标签,在标签里带上app的信息,和打开后的行为,代码形如

  1. <meta name="apple-itunes-app" content="app-id=1023600494, app-argument=tigerbrokersusstock://com.tigerbrokers.usstock/post?postId=7125"/> 

我们还需要知道的一点是,微信里屏蔽了schema协议。除非你是微信的合作伙伴之类的,他们专门给你配置进白名单。否则我们就没办法通过这个协议在微信中直接唤起app。

因此我们会判断页面场景是否在微信中,如果在微信中,则会提示用户在浏览器中打开。

如何判断本地是否安装了app

很无奈的是,在浏览器中无法明确的判断本地是否安装了app。因此我们必须采取一些取巧的思路来解决这个问题。

我们能够很容易想到,采用设置一个延迟定时器setTimeout的方式,***时间尝试唤起app,如果200ms没有唤起成功,则默认本地没有安装app,200ms以后,将会触发下载行为。

结合这个思路,我们来全局考虑一下这个需求应该采用什么样的方案来实现它。

使用location.href的同学可能会面临一个担忧,在有的浏览器中,当我们尝试激活schema link的时候,若本地没有安装app,则会跳转到一个浏览器默认的错误页面去了。因此大多数人采用的解决方案都是使用iframe

测试了很多浏览器,没有发现过这种情况

后来观察了网易新闻,今日头条,YY等的实现方案,发现大家都采用的是iframe来实现。好吧,面对这种情况,只能屈服。

整理一下目前的思路,得到下面的解决方案

  1. var url = { 
  2.  
  3.   open'app://xxxxx'
  4.  
  5.   down: 'xxxxxxxx' 
  6.  
  7. }; 
  8.  
  9. var iframe = document.createElement('iframe'); 
  10.  
  11. var body = document.body; 
  12.  
  13. iframe.style.cssText='display:none;width=0;height=0'
  14.  
  15. var timer = null
  16.  
  17.   
  18.  
  19. // 立即打开的按钮 
  20.  
  21. var openapp = document.getElementById('openapp'); 
  22.  
  23. openapp.addEventListener('click'function() { 
  24.  
  25.   if(/MicroMessenger/gi.test(navigator.userAgent) { 
  26.  
  27.     // 引导用户在浏览器中打开 
  28.  
  29.   }) else
  30.  
  31.     body.appendChild(iframe); 
  32.  
  33.     iframe.src = url.open
  34.  
  35.     timer = setTimeout(function() { 
  36.  
  37.       wondow.location.href = url.down; 
  38.  
  39.     }, 500); 
  40.  
  41.   } 
  42.  
  43. }, false 

想法很美好,现实很残酷。一测试,就发现简单的这样实现有许多的问题。

***个问题在于,当页面成功唤起app之后,我们再切换回来浏览器,发现跳转到了下载页面。

为了解决这个问题,发现各个公司都进行了不同方式的尝试。

也是历经的很多折磨,发现了几个比较有用的事件。

pageshow: 页面显示时触发,在load事件之后触发。需要将该事件绑定到window上才会触发

pagehide: 页面隐藏时触发

visibilitychange: 页面隐藏没有在当前显示时触发,比如切换tab,也会触发该事件

document.hidden 当页面隐藏时,该值为true,显示时为false

由于各个浏览器的支持情况不同,我们需要将这些事件都给绑定上,即使这样,也不一定能够保证所有的浏览器都能够解决掉这个小问题,实在没办法的事情就不管了。

因此需要扩充一下上面的方案,当本地app被唤起,则页面会隐藏掉,就会触发pagehide与visibilitychange事件

  1. $(document).on('visibilitychange webkitvisibilitychange'function() { 
  2.  
  3.     var tag = document.hidden || document.webkitHidden; 
  4.  
  5.     if (tag) { 
  6.  
  7.         clearTimeout(timer); 
  8.  
  9.     } 
  10.  
  11. }) 
  12.  
  13.   
  14.  
  15. $(window).on('pagehide'function() { 
  16.  
  17.     clearTimeout(timer); 
  18.  
  19. })  

而另外一个问题就是IOS9+下面的问题了。ios9的Safari,根本不支持通过iframe跳转到其他页面去。也就是说,在safari下,我的整体方案被全盘否决!

于是我就只能尝试使用location.href的方式,这个方式能够唤起app,但是有一个坑爹的问题,使用schema协议唤起app会有弹窗而不会直接跳转去app!甚至当本地没有app时,会被判断为链接无效,然后还有一个弹窗。

这个弹窗会造成什么问题呢?如果用户不点确认按钮,根据上面的逻辑,这个时候就会发现页面会自动跳转到下载去了。而且无效的弹窗提示在用户体验上是不允许出现的。

好吧,继续扒别人的代码,看看别人是如何实现的。然后我又去观摩了其他公司的实现结果,发现网易新闻,今日头条都可以在ios直接从微信中唤起app。真是神奇了,可是今日头条在Android版微信上也没办法直接唤起的,他们在Android上都是直接到腾讯应用宝的下载里去。所以按道理来说这不是添加了白名单。

为了找到这个问题的解决方案,我在网易新闻的页面中扒出了他们的代码,并整理如下,添加了部分注释

  1. window.NRUM = window.NRUM || {}; 
  2.  
  3. window.NRUM.config = { 
  4.  
  5.     key:'27e86c0843344caca7ba9ea652d7948d'
  6.  
  7.     clientStart: +new Date() 
  8.  
  9. }; 
  10.  
  11. (function() { 
  12.  
  13.     var n = document.getElementsByTagName('script')[0], 
  14.  
  15.         s = document.createElement('script'); 
  16.  
  17.   
  18.  
  19.     s.type = 'text/javascript'
  20.  
  21.     s.async = true
  22.  
  23.     s.src = '//nos.netease.com/apmsdk/napm-web-min-1.1.3.js'
  24.  
  25.     n.parentNode.insertBefore(s, n); 
  26.  
  27. })(); 
  28.  
  29.   
  30.  
  31.   
  32.  
  33.  
  34. (function(window,doc){ 
  35.  
  36.   
  37.  
  38.     // http://apm.netease.com/manual?api=web 
  39.  
  40.     NRUM.mark && NRUM.mark('pageload'true
  41.  
  42.   
  43.  
  44.     var list = [] 
  45.  
  46.     var config = null 
  47.  
  48.   
  49.  
  50.     // jsonp 
  51.  
  52.     function jsonp(a, b, c) { 
  53.  
  54.         var d; 
  55.  
  56.         d = document.createElement('script'); 
  57.  
  58.         d.src = a; 
  59.  
  60.         c && (d.charset = c); 
  61.  
  62.         d.onload = function() { 
  63.  
  64.             this.onload = this.onerror = null
  65.  
  66.             this.parentNode.removeChild(this); 
  67.  
  68.             b && b(!0); 
  69.  
  70.         }; 
  71.  
  72.         d.onerror = function() { 
  73.  
  74.             this.onload = this.onerror = null
  75.  
  76.             this.parentNode.removeChild(this); 
  77.  
  78.             b && b(!1); 
  79.  
  80.         }; 
  81.  
  82.         document.head.appendChild(d); 
  83.  
  84.     }; 
  85.  
  86.   
  87.  
  88.   
  89.  
  90.     function localParam(search,hash){ 
  91.  
  92.         search = search || window.location.search; 
  93.  
  94.         hash = hash || window.location.hash; 
  95.  
  96.         var fn = function(str,reg){ 
  97.  
  98.             if(str){ 
  99.  
  100.                 var data = {}; 
  101.  
  102.                 str.replace(reg,function( $0, $1, $2, $3 ){ 
  103.  
  104.                     data[ $1 ] = $3; 
  105.  
  106.                 }); 
  107.  
  108.                 return data; 
  109.  
  110.             } 
  111.  
  112.         } 
  113.  
  114.         return {search: fn(search,new RegExp( "([^?=&]+)(=([^&]*))?""g" ))||{},hash: fn(hash,new RegExp( "([^#=&]+)(=([^&]*))?""g" ))||{}}; 
  115.  
  116.     } 
  117.  
  118.   
  119.  
  120.     jsonp('http://active.163.com/service/form/v1/5847/view/1047.jsonp'
  121.  
  122.   
  123.  
  124.     window.search = localParam().search 
  125.  
  126.     window._callback = function(data) { 
  127.  
  128.         window._callback = null 
  129.  
  130.         list = data.list 
  131.  
  132.         if(search.s && !!search.s.match(/^wap/i)) { 
  133.  
  134.             config = list.filter(function(item){ 
  135.  
  136.                 return item.type === 'wap' 
  137.  
  138.             })[0] 
  139.  
  140.             return 
  141.  
  142.         } 
  143.  
  144.         config = list.filter(function(item){ 
  145.  
  146.             return item.type === search.s 
  147.  
  148.         })[0] 
  149.  
  150.     } 
  151.  
  152.   
  153.  
  154.     var isAndroid = !!navigator.userAgent.match(/android/ig), 
  155.  
  156.         isIos = !!navigator.userAgent.match(/iphone|ipod/ig), 
  157.  
  158.         isIpad = !!navigator.userAgent.match(/ipad/ig), 
  159.  
  160.         isIos9 = !!navigator.userAgent.match(/OS 9/ig), 
  161.  
  162.         isYx = !!navigator.userAgent.match(/MailMaster_Android/i), 
  163.  
  164.         isNewsapp = !!navigator.userAgent.match(/newsapp/i), 
  165.  
  166.         isWeixin = (/MicroMessenger/ig).test(navigator.userAgent), 
  167.  
  168.         isYixin = (/yixin/ig).test(navigator.userAgent), 
  169.  
  170.         isQQ = (/qq/ig).test(navigator.userAgent), 
  171.  
  172.         params = localParam().search, 
  173.  
  174.         url = 'newsapp://'
  175.  
  176.         iframe = document.getElementById('iframe'); 
  177.  
  178.   
  179.  
  180.     var isIDevicePhone = (/iphone|ipod/gi).test(navigator.platform); 
  181.  
  182.     var isIDeviceIpad = !isIDevicePhone && (/ipad/gi).test(navigator.platform); 
  183.  
  184.     var isIDevice = isIDevicePhone || isIDeviceIpad; 
  185.  
  186.     var isandroid2_x = !isIDevice && (/android\s?2\./gi).test(navigator.userAgent); 
  187.  
  188.     var isIEMobile = !isIDevice && !isAndroid && (/MSIE/gi).test(navigator.userAgent); 
  189.  
  190.     var android_url = (!isandroid2_x) ? "http://3g.163.com/links/4304" : "http://3g.163.com/links/6264"
  191.  
  192.     var ios_url = "http://3g.163.com/links/3615"
  193.  
  194.     var wphone_url = "http://3g.163.com/links/3614"
  195.  
  196.     var channel = params.s || 'newsapp' 
  197.  
  198.   
  199.  
  200.     // 判断在不同环境下app的url 
  201.  
  202.     if(params.docid){ 
  203.  
  204.         if(params['boardid'] && params['title']){ 
  205.  
  206.             url = url + 'comment/' + params.boardid + '/' + params.docid + '/' + params.title 
  207.  
  208.         }else
  209.  
  210.             url = url + 'doc/' + params.docid 
  211.  
  212.         } 
  213.  
  214.     }else if(params.sid){ 
  215.  
  216.         url = url + 'topic/' + params.sid 
  217.  
  218.     }else if(params.pid){ 
  219.  
  220.         var pid = params.pid.split('_'
  221.  
  222.         url = url + 'photo/' + pid[0] + '/' + pid[1] 
  223.  
  224.     }else if(params.vid){ 
  225.  
  226.         url = url + 'video/' + params.vid 
  227.  
  228.     }else if(params.liveRoomid){ 
  229.  
  230.         url = url + 'live/' + params.liveRoomid 
  231.  
  232.     }else if(params.url){ 
  233.  
  234.         url = url + 'web/' + decodeURIComponent(params.url) 
  235.  
  236.     }else if(params.expertid){ 
  237.  
  238.         url = url + 'expert/' + params.expertid 
  239.  
  240.     }else if(params.subjectid){ 
  241.  
  242.         url = url + 'subject/' + params.subjectid 
  243.  
  244.     }else if(params.readerid){ 
  245.  
  246.         url = url + 'reader/' + params.readerid 
  247.  
  248.     }else
  249.  
  250.         url += 'startup' 
  251.  
  252.     } 
  253.  
  254.     if(url.indexOf('?') >= 0){ 
  255.  
  256.         url += '&s=' + (params.s || 'sps'
  257.  
  258.     }else
  259.  
  260.         url += '?s=' + (params.s || 'sps'
  261.  
  262.     } 
  263.  
  264.   
  265.  
  266.     // ios && 易信  用iframe 打开 
  267.  
  268.     if((isIos||isIpad) && navigator.userAgent.match(/yixin/i)) { 
  269.  
  270.         document.getElementById('iframe').src = url; 
  271.  
  272.     } 
  273.  
  274.   
  275.  
  276.     var height = document.documentElement.clientHeight; 
  277.  
  278.   
  279.  
  280.     // 通常情况下先尝试使用iframe打开 
  281.  
  282.     document.getElementById('iframe').src = url; 
  283.  
  284.   
  285.  
  286.     // 移动端浏览器中,将下载页面显示出来 
  287.  
  288.     if(!isWeixin && !isQQ && !isYixin && !isYx){ 
  289.  
  290.         document.querySelector('.main-body').style.display = 'block' 
  291.  
  292.         if(isIos9){ 
  293.  
  294.             document.querySelector('.main-body').classList.add('showtip'
  295.  
  296.         } 
  297.  
  298.   
  299.  
  300.         setTimeout(function(){ 
  301.  
  302.             document.body.scrollTop = 0 
  303.  
  304.         },200) 
  305.  
  306.     }else
  307.  
  308.         document.getElementById('guide').style.display = 'block' 
  309.  
  310.     } 
  311.  
  312.   
  313.  
  314.     // Forward To Redirect Url 
  315.  
  316.     // Add by zhanzhixiang 12/28/2015 
  317.  
  318.     if (params.redirect) { 
  319.  
  320.         var redirectUrl = decodeURIComponent(params.redirect); 
  321.  
  322.         if ( typeof(URL) === 'function' && new URL(redirectUrl).hostname.search("163.com") !== -1) { 
  323.  
  324.             window.location.href = redirectUrl; 
  325.  
  326.         } else if (redirectUrl.search("163.com") !== -1){ 
  327.  
  328.             window.location.href = redirectUrl; 
  329.  
  330.         }; 
  331.  
  332.     } 
  333.  
  334.   
  335.  
  336.     // Forward To Redirect Url End 
  337.  
  338.     if ((isWeixin || isQQ) && isAndroid) { 
  339.  
  340.         window.location.href = 'http://a.app.qq.com/o/simple.jsp?pkgname=com.netease.newsreader.activity&ckey=CK1331205846719&android_schema=' + url.match(/(.*)\?/)[1] 
  341.  
  342.     } 
  343.  
  344.   
  345.  
  346.     if(isIos||isIpad){ 
  347.  
  348.         document.getElementById("guide").classList.add('iosguideopen'
  349.  
  350.     }else if (isAndroid){ 
  351.  
  352.         document.getElementById("guide").classList.add('androidguideopen'
  353.  
  354.     }else
  355.  
  356.         // window.location.href = 'http://www.163.com/newsapp' 
  357.  
  358.     } 
  359.  
  360.   
  361.  
  362.     document.getElementById('link').addEventListener('click'function(){ 
  363.  
  364.   
  365.  
  366.         // 统计 
  367.  
  368.         neteaseTracker && neteaseTracker(false,'http://sps.163.com/func/?func=downloadapp&modelid='+modelid+'&spst='+spst+'&spsf&spss=' + channel,'''sps' ) 
  369.  
  370.   
  371.  
  372.         if (config) { 
  373.  
  374.             android_url = config.android 
  375.  
  376.         } 
  377.  
  378.         if (config && config.iOS) { 
  379.  
  380.             ios_url = config.iOS 
  381.  
  382.         } 
  383.  
  384.         if(isWeixin || isQQ){ 
  385.  
  386.             return 
  387.  
  388.         } 
  389.  
  390.         var msg = isIDeviceIpad ? "检测到您正在使用iPad, 是否直接前往AppStore下载?" : "检测到您正在使用iPhone, 是否直接前往AppStore下载?"
  391.  
  392.         if (isIDevice){ 
  393.  
  394.             window.location = ios_url; 
  395.  
  396.             return
  397.  
  398.         }else if(isAndroid){ 
  399.  
  400.             // uc浏览器用iframe唤醒 
  401.  
  402.             if(navigator.userAgent.match(/ucbrowser|yixin|MailMaster/i)){ 
  403.  
  404.                 document.getElementById('iframe').src = url; 
  405.  
  406.             } else { 
  407.  
  408.                 window.location.href = url; 
  409.  
  410.             } 
  411.  
  412.             setTimeout(function(){ 
  413.  
  414.                 if(document.webkitHidden) { 
  415.  
  416.                     return 
  417.  
  418.                 } 
  419.  
  420.                 if (confirm("检测到您正在使用Android 手机,是否直接下载程序安装包?")) { 
  421.  
  422.                     neteaseTracker && neteaseTracker(false,'http://sps.163.com/func/?func=downloadapp_pass&modelid='+modelid+'&spst='+spst+'&spsf&spss=' + channel,'''sps' ) 
  423.  
  424.                     window.location.href = android_url; 
  425.  
  426.                 } else { 
  427.  
  428.                     neteaseTracker && neteaseTracker(false,'http://sps.163.com/func/?func=downloadapp_cancel&modelid='+modelid+'&spst='+spst+'&spsf&spss=' + channel,'''sps' ) 
  429.  
  430.                 } 
  431.  
  432.             },200) 
  433.  
  434.             return
  435.  
  436.         }else if(isIEMobile){ 
  437.  
  438.             window.location = wphone_url; 
  439.  
  440.             return
  441.  
  442.         }else
  443.  
  444.             window.open('http://www.163.com/special/00774IQ6/newsapp_download.html'); 
  445.  
  446.             return
  447.  
  448.         } 
  449.  
  450.     }, false
  451.  
  452.   
  453.  
  454.     setTimeout(function(){ 
  455.  
  456.         if(isIDevice && params.notdownload != 1 && !isNewsapp && !isIos9){ 
  457.  
  458.             document.getElementById('link').click() 
  459.  
  460.         } 
  461.  
  462.     }, 1000) 
  463.  
  464.   
  465.  
  466. })(window,document);  

虽然有一些外部的引用,和一些搞不懂是干什么用的方法和变量,但是基本逻辑还是能够看明白。好像也没有什么特别的地方。研究了许久,看到了一个jsonp请求很奇特。这是来干嘛用的?

于是费尽千辛万苦,搜索了很多文章,最终锁定了一个关键的名词 Universal links。

如果我早知道这个名词,那么问题就不会变的那么束手无策。所以这个东西是什么呢?

Apple为iOS 9发布了一个所谓的通用链接的深层链接特性,即Universal links。虽然它并不***,但是这一发布,让数以千计的应用开发人员突然意识到自己的应用体验被打破。

Universal links,一种能够方便的通过传统的HTTP/HTTPS 链接来启动App,使用相同的网址打开网站和App。

关于这个问题的提问与universal links的介绍(http://stackoverflow.com/questions/31891777/ios-9-safari-iframe-src-with-custom-url-scheme-not-working)

ios9推行的一个新的协议!

关于本文的这个问题,国内的论坛有许许多多的文章来解决,但是提到universal links的文章少之又少,而我想吐槽的是,我们的ios开发也尼玛不知道这个名词,搞什么鬼。他改变了用户体验的关键在于,微信没有屏蔽这个协议。因此如果我们的app注册了这个协议,那么我们就能够从微信中直接唤起app。

这个时候我就发现,上面贴的网易新闻代码中的jsonp请求的内容,就是这个协议必须的一个叫做apple-app-site-association的JSON文件

  1.  
  2.    "applinks": { 
  3.  
  4.        "apps": [ ], 
  5.  
  6.        "details": { 
  7.  
  8.            "TEAM-IDENTIFIER.YOUR.BUNDLE.IDENTIFIER": { 
  9.  
  10.                "paths": [ 
  11.  
  12.                    "*" 
  13.  
  14.                ] 
  15.  
  16.            } 
  17.  
  18.        } 
  19.  
  20.    } 
  21.  
  22.  

大家可以直接访问这个链接,查看里面的内容

http://active.163.com/service…

至于universal links具体如何实现,让ios的同学去搞定吧,这里提供两个参考文章

http://www.cocoachina.com/bbs…

https://blog.branch.io/how-to…

支持了这个协议之后,我们又可以通过iframe来唤起app了,因此基本逻辑就是这样了。

但是!并不是就没有坑了。

universal links还有一个大坑,就是如果想要通过universal links只在在微信中打开app,同一个页面我们还得使用不同的两个域名。

这个特性虽然有点坑,但是通过这个特性却能够***判断本地是否安装了你们的app。

比如我们正常访问当前页面的域名为A,对应的页面url为A+,而当我们点击按钮,需要打开app用到的域名为B,,对应的页面url为B+。

A与B都被注册成为了对应app的universal links,A+ 与 B+ 都指向同一个页面。

我们通过js判断,如果是通过B+访问的该页面,则直接跳去下载app。这样,当我们从A+通过点击访问B+时,如果universal links生效并且本地安装了对应的app,app会直接被打开。如果本地没有安装App,则会直接执行刚才B+中跳去下载的设定。

OK,这个问题,几乎所有的坑我都在上面说到了,如果想要做好兼容,就是一个针对每个坑做***选择了,这是一个工作量的问题。

不过最终的调研结果是

没有***的解决方案

就算是网易新闻,这个按钮在使用过程中也会有一些小bug,无法做到***的状态。

因为我们面临许多没办法解决的问题,比如无法真正意义上的判断本地是否安装了app,pageshow,pagehide并不是所有的浏览器都支持等。很多其他博客里面,什么计算时间差等方案,我花了很久的时间去研究这个方案,结果是,根!本!没!有!用!

老实说,从微信中跳转到外部浏览器,并不是一个好的解决方案,这样会导致很多用户流失,因此大家都在ios上实现了universal links。

网易新闻的逻辑是,点击打开会跳转到一个下载页面,这个下载页面一加载完成就尝试打开app,如果打开了就直接跑到app里面去了,如果没有就在页面上有一个立即下载的按钮,按钮行只有下载处理。

这个问题就总结到这里,如果大家有更好的方案,欢迎与我沟通。

责任编辑:庞桂玉 来源: 前端大全
相关推荐

2021-09-26 05:04:45

浏览器AppActivity

2012-03-20 11:07:08

2012-03-19 17:25:22

2012-03-20 11:31:58

移动浏览器

2012-03-20 11:41:18

海豚浏览器

2012-03-07 10:17:33

傲游移动浏览器排名第一

2012-03-20 11:22:02

QQ手机浏览器

2012-03-19 17:17:00

移动浏览器欧朋

2012-06-21 15:38:02

猎豹浏览器

2010-04-05 21:57:14

Netscape浏览器

2016-09-21 14:24:37

3D全景浏览器浏览器

2012-03-20 11:35:32

傲游手机浏览器

2011-09-09 18:43:13

Qt Webkit浏览器

2009-07-01 16:52:47

增加浏览器Visual Stud

2013-01-14 10:58:51

傲游云浏览器

2015-01-21 15:45:50

斯巴达浏览器

2012-03-20 11:25:07

360手机浏览器

2012-08-23 14:56:46

浏览器

2010-12-21 10:11:35

手机浏览器

2015-06-11 14:05:46

QQ浏览器
点赞
收藏

51CTO技术栈公众号