目錄
一.為什么要配置Universal Links
二.Universal Links配置步驟及驗證
三.微信QQ的Universal Links配置問題
四.常見問題及解決方案
蘋果官方文檔：蘋果官方文檔-Universal Links
一.為什么要配置Universal Links
1.Universal Links可以通過配置指定域名路徑直接喚醒APP，一步到位。對比以前的 URL Scheme跳轉(zhuǎn)強大太多，有興趣可以自行谷歌了解詳細(xì)原因這里不作太多解釋。
2.QQ微信等第三方平臺在2021以后相關(guān)分享第三方登錄都會進(jìn)行universal link的校驗，不配置的話將無法正常使用第三方的功能。
二.Universal Links配置步驟及驗證
1.創(chuàng)建一個名字叫做apple-app-site-association，包含固定格式的json文件內(nèi)容如下：
{
"applinks": {
"apps": [],
"details": [
{?
"appID": "TeamID.com.demon.lan",
"paths":["*"]
]
}
????注意事項：
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則表示示例域名，大家的項目應(yīng)該都是這么命名的吧）
3.??paths配置，實際上就是限制哪些路徑可以喚醒app，哪些路徑不能喚醒app。
上面的示例中是"paths":["*"] , 只有一個*則表示整個網(wǎng)站都可以使用，不推薦這么寫，博主剛開始是這么配置的，出了一個嚴(yán)重的bug，一個支付H5鏈接，本來點擊去H5支付頁面的，結(jié)果因為我這么配置了，只要鏈接包含域名直接往APP里面跳，導(dǎo)致用戶無法支付！
所以我們要加一些路徑：
比如現(xiàn)在我項目有一個把一個事件記錄到系統(tǒng)日歷里面的功能，里面放一個指定鏈接如：https://app.mytest.com/SystemCalendar/?點擊直接進(jìn)入我的APP，那么我path就需要像下面這樣配置就好啦，（備注：為了兼容后面需要加字段，我在后面添加了* 來指定網(wǎng)站的某一部分）
"paths": [ "/SystemCalendar/*"]
依次類推如果還想加其他路徑，用逗號分割即可，文章后面也會加入QQ微信等path，以下是蘋果官方文檔示例可以了解一下，注意配置的paths路徑，是區(qū)分大小寫的
"paths": [ "/wwdc/news/", "NOT /videos/wwdc/2010/*", "/videos/wwdc/201?/*"]
2.xcode項目的配置：
在項目的Capablities中開啟Associated domains，如下圖：
一定要按照applinks:域名 的格式填寫
3.服務(wù)器的配置：
將apple-app-site-association文件上傳到服務(wù)器這個需要后端開發(fā)配合完成，將這個文件放到服務(wù)器的根目錄下或者放到.well-known目錄下。
當(dāng)時后端同學(xué)給我的截圖如下，這里我還是使用文章的相關(guān)示例id展示：
確保使用https://app.mytest.com/apple-app-site-association這個鏈接在safari可以打開APP，一定要是這個格式，后綴不能帶.json,中間也不能包含其他路徑，app.mytest.com為你的服務(wù)器域名。
4.驗證Universal Links配置是否成功
如果已經(jīng)配置過Universal Links，那么在用戶第一次安裝app時，蘋果會發(fā)送一個請求，請求你服務(wù)器上的apple-app-site-association文件。
請求apple-app-site-association文件成功之后，用戶就可以使用Universal Links喚醒app了。測試的咱們最好把應(yīng)用刪了重新裝，確保蘋果會發(fā)請求。
以下幾種測試方法可以參考：
1.直接將https://app.mytest.com/SystemCalendar??復(fù)制到Safari打開，記得下拉以下看看會不會出現(xiàn)APP的跳轉(zhuǎn)欄，像下面這樣就是成功了
2.快捷驗證，在備忘錄中輸入https://app.mytest.com/apple-app-site-association，長按這個鏈接，如果能正常顯示出apple-app-site-association文件內(nèi)容，則表示服務(wù)端已經(jīng)上傳成功了。
然后長按 https://app.mytest.com/SystemCalendar ，出現(xiàn)“在xxxx中打開”(xxxx為你的項目名稱)則表示配置成功
3.使用蘋果的驗證網(wǎng)站，驗證文件是否能被蘋果請求到。如果是未上線的應(yī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路徑無法訪問，需要檢查網(wǎng)絡(luò)和后端同學(xué)聯(lián)調(diào)一下。
Tips：服務(wù)器必須要支持https，而且需要支持TLS1.2協(xié)議以上，不過相信蘋果強制支持https之后，這個坑就會慢慢填上了。現(xiàn)在還有很多童鞋的服務(wù)器使用的免費的證書，或者證書不被蘋果信任，然后就會導(dǎo)致無法下載apple-app-site-association。蘋果支持的https根證書列表
apple-app-site-association文件名千萬不能寫錯，使用charles抓包顯示，只有初次安裝app時才會去請求apple-app-site-association文件，所以測試時有可能因為網(wǎng)絡(luò)波動導(dǎo)致apple-app-site-association文件獲取失敗。這種情況，多卸載幾次，安裝時使用4G。
驗證各種配置的還有一個網(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中實現(xiàn)上面這個方法，當(dāng)使用Universal Links喚醒app時就執(zhí)行這個方法。
三.微信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)建完是要點擊驗證的，我們拿到QQ的appId 及12345678（注意這個不是項目的APPID，是QQ生成的）；
項目中對接QQSDK需要配置一下這個Universal Links，初始化會讓你傳進(jìn)去
然后將?qq_conn/12345678 這個path加入到apple-app-site-association文件，如下
"paths": [ "/SystemCalendar/*", "/qq_conn/12345678/*"]
即?SystemCalendar為上面提到過的日歷路徑 ，/qq_conn/12345678/*則QQ的路徑，
相關(guān)QQ配置可參考QQUniversallinks配置
3.微信的配置
和上面QQ類似，個人感覺比QQ簡單很多，登錄后臺配置一條Universal Links，如果有指定路徑則和上面一樣加上指定路徑，也可以直接填域名，項目內(nèi)初始化傳入即可。
四.常見問題及解決方案
1：appid和項目中為什么要配置支持associate domains呢？
為了在app啟動的時候告訴系統(tǒng)，我這個app支持Universal Links呀，這樣系統(tǒng)才方便根據(jù)項目中配置的domain域，去下載apple-app-site-association文件呀。
2：apple-app-site-association文件配置了一堆是干啥用的呀？
作為WebKit加載鏈接時進(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ī)就不行呢？？？
上面也提到過，因為網(wǎng)絡(luò)波動有可能會導(dǎo)致部分用戶第一次安裝時，無法下載apple-app-site-association文件，這個只能引導(dǎo)用戶刪除重裝或者在迭代時修改Associated Domains配置告訴系統(tǒng)重新下載apple-app-site-association文件。
7.服務(wù)器換域名了腫么辦？？？
博主做了一個小測試，當(dāng)Associated Domains添加新的 Domains的之后，在app再次啟動的時候抓包發(fā)現(xiàn)（不需要刪除重裝），蘋果會給新添加的這個Domains發(fā)送一個請求，請求新Domain下的apple-app-site-association文件。也就是說Associated Domains發(fā)生改變的話，系統(tǒng)是會知道的，這樣就可以在迭代的時候刪除舊的域名，添加新的域名了。另外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?？缬虻囊馑际钦f，通用鏈接 和 調(diào)用通用鏈接的網(wǎng)頁不要使用同一域名。即如果通用鏈接域名為“www.mydomain.com”，則通用鏈接所處的網(wǎng)頁域名就不能是“www.mydomain.com”。
總結(jié)不易，如有幫助到你，點個贊再走唄～
