前段時間遇到一個小需求:要求在分享出來的h5頁面中,有一個立即開啟的按鈕,如果本地安裝了我們的app,那麼點選就直接喚起本地app,如果沒有安裝,則跳轉到下載。
因為從來沒有做過這個需求,因此這注定是一個苦逼的調研過程。
我們最開始就面臨2個問題:一是如何喚起本地app,二是如何判斷瀏覽器是否安裝了對應app。
如何喚起本地app
首先,想要實現這個需求,肯定是必須要客戶端同學的配合才行,因此我們不用知道所有的實現細節,我們從前端角度思考看這個問題,需要知道的一點是,ios與Android都支援一種叫做schema協議的連結。比如網易新聞客戶端的協議為
newsapp://xxxxx複製程式碼
當然,這個協議不需要我們前端去實現,我們只需要將協議放在a標籤的href屬性裡,或者使用location.href與iframe來實現啟用這個連結。而location.href與iframe是解決這個需求的關鍵。
在ios中,還支援通過smart app banner
來喚起app,即通過一個meta標籤,在標籤裡帶上app的資訊,和開啟後的行為,程式碼形如
<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來實現。好吧,面對這種情況,只能屈服。
整理一下目前的思路,得到下面的解決方案
var url = {
open: 'app://xxxxx',
down: 'xxxxxxxx'
};
var iframe = document.createElement('iframe');
var body = document.body;
iframe.style.cssText='display:none;width=0;height=0';
var timer = null;
// 立即開啟的按鈕
var openapp = document.getElementById('openapp');
openapp.addEventListener('click', function() {
if(/MicroMessenger/gi.test(navigator.userAgent) {
// 引導使用者在瀏覽器中開啟
}) else{
body.appendChild(iframe);
iframe.src = url.open;
timer = setTimeout(function() {
wondow.location.href = url.down;
}, 500);
}
}, false)複製程式碼
想法很美好,現實很殘酷。一測試,就發現簡單的這樣實現有許多的問題。
第一個問題在於,當頁面成功喚起app之後,我們再切換回來瀏覽器,發現跳轉到了下載頁面。
為了解決這個問題,發現各個公司都進行了不同方式的嘗試。
也是歷經的很多折磨,發現了幾個比較有用的事件。
pageshow
: 頁面顯示時觸發,在load事件之後觸發。需要將該事件繫結到window上才會觸發
pagehide
: 頁面隱藏時觸發
visibilitychange
: 頁面隱藏沒有在當前顯示時觸發,比如切換tab,也會觸發該事件
document.hidden
當頁面隱藏時,該值為true,顯示時為false
由於各個瀏覽器的支援情況不同,我們需要將這些事件都給繫結上,即使這樣,也不一定能夠保證所有的瀏覽器都能夠解決掉這個小問題,實在沒辦法的事情也就只能這樣了。
擴充一下上面的方案,當本地app被喚起,則頁面會隱藏掉,就會觸發pagehide與visibilitychange事件
$(document).on('visibilitychange webkitvisibilitychange', function() {
var tag = document.hidden || document.webkitHidden;
if (tag) {
clearTimeout(timer);
}
})
$(window).on('pagehide', function() {
clearTimeout(timer);
})複製程式碼
而另外一個問題就是IOS9+下面的問題了。ios9的Safari,根本不支援通過iframe跳轉到其他頁面去。也就是說,在safari下,我的整體方案被全盤否決!
於是我就只能嘗試使用location.href的方式,這個方式能夠喚起app,但是有一個坑爹的問題,使用schema協議喚起app會有彈窗而不會直接跳轉去app!甚至當本地沒有app時,會被判斷為連結無效,然後還有一個彈窗。
這個彈窗會造成什麼問題呢?如果使用者不點確認按鈕,根據上面的邏輯,這個時候就會發現頁面會自動跳轉到下載去了。而且無效的彈窗提示在使用者體驗上是無法容忍的。
好吧,繼續扒別人的程式碼,看看別人是如何實現的。所以我又去觀摩了其他公司的實現結果,發現網易新聞,今日頭條都可以在ios直接從微信中喚起app。真是神奇了,可是今日頭條在Android版微信上也沒辦法直接喚起的,他們在Android上都是直接到騰訊應用寶的下載裡去。所以按道理來說這不是新增了白名單。
為了找到這個問題的解決方案,我在網易新聞的頁面中扒出了他們的程式碼,並整理如下,新增了部分註釋
window.NRUM = window.NRUM || {};
window.NRUM.config = {
key:'27e86c0843344caca7ba9ea652d7948d',
clientStart: +new Date()
};
(function() {
var n = document.getElementsByTagName('script')[0],
s = document.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = '//nos.netease.com/apmsdk/napm-web-min-1.1.3.js';
n.parentNode.insertBefore(s, n);
})();
;
(function(window,doc){
// http://apm.netease.com/manual?api=web
NRUM.mark && NRUM.mark('pageload', true)
var list = []
var config = null
// jsonp
function jsonp(a, b, c) {
var d;
d = document.createElement('script');
d.src = a;
c && (d.charset = c);
d.onload = function() {
this.onload = this.onerror = null;
this.parentNode.removeChild(this);
b && b(!0);
};
d.onerror = function() {
this.onload = this.onerror = null;
this.parentNode.removeChild(this);
b && b(!1);
};
document.head.appendChild(d);
};
function localParam(search,hash){
search = search || window.location.search;
hash = hash || window.location.hash;
var fn = function(str,reg){
if(str){
var data = {};
str.replace(reg,function( $0, $1, $2, $3 ){
data[ $1 ] = $3;
});
return data;
}
}
return {search: fn(search,new RegExp( "([^?=&]+)(=([^&]*))?", "g" ))||{},hash: fn(hash,new RegExp( "([^#=&]+)(=([^&]*))?", "g" ))||{}};
}
jsonp('http://active.163.com/service/form/v1/5847/view/1047.jsonp')
window.search = localParam().search
window._callback = function(data) {
window._callback = null
list = data.list
if(search.s && !!search.s.match(/^wap/i)) {
config = list.filter(function(item){
return item.type === 'wap'
})[0]
return
}
config = list.filter(function(item){
return item.type === search.s
})[0]
}
var isAndroid = !!navigator.userAgent.match(/android/ig),
isIos = !!navigator.userAgent.match(/iphone|ipod/ig),
isIpad = !!navigator.userAgent.match(/ipad/ig),
isIos9 = !!navigator.userAgent.match(/OS 9/ig),
isYx = !!navigator.userAgent.match(/MailMaster_Android/i),
isNewsapp = !!navigator.userAgent.match(/newsapp/i),
isWeixin = (/MicroMessenger/ig).test(navigator.userAgent),
isYixin = (/yixin/ig).test(navigator.userAgent),
isQQ = (/qq/ig).test(navigator.userAgent),
params = localParam().search,
url = 'newsapp://',
iframe = document.getElementById('iframe');
var isIDevicePhone = (/iphone|ipod/gi).test(navigator.platform);
var isIDeviceIpad = !isIDevicePhone && (/ipad/gi).test(navigator.platform);
var isIDevice = isIDevicePhone || isIDeviceIpad;
var isandroid2_x = !isIDevice && (/android\s?2\./gi).test(navigator.userAgent);
var isIEMobile = !isIDevice && !isAndroid && (/MSIE/gi).test(navigator.userAgent);
var android_url = (!isandroid2_x) ? "http://3g.163.com/links/4304" : "http://3g.163.com/links/6264";
var ios_url = "http://3g.163.com/links/3615";
var wphone_url = "http://3g.163.com/links/3614";
var channel = params.s || 'newsapp'
// 判斷在不同環境下app的url
if(params.docid){
if(params['boardid'] && params['title']){
url = url + 'comment/' + params.boardid + '/' + params.docid + '/' + params.title
}else{
url = url + 'doc/' + params.docid
}
}else if(params.sid){
url = url + 'topic/' + params.sid
}else if(params.pid){
var pid = params.pid.split('_')
url = url + 'photo/' + pid[0] + '/' + pid[1]
}else if(params.vid){
url = url + 'video/' + params.vid
}else if(params.liveRoomid){
url = url + 'live/' + params.liveRoomid
}else if(params.url){
url = url + 'web/' + decodeURIComponent(params.url)
}else if(params.expertid){
url = url + 'expert/' + params.expertid
}else if(params.subjectid){
url = url + 'subject/' + params.subjectid
}else if(params.readerid){
url = url + 'reader/' + params.readerid
}else{
url += 'startup'
}
if(url.indexOf('?') >= 0){
url += '&s=' + (params.s || 'sps')
}else{
url += '?s=' + (params.s || 'sps')
}
// ios && 易信 用iframe 開啟
if((isIos||isIpad) && navigator.userAgent.match(/yixin/i)) {
document.getElementById('iframe').src = url;
}
var height = document.documentElement.clientHeight;
// 通常情況下先嚐試使用iframe開啟
document.getElementById('iframe').src = url;
// 移動端瀏覽器中,將下載頁面顯示出來
if(!isWeixin && !isQQ && !isYixin && !isYx){
document.querySelector('.main-body').style.display = 'block'
if(isIos9){
document.querySelector('.main-body').classList.add('showtip')
}
setTimeout(function(){
document.body.scrollTop = 0
},200)
}else{
document.getElementById('guide').style.display = 'block'
}
// Forward To Redirect Url
// Add by zhanzhixiang 12/28/2015
if (params.redirect) {
var redirectUrl = decodeURIComponent(params.redirect);
if ( typeof(URL) === 'function' && new URL(redirectUrl).hostname.search("163.com") !== -1) {
window.location.href = redirectUrl;
} else if (redirectUrl.search("163.com") !== -1){
window.location.href = redirectUrl;
};
}
// Forward To Redirect Url End
if ((isWeixin || isQQ) && isAndroid) {
window.location.href = 'http://a.app.qq.com/o/simple.jsp?pkgname=com.netease.newsreader.activity&ckey=CK1331205846719&android_schema=' + url.match(/(.*)\?/)[1]
}
if(isIos||isIpad){
document.getElementById("guide").classList.add('iosguideopen')
}else if (isAndroid){
document.getElementById("guide").classList.add('androidguideopen')
}else{
// window.location.href = 'http://www.163.com/newsapp'
}
document.getElementById('link').addEventListener('click', function(){
// 統計
neteaseTracker && neteaseTracker(false,'http://sps.163.com/func/?func=downloadapp&modelid='+modelid+'&spst='+spst+'&spsf&spss=' + channel,'', 'sps' )
if (config) {
android_url = config.android
}
if (config && config.iOS) {
ios_url = config.iOS
}
if(isWeixin || isQQ){
return
}
var msg = isIDeviceIpad ? "檢測到您正在使用iPad, 是否直接前往AppStore下載?" : "檢測到您正在使用iPhone, 是否直接前往AppStore下載?";
if (isIDevice){
window.location = ios_url;
return;
}else if(isAndroid){
// uc瀏覽器用iframe喚醒
if(navigator.userAgent.match(/ucbrowser|yixin|MailMaster/i)){
document.getElementById('iframe').src = url;
} else {
window.location.href = url;
}
setTimeout(function(){
if(document.webkitHidden) {
return
}
if (confirm("檢測到您正在使用Android 手機,是否直接下載程式安裝包?")) {
neteaseTracker && neteaseTracker(false,'http://sps.163.com/func/?func=downloadapp_pass&modelid='+modelid+'&spst='+spst+'&spsf&spss=' + channel,'', 'sps' )
window.location.href = android_url;
} else {
neteaseTracker && neteaseTracker(false,'http://sps.163.com/func/?func=downloadapp_cancel&modelid='+modelid+'&spst='+spst+'&spsf&spss=' + channel,'', 'sps' )
}
},200)
return;
}else if(isIEMobile){
window.location = wphone_url;
return;
}else{
window.open('http://www.163.com/special/00774IQ6/newsapp_download.html');
return;
}
}, false)
setTimeout(function(){
if(isIDevice && params.notdownload != 1 && !isNewsapp && !isIos9){
document.getElementById('link').click()
}
}, 1000)
})(window,document);複製程式碼
雖然有一些外部的引用,和一些搞不懂是幹什麼用的方法和變數,但是基本邏輯還是能夠看明白。好像也沒有什麼特別的地方。研究了許久,看到了一個叫做apple-app-site-association
的jsonp請求很奇特。這是來幹嘛用的?
{
"applinks": {
"apps": [ ],
"details": {
"TEAM-IDENTIFIER.YOUR.BUNDLE.IDENTIFIER": {
"paths": [
"*"
]
}
}
}
}複製程式碼
大家可以直接訪問這個連結,檢視裡面的內容
為了搞清楚這個問題,費盡千辛萬苦搜尋了很多文章,最終鎖定了一個極為關鍵的名詞 Universal links
。
Apple為iOS 9釋出了一個所謂的通用連結的深層連結特性,即Universal links。雖然它並不完美,但是這一發布,讓數以千計的應用開發人員突然意識到自己的應用體驗被打破。
Universal links,一種能夠方便的通過傳統的HTTP/HTTPS 連結來啟動App,使用相同的網址開啟網站和App。
關於這個問題的提問與universal links的介紹 點選這裡檢視
ios9推行的一個新的協議!
關於本文的這個問題,國內的論壇有許許多多的文章來解決,但是提到universal links的文章少之又少。他改變了使用者體驗的關鍵在於,微信沒有辦法遮蔽這個協議。因此如果我們的app註冊了這個協議,那麼我們就能夠從微信中直接喚起app。
至於universal links具體如何實現,讓ios的同學去搞定吧,這裡提供兩個參考文章
www.cocoachina.com/bbs/read.ph…
支援了這個協議之後,我們又可以通過iframe來喚起app了,因此基本邏輯就是這樣了。最終的調研結果是
沒有完美的解決方案
就算是網易新聞,這個按鈕在使用過程中也會有一些小bug,無法做到完美的狀態。
因為我們面臨許多沒辦法解決的問題,比如無法真正意義上的判斷本地是否安裝了app,pageshow,pagehide並不是所有的瀏覽器都支援等。很多其他部落格裡面,什麼計算時間差等方案,我花了很久的時間去研究這些方案,結果是,根!本!沒!有!用!
老實說,從微信中跳轉到外部瀏覽器,並不是一個好的解決方案,這樣會導致很多使用者流失,因此大家都在ios上實現了universal links,而我更加傾向的方案是知乎的解決,他們從設計上避免了在一個按鈕上來判斷這個邏輯,而採用了兩個按鈕的方式。
網易新聞的邏輯是,點選開啟會跳轉到一個下載頁面,這個下載頁面一載入完成就嘗試開啟app,如果開啟了就直接跑到app裡面去了,如果沒有就在頁面上有一個立即下載的按鈕,按鈕行只有下載處理。
在後續與ios同學實現universal liks的時候又遇到了一些坑,總結了一些經驗,歡迎持續關注我下一篇關於這個話題的討論。