iOS9 Universal Links踩坑之旅,移動應用之deeplink喚醒app

目錄

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

簡單粗暴,有一個需求:


  • 用手機打開我們的網(wǎng)站碧信,點擊打開按鈕或者收藏按鈕垫挨,用戶如果已經(jīng)安裝app,跳轉到app做相應的操作诈悍。
  • 如果沒有安裝app祸轮,則跳轉到應用商店提示用戶下載安裝。

方法1: URL Scheme


????holy 個 shit 啊侥钳,第一時間想到的是url scheme 适袜,然后將參數(shù)配置在url scheme后面,喚醒app再進行頁面跳轉邏輯舷夺。

????但殘酷的現(xiàn)實是企鵝和微信都把url scheme 喚醒app這種方式給禁了苦酱。

方法2: meta標簽


????然后考慮了在網(wǎng)頁上對meta 標簽做手腳,可以實現(xiàn)類似下圖的效果:

meta標簽示例.jpeg

meta標簽的格式如下:

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

????這樣添加meta標簽后的網(wǎng)頁给猾,使用safari打開的時候疫萤,就會在頂部顯示自己app的導航條。
????如果沒有安裝app點擊能夠跳轉到appstore去下載敢伸,如果安裝了app就能直接通過頂部的meta標簽喚醒app了扯饶。

方法3:Why Universal Links?


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

什么是Universal Links呢饶辙?

????Universal Links就是一個通用鏈接蹲诀,iOS9以上的用戶,可以通過點擊這個鏈接無縫的重定向到一個app應用弃揽,而不需要通過safari打開跳轉脯爪。

????如果用戶沒有安裝這個app则北,則會在safari中打開這個鏈接指向的網(wǎng)頁。

如何支持Universal Links呢痕慢?

????按照蘋果官方文檔來說尚揣,支持通用鏈接非常簡單喲,只需要三步呢

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

2.將這個文件上傳到你的服務器快骗,可以將這個文件放到服務器的根目錄下,也可以放到.well-known這個子目錄下塔次。

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

????如果已經(jīng)配置過Universal Links,那么在用戶第一次安裝app時励负,蘋果會發(fā)送一個請求藕溅,請求你服務器上的apple-app-site-association文件。

????請求apple-app-site-association文件成功之后继榆,用戶就可以使用Universal Links喚醒app了巾表。

詳細的配置流程如下


(1) 關于apple-app-site-association文件的配置

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

????創(chuàng)建一個包含上述格式的json文件,文件名字必須為apple-app-site-association略吨,不能帶后綴名集币,有的電腦設置的隱藏后綴名,這點需要注意晋南。

appID

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

如何獲取teamID呢?

????登錄開發(fā)者網(wǎng)站 负间,找到Membership選項卡偶妖。

teamId.png

????譬如說我的teamIDxxxxxxxxxxxbundleIdcom.mytest.app
????那么我的appID就是:xxxxxxxxxxx.com.mytest.app

paths

????paths配置政溃,實際上就是限制哪些路徑可以喚醒app趾访,哪些路徑不能喚醒app。格式如下:

