iOS配置Universal Links

Universal Links 相關(guān)文檔

蘋果官方文檔說明

蘋果官方測試鏈接

先上效果:

Universal Links 鏈接識(shí)別


工作原理

1燎竖、App第一次啟動(dòng)時(shí)璃弄,或App更新后第一次啟動(dòng)時(shí),會(huì)通過Associated Domains里取的域名构回,通過GET請(qǐng)求訪問apple-app-site-association的文件

2夏块、訪問到到apple-app-site-association文件,統(tǒng)一注冊(cè)到系統(tǒng)

3纤掸、任意Webview(包括第三方應(yīng)用內(nèi)的Webview)發(fā)起跳轉(zhuǎn)(必須要跨域跳轉(zhuǎn))脐供,如果命中通過apple-app-site-association注冊(cè)的通用鏈接,就會(huì)找到AppID

4借跪、如果下載安裝過該App則會(huì)打開App 觸發(fā) Universal Link Delegate事件政己,如果沒安裝,則繼續(xù)跳轉(zhuǎn)url

應(yīng)用場景

1掏愁、微信?WechatOpenSDK_NoPay 1.8.6.1版本初始化需要配置universalLink

/*! @brief WXApi的成員函數(shù)歇由,向微信終端程序注冊(cè)第三方應(yīng)用。?
* 需要在每次啟動(dòng)第三方應(yīng)用程序時(shí)調(diào)用果港。
* @attention 請(qǐng)保證在主線程中調(diào)用此函數(shù)?
* @param appid 微信開發(fā)者ID
* @param universalLink 微信開發(fā)者Universal Link
* @return 成功返回YES沦泌,失敗返回NO。?
*/
+ (BOOL)registerApp:(NSString *)appid universalLink:(NSString *)universalLink;

2辛掠、類似淘寶谢谦、小紅書詳情自動(dòng)跳轉(zhuǎn)到原生App,若未安裝,可以顯示原鏈接內(nèi)容



開始配置

1他宛、配置developer.apple.com?后臺(tái) Certificates, Identifiers & Profiles 船侧,在Identifiers 中 找到對(duì)應(yīng)的 Identifiers,進(jìn)行配置

Identifiers 配置圖

2厅各、在工程中镜撩,配置Domains,配置Domains队塘,需要?applinks: 開頭袁梗,結(jié)構(gòu)為:applinks:<domains>, 例如:applinks:www.baidu.com

配置Domains

3、服務(wù)端配置apple-app-site-association文件憔古,通過瀏覽器能夠直接訪問:https://<domains>/.well-known/apple-app-site-association 或者?https://<domains>/apple-app-site-association能夠直接訪問到配置文件

apple-app-site-association 模板:

{
?"applinks": {
?????"apps": [],
?????"details": [ {
?????????????"appID": "9JA89QQLNQ.com.apple.wwdc",? ? // TeamID.BoundleID
?????????????"paths": [ "/wwdc/news/", "/videos/wwdc/2015/*"]? ? // 正則匹配URL域名后面的路徑
?????????}, {
?????????????"appID": "ABCD1234.com.apple.wwdc",
?????????????"paths": [ "*" ]
?????????} ]
?????}
}

當(dāng)safri瀏覽器訪問https://<domains>/wwdc/news/ 或?https://<domains>/videos/wwdc/2015/xxx 時(shí)遮怜,會(huì)檢測iOS設(shè)備是否安裝?9JA89QQLNQ.com.apple.wwdc 這個(gè)App,如果安裝鸿市,則會(huì)跳轉(zhuǎn)到原生應(yīng)用锯梁,并保留safri頁面,如果未安裝焰情,則停留safri頁面陌凳,并打開當(dāng)前網(wǎng)頁。
當(dāng)有多個(gè)details時(shí)内舟,匹配規(guī)則從上到下一次匹配合敦,匹配到后就不再往下匹配

這個(gè)步驟坑比較多,且排查困難

坑1:運(yùn)維存放文件時(shí)验游,不能以json文件格式保存充岛。不需要加任何擴(kuò)展名

Don’t append?.json?to the?apple-app-site-association?filename.

坑2:通過瀏覽器返回時(shí),Response Headers的Content-Type設(shè)置為:text/html耕蝉,不能用text/plain崔梗。因?yàn)閠ext/plain返回的瀏覽器會(huì)當(dāng)作文本不作任何解析

