网页调用 iOS/Android 客户端

蔚落 2022-07-19 05:12 199阅读 0赞

无论 iOS 还是 Android 都不约而同地支持 URI Scheme（[扫盲帖][Link 1]）来作为页面与客户端的通讯协议。这里的 URI Scheme 前缀不是一般的 http://，而是由客户端开发者定义的，一般在写程序的时候就会设置的了。然后剩下的部分就像普通的 URL 地址一样，需要大家来约定 URI Scheme 具体如何，例如参数是什么等等，好比网易新闻客户端的是以 newsapp:// 为前缀：

**\[html\]**  [view plain][]   [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **<****a** href="newsapp://"**>** 打开网易新闻客户端**</****a****>**

如此便可以从网页打开客户端了。这只是最简单的 Scheme 部分，除此之外，应该还有更多的参数，一般要约定好，让网页开发者和客户端开发者两者之间可以相互调用。

这种情况，当然是假设用户已经安装了客户端，进而才会自动打开。那么，问题就来了，没有安装怎么办？以及最关键的一点——如何判断客户端是否已经安装呢？如果没有安装的话，我们可以提示提示用户去下载（跳到相应的下载页面）这个比较简单；但是，如何判断客户端是否已经安装呢？遗憾的是，浏览器并没有一个方法可以告诉你哪个客户端安装了，哪个没有安装！因此，如果按照上述 a 链接直接跳转而用户又没有安装客户端的话，浏览者看到的是一张空白的页面，——用户体验很差哦～于是我们一般采用“障眼法”，也就是把“隐藏”的 iframe 派上场，用 iframe.src 指向 URI Scheme 地址就可以了，既可以尝试打开客户端，又可以停留在当前页面上。

不过，我们也可以不停留也页面上——因为我们总是鼓励使用客户端的，所以这时候可跳转到下载客户端的页面。这是在没有安装的情况下的做法。如果客户端已经安装了，那就可以不跳转。

具体逻辑如下：

**\[html\]**  [view plain][]   [copy][view plain]

1.  **<****iframe** class="openApp hide" src="about:blank"**>****</****iframe****>**  
2.  **<****script****>**  
3.      function openClient(el, downloadUrl)\{  
4.          var iframe = arguments.callee.iframe;  
5.            
6.          if(!iframe)\{  
7.              iframe = document.querySelector('.openApp')  
8.              arguments.callee.iframe = iframe;  
9.          \}  
10.         var startTime = +new Date();  
11.         iframe.src = el.getAttribute('data-scheme');  
12.           
13.         // 如果已知安装的了，则无须跳转下载页  
14.         setTimeout(function() \{ // 如果不能打开客户端，跳到下载页面  
15.             if (Date.now() - startTime **<** **500**) // 通过判断触发的时间与执行settimeout的时间差值是否小于设置的定时时间加上一个浮动值（一般设为100）。  
16.                 window.location.href = downloadUrl;  
17.         \}, 400);  
18.     \}  
19.     openClient = openClient.delegate(null, 'http://g.3gtv.net');  
20. **</****script****>**

稍有点不足的就是，iOS 上面，如果没安装客户端，那么这段自定义的 URL Scheme（如 newsapp://） 就被视为"无效的链接“，弹对话框出来！（貌似 腾讯视频可以解决该问题哦，点击这里看[页面][Link 2]——无奈的就是代码经过混淆的，不易察觉） 更新代码后，没有发现这个问题了。如果还是会这样的话，可以尝试用 script tag 发起请求，看能不能规避这个弹出框。

最后我们遇到一个下载页面的问题，由于微信内部浏览器限制的原因，不允许下载 apk 文件或者访问 app store，除非腾讯旗下的“应用宝”才可以。我们对腾讯这一封闭的做法十分不齿，却又无可奈何。于是只能默默地“归化”应用宝。好了，用就用呗——本来跳到下载页面是没有问题的。但令人觉得蛋疼的是，应用宝页面居然自己又会调起客户端（如果安装过的话）！这样势必就是“二次打开”客户端！要规避这个问题，一、不直接跳掉应用宝下载页面；二、改 UI，提供两个按钮，一是打开客户端的，另外一个是下载。

后记，还是兼容性问题：

*  发现三星 note3 系统浏览器竟然不能 iframe 调起！
 *  QQ 浏览器杯具了，竟然对 URI Scheme 一点都不支持！如下图所示，对此，优酷的做法是干脆把 打开客户端 的按钮隐藏掉。

**\[html\]**  [view plain][]   [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **<**%@tag pageEncoding="UTF-8" import="com.ajaxjs.bigfoot.\*" %**>**  
2.  **<**%@ attribute name="download\_url" required="true" description="应用的下载页面，for Android used"%**>**   
3.  **<**%@ attribute name="app\_store\_id" required="true" description="苹果商店的之 id，当前为 iphone 版，有 ipad 版吗？"%**>**   
4.  **<**%@ attribute name="URI\_Scheme\_iOS" required="true" description="iOS 的 URI\_Scheme"%**>**   
5.  **<**%@ attribute name="URI\_Scheme\_Android" required="true" description="安卓的 URI\_Scheme"%**>**  
6.    
7.    
8.    
9.  **<****iframe** id="ifr" style="display: none;border:0;" src="javascript:void(0)"**>****</****iframe****>**  
10. **<****script****>**  
11.     ;(function(window, doc)\{  
12.           
13.         /\*\*  
14.          \* 读取 search 和 hash 的参数  
15.          \*/  
16.         function localParam(search, hash)\{  
17.             search  = search    || window.location.search;  
18.             hash    = hash      || window.location.hash;  
19.               
20.             var fn = function(str, reg)\{  
21.                 if(str)\{  
22.                     var data = \{\};  
23.                     str.replace(reg,function( $0, $1, $2, $3 )\{  
24.                         data\[ $1 \] = $3;  
25.                     \});  
26.                     return data;  
27.                 \}  
28.             \}  
29.               
30.             return \{  
31.                 search: fn(search,  new RegExp( "(\[^?=&\]+)(=(\[^&\]\*))?", "g" ))||\{\},  
32.                 hash:   fn(hash,    new RegExp( "(\[^\#=&\]+)(=(\[^&\]\*))?", "g" ))||\{\}  
33.             \};  
34.         \}  
35.           
36.         // 应用注册的URI Scheme   
37.         // 当发现没有安装应用的时候，跳转到 WAP 的下载页面  
38.           
39.         window.scrollTo(0,1);  
40.         var params = localParam(),  
41.             isIDevice = (/iphone|ipod/gi).test(navigator.platform),  
42.             isIDeviceIpad = (/ipad/gi).test(navigator.platform),  
43.             isAndroid = (/Android/gi).test(navigator.userAgent),  
44.             isWeixin = (/MicroMessenger/ig).test(navigator.userAgent),  
45.             isappinstalled = params.search\['isappinstalled'\],  
46.             appinstall = params.search\['appinstall'\],  
47.             wxLink = 'weixinfallback.html',  
48.             iDownload = 'itms-apps://itunes.apple.com/cn/app/<%=app\_store\_id%>?mt=8',  
49.             openAppLink = params.hash\['url'\] || params.search\['url'\],  
50.             iframe = document.getElementById('ifr');  
51.               
52.         if( (isIDevice || isIDeviceIpad) && !isAndroid)\{  
53. //          openAppLink = openAppLink || 'smcyuetv://';  
54.             openAppLink = openAppLink || '**<**%=URI\_Scheme\_iOS%**>**';  
55.         \}else if(isAndroid)\{  
56. //          openAppLink = openAppLink || 'yuetv://';  
57.             openAppLink = openAppLink || '**<**%=URI\_Scheme\_Android%**>**';  
58.         \}  
59.           
60.         if(isappinstalled!==undefined)\{  
61.             wxLink += '?isappinstalled='+isappinstalled+'&openurl='+openAppLink;  
62.         \}else if(appinstall!==undefined)\{  
63.             wxLink += '?appinstall='+appinstall+'&openurl='+openAppLink;  
64.         \}else\{  
65.             wxLink += '?openurl='+openAppLink;  
66.         \}  
67.           
68.         if(isIDeviceIpad)\{  
69.             //iDownload = 'itms-apps://itunes.apple.com/cn/app/id425349261?mt=8';  
70.         \}     
71.         function download()\{  
72.             // if(isAndroid)\{  
73.                 // window.location = 'http://3g.163.com/m/android/software/2vbrks.html';  
74.             // \}else\{  
75.                 window.location ='<%=download\_url%>';  
76.             // \}  
77.         \}  
78.         /\*  
79.          \* iOS点击打开:  
80.         1.如果是微信就去引导图页面  
81.         2.如果不是微信就走安装就打开不安装就去app store  
82.         3.如果微信用户按引导图从浏览器打开就能走通第2条  
83.           
84.         android点击打开:  
85.         1.如果是微信就在打开的时候同时跳转到有图的引导页  
86.         2.如果不是微信就同时跳转到公公共下载页  
87.         3.如果微信用户按引导图从浏览器打开就能走通第2条  
88.          \*/  
89.         function open()\{  
90.             if(isWeixin)\{  
91.                 window.location = wxLink;  
92.             \}else if((isIDevice || isIDeviceIpad) && !isAndroid)\{  
93.                 window.location = openAppLink;  
94.                 setTimeout(function()\{  
95.                     window.location = iDownload;  
96.                 \}, 50);  
97.             \}else\{  
98.                 iframe.src = openAppLink;  
99.                 download();  
100.             \}  
101.         \}  
102.           
103.         document.querySelector(".openBtn").addEventListener("click", open, false);  
104.           
105.         // 自动打开  
106.         var autoopen = params.search\['autoopen'\] || params.hash\['autoopen'\];  
107.         autoopen == 1 && open();  
108.     \})(window,document);  
109. **</****script****>**

其实，只要是在页面，就应该可以通过 URI Scheme 调用客户端。那么，在 WebApp / Hyper App 也能如是作法吧！

另外，我这里只是着重讨论的网页的部分。调用客户端还是比较简单的，如果需要调用客户端里面的某个一个模块呢？客户端可不想网页那样，天生就是有 URL 定位，传个地址或参数就可以了。这里涉及的客户端原生程序的部分比较多，就是说，如果直接跳到某个模块里面去，——这涉及到客户端模块是否已经合理解耦了，以及所依赖的上下文参数等等诸多问题，——需要和客户端开发者好好商量才行。

参考：

*  [《在mobile safari中巧妙实现检测应用安装就打开，否则进App Store下载》][mobile safari_App Store]
 *  [http://yansong.me/2013/10/24/open-native-app-in-browser.html][http_yansong.me_2013_10_24_open-native-app-in-browser.html]
 *  [Intent scheme URL attack][]

顶

[Link 1]: http://blog.csdn.net/woyaowenzi/article/details/7313543
[view plain]: http://blog.csdn.net/zhangxin09/article/details/38011051#
[CODE]: https://code.csdn.net/assets/CODE_ico.png
[CODE_CODE]: https://code.csdn.net/snippets/431599
[ico_fork.svg]: https://code.csdn.net/assets/ico_fork.svg
[ico_fork.svg 1]: https://code.csdn.net/snippets/431599/fork
[Link 2]: http://m.v.qq.com/page/d/c/a/d0133j6juca.html?ptag=v.qq.com%23v.play.adaptor%232&mreferrer=http%3A%2F%2Fv.qq.com%2Fsearch.html%3Fpagetype%3D3%26stj2%3Dsearch.search%26stag%3Dtxt.index%26ms_key%3D%25E9%25BC%2593%25E6%2589%258B%25E7%258C%25AB%25E5%2592%25AA
[mobile safari_App Store]: http://www.iunbug.com/archives/2012/09/18/401.html
[http_yansong.me_2013_10_24_open-native-app-in-browser.html]: http://yansong.me/2013/10/24/open-native-app-in-browser.html
[Intent scheme URL attack]: http://drops.wooyun.org/papers/2893