本文由 CocoaChina 譯者 Amon Xu 翻譯自 HOKO 部落格,原文為 Breaking down iOS 9 Universal Links。
在 WWDC 2015 上,Apple 為 iOS 9 帶來了一項名為「通用鏈接(Universal Links)」的深層鏈接能力。雖然它並非強制實作的功能,卻值得開發者多加留意。
網路上關於這項特性的資訊既零散又常有誤解,就連 WWDC 本身也沒有著墨太多細節。所幸 HOKO 團隊已在自家智慧鏈接產品中導入這個特性,得以無縫地將使用者導引至 App 內。
很明顯,Apple 正大力推動開發者在深層鏈接上打造更好的體驗,這段時間所有的訊息幾乎都繞著深層鏈接打轉。與此同時,Apple 推出了通用鏈接:它能透過傳統的 HTTP 鏈接直接開啟 App,讓同一個網址既能開啟網站,也能開啟 App。
透過唯一的網址,就能把某個特定頁面關聯到你 App 裡的對應畫面,而且不需要額外自訂 URL Scheme。試想一下,如果 Twitter 採用了通用鏈接,那麼你每次在 twitter.com 點擊一個連結,你的 iOS 裝置都會自動在 Twitter App 裡打開該頁面;若你沒安裝,才會退回一般網頁。這種體驗非常順暢,而且最重要的是使用者不會失去上下文——跳進 App 後,Safari 不會再留下無用的空白分頁。
實作通用鏈接並不難,但必須先滿足幾個前提條件:
擁有一個已註冊的網域
該網域可透過 SSL 存取
支援上傳一個 JSON 檔案到你的網域
至少具備 iOS 9 beta 2 版本,這很重要,因為更早的測試版本需要額外的操作
至少具備 Xcode 7 beta 2
如果以上都齊備,就照著下面三個步驟動手吧。
首先,你必須在 Xcode 的 Capabilities 裡加入 App 的網域,並在前面加上 applinks: 前綴;同時別忘了補上你可能擁有的子網域與延伸(例如 www.domain.com、news.domain.com 等)。

用 applinks: 前綴加入所有網域,並記得涵蓋所有可能需要的子網域。
這會讓你的 App 向網域請求一個名為 apple-app-site-association 的特殊 JSON 檔案。當你第一次啟動 App 時,它會從 https://domain.com/apple-app-site-association 下載這個檔案。接著看下一步,了解如何打造這個檔案。
這個檔案必須存在,而且基於安全考量,需能透過 SSL 以 GET 請求存取。你可以打開編輯器,寫出一份如下的簡單 JSON:
{ "applinks": { "apps": [], "details": { "TBEJCS6FFP.com.domain.App": { "paths":[ "*" ] } } } }你可以用 paths 這個鍵設定一份允許的路徑清單(也就是你希望 App 做出反應的路徑),或者乾脆用一個星號,代表不管什麼路徑都開啟 App。
你可能會好奇 TBEJCS6FFP.com.domain.App 是怎麼來的。基本上,它就是加入了你團隊識別碼的 Bundle ID。你可以從 Apple 開發者帳號頁面取得團隊識別碼:

這個頁面上有你的團隊識別碼,複製貼上到 apple-app-site-association 檔案即可。
Bundle ID 可以在專案的 target 的 General 分頁中找到:

檢查 General 分頁並複製貼上 Bundle ID 到 apple-app-site-association 檔案。
最後,把這個檔案上傳到網域的根目錄。如果你開啟 https://domain.com/apple-app-site-association 能看到這個檔案,就可以進入下一步了。
為了在 App 內支援通用鏈接,你需要在 AppDelegate 裡實作 application(_:continueUserActivity:restorationHandler:)。雖然這個方法可用於多種用途(例如 Handoff 與搜尋 API),但我們這裡只聚焦在如何處理接收到的通用鏈接。
import UIKit
extension AppDelegate {
func application(application: UIApplication, continueUserActivity userActivity: NSUserActivity, restorationHandler: ([AnyObject]?) -> Void) -> Bool {
if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
let webpageURL = userActivity.webpageURL! // Always exists
if !handleUniversalLink(URL: webpageURL) {
UIApplication.sharedApplication().openURL(webpageURL)
}
}
return true
}
private func handleUniversalLink(URL url: NSURL) -> Bool {
if let components = NSURLComponents(URL: url, resolvingAgainstBaseURL: true), let host = components.host, let pathComponents = components.path?.pathComponents {
switch host {
case "domain.com":
if pathComponents.count >= 4 {
switch (pathComponents[0], pathComponents[1], pathComponents[2], pathComponents[3]) {
case ("/", "path", "to", let something):
if validateSomething(something) {
presentSomethingViewController(something)
return true
}
default:
return false
}
}
default:
return false
}
}
return false
}
}如果傳入的 userActivity 屬於 NSUserActivityTypeBrowsingWeb 類型,就代表它已經由通用鏈接 API 代理。此時可以確定,使用者開啟的 URL 一定有一個非空的 webpageURL 屬性。以前面的例子來說,它會是 https://domain.com/path/to/thezoo 的呈現。
為了確保你的 App 能把 URL 轉譯成實際內容,你需要做幾件事:
用 NSURLComponents 簡單解析 webpageURL,取得 host(如 domain.com)以及各段路徑(如 "/"、path、to、thezoo)。
確認能辨識這個 host。
嘗試把 pathComponents 對應到 App 已知的內容。
驗證該內容確實可以被呈現。
把內容呈現給使用者。
如果上述任一環節失敗,Apple 建議你的 App 應該在 Safari 中打開 webpageURL,以顯示錯誤訊息。
整體流程可參閱下圖:

上圖是通用鏈接工作流程的概要。
通用鏈接對開發者來說是個好主意,但也有一些缺點,可能讓它不受青睞。
讓 App 支援通用鏈接,意味著只有 iOS 9 的使用者才能享受這項技術優勢。舊版系統的使用者在點擊網頁連結時,仍然無法直接開啟 App,而是會像過去一樣回到瀏覽器與網頁。
如果你想退回首頁,或導向一個與 App 完全無關的網站,就得花點額外功夫,配置一個能把使用者導引到目標頁面的網頁。此外,如果你根本沒有網站,這幾乎就是無解的難題。
這對小型開發者可能是一大噩耗——他們也許買不起、也維護不了一個網站,卻仍希望透過網頁連結把使用者帶進 App。
關於更多細節,可以進一步查閱 Apple 官方文件或相關的深層鏈接指南。