您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 教學 >> iOS 相關教學

iOS 中用 URL Scheme 喚起 App:schema 協議與 iframe 實戰

編輯:iOS 相關教學

在 iOS 上要從網頁喚起自家 App,最普遍的做法是使用 URL Scheme。這是系統原生支援的機制,而且因為 iOS 不允許第三方瀏覽器自帶內核,所有瀏覽器都得走同一套 WebKit,相容性反而比 Android 好處理得多。

官方提供的方式有兩種:Smart App Banner 與 URL Scheme。

Smart App Banner

透過一個 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 喚起 App

Scheme 類似自訂的 URL 協議,格式通常長這樣:

myapplink://      # 自訂
fb://             # Facebook
itms-apps://      # App Store
sms://            # 簡訊

最簡單的喚起方式就是一個連結:

<a href="myapplink://">打開我的 app</a>

使用者點下去,對應的 App 就會被開啟。

實際上多半要綁事件

真實場景裡我們通常不會直接用 a 標籤,而是綁定 click 事件(例如先彈個提示層),這時候有兩條路:location.href 與 iframe。

iframe 是常見選擇,但問題不少:

  1. 沒有好辦法直接判斷 App 是否已被喚起。
  2. 會改變 history,瀏覽器的返回行為跟著受影響。
  3. 因為改動了 history,部分 WebView 會出問題——例如某 App 內開啟頁面後,選擇用 Safari 開啟,實際打開的卻是 iframe 裡的頁面。
  4. 同一份頁面若同時丟給 Android,容易出現打不開的狀況。
  5. 若使用者沒裝該 App,iOS Safari 會自己彈一個「打不開網址」的提示框。

所以真正的難題是:如何知道 iframe 已經成功喚起了 App。

用 setTimeout 做判斷

你可能會想用 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 秒,互動體驗根本說不過去。

改用 pageshow / pagehide

後來我們想到用頁面生命週期事件:瀏覽器被切去開 App 時應該觸發 pagehide,從 App 返回時則觸發 pageshow。實測結果是 Safari 可以,但 UC、Chrome 都不會觸發這兩個事件。

結論

  1. 用 iframe 載入 scheme URL。
  2. 用計時器判斷一段時間內是否喚起成功。
  3. 再用 pageshow / pagehide 輔助計時器做更精確的判斷。
  4. 計時器內若使用 alert 可能不會彈出——這一點相當出人意料,後續 DOM 都執行了,alert 卻沒顯示,推測與其實作方式有關。
  5. 實驗中我用了兩個計時器,因為切回瀏覽器後,timeout 有時會早於 pagehide / pageshow 觸發。
  6. 靠計算計時器的實際執行時間差,其實也不可靠。

以下是我研究後整理出的版本,相對穩妥,但仍有失敗案例(第三方瀏覽器不觸發 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 喚起天生缺乏可靠的「成功回呼」,只能層層堆疊近似判斷。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved