Universal Links适配

一:适配原因

由于苹果iOS 13系统版本升级,因为没有配置Universal Links导致微信和QQ分享失败,微信SDK在1.8.6.1版本进行了适配,支持通过Universal Links方式跳转完成应用安全校验,提升使用流程安全性。开发者需更新iOS 1.8.6.1版本SDK,并按苹果官网的要求,创建应用的Universal Links服务,随后在微信开放平台填写应用的Universal Links信息。

微信开发者平台,包括QQ目前新建应用都必须配置Universal Link,老本版存量问题,微信开发者平台公告:2020年3月起逐渐收回老版本功能。 QQ互联公告:将于2019年12月1日进行Universal Links校验,请开发者及时更新SDK3.3.7版本进行适配。

因为项目中使用的ShareSDK进行第三方分享。因此更新ShareSDK配置Universal Link就是必须要做的。

二:配置Universal Link

  1. 准备一个https的域名。
    将配置好的apple-app-site-association存放在域名根目录下,或者放根目录的(.well-known)的子目录下,两者选一个。 可以多个app可共用同一个配置文件。
  2. 制作apple-app-site-association文件。
    需要制作apple-app-site-association文件并添加自己的配置项,apple-app-site-association不能带后缀名。

appID:是TeamID+BundleID的组合
paths:是用于区分不同APP的路径,每个项目配置自己的唯一标识,必需以通配符*结尾。
针对微信和QQ每个项目需要配置两个path:

  • 一个为微信开放平台格式如:"/标识app唯一的字符串/",如:"/appdemo1/";
  • 一个按照QQ互联平台格式:"/qq_conn/qq互联appId/*",如:"/qq_conn/1101150000/*";

修改完 apple-app-site-association 文件发给服务端同学进行更新。

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "TeamID.com.xxx.app1",
                "paths": [ "/app1/*","/qq_conn/1101150000/*"]
            },
            {
                "appID": "TeamID.com.xxx.app2",
                "paths": [ "/app2/*","/qq_conn/1101160000/*"]
            },
        ]
    }
}
  1. 在appstore对应的bundleID开启Universal Link服务,更新描述文件后下载安装。

  2. 在Xcode开启Associated Domains,并填写对应的Domains。
    这里只需要填写Domain就行不需要path,例如填写:applinks:help.wechat.com


  3. 测试配置是否成功。
    重新打包安装app,然后在手机Safari浏览器中输入:域名+path (例如:https://help.wechat.com/xxxx/ )并下拉,看是否有跳转App的链接。

三:配置微信开发者平台

  1. 登录微信开发平台,进入对应的项目控制台,更新Universal Link为你配置的domain+path。


    image
  2. 更新shareSDK到最新版本,微信API初始化的时候需要设置UniversalLinks,必需和开放平台设置的一致。
[WXApi registerApp:weiXinAppId universalLink:@"https://xxx.xxxx.com/path/"];
  1. 在AppDelegate 添加事件回调
    - (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void(^)(NSArray<id<UIUserActivityRest
    oring>> * __nullable restorableObjects))restorationHandler {
        return [WXApi handleOpenUniversalLink:userActivity delegate:self];
    }
  1. 更新ShareSDK初始化方法
[ShareSDK registPlatforms:^(SSDKRegister *platformsRegister) {
        [platformsRegister setupQQWithAppId:QQAppId appkey:QQAppSecret];
        [platformsRegister setupWeChatWithAppId:weiXinAppId appSecret:weiXinAppSecret universalLink:@"https://xxx.xxx.com/path/"];
    }];

四:配置QQ互联平台

修改universalLink配置(请注意只需要输入host,如:xxx.xxx.com)


image

五:问题排查

  1. 分享提示失败
    检查 BOOL bol = [WXApi registerApp:weiXinAppId universalLink:@"https://xxx.xxx.com/path/"] 注册的时候返回值如果为No,有可能是URL Scheme 配置错误或遗漏。

请检查是否添加weixin和weixinULAPI:


备注:如果遇到其他问题可评论留言,第一时间分享解决方案~

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

推荐阅读更多精彩内容