在 iOS 上要從網頁喚起自家 App,最普遍的做法是使用 URL Scheme。這是系統原生支援的機制,而且因為 iOS 不允許第三方瀏覽器自帶內核,所有瀏覽器都得走同一套 WebKit,相容性反而比 Android 好處理得多。
官方提供的方式有兩種:Smart App Banner 與 URL Scheme。
透過一個 meta 標籤帶上 App 資訊與開啟後的行為:
<meta name="apple-itunes-app" content="app-id=myAppStoreID, affiliate-data=myAffiliateData, app-argument=myURL">
細節可參考 Apple 的官方文件(Promoting Apps with App Banners)。這不是本文重點,我們要談的是 Scheme。
Scheme 類似自訂的 URL 協議,格式通常長這樣:
myapplink:// # 自訂 fb:// # Facebook itms-apps:// # App Store sms:// # 簡訊
最簡單的喚起方式就是一個連結:
<a href="myapplink://">打開我的 app</a>
使用者點下去,對應的 App 就會被開啟。
真實場景裡我們通常不會直接用 a 標籤,而是綁定 click 事件(例如先彈個提示層),這時候有兩條路:location.href 與 iframe。
iframe 是常見選擇,但問題不少:
所以真正的難題是:如何知道 iframe 已經成功喚起了 App。
你可能會想用 iframe 的 onload,但遺憾的是它無效。於是改用計時器:點擊後記下時間,若頁面在一段時間內(例如 500ms)沒有被切走,代表 App 沒被喚起;反之若 App 被成功開啟,頁面進程會被中斷,計時器自然也跟著中斷,不會觸發。
function openIos(url, callback) {
if (!url) {
return;
}
var node = document.createElement('iframe');
node.style.display = 'none';
var body = document.body;
var timer;
var clear = function(evt, isTimeout) {
(typeof callback === 'function') && callback(isTimeout);
if (!node) {
return;
}
node.onload = null;
body.removeChild(node);
node = null;
};
var hide = function(e) {
clearTimeout(timer);
clear(e, false);
};
node.onload = clear;
node.src = url;
body.appendChild(node);
var now = +new Date();
timer = setTimeout(function() {
var newTime = +new Date();
if (now - newTime > 600) {
// 已經切走再切回來會耗時,因此時間差應該與 500ms 有明顯落差
clear(null, false);
} else {
clear(null, true);
}
}, 500);
}聽起來很穩妥,但現實總是殘酷:不同瀏覽器(包含各家 WebView)在背景都有各自的常駐時間。若某瀏覽器被切走後還能在背景存活 10 秒,那麼 5 秒的計時器就形同虛設;更別說 5 秒的話使用者得乾等 5 秒,互動體驗根本說不過去。
後來我們想到用頁面生命週期事件:瀏覽器被切去開 App 時應該觸發 pagehide,從 App 返回時則觸發 pageshow。實測結果是 Safari 可以,但 UC、Chrome 都不會觸發這兩個事件。
以下是我研究後整理出的版本,相對穩妥,但仍有失敗案例(第三方瀏覽器不觸發 pagehide / pageshow):
<p><button id="btn">點我點我啊!alert,不會彈出</button></p>
<p><button id="btn2">點我點我啊!alert2,info 會執行但 alert 不彈出</button></p>
<p><button id="btninfo">點我點我啊!info 可以</button></p>
$(function() {
var $info = $('#info');
function info(msg) {
var p = $('<p>' + msg + '</p>');
$info.append(p);
}
$('#btn').on('click', function() {
openIos('baiduboxapp://', function(t) {
if (t) {
alert('timeout or no baidu APP');
} else {
alert('invoke success');
}
});
});
$('#btn2').on('click', function() {
openIos('baiduboxapp://', function(t) {
if (t) {
info('timeout or no baidu APP2');
alert('timeout or no baidu APP2');
} else {
info('invoke success2');
alert('invoke success2');
}
});
});
$('#btninfo').on('click', function() {
openIos('baiduboxapp://', function(t) {
if (t) {
info('timeout or no baidu APP');
} else {
info('invoke success');
}
});
});
});
function openIos(url, callback) {
if (!url) {
return;
}
var node = document.createElement('iframe');
node.style.display = 'none';
var body = document.body;
var timer;
var clear = function(evt, isTimeout) {
(typeof callback === 'function') && callback(isTimeout);
window.removeEventListener('pagehide', hide, true);
window.removeEventListener('pageshow', hide, true);
if (!node) {
return;
}
node.onload = null;
body.removeChild(node);
node = null;
};
var hide = function(e) {
clearTimeout(timer);
clear(e, false);
};
window.addEventListener('pagehide', hide, true);
window.addEventListener('pageshow', hide, true);
node.onload = clear;
node.src = url;
body.appendChild(node);
var now = +new Date();
timer = setTimeout(function() {
timer = setTimeout(function() {
var newTime = +new Date();
if (now - newTime > 1300) {
clear(null, false);
} else {
clear(null, true);
}
}, 1200);
}, 60);
}實務上的建議是:把喚起失敗的判斷時間壓到使用者可接受的下限,並準備好 App Store 的引導作為退路。畢竟 scheme 喚起天生缺乏可靠的「成功回呼」,只能層層堆疊近似判斷。