"paths": [ "/wwdc/news/", "NOT /videos/wwdc/2010/*", "/videos/wwdc/201?/*"]
  • 使用*配置董虱,則整個網(wǎng)站都可以使用

  • 使用特定的URL扼鞋,例如/wwdc/news/來指定某一個特殊的鏈接

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

  • 除了使用*來匹配任意字符愤诱,你也可以使用 ?來匹配單個字符云头,你可以在路徑當中結合這兩個字符使用,例如 /foo/*/bar/201?/mypage

需要注意的是:
配置的paths路徑淫半,是區(qū)分大小寫的

驗證apple-app-site-association文件

????文件配置完成之后溃槐,將其上傳到你的服務器根目錄或者.well-known這個子目錄下。

  • 確保使用https://yourdomain.com/apple-app-site-association這個鏈接可以訪問到科吭,yourdomain.com為你的服務器域名昏滴。
  • 也可以使用蘋果的驗證網(wǎng)站猴鲫,驗證文件是否能被蘋果請求到。如果是未上線的應用谣殊,使用驗證網(wǎng)站時可能出現(xiàn)如下提示:
Validation Tool.png
  • 出現(xiàn)該提示為apple-app-site-association文件配置正確拂共。
  • 出現(xiàn)404錯誤碼提示,則為apple-app-site-association文件未上傳成功姻几,或者使用https://yourdomain.com/apple-app-site-association路徑無法訪問宜狐。

(2) 建立web網(wǎng)頁和app應用之間的關聯(lián) -> app IDs 配置 和 項目配置

app IDs 配置

????進入開發(fā)者網(wǎng)站,找到你自己的bundleId鲜棠,可以點擊edit按鈕肌厨,開啟associate domains,如下圖:

associated domains.png

項目配置

????在項目的Capablities中開啟Associated domains豁陆,如下圖:

appLinks.png

????注意domains可以添加多個,前綴必須為applinks:吵护,applinks:后為你的服務器的域名盒音。

代碼接收Universal Links喚醒

-(BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler{

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

????在appdelegate中實現(xiàn)上面這個方法,當使用Universal Links喚醒app時就執(zhí)行這個方法馅而。

(3)驗證以上配置

????快捷驗證祥诽,在備忘錄中輸入https://yourdomain.com/apple-app-site-association,長按這個鏈接瓮恭,出現(xiàn)下圖提示則配置成功雄坪。

successful.png

某些坑


  • 服務器必須要支持https,而且需要支持TLS1.2協(xié)議以上屯蹦,不過相信蘋果強制支持https之后维哈,這個坑就會慢慢填上了。現(xiàn)在還有很多童鞋的服務器使用的免費的證書登澜,或者證書不被蘋果信任阔挠,然后就會導致無法下載apple-app-site-association。蘋果支持的https根證書列表
  • 只支持iOS9以上
  • apple-app-site-association文件名千萬不能寫錯啊
  • 使用charles抓包顯示脑蠕,只有初次安裝app時才會去請求apple-app-site-association文件购撼,所以測試時有可能因為網(wǎng)絡波動導致apple-app-site-association文件獲取失敗。這種情況谴仙,多卸載幾次迂求,安裝時使用4G。
  • 驗證各種配置的還有一個網(wǎng)站晃跺,需要打成ipa包丟上去揩局。

小結一下


????Universal Links的配置總結起來很簡單:

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

????先來看一下審核條款中的一項規(guī)定

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

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

????而Universal Links之所以可行励背,也正是因為 WebKit。運行在iOS上的所有app砸西,當他們使用 WebKit 打開某一個鏈接時叶眉,WebKit 肯定是能攔截到的。

????那么芹枷,Universal Links相關配置的作用就非常明了了衅疙。

Q:appid和項目中為什么要配置支持associate domains呢?
A:為了在app啟動的時候告訴系統(tǒng)鸳慈,我這個app支持Universal Links呀饱溢,這樣系統(tǒng)才方便根據(jù)項目中配置的domain域,去下載apple-app-site-association文件呀走芋。

Q:apple-app-site-association文件配置了一堆是干啥用的呀绩郎?
A:作為WebKit加載鏈接時進行攔截,然后跳轉到目標app的配置文件呀翁逞。

如何在自己的app里實現(xiàn)微信屏蔽Universal Links的效果肋杖?(2018-07-27更新)


????我們先來看一下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微信瀏覽器對于Universal Links的攔截并不是這樣,微信攔截的是Universal Links喚醒其他app的動作哲思,而并不會將Universal Links指向的網(wǎng)頁加載攔掉洼畅。

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

????除此之外棚赔,還有一個私有的枚舉_WKNavigationActionPolicyAllowWithoutTryingAppLink帝簇,且

  _WKNavigationActionPolicyAllowWithoutTryingAppLink = WKNavigationActionPolicyAllow + 2;

????那么我們在app里面攔截Universal Links的喚醒行為就非常簡單了,同時不會對Universal Links指向網(wǎng)頁的加載造成影響靠益。

- (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丧肴,如果有興趣,還可以深入研究一下這個私有類LSAppLink胧后。
????參考鏈接

2017年9月14日更新----評論區(qū)問題匯總


  • 按照上面寫的配好了芋浮,怎么死活打不開呀?壳快?纸巷?

????1.支持https呀镇草,一定要是符合蘋果認證的https證書呀。

????2.系統(tǒng)問題瘤旨,確保iOS9以上

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

????4.域名問題因宇,xcode中配置的域名一不小心寫錯了。

  • 為毛有的手機成功了祟偷,有的手機就不行呢察滑??修肠?

????1.上面也提到過贺辰,因為網(wǎng)絡波動有可能會導致部分用戶第一次安裝時,無法下載apple-app-site-association文件嵌施,這個只能引導用戶刪除重裝或者在迭代時修改Associated Domains配置告訴系統(tǒng)重新下載apple-app-site-association文件魂爪。

????2.另外一種可能是蘋果抽風導致,筆者今年年初一碰到過一個蛋疼的問題艰管,從中午一直到下午4點發(fā)現(xiàn)重復的刪除重裝,app也不會請求服務器的apple-app-site-association文件蒋川,過了4點之后就好了牲芋。當時因為時間特殊并沒有深究到底是什么原因?qū)е隆?/p>

  • 服務器換域名了腫么辦?捺球?缸浦?

????筆者做了一個小測試,當Associated Domains添加新的 Domains的之后氮兵,在app再次啟動的時候抓包發(fā)現(xiàn)(不需要刪除重裝)裂逐,蘋果會給新添加的這個Domains發(fā)送一個請求,請求新Domain下的apple-app-site-association文件泣栈。

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

  • 全都配置好了疼进,項目也能喚起來了薪缆,web頁面到底該怎么弄呀?伞广?拣帽?通用鏈接指向的服務器的頁面到底應該是哪個疼电?

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

????如果是安卓用戶峡谊,則顯示安卓相關提示頁面茫虽。

????如果是蘋果用戶,那么分兩種:

????1既们、如果是9以上的系統(tǒng)濒析,相關的“在app內(nèi)打開”按鈕的鏈接配置的就是我們的通用鏈接Universal Links了,且該通用鏈接地址指向的是一個 app下載引導頁面啥纸,那么當用戶安裝了app号杏,即可通過通用鏈接喚醒app;如果用戶沒有安裝app斯棒,那么就會跳轉到通用鏈接指向的app下載引導頁面盾致,達到最大化的客戶導流。

????2荣暮、如果是9以下的系統(tǒng)庭惜,則由web童鞋在當前頁面添加一個 “右上角在safari打開”,相應的 “在app內(nèi)打開”的按鈕就會發(fā)一個 跳轉到我們app schema的重定向穗酥,以實現(xiàn)在safari中喚醒我們的app护赊。

  • 當使用通用鏈接喚醒app之后,手機右上角有一個小按鈕砾跃?

????那個小按鈕是可以引導用戶跳轉到safari中骏啰,名字叫bread crumbs button(面包屑),當然也去不掉抽高。

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

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

  • 歡迎大家在評論區(qū)繼續(xù)互動呀方仿,私信不好一起玩耍呀。

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

最后編輯于
?著作權歸作者所有,轉載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市仙蚜,隨后出現(xiàn)的幾起案子此洲,更是在濱河造成了極大的恐慌,老刑警劉巖委粉,帶你破解...
    沈念sama閱讀 206,839評論 6 482
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件呜师,死亡現(xiàn)場離奇詭異,居然都是意外死亡贾节,警方通過查閱死者的電腦和手機汁汗,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,543評論 2 382
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來栗涂,“玉大人知牌,你說我怎么就攤上這事〗锍蹋” “怎么了角寸?”我有些...
    開封第一講書人閱讀 153,116評論 0 344
  • 文/不壞的土叔 我叫張陵,是天一觀的道長忿墅。 經(jīng)常有香客問我扁藕,道長,這世上最難降的妖魔是什么疚脐? 我笑而不...
    開封第一講書人閱讀 55,371評論 1 279
  • 正文 為了忘掉前任亿柑,我火速辦了婚禮,結果婚禮上棍弄,老公的妹妹穿的比我還像新娘橄杨。我一直安慰自己,他們只是感情好照卦,可當我...
    茶點故事閱讀 64,384評論 5 374
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著乡摹,像睡著了一般役耕。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上聪廉,一...
    開封第一講書人閱讀 49,111評論 1 285
  • 那天瞬痘,我揣著相機與錄音,去河邊找鬼板熊。 笑死框全,一個胖子當著我的面吹牛,可吹牛的內(nèi)容都是我干的干签。 我是一名探鬼主播津辩,決...
    沈念sama閱讀 38,416評論 3 400
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了喘沿?” 一聲冷哼從身側響起闸度,我...
    開封第一講書人閱讀 37,053評論 0 259
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎蚜印,沒想到半個月后莺禁,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,558評論 1 300
  • 正文 獨居荒郊野嶺守林人離奇死亡窄赋,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,007評論 2 325
  • 正文 我和宋清朗相戀三年哟冬,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片忆绰。...
    茶點故事閱讀 38,117評論 1 334
  • 序言:一個原本活蹦亂跳的男人離奇死亡浩峡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出较木,到底是詐尸還是另有隱情红符,我是刑警寧澤,帶...
    沈念sama閱讀 33,756評論 4 324
  • 正文 年R本政府宣布伐债,位于F島的核電站预侯,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏峰锁。R本人自食惡果不足惜萎馅,卻給世界環(huán)境...
    茶點故事閱讀 39,324評論 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望虹蒋。 院中可真熱鬧糜芳,春花似錦、人聲如沸魄衅。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,315評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽晃虫。三九已至皆撩,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間哲银,已是汗流浹背扛吞。 一陣腳步聲響...
    開封第一講書人閱讀 31,539評論 1 262
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留荆责,地道東北人滥比。 一個月前我還...
    沈念sama閱讀 45,578評論 2 355
  • 正文 我出身青樓,卻偏偏與公主長得像做院,于是被迫代替她去往敵國和親盲泛。 傳聞我的和親對象是個殘疾皇子濒持,可洞房花燭夜當晚...
    茶點故事閱讀 42,877評論 2 345

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