最近，關(guān)于蘋果Universal Links，我發(fā)現(xiàn)有很多蘋果開發(fā)者遇到微信分享或打開小程序多次跳轉(zhuǎn)微信后連接中后又返回APP的問題，谷歌了很久沒有一個(gè)說到關(guān)鍵點(diǎn)上，當(dāng)然也是因?yàn)槲覍俜轿臋n的解讀存在理解偏差，讓我踩了多次坑。接下來，為大家全面又重點(diǎn)的說明，保證你能立馬解決Universal Links跳轉(zhuǎn)問題??。
重點(diǎn)排查：
在apple-app-site-association文件格式正確的情況下，是否放在指定服務(wù)器根目錄或者根目錄新建的.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不下來的。錯(cuò)誤示例：

https://x.y.com/a/b/apple-app-site-association
或者
https://x.y.com/a/b/.well-known/apple-app-site-association

全面弄清楚Universal Links需要理解以下幾個(gè)概念及關(guān)系：

1. Universal Links
2. Associated Domains
3. apple-app-site-association

Universal Links

Universal Links是蘋果推出的通用鏈接，它的用處是iOS用戶可以點(diǎn)擊指向你網(wǎng)站的鏈接并無縫重定向到你的APP，不需要再通過Safari。你可能會(huì)問，這種打開APP的操作一個(gè)scheme不就可以了。是的，但是蘋果要這樣干，咱也不敢問，況且微信QQ已經(jīng)放棄scheme，為了能夠使用微信分享、支付和小程序，也只能使用Universal Links方式了。關(guān)于Universal Links最終定義，文末示例有說明。

Associated Domains

Associated Domains是關(guān)聯(lián)域，簡單理解就是存放關(guā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下，那么它的關(guān)聯(lián)域就是x.y.com，并且需要同步配置在Xcode工程Associated Domains內(nèi)，格式要嚴(yán)格按照：applinks:x.y.com，

image.png

apple-app-site-association

apple-app-site-association就是關(guān)聯(lián)域文件，這里面蘋果那邊有個(gè)版本的更新。
舊的格式是這樣：

{
    "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不匹配的一個(gè)安全提示，咱不管，抄過來即可"
               },
               {
                  "/": "/mm/nn/*",
                  "exclude": true,
                  "comment": "匹配路徑以/mm/nn/為開頭的任意URL"
               },
               {
                  "/": "/sb/*",
                  "comment": "匹配路徑以/sb/為開頭的任意URL"
               },
               {
                  "/": "/help/*",
                  "?": { "articleNumber": "????" },
                  "comment": "暫時(shí)用不上，不管"
               }
             ]
           }
       ]
   },
   "webcredentials": {
      "apps": [ "teamID.BundleID", "teamID.BundleID2" ]
   },

    "appclips": {
        "apps": ["teamID.BundleID.Clip", "teamID.BundleID2.Clip" ]
    }
}

格式上，別猶豫，用新的。如果用了老的，問題不大，蘋果已經(jīng)做了兼容。但是不論是新老版本的JSON文件，如果有文件上的改動(dòng)，注意不要影響老版本。比如BundleID改了，路徑改了，可以新增，但是別替換。
示例中"teamID"就是你的開發(fā)者賬號(hào)對應(yīng)的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中定義的路徑（文中有官方格式說明） + 其他子路徑（可加可不加），但是微信開放平臺(tái)等三方平臺(tái)中的Universal Links必須和其保持一致。可以通過Safari瀏覽器中輸入U(xiǎn)niversal Links，看頂部是否有打開你的App的提示（微信等也會(huì)通過該Universal Links直接跳轉(zhuǎn)返回我們的APP）。
比如：

1626061196935.jpg

相信已經(jīng)比較清晰了，有幾點(diǎn)注意事項(xiàng)：

1. 關(guān)于關(guān)聯(lián)域，它可以是你們公司的官網(wǎng)地址，也可以是其他穩(wěn)定域，比如阿里云等。
2. apple-app-site-association還是按照蘋果官網(wǎng)最新要求放在服務(wù)器根目錄下新建的.well-known/文件夾下，需要同步給公司的運(yùn)維小伙伴，直接放在根目錄可能運(yùn)維后期不易理解不好維護(hù)。
3. 關(guān)于版本兼容，這個(gè)水比較深，第一，若你的應(yīng)用先用了老版本的apple-app-site-association，放在原來的關(guān)聯(lián)域服務(wù)器下，但是現(xiàn)在需要升級(jí)，為了不影響原來的老版本APP使用，可以放在新的關(guān)聯(lián)域下。因?yàn)樘O果對apple-app-site-association的管理有時(shí)效、有緩存、也有規(guī)則。若APP已經(jīng)下載過apple-app-site-association文件，再次下載觸發(fā)的條件比較苛刻，比如重裝、更新、達(dá)到指定周期。該周期，網(wǎng)上說是1-3天，我還沒測出來，不敢妄加揣測。穩(wěn)一點(diǎn)，換一個(gè)自家服務(wù)器存放該文件。APP會(huì)第一時(shí)間下載更新后的apple-app-site-association文件。
4. 關(guān)聯(lián)域，請確保它的穩(wěn)定性，不要把放在根目錄下的apple-app-site-association文件弄丟了，我們因?yàn)楣倬W(wǎng)更新把該文件弄丟導(dǎo)致大批量的用戶打開微信失敗。還有一個(gè)比較重要的是，請確保該關(guān)聯(lián)域不要關(guān)聯(lián)多個(gè)服務(wù)器，若有多個(gè)服務(wù)器，除非每個(gè)服務(wù)器上都配置了apple-app-site-association，否則無法下載該文件，一樣無法使用。
5. 若有其他問題，歡迎咨詢討論，1262078574@qq.com

參考文獻(xiàn)：
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-