universal links

是iOS9之后 蘋果推出的一種能夠方便的通過(guò)https 鏈接來(lái)啟動(dòng)APP的功能宣脉。當(dāng)你的APP支持universal links 的話，點(diǎn)擊配置好的連接玉锌，可以跳轉(zhuǎn)到你的APP，如果你的APP沒(méi)有下載 或者不支持的話，那么點(diǎn)擊鏈接會(huì)通過(guò)Safari 打開仁期。
當(dāng)我使用1.8.6 版本的微信SDK實(shí)現(xiàn)微信分享许昨，支付等功能的時(shí)候萍恕，后臺(tái)網(wǎng)站需要配置universal links，對(duì)openSDK分享進(jìn)行合法性校驗(yàn)车要。這是一個(gè)必填項(xiàng)允粤。那么該如何配置通用鏈接呢？

• 首先登陸開發(fā)者中心翼岁，在證書列表頁(yè)面找到你的 APP id

  
  
  image.png

• 點(diǎn)擊該id类垫，進(jìn)入到該id 的配置頁(yè)面，選擇打開 Associated Domains

  
  
  image.png
  
  

  以上是網(wǎng)站后臺(tái)的配置琅坡，下面進(jìn)入到APP配置悉患。

• 打開APP項(xiàng)目，按如下圖方式打開 Associated Domains

  
  
  image.png

• 在domains 下面 按如下填寫榆俺，注意 前面一點(diǎn)要以 applinks:+ 你網(wǎng)站域名（此域名下放下文中提到的文件）

  
  
  image.png
• 創(chuàng)建名稱為 apple-app-site-association 的文件售躁，內(nèi)容為json，但是不能有后綴名（如果創(chuàng)建了.json的文件茴晋，再手動(dòng)刪除后綴名 陪捷，這樣是不對(duì)的）
  創(chuàng)建方法：打開終端，cd 到指定文件夾诺擅，'touch apple-app-site-association' 回車
  打開文件市袖，復(fù)制以下內(nèi)容：

