iOS Universal Links 使用詳細(xì)教程

一.為什么要配置Universal Links

1.Universal Links可以通過配置指定域名路徑直接喚醒APP浇揩，一步到位。對比以前的 URL Scheme跳轉(zhuǎn)強(qiáng)大太多北发，有興趣可以自行谷歌了解詳細(xì)原因這里不作太多解釋呻粹。

2.QQ微信等第三方平臺在2021以后相關(guān)分享第三方登錄都會進(jìn)行universal link的校驗(yàn)，不配置的話將無法正常使用第三方的功能魂角。

二.Universal Links配置步驟及驗(yàn)證

1.創(chuàng)建一個(gè)名字叫做apple-app-site-association昵济，包含固定格式的json文件內(nèi)容如下：

{

"applinks": {

"apps": [],

"details": [

"appID": "TeamID.com.demon.lan",

"paths":["*"]

]

}

????注意事項(xiàng)：

1.文件名字必須為apple-app-site-association，不能帶json后綴名野揪，不能帶json后綴名,不能帶json后綴名,重要的事情說三次访忿。

2.apple-app-site-association中的appID 的格式為 teamID.BundleID，teamID和BundleID在開發(fā)者網(wǎng)站?Identifiers一欄可以找到斯稳。（BundleID在xcode里面也可以找到）

譬如說我的teamID是xxxxxxxxxxx海铆，bundleId是com.mytest.app （為了方便敘述，文章后面都將用com.mytest.app 作為示例的bundleID挣惰，?bundleID反過來app.mytest.com則表示示例域名卧斟，大家的項(xiàng)目應(yīng)該都是這么命名的吧）

3.??paths配置，實(shí)際上就是限制哪些路徑可以喚醒a(bǔ)pp憎茂，哪些路徑不能喚醒a(bǔ)pp珍语。

上面的示例中是"paths":["*"] , 只有一個(gè)*則表示整個(gè)網(wǎng)站都可以使用，不推薦這么寫竖幔，博主剛開始是這么配置的板乙，出了一個(gè)嚴(yán)重的bug，一個(gè)支付H5鏈接拳氢，本來點(diǎn)擊去H5支付頁面的募逞，結(jié)果因?yàn)槲疫@么配置了，只要鏈接包含域名直接往APP里面跳馋评，導(dǎo)致用戶無法支付放接！

所以我們要加一些路徑：

比如現(xiàn)在我項(xiàng)目有一個(gè)把一個(gè)事件記錄到系統(tǒng)日歷里面的功能，里面放一個(gè)指定鏈接如：https://app.mytest.com/SystemCalendar/?點(diǎn)擊直接進(jìn)入我的APP留特，那么我path就需要像下面這樣配置就好啦纠脾，（備注：為了兼容后面需要加字段玛瘸，我在后面添加了* 來指定網(wǎng)站的某一部分）

"paths": [ "/SystemCalendar/*"]

依次類推如果還想加其他路徑，用逗號分割即可乳乌，文章后面也會加入QQ微信等path捧韵，以下是蘋果官方文檔示例可以了解一下，注意配置的paths路徑汉操，是區(qū)分大小寫的

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

2.xcode項(xiàng)目的配置：

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

一定要按照applinks:域名的格式填寫

3.服務(wù)器的配置：

將apple-app-site-association文件上傳到服務(wù)器這個(gè)需要后端開發(fā)配合完成，將這個(gè)文件放到服務(wù)器的根目錄下或者放到.well-known目錄下磷瘤。

當(dāng)時(shí)后端同學(xué)給我的截圖如下芒篷，這里我還是使用文章的相關(guān)示例id展示：

確保使用https://app.mytest.com/apple-app-site-association這個(gè)鏈接在safari可以打開APP，一定要是這個(gè)格式采缚，后綴不能帶.json,中間也不能包含其他路徑针炉，app.mytest.com為你的服務(wù)器域名。

4.驗(yàn)證Universal Links配置是否成功

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

請求apple-app-site-association文件成功之后镰烧，用戶就可以使用Universal Links喚醒a(bǔ)pp了。測試的咱們最好把應(yīng)用刪了重新裝楞陷，確保蘋果會發(fā)請求怔鳖。

以下幾種測試方法可以參考：

1.直接將https://app.mytest.com/SystemCalendar??復(fù)制到Safari打開，記得下拉以下看看會不會出現(xiàn)APP的跳轉(zhuǎn)欄固蛾，像下面這樣就是成功了

2.快捷驗(yàn)證结执，在備忘錄中輸入https://app.mytest.com/apple-app-site-association，長按這個(gè)鏈接艾凯，如果能正常顯示出apple-app-site-association文件內(nèi)容献幔，則表示服務(wù)端已經(jīng)上傳成功了。

然后長按 https://app.mytest.com/SystemCalendar 趾诗，出現(xiàn)“在xxxx中打開”(xxxx為你的項(xiàng)目名稱)則表示配置成功

