接入指引
- 1. 在适配3.3.6版本时,如果已经注册过使用UniversalLink,则相关注册信息无需调整。
2. 配置文件(apple-app-site-association)
如果第三方开发者希望支持多UniversalLink,需要关注以下适配场景:
2.1 第三方开发者在上架AppStore时,本身便是不同的APP应用
该场景建议第三方开发者,直接为不同的APP分别申请AppID。
示例参考:
{ "applinks": { "apps": [], "details": [{ "appID": "ABCD5678.com.apple.wwdc.bundleId2", // 新增线网版本bundleId2的一一对应关系 "paths": [ "/wwdc/news/", "/qq_conn/333333/*"] }, { "appID":"ABCD1234.com.apple.wwdc.bundleId1", // 线上已经存在bundleId1的path配置 "paths": [ "/wwdc/news/", "/qq_conn/222222/*"] } ] } } |
2.2 第三方开发者在同一AppID下,期望区分“测试版本和AppStore版本”
(1)服务端配置文件中,新增BundleID对应的Paths路径,需要按照对应的格式编写,即"/qq_conn/{AppID}/{BundleID}/*"。
(2)在编写支持多UniversalLink的配置文件时,线上版本如果已经存在了诸如"/qq_conn/222222/*"对应的bundleID,需要考虑兼容性。
(3)手Q版本须要求>=8.2.0
示例参考:
{ "applinks": { "apps": [], "details": [ { "appID": "ABCD0755.com.apple.wwdc.bundleId.test2", // 新增测试版本bundleId.test2的一一对应关系 "paths": [ "/wwdc/news/", "/qq_conn/222222/com.apple.wwdc.bundleId.test2/*"] }, { "appID": "ABCD5678.com.apple.wwdc.bundleId.test1", // 新增测试版本bundleId.test1的一一对应关系 "paths": [ "/wwdc/news/", "/qq_conn/222222/com.apple.wwdc.bundleId.test1/*"] }, { "appID":"ABCD1234.com.apple.wwdc.bundleId1", // 线上已经存在bundleId1的path配置 "paths": [ "/wwdc/news/", "/qq_conn/222222/*"] } ] } } |
3. 示例代码
SDK内部的相关接口与3.3.6相同,APP接入的逻辑代码仍可参考此处。