iOS9 Universal Links踩坑之旅，移動(dòng)應(yīng)用之deeplink喚醒a(bǔ)pp

目錄

一.URL Scheme
二.通過(guò)meta標(biāo)簽打開app
三.Universal Links簡(jiǎn)介
????· Universal Links的相關(guān)配置
四.小結(jié)
????· Universal Links的配置都是干啥用的
五.如何實(shí)現(xiàn)微信攔截Universal Links的效果
六.評(píng)論區(qū)問(wèn)題匯總

簡(jiǎn)單粗暴，有一個(gè)需求:

  • 用手機(jī)打開我們的網(wǎng)站，點(diǎn)擊打開按鈕或者收藏按鈕，用戶如果已經(jīng)安裝app，跳轉(zhuǎn)到app做相應(yīng)的操作。
  • 如果沒(méi)有安裝app，則跳轉(zhuǎn)到應(yīng)用商店提示用戶下載安裝。

方法1: URL Scheme

????holy 個(gè) shit 啊，第一時(shí)間想到的是url scheme ，然后將參數(shù)配置在url scheme后面，喚醒a(bǔ)pp再進(jìn)行頁(yè)面跳轉(zhuǎn)邏輯。

????但殘酷的現(xiàn)實(shí)是企鵝和微信都把url scheme 喚醒a(bǔ)pp這種方式給禁了。

方法2: meta標(biāo)簽

????然后考慮了在網(wǎng)頁(yè)上對(duì)meta 標(biāo)簽做手腳，可以實(shí)現(xiàn)類似下圖的效果：

meta標(biāo)簽示例.jpeg

meta標(biāo)簽的格式如下：

 <meta charset="UTF-8" name="apple-itunes-app" content="app-id=1234567890, affiliate-data=myAffiliateData, app-argument=yourScheme://">

????這樣添加meta標(biāo)簽后的網(wǎng)頁(yè)，使用safari打開的時(shí)候，就會(huì)在頂部顯示自己app的導(dǎo)航條。
????如果沒(méi)有安裝app點(diǎn)擊能夠跳轉(zhuǎn)到appstore去下載，如果安裝了app就能直接通過(guò)頂部的meta標(biāo)簽喚醒a(bǔ)pp了。

方法3:Why Universal Links？

????上面兩種方式都能實(shí)現(xiàn)某一方面的需求，但無(wú)法完美解決。于是就想到了iOS9之后的Universal Links。

什么是Universal Links呢？

????Universal Links就是一個(gè)通用鏈接，iOS9以上的用戶，可以通過(guò)點(diǎn)擊這個(gè)鏈接無(wú)縫的重定向到一個(gè)app應(yīng)用，而不需要通過(guò)safari打開跳轉(zhuǎn)。

????如果用戶沒(méi)有安裝這個(gè)app，則會(huì)在safari中打開這個(gè)鏈接指向的網(wǎng)頁(yè)。

如何支持Universal Links呢？

????按照蘋果官方文檔來(lái)說(shuō)，支持通用鏈接非常簡(jiǎn)單喲，只需要三步呢

1.創(chuàng)建一個(gè)名字叫做apple-app-site-association，包含固定格式的json文件

2.將這個(gè)文件上傳到你的服務(wù)器，可以將這個(gè)文件放到服務(wù)器的根目錄下，也可以放到.well-known這個(gè)子目錄下。

3.配置app，然后在app里面添加代理方法

????如果已經(jīng)配置過(guò)Universal Links，那么在用戶第一次安裝app時(shí)，蘋果會(huì)發(fā)送一個(gè)請(qǐng)求，請(qǐng)求你服務(wù)器上的apple-app-site-association文件。

????請(qǐng)求apple-app-site-association文件成功之后，用戶就可以使用Universal Links喚醒a(bǔ)pp了。

詳細(xì)的配置流程如下

（1） 關(guān)于apple-app-site-association文件的配置

{
"applinks": {
        "apps": [],
        "details": [
            {
                "appID": "teamID.bundleId",
                "paths": ["/deaplink","/wwdc/news/","*"]
            },
            {
                "appID": "ABCD1234.com.apple.wwdc",
                "paths": [ "*" ]
            }
        ]
    }
}

????創(chuàng)建一個(gè)包含上述格式的json文件，文件名字必須為apple-app-site-association，不能帶后綴名，有的電腦設(shè)置的隱藏后綴名，這點(diǎn)需要注意。

appID

????appID 的 格式為 teamID.bundleId形式。

如何獲取teamID呢？

????登錄開發(fā)者網(wǎng)站 ，找到Membership選項(xiàng)卡。

