iOS開發(fā)配置Universal Links及注意事項
官方文檔
配置 https://developer.apple.com/documentation/safariservices/supporting_associated_domains_in_your_app?language=objc#3001215
驗證 https://search.developer.apple.com/appsearch-validation-tool/
集成步驟
-
添加
Associated Domains Entitlement
- 添加Associated Domains:
TARGETS -> Signing & Capabilities -> + Capability -> Associated Domains
- 配置域名:
applinks:域名
- 注意事項:
-
手動配置證書:需要到證書管理頁面闪水,找到對應的
IDENTIFIER
糕非,并勾選Associated Domains
自動配置證書:無需手動操作,自動處理
注意:此時球榆,對應的
Profiles
會狀態(tài)會變成Invalid
朽肥,需要重新編輯保存;
-
- 添加Associated Domains:
-
添加
apple-app-site-association
文件需要服務器開發(fā)人員配合持钉,將此文件上傳至域名根目錄的
.well-known
文件夾中-
apple-app-site-association
文件內(nèi)容:{ "applinks": { "apps": [], "details": [ { "appID": "ABCDE12345.com.example.app", "paths": [ "/app/*"] } ] } }
其中衡招,appID為
Team ID.Bundle Identifier
, paths中的/app/*
為自定義路徑,需要根據(jù)具體需求設置(注意: 如果配置微信平臺的Universal Links每强,則需要在域名的后邊加上此處添加的路徑始腾,否則微信分享成功后無法返回原App) -
服務器配置注意事項:
-
apple-app-site-association
文件名固定,不能修改空执,不能加后綴浪箭; - 必須支持https且不能重定向
-
-
驗證
瀏覽器輸入
https://<fully qualified domain>/.well-known/apple-app-site-association
可以正確顯示apple-app-site-association
文件內(nèi)容,或下載文件辨绊;使用驗證工具測試:https://search.developer.apple.com/appsearch-validation-tool/
手機瀏覽器輸入
域名+路徑+其他
地址奶栖,下拉頁面可以顯示打開App提示;(注意: 使用這種驗證方式门坷,修改配置文件后需要卸載重裝App后宣鄙,配置才會生效)
-
參考: 上述配置步驟描述的比較簡單,可以參考下面幾篇文章配置
注意事項(重要0莺住?蚣健A鹘贰)
修改Xcode配置中的域名或更新服務器文件
apple-app-site-association
內(nèi)容后敏簿,需要卸載App重新安裝,然后在瀏覽器驗證才能看到驗證效果宣虾,否則顯示為之前緩存的結(jié)果惯裕;如果
apple-app-site-association
中的path設置了路徑:比如/app/*
,則微信后臺設置的Universal Links需要加上/app/
路徑绣硝,否則分享成功后蜻势,無法返回;