{
    "applinks": {
        "apps": [],//必須為空數(shù)組
        "details": [ //你的網(wǎng)站可以支持多個(gè)APP跳轉(zhuǎn)
            {
              //appid 為你應(yīng)用的唯一標(biāo)識(shí)，由teamid 和 bundleid 組成
                "appID": "teamId.bundleId",
                "paths": [ "/wwdc/news/", "/videos/wwdc/2015/*"]
            },
            {
                "appID": "teamId.bundleId",
                "paths": [ "*" ]
            }
        ]
    }
}
特別說(shuō)明：
paths：為  限制哪些路徑可以跳轉(zhuǎn)到你的APP烁涌，如果不限制 可以使用通配符`*`苍碟，在微信SDK ，我設(shè)置的path 為一個(gè) /StoreHelper/*,所以我的universal links 為 https://mydomain/StoreHelper/,微信自己會(huì)在末尾匹配相應(yīng)的字符串撮执。
注：在iOS9.3以后微峰，此文件在未壓縮狀態(tài)下都不能超過(guò)128k！Ｊ闱蜓肆！

• 將你創(chuàng)建的json 文件上傳到服務(wù)器（讓后臺(tái)開發(fā)人員放到一開始項(xiàng)目中配置的域名的根目錄下颜凯，或者.well-known目錄下,別忘了中間有個(gè) 點(diǎn) . ），這是為了蘋果能獲取到你上傳的文件症杏，上傳后先訪問(wèn)一下装获，https://yourDomain/apple-app-site-association 或者https://yourDomain/.well-known/apple-app-site-association. 其實(shí)蘋果是先訪問(wèn)后者，再訪問(wèn)前者厉颤，如果不想多次訪問(wèn)服務(wù)器穴豫，可以直接放在.well-known 目錄下。
  訪問(wèn)該鏈接逼友，應(yīng)該是能下載精肃，或者能在網(wǎng)站直接打開該文件，不管什么樣的形式都要能看到該文件的內(nèi)容帜乞。如下：
  
  image.png
• 代碼中的配置司抱，APPdelegate 中實(shí)現(xiàn)如下三個(gè)方法：

//以下兩個(gè)方法是為了兼容低版本，適配 Custom URL scheme 自定義url黎烈，之前的傳統(tǒng)方式
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {
   //微信sdk 中的方法
    return [[HLWXAPIManager manager]hl_handleOpenURL:url];
}

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
  //微信sdk 中的方法
    return [[HLWXAPIManager manager]hl_handleOpenURL:url];
}

//以下的方法是通過(guò) https 通用鏈接 打開APP時(shí) 會(huì)回調(diào)的方法习柠，如果鏈接配置失敗，是不會(huì)打開如下方法的照棋，會(huì)走上面的方法资溃。在此方法中可以進(jìn)行判斷，因?yàn)槭桥渲梦⑿帕姨浚跃褪褂昧宋⑿舠dk 中的方法
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
    return [[HLWxApiManager manager]hl_handleOpenUniversalLink:userActivity];
}
//微信API 調(diào)用(HLWXAPIManager)
- (BOOL)hl_handleOpenURL:(NSURL *)url {
   return [WXApi handleOpenURL:url delegate:self];
}

- (BOOL)hl_handleOpenUniversalLink:(NSUserActivity *)userActivity {
    return [WXApi handleOpenUniversalLink:userActivity delegate:self];
}

• info.plist中 配置
  
  image.png
  
  不然會(huì)提示 failed for URL: "weixinULAPI://"

<key>LSApplicationQueriesSchemes</key>
    <array>
        <string>wechat</string>
        <string>weixin</string>
        <string>weixinULAPI</string>
    </array>

• 驗(yàn)證 通用鏈接配置是否成功溶锭。
  1、蘋果自己提供了個(gè)工具：https://search.developer.apple.com/appsearch-validation-tool/
  如果出現(xiàn)了以下頁(yè)面符隙，表示是正確的（驗(yàn)證的時(shí)我放的連接是 https://yourDomain而不是整個(gè)universal link ）趴捅。
  
  image.png

2、將通用鏈接 universal link 放到備忘錄霹疫，長(zhǎng)按 能夠可以跳轉(zhuǎn)到你的APP
3拱绑、如果用于微信sdk ，以下驗(yàn)證的頁(yè)面只出現(xiàn)一次更米，而不是每次都出現(xiàn)欺栗。

image.png

如果是微信登錄，不會(huì)出現(xiàn)兩次授權(quán)彈框

image.png

Universal Link（通用鏈接）注意點(diǎn)

• Universal Link跨域問(wèn)題征峦，Universal Link必須要求跨域，如果不跨域就不會(huì)跳轉(zhuǎn)消请。（iOS9.2之后的改動(dòng)）栏笆。
  假如當(dāng)前的頁(yè)面的域名是A，當(dāng)前網(wǎng)頁(yè)發(fā)起跳轉(zhuǎn)的域名是B臊泰，必須要求B和A是不同的域名才會(huì)觸發(fā)Universal Link蛉加，如果B和A 是相同域名，只會(huì)繼續(xù)在當(dāng)前WebView里面進(jìn)行跳轉(zhuǎn)，哪怕你的Universal Link一切正常针饥，根本不會(huì)打開APP（因?yàn)槲抑皇沁m配了微信的sdk厂抽，能夠?qū)崿F(xiàn)分享登錄和支付，在網(wǎng)頁(yè)內(nèi)跳轉(zhuǎn)并沒(méi)有做實(shí)測(cè)丁眼，所以這個(gè)需要注意）筷凤。

Universal Link請(qǐng)求 apple-app-site-association時(shí)機(jī)。

• 當(dāng)我們的APP在設(shè)備上第一次運(yùn)行時(shí)苞七，如果支持Associated Domains功能藐守，那么iOS會(huì)去get 定義的Domain下的apple-app-site-association文件。
• iOS 會(huì)先請(qǐng)求 https://domain.com/.well-known/apple-app-site-association,如果此文件請(qǐng)求不到再 去請(qǐng)求https://domain.com/apple-app-site-association,如果想要避免服務(wù)器多次get請(qǐng)求蹂风，可以直接把a(bǔ)pple-app-site-association放在./well-known目錄下卢厂。
• 服務(wù)器上的apple-app-site-association的更新不會(huì)讓iOS本地的apple-app-site-association同步更新，即iOS只會(huì)在APP第一次啟動(dòng)的時(shí)候請(qǐng)求一次惠啄，以后除非APP更新或者重新安裝慎恒，否則不會(huì)在每次打開時(shí)請(qǐng)求 apple-app-site-association文件。

Universal Link的好處

• 之前的Custom URL scheme是自定義的協(xié)議撵渡，因此在沒(méi)有安裝該APP的情況下是無(wú)法直接打開的融柬。而Universal Links本身就是一個(gè)能夠指向web頁(yè)面或者APP內(nèi)容頁(yè)的標(biāo)準(zhǔn)的web link，因此能夠很好的兼容其他情況姥闭。
• Universal Links是從服務(wù)器上查詢哪個(gè)APP需要被打開丹鸿，因此不存在Custom URL scheme那樣名字被搶占沖突的情況。
• Universal Links支持從其他APP中的uiwebview中跳轉(zhuǎn)到目標(biāo)APP棚品。
• 提供Universal Links給別的APP進(jìn)行APP間的交流時(shí)靠欢，對(duì)方并不能夠用這個(gè)方法去檢測(cè)你的APP是否被安裝（之前的`Custom URL scheme的canOpenUrl 方法可以）。