teamId.png

????譬如說(shuō)我的teamID是xxxxxxxxxxx，bundleId是com.mytest.app
????那么我的appID就是：xxxxxxxxxxx.com.mytest.app

paths

????paths配置，實(shí)際上就是限制哪些路徑可以喚醒a(bǔ)pp，哪些路徑不能喚醒a(bǔ)pp。格式如下：

"paths": [ "/wwdc/news/", "NOT /videos/wwdc/2010/*", "/videos/wwdc/201?/*"]

  • 使用*配置，則整個(gè)網(wǎng)站都可以使用

  • 使用特定的URL，例如/wwdc/news/來(lái)指定某一個(gè)特殊的鏈接

  • 在特定URL后面添加*，例如 /videos/wwdc/2015/*, 來(lái)指定網(wǎng)站的某一部分

  • 除了使用*來(lái)匹配任意字符，你也可以使用 ?來(lái)匹配單個(gè)字符，你可以在路徑當(dāng)中結(jié)合這兩個(gè)字符使用，例如 /foo/*/bar/201?/mypage

需要注意的是：
配置的paths路徑，是區(qū)分大小寫的

驗(yàn)證apple-app-site-association文件

????文件配置完成之后，將其上傳到你的服務(wù)器根目錄或者.well-known這個(gè)子目錄下。

  • 確保使用https://yourdomain.com/apple-app-site-association這個(gè)鏈接可以訪問(wèn)到，yourdomain.com為你的服務(wù)器域名。
  • 也可以使用蘋果的驗(yàn)證網(wǎng)站，驗(yàn)證文件是否能被蘋果請(qǐng)求到。如果是未上線的應(yīng)用，使用驗(yàn)證網(wǎng)站時(shí)可能出現(xiàn)如下提示：
Validation Tool.png
  • 出現(xiàn)該提示為apple-app-site-association文件配置正確。
  • 出現(xiàn)404錯(cuò)誤碼提示，則為apple-app-site-association文件未上傳成功，或者使用https://yourdomain.com/apple-app-site-association路徑無(wú)法訪問(wèn)。

（2） 建立web網(wǎng)頁(yè)和app應(yīng)用之間的關(guān)聯(lián) -> app IDs 配置 和 項(xiàng)目配置

app IDs 配置

????進(jìn)入開發(fā)者網(wǎng)站，找到你自己的bundleId，可以點(diǎn)擊edit按鈕，開啟associate domains，如下圖：

associated domains.png

項(xiàng)目配置

????在項(xiàng)目的Capablities中開啟Associated domains，如下圖：

appLinks.png

????注意domains可以添加多個(gè)，前綴必須為applinks:，applinks:后為你的服務(wù)器的域名。

代碼接收Universal Links喚醒
-(BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler{

    NSLog(@"userActivity : %@",userActivity.webpageURL.description);
    return YES;
}

????在appdelegate中實(shí)現(xiàn)上面這個(gè)方法，當(dāng)使用Universal Links喚醒a(bǔ)pp時(shí)就執(zhí)行這個(gè)方法。

（3）驗(yàn)證以上配置

????快捷驗(yàn)證，在備忘錄中輸入https://yourdomain.com/apple-app-site-association，長(zhǎng)按這個(gè)鏈接，出現(xiàn)下圖提示則配置成功。

successful.png

某些坑

  • 服務(wù)器必須要支持https，而且需要支持TLS1.2協(xié)議以上，不過(guò)相信蘋果強(qiáng)制支持https之后，這個(gè)坑就會(huì)慢慢填上了。現(xiàn)在還有很多童鞋的服務(wù)器使用的免費(fèi)的證書，或者證書不被蘋果信任，然后就會(huì)導(dǎo)致無(wú)法下載apple-app-site-association。蘋果支持的https根證書列表
  • 只支持iOS9以上
  • apple-app-site-association文件名千萬(wàn)不能寫錯(cuò)啊
  • 使用charles抓包顯示，只有初次安裝app時(shí)才會(huì)去請(qǐng)求apple-app-site-association文件，所以測(cè)試時(shí)有可能因?yàn)榫W(wǎng)絡(luò)波動(dòng)導(dǎo)致apple-app-site-association文件獲取失敗。這種情況，多卸載幾次，安裝時(shí)使用4G。
  • 驗(yàn)證各種配置的還有一個(gè)網(wǎng)站，需要打成ipa包丟上去。

小結(jié)一下

