最近，關于蘋果Universal Links，我發(fā)現(xiàn)有很多蘋果開發(fā)者遇到微信分享或打開小程序多次跳轉微信后連接中后又返回APP的問題，谷歌了很久沒有一個說到關鍵點上，當然也是因為我對官方文檔的解讀存在理解偏差，讓我踩了多次坑。接下來，為大家全面又重點的說明，保證你能立馬解決Universal Links跳轉問題??。
重點排查：
在apple-app-site-association文件格式正確的情況下，是否放在指定服務器根目錄或者根目錄新建的.well-known/文件夾下。
比如你的apple-app-site-association文件需要放在如下路徑：
https://x.y.com/apple-app-site-association
或者
https://x.y.com/.well-known/apple-app-site-association
否則，JSON文件在客戶端是down不下來的。錯誤示例：
https://x.y.com/a/b/apple-app-site-association
或者
https://x.y.com/a/b/.well-known/apple-app-site-association
全面弄清楚Universal Links需要理解以下幾個概念及關系：
- Universal Links
- Associated Domains
- apple-app-site-association
Universal Links
Universal Links是蘋果推出的通用鏈接，它的用處是iOS用戶可以點擊指向你網(wǎng)站的鏈接并無縫重定向到你的APP，不需要再通過Safari。你可能會問，這種打開APP的操作一個scheme不就可以了。是的，但是蘋果要這樣干，咱也不敢問，況且微信QQ已經(jīng)放棄scheme，為了能夠使用微信分享、支付和小程序，也只能使用Universal Links方式了。關于Universal Links最終定義，文末示例有說明。
Associated Domains
Associated Domains是關聯(lián)域，簡單理解就是存放關聯(lián)域文件apple-app-site-association的地方，本文中，我們的JSON文件放在https://x.y.com/apple-app-site-association或者https://x.y.com/.well-known/apple-app-site-association下，那么它的關聯(lián)域就是x.y.com，并且需要同步配置在Xcode工程Associated Domains內，格式要嚴格按照：applinks:x.y.com，
apple-app-site-association
apple-app-site-association就是關聯(lián)域文件，這里面蘋果那邊有個版本的更新。
舊的格式是這樣：
{
"applinks": {
"apps": [],
"details": [
{
"appID": "teamID.BundleID",
"paths": [ "/mm/nn/", "/sb/*"] //匹配路徑為/mm/nn/的URL，匹配路徑以/sb/為開頭的任意URL
},
{
"appID": "teamID.BundleID2",
"paths": [ "*" ] //匹配任意路徑的URL
}
]
}
}
新的改成這樣：
{
"applinks": {
"details": [
{
"appIDs": [ "teamID.BundleID", "teamID.BundleID2" ],
"components": [
{
"#": "no_universal_links",
"exclude": true,
"comment": "這是和Universal Links不匹配的一個安全提示，咱不管，抄過來即可"
},
{
"/": "/mm/nn/*",
"exclude": true,
"comment": "匹配路徑以/mm/nn/為開頭的任意URL"
},
{
"/": "/sb/*",
"comment": "匹配路徑以/sb/為開頭的任意URL"
},
{
"/": "/help/*",
"?": { "articleNumber": "????" },
"comment": "暫時用不上，不管"
}
]
}
]
},
"webcredentials": {
"apps": [ "teamID.BundleID", "teamID.BundleID2" ]
},
"appclips": {
"apps": ["teamID.BundleID.Clip", "teamID.BundleID2.Clip" ]
}
}
格式上，別猶豫，用新的。如果用了老的，問題不大，蘋果已經(jīng)做了兼容。但是不論是新老版本的JSON文件，如果有文件上的改動，注意不要影響老版本。比如BundleID改了，路徑改了，可以新增，但是別替換。
示例中"teamID"就是你的開發(fā)者賬號對應的teamID，其他完全按照官方格式來即可。比較重要的老格式中的"paths"字段和新格式中的"/"字段，它們表示URL匹配符，比如"/mm/nn/*"就表示匹配路徑以/mm/nn/開頭的任何URL。
簡單舉例：本例中，apple-app-site-association放在了https://x.y.com/.well-known/apple-app-site-association，
本例中Universal Links它可以是：https://x.y.com/mm/nn/或者https://x.y.com/sb/a/或者https://x.y.com/或者https://x.y.com/mm/nn/a/或者https://x.y.com/help/a/b/都行，明白了嗎？它的格式就是Associated Domains + apple-app-site-association中定義的路徑（文中有官方格式說明） + 其他子路徑（可加可不加），但是微信開放平臺等三方平臺中的Universal Links必須和其保持一致。可以通過Safari瀏覽器中輸入Universal Links，看頂部是否有打開你的App的提示（微信等也會通過該Universal Links直接跳轉返回我們的APP）。
比如：
相信已經(jīng)比較清晰了，有幾點注意事項：
- 關于關聯(lián)域，它可以是你們公司的官網(wǎng)地址，也可以是其他穩(wěn)定域，比如阿里云等。
- apple-app-site-association還是按照蘋果官網(wǎng)最新要求放在服務器根目錄下新建的.well-known/文件夾下，需要同步給公司的運維小伙伴，直接放在根目錄可能運維后期不易理解不好維護。
- 關于版本兼容，這個水比較深，第一，若你的應用先用了老版本的apple-app-site-association，放在原來的關聯(lián)域服務器下，但是現(xiàn)在需要升級，為了不影響原來的老版本APP使用，可以放在新的關聯(lián)域下。因為蘋果對apple-app-site-association的管理有時效、有緩存、也有規(guī)則。若APP已經(jīng)下載過apple-app-site-association文件，再次下載觸發(fā)的條件比較苛刻，比如重裝、更新、達到指定周期。該周期，網(wǎng)上說是1-3天，我還沒測出來，不敢妄加揣測。穩(wěn)一點，換一個自家服務器存放該文件。APP會第一時間下載更新后的apple-app-site-association文件。
- 關聯(lián)域，請確保它的穩(wěn)定性，不要把放在根目錄下的apple-app-site-association文件弄丟了，我們因為官網(wǎng)更新把該文件弄丟導致大批量的用戶打開微信失敗。還有一個比較重要的是，請確保該關聯(lián)域不要關聯(lián)多個服務器，若有多個服務器，除非每個服務器上都配置了apple-app-site-association，否則無法下載該文件，一樣無法使用。
- 若有其他問題，歡迎咨詢討論，1262078574@qq.com
參考文獻：
https://developer.apple.com/library/archive/documentation/General/Conceptual/AppSearch/UniversalLinks.html
https://developer.apple.com/documentation/xcode/supporting-associated-domains
https://support.iterable.com/hc/en-us/articles/360035496511-iOS-Universal-Links-