3.使用蘋果的驗(yàn)證網(wǎng)站斜姥，驗(yàn)證文件是否能被蘋果請求到。如果是未上線的應(yīng)用沧竟，使用驗(yàn)證網(wǎng)站時(shí)可能出現(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路徑無法訪問，需要檢查網(wǎng)絡(luò)和后端同學(xué)聯(lián)調(diào)一下闪水。

Tips：服務(wù)器必須要支持https糕非，而且需要支持TLS1.2協(xié)議以上，不過相信蘋果強(qiáng)制支持https之后，這個(gè)坑就會慢慢填上了⌒喾剩現(xiàn)在還有很多童鞋的服務(wù)器使用的免費(fèi)的證書禁筏，或者證書不被蘋果信任，然后就會導(dǎo)致無法下載apple-app-site-association衡招。蘋果支持的https根證書列表

apple-app-site-association文件名千萬不能寫錯篱昔，使用charles抓包顯示，只有初次安裝app時(shí)才會去請求apple-app-site-association文件始腾，所以測試時(shí)有可能因?yàn)榫W(wǎng)絡(luò)波動導(dǎo)致apple-app-site-association文件獲取失敗州刽。這種情況，多卸載幾次浪箭，安裝時(shí)使用4G穗椅。

驗(yàn)證各種配置的還有一個(gè)網(wǎng)站，需要打成ipa包丟上去奶栖。

5.通過Universal Links跳到APP內(nèi)匹表，獲取URL：

OC代碼：

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

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

returnYES;

}

Swift代碼：

func?application(_application:UIApplication, continue userActivity:NSUserActivity, restorationHandler:@escaping([UIUserActivityRestoring]?) ->Void) ->Bool{

? ?NSLog("userActivity :\(userActivity.webpageURL.description)")

? ? ? ??return true

? ?}

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

三.微信QQ的Universal Links配置問題

1.QQ的配置

1.登錄QQ互聯(lián)官網(wǎng)袍镀，到應(yīng)用管理->找到應(yīng)用(需要審核通過) ->查看

按照提示填寫相關(guān)信息，最后生成如下Universal Links :https://app.mytest.com/qq_conn/12345678框冀，剛創(chuàng)建完是要點(diǎn)擊驗(yàn)證的流椒，我們拿到QQ的appId 及12345678（注意這個(gè)不是項(xiàng)目的APPID，是QQ生成的）明也；

項(xiàng)目中對接QQSDK需要配置一下這個(gè)Universal Links宣虾，初始化會讓你傳進(jìn)去

然后將?qq_conn/12345678 這個(gè)path加入到apple-app-site-association文件，如下

"paths": [ "/SystemCalendar/*", "/qq_conn/12345678/*"]

即?SystemCalendar為上面提到過的日歷路徑温数，/qq_conn/12345678/*則QQ的路徑绣硝，

相關(guān)QQ配置可參考QQUniversallinks配置

3.微信的配置

和上面QQ類似，個(gè)人感覺比QQ簡單很多撑刺，登錄后臺配置一條Universal Links鹉胖，如果有指定路徑則和上面一樣加上指定路徑，也可以直接填域名够傍，項(xiàng)目內(nèi)初始化傳入即可甫菠。

四.常見問題及解決方案

1：appid和項(xiàng)目中為什么要配置支持associate domains呢？

為了在app啟動的時(shí)候告訴系統(tǒng)冕屯，我這個(gè)app支持Universal Links呀寂诱，這樣系統(tǒng)才方便根據(jù)項(xiàng)目中配置的domain域，去下載apple-app-site-association文件呀安聘。

2：apple-app-site-association文件配置了一堆是干啥用的呀痰洒？

作為WebKit加載鏈接時(shí)進(jìn)行攔截瓢棒，然后跳轉(zhuǎn)到目標(biāo)app的配置文件呀。

3.按照上面寫的配好了丘喻，怎么死活打不開呀脯宿？？泉粉？

a.必須支持https连霉，一定要是符合蘋果認(rèn)證的https證書；

b.配置文件問題搀继，apple-app-site-association文件中配置的path和測試用的通用鏈接不一致窘面，注意是區(qū)分大小寫的；

c.域名問題叽躯，xcode中配置的域名一不小心寫錯了财边。

6.為毛有的手機(jī)成功了，有的手機(jī)就不行呢点骑？酣难？？

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

7.服務(wù)器換域名了腫么辦菜谣？？晚缩？

博主做了一個(gè)小測試尾膊，當(dāng)Associated Domains添加新的 Domains的之后，在app再次啟動的時(shí)候抓包發(fā)現(xiàn)（不需要刪除重裝）荞彼，蘋果會給新添加的這個(gè)Domains發(fā)送一個(gè)請求冈敛，請求新Domain下的apple-app-site-association文件。也就是說Associated Domains發(fā)生改變的話鸣皂，系統(tǒng)是會知道的抓谴，這樣就可以在迭代的時(shí)候刪除舊的域名，添加新的域名了寞缝。另外Domains的配置也可以使用通配符癌压，例如：applinks:*.mywebsite.com

8.備忘錄和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”。

總結(jié)不易汹碱，如有幫助到你粘衬，點(diǎn)個(gè)贊再走唄～