????Universal Links的配置總結(jié)起來(lái)很簡(jiǎn)單：

  • 去開發(fā)者網(wǎng)站配置appid，找到teamid
  • 創(chuàng)建一個(gè)沒(méi)有后綴名的apple-app-site-association文件，填寫相應(yīng)的配置
  • 配置項(xiàng)目，并編寫相應(yīng)的喚醒處理邏輯
????但是為什么要配置這些東西呢？配置他們的目的分別又是什么呢？我們換個(gè)角度來(lái)考慮一下

????先來(lái)看一下審核條款中的一項(xiàng)規(guī)定

  2.5.6 Apps that browse the web must use the appropriate WebKit framework and WebKit Javascript.

=????( ??д??) app 瀏覽網(wǎng)頁(yè)使用的都是蘋果的WebKit喲。

????而Universal Links之所以可行，也正是因?yàn)?WebKit。運(yùn)行在iOS上的所有app，當(dāng)他們使用 WebKit 打開某一個(gè)鏈接時(shí)，WebKit 肯定是能攔截到的。

????那么，Universal Links相關(guān)配置的作用就非常明了了。

Q：appid和項(xiàng)目中為什么要配置支持associate domains呢？
A：為了在app啟動(dòng)的時(shí)候告訴系統(tǒng)，我這個(gè)app支持Universal Links呀，這樣系統(tǒng)才方便根據(jù)項(xiàng)目中配置的domain域，去下載apple-app-site-association文件呀。

Q：apple-app-site-association文件配置了一堆是干啥用的呀？
A：作為WebKit加載鏈接時(shí)進(jìn)行攔截，然后跳轉(zhuǎn)到目標(biāo)app的配置文件呀。

如何在自己的app里實(shí)現(xiàn)微信屏蔽Universal Links的效果？（2018-07-27更新）

????我們先來(lái)看一下UIWebview的代理方法。
????以知乎為例，在下面的代碼里判斷如果是知乎的Universal Links鏈接 ，就不再加載。
????這種方法適用于白名單類型的加載，只要不在名單里面的全部干掉。

  - (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType{
    
      NSString *requesUrl = request.URL.absoluteString;
    
      if ([requesUrl containsString:@"oia.zhihu.com"]) {
          return NO;
      }else{
          return YES;
      }
  }

????而iOS微信瀏覽器對(duì)于Universal Links的攔截并不是這樣，微信攔截的是Universal Links喚醒其他app的動(dòng)作，而并不會(huì)將Universal Links指向的網(wǎng)頁(yè)加載攔掉。

????iOS微信瀏覽器內(nèi)核是基于WebKit的WKWebview ,在WebKit中，有兩個(gè)公開的控制是否加載某個(gè)鏈接的WKNavigationActionPolicy枚舉：
????- WKNavigationActionPolicyCancel
????- WKNavigationActionPolicyAllow

????除此之外，還有一個(gè)私有的枚舉_WKNavigationActionPolicyAllowWithoutTryingAppLink，且

  _WKNavigationActionPolicyAllowWithoutTryingAppLink = WKNavigationActionPolicyAllow + 2;

????那么我們?cè)赼pp里面攔截Universal Links的喚醒行為就非常簡(jiǎn)單了，同時(shí)不會(huì)對(duì)Universal Links指向網(wǎng)頁(yè)的加載造成影響。

- (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler{
    
    NSString *requesUrl = navigationAction.request.URL.absoluteString;
    
    if ([requesUrl containsString:@"oia.zhihu.com"]) {
        decisionHandler(WKNavigationActionPolicyAllow + 2);
    }else{
        decisionHandler(WKNavigationActionPolicyAllow);
    }
}

????這是demo，如果有興趣，還可以深入研究一下這個(gè)私有類LSAppLink。
????參考鏈接

2017年9月14日更新----評(píng)論區(qū)問(wèn)題匯總

  • 按照上面寫的配好了，怎么死活打不開呀？？？

????1.支持https呀，一定要是符合蘋果認(rèn)證的https證書呀。

????2.系統(tǒng)問(wèn)題，確保iOS9以上

????3.配置文件問(wèn)題，apple-app-site-association文件中配置的path和測(cè)試用的通用鏈接不一致，注意是區(qū)分大小寫的。

????4.域名問(wèn)題，xcode中配置的域名一不小心寫錯(cuò)了。

  • 為毛有的手機(jī)成功了，有的手機(jī)就不行呢？？？

????1.上面也提到過(guò)，因?yàn)榫W(wǎng)絡(luò)波動(dòng)有可能會(huì)導(dǎo)致部分用戶第一次安裝時(shí)，無(wú)法下載apple-app-site-association文件，這個(gè)只能引導(dǎo)用戶刪除重裝或者在迭代時(shí)修改Associated Domains配置告訴系統(tǒng)重新下載apple-app-site-association文件。

