目錄
一.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標簽的格式如下:
<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
是xxxxxxxxxxx
,bundleId
是com.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)如下提示:
- 出現(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
,如下圖:
項目配置
????在項目的Capablities
中開啟Associated domains
豁陆,如下圖:
????注意
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)下圖提示則配置成功雄坪。
某些坑
- 服務器必須要支持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)核是基于WebKit
的WKWebview
,在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證書列表