Response Headers的Content-Type設(shè)置

坑3:必須要Https下才能正確訪問到,且文件必須在根目錄下才能訪問

最總目的是 https://<domains>/.well-known/apple-app-site-association 或 https://<domains>/apple-app-site-association 能訪問

目前我們的方案可以參考一下:

nginx 配置

? ? location /apple-app-site-association {
? ? ? ? charset UTF-8;
? ? ? ? default_type text/html;
? ? ? ? return 200?'{\"applinks\":{\"apps\":[],\"details\":[{\"appID\":\"appID.com.xxxx\",\"paths\":[\"*\", \"/*\"]}]}}'
????}
? ?

官方驗(yàn)證鏈接:蘋果官方測試鏈接

配置結(jié)果說明:

1赔硫、

Error no apps associated with url

配置異常炒俱,沒有訪問到apple-app-site-association的文件


2、
Error?no apps with domain entitlements

The entitlement data used to verify deep link dual authentication is from the current released version of your app. This data may take 48 hours to update.

48小時(shí)后生效

48小時(shí)后生效

3爪膊、

配置成功的標(biāo)志

配置成功
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市砸王,隨后出現(xiàn)的幾起案子推盛,更是在濱河造成了極大的恐慌,老刑警劉巖谦铃,帶你破解...
    沈念sama閱讀 206,602評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件耘成,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)瘪菌,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,442評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門撒会,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人师妙,你說我怎么就攤上這事诵肛。” “怎么了默穴?”我有些...
    開封第一講書人閱讀 152,878評(píng)論 0 344
  • 文/不壞的土叔 我叫張陵怔檩,是天一觀的道長。 經(jīng)常有香客問我蓄诽,道長薛训,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 55,306評(píng)論 1 279
  • 正文 為了忘掉前任仑氛,我火速辦了婚禮乙埃,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘锯岖。我一直安慰自己膊爪,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,330評(píng)論 5 373
  • 文/花漫 我一把揭開白布嚎莉。 她就那樣靜靜地躺著米酬,像睡著了一般。 火紅的嫁衣襯著肌膚如雪趋箩。 梳的紋絲不亂的頭發(fā)上赃额,一...
    開封第一講書人閱讀 49,071評(píng)論 1 285
  • 那天,我揣著相機(jī)與錄音叫确,去河邊找鬼跳芳。 笑死,一個(gè)胖子當(dāng)著我的面吹牛竹勉,可吹牛的內(nèi)容都是我干的飞盆。 我是一名探鬼主播,決...
    沈念sama閱讀 38,382評(píng)論 3 400
  • 文/蒼蘭香墨 我猛地睜開眼次乓,長吁一口氣:“原來是場噩夢(mèng)啊……” “哼吓歇!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起票腰,我...
    開封第一講書人閱讀 37,006評(píng)論 0 259
  • 序言:老撾萬榮一對(duì)情侶失蹤城看,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后杏慰,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體测柠,經(jīng)...
    沈念sama閱讀 43,512評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡炼鞠,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,965評(píng)論 2 325
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了轰胁。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片谒主。...
    茶點(diǎn)故事閱讀 38,094評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖赃阀,靈堂內(nèi)的尸體忽然破棺而出霎肯,到底是詐尸還是另有隱情,我是刑警寧澤凹耙,帶...
    沈念sama閱讀 33,732評(píng)論 4 323
  • 正文 年R本政府宣布姿现,位于F島的核電站,受9級(jí)特大地震影響肖抱,放射性物質(zhì)發(fā)生泄漏备典。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,283評(píng)論 3 307
  • 文/蒙蒙 一意述、第九天 我趴在偏房一處隱蔽的房頂上張望提佣。 院中可真熱鬧,春花似錦荤崇、人聲如沸拌屏。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,286評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽倚喂。三九已至,卻和暖如春瓣戚,著一層夾襖步出監(jiān)牢的瞬間端圈,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,512評(píng)論 1 262
  • 我被黑心中介騙來泰國打工子库, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留舱权,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 45,536評(píng)論 2 354
  • 正文 我出身青樓仑嗅,卻偏偏與公主長得像宴倍,于是被迫代替她去往敵國和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子仓技,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,828評(píng)論 2 345