UniversalLink适配踩坑

iOS UniversalLink适配踩坑

最近微信OpenSDK升级微信OpenSDK更新要求

关于openSDK1.8.6的更新说明

由于苹果iOS 13系统版本安全升级,为此openSDK在1.8.6版本进行了适配。 1.8.6版本支持Universal Links方式跳转,对openSDK分享进行合法性校验。

*建议开发者接入新版本SDK, 覆盖测试微信7.0.7或以上版本、iOS12或13,以验证所使用的接口的功能性和可用性。

以及QQ OpenSDK更新要求

1. 系统及版本要求

Universal Links方案是基于苹果在iOS13系统上针对隐私政策的调整,相关的验证环境请首先确认:
1. SDK版本: OpenSdk3.3.7或以上
2. 手Q版本: 8.1.3或以上
3. 系统版本: iOS13或以上

但是 但是 但是

2020年3月17日更新的QQ OpenSDK 3.3.8版本支持了iOS13以下的Universal Links,新增支持设置opensdk只使用UniversalLink模式与手机QQ交互(系统要求大于等于iOS9)和需要使用新的注册方法

/**
* 初始化TencentOAuth对象(>=3.3.8)
* \param appId 不可为nil,第三方应用在互联开放平台申请的唯一标识
* \param enabled  默认为NO,第三方应用是否将sdk和手机QQ的交互方式切换为UniversalLink方式,启用后则在iOS9及以上的系统都会生效UniversalLink方式;否则,默认仅在iOS13及以上的系统生效UniversalLink方式。
* \param universalLink 可以为nil,第三方应用在互联开放平台注册的UniversalLink,和bundleID一一对应(当为nil时,互联平台会按规则生成UniversalLink,详见官网说明)
* \param delegate 不可为nil,第三方应用用于接收请求返回结果的委托对象
* \return 初始化后的授权登录对象
*
*****【使用说明】*****
*  1、支持sdk与手Q的交互切换为UniversalLink模式,主要目的"是为了避免手Q的UrlScheme被其他应用抢注后,导致sdk接口功能受到影响"。
*  2 、由于手Q版本在 >=8.1.3 后才适配了UniversalLink,所以一旦开启了enabled开关,“务必做到”及时知会用户升级手Q版本。
*****
*/
- (id)initWithAppId:(NSString *)appId
 enableUniveralLink:(BOOL)enabled
      universalLink:(NSString *)universalLink
           delegate:(id<TencentSessionDelegate>)delegate;

注意 由于手Q版本在 >=8.1.3 后才适配了UniversalLink,所以一旦开启了enabled开关,“务必做到”及时知会用户升级手Q版本

QQ填写及校验universallinks

所以,项目需要做Universal Links适配,准备工作按照Universal Links 苹果官方文档操作即可

这里遇到的最大的坑是,网上大多数的文章所写的的apple-app-site-association文件中关于Paths都写着可以用"paths": [ "*" ],但是如果公司不止一个App需要适配,那么这么写是不对的,因为这代表这域名下所有链接都跳这个指定的App,分享过程会产生很多匪夷所思的问题。

正确操作

域名

指定域名:https://www.xxx.com

apple-app-site-association文件放在该域名根目录下或者.well-known目录下,没有.json后缀.

https://www.xxx.com/apple-app-site-association

https://www.xxx.com/.well-known/apple-app-site-association

apple-app-site-association文件格式

单个App

信息:
Team ID   :Honzon
Bundle ID :com.honzonapp
appid       :12345678


{
    "applinks": {
        "apps": [],
        "details": [{
            "appID": "Honzon.com.honzonapp",
            "paths": ["*","/qq_conn/12345678/*"]
        }
    }
}

注册相应平台的universalLink链接

appid       :12345678

微信  https://www.xxx.com/
QQ   https://www.xxx.com/qq_conn/12345678/ 

多个app

信息:
Team ID   :Honzon

Bundle ID :com.honzonapp
appid       :1111111

Bundle ID :com.hzapp
appid       :2222222

Bundle ID :com.hoapp
appid       :3333333


{
    "applinks": {
        "apps": [],
        "details": [{
            "appID": "Honzon.com.honzonapp",
            "paths": ["/wechat-honzon/*","/qq_conn/1111111/*"]
        },{
            "appID": "Honzon.com.hzapp",
            "paths": ["/wechat-hz/*","/qq_conn/2222222/*"]
        },{
            "appID": "Honzon.com.hoapp",
            "paths": ["/wechat-ho/*","/qq_conn/3333333/*"]
        }
    }
}

注册相应平台的universalLink链接

Bundle ID :com.honzonapp
appid       :1111111

微信  https://www.xxx.com/wechat-honzon/
QQ   https://www.xxx.com/qq_conn/1111111/ 



Bundle ID :com.hzapp
appid       :2222222

微信  https://www.xxx.com/wechat-hz/
QQ   https://www.xxx.com/qq_conn/2222222/ 



Bundle ID :com.hoapp
appid       :3333333

微信  https://www.xxx.com/wechat-ho/
QQ   https://www.xxx.com/qq_conn/3333333/ 

2020.08.35更新

设备会下载apple-app-site-association的json文件到设备本地,并有一定时间的缓存,适配时一定要注意

记此一游,谨防踩坑。

未经授权,禁止转载

未经授权,禁止转载

未经授权,禁止转载

最后编辑于
?著作权归作者所有,转载或内容合作请联系作者
禁止转载,如需转载请通过简信或评论联系作者。
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,029评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,238评论 3 388
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,576评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,214评论 1 287
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,324评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,392评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,416评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,196评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,631评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,919评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,090评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,767评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,410评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,090评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,328评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,952评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,979评论 2 351

推荐阅读更多精彩内容