????2.另外一種可能是蘋果抽風(fēng)導(dǎo)致，筆者今年年初一碰到過(guò)一個(gè)蛋疼的問(wèn)題，從中午一直到下午4點(diǎn)發(fā)現(xiàn)重復(fù)的刪除重裝，app也不會(huì)請(qǐng)求服務(wù)器的apple-app-site-association文件，過(guò)了4點(diǎn)之后就好了。當(dāng)時(shí)因?yàn)闀r(shí)間特殊并沒(méi)有深究到底是什么原因?qū)е隆?/p>

  • 服務(wù)器換域名了腫么辦？？？

????筆者做了一個(gè)小測(cè)試，當(dāng)Associated Domains添加新的 Domains的之后，在app再次啟動(dòng)的時(shí)候抓包發(fā)現(xiàn)（不需要?jiǎng)h除重裝），蘋果會(huì)給新添加的這個(gè)Domains發(fā)送一個(gè)請(qǐng)求，請(qǐng)求新Domain下的apple-app-site-association文件。

????也就是說(shuō)Associated Domains發(fā)生改變的話，系統(tǒng)是會(huì)知道的，這樣就可以在迭代的時(shí)候刪除舊的域名，添加新的域名了。
????另外Domains的配置也可以使用通配符，例如：applinks:*.mywebsite.com

  • 全都配置好了，項(xiàng)目也能喚起來(lái)了，web頁(yè)面到底該怎么弄呀？？？通用鏈接指向的服務(wù)器的頁(yè)面到底應(yīng)該是哪個(gè)？

????我們之前iOS和安卓用的是同一個(gè)網(wǎng)頁(yè)，也就是說(shuō)從app內(nèi)分享出去的網(wǎng)頁(yè)，可以被蘋果用戶和安卓用戶同時(shí)查看，在這里我們是由web童鞋使用js判斷當(dāng)前所處的平臺(tái)以及其系統(tǒng)。

????如果是安卓用戶，則顯示安卓相關(guān)提示頁(yè)面。

????如果是蘋果用戶，那么分兩種：

????1、如果是9以上的系統(tǒng)，相關(guān)的“在app內(nèi)打開”按鈕的鏈接配置的就是我們的通用鏈接Universal Links了，且該通用鏈接地址指向的是一個(gè) app下載引導(dǎo)頁(yè)面，那么當(dāng)用戶安裝了app，即可通過(guò)通用鏈接喚醒a(bǔ)pp；如果用戶沒(méi)有安裝app，那么就會(huì)跳轉(zhuǎn)到通用鏈接指向的app下載引導(dǎo)頁(yè)面，達(dá)到最大化的客戶導(dǎo)流。

????2、如果是9以下的系統(tǒng)，則由web童鞋在當(dāng)前頁(yè)面添加一個(gè) “右上角在safari打開”，相應(yīng)的 “在app內(nèi)打開”的按鈕就會(huì)發(fā)一個(gè) 跳轉(zhuǎn)到我們app schema的重定向，以實(shí)現(xiàn)在safari中喚醒我們的app。

  • 當(dāng)使用通用鏈接喚醒a(bǔ)pp之后，手機(jī)右上角有一個(gè)小按鈕？

????那個(gè)小按鈕是可以引導(dǎo)用戶跳轉(zhuǎn)到safari中，名字叫bread crumbs button（面包屑），當(dāng)然也去不掉。

  • 備忘錄和safari中都可以打開app，怎么分享到其他app里面就不行了？

????未跨域?qū)е碌模纾悍窒淼轿⑿诺逆溄邮?https://www.mydomain.com/share.html，然后該網(wǎng)頁(yè)中的“在app內(nèi)打開”按鈕配置的通用鏈接為 https://www.mydomain.com/index.html。
????跨域的意思是說(shuō)，通用鏈接 和 調(diào)用通用鏈接的網(wǎng)頁(yè)不要使用同一域名。
????即如果通用鏈接域名為“www.mydomain.com”，則通用鏈接所處的網(wǎng)頁(yè)域名就不能是“www.mydomain.com”。

  • 歡迎大家在評(píng)論區(qū)繼續(xù)互動(dòng)呀，私信不好一起玩耍呀。

參考鏈接：
????1.大招之 官方文檔
????2.不錯(cuò)的博文
????3.蘋果驗(yàn)證通用鏈接是否可用的網(wǎng)站
????4.通用鏈接文件存放的server需要支持https 蘋果支持的https證書列表

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

推薦閱讀更多精彩內(nèi)容