iOS 微信SDK升级之配置Universal Link

原来公司老的App用的微信SDK为1.8.2,并不需要配置Universal Link,
然后最近有需求需要新建一个APP,发现苹果官方从2020年中起,新建的App里就不允许使用UIWebView了,否则打包上传后无法在Apple Connect中显示,邮箱会收到如下的提示:
ITMS-90809: Deprecated API Usage - New apps that use UIWebView are no longer accepted. Instead, use WKWebView for improved security and reliability.
接下去检测项目中哪些代码或者插件使用了UIWebView,使用如下命令:

grep -r UIWebView .

发现微信SDK中使用了UIWebView,看来新的App已经无法使用1.8.2版本的微信SDK了,看了一下微信开放平台iOS相关文档,iOS的SDK从1.8.6.2开始移除UIWebView,也就是说,起码要升级到1.8.6.2,最新版本是1.9.1。

没办法,只能升级了,更新了项目中的SDK后发现初始化的方法变了:

// 原来
[WXApi registerApp: XXXX];

// 现在
[WXApi registerApp: XXXX universalLink: XXXX];

初始化需要Universal Link了,先不管他,直接设置空

[WXApi registerApp: XXXX universalLink: @""];

然后,App就无法拉起微信了。。

看来微信SDK现在一定要配置Universal Link了,我原来的理解是:Universal Link都是给需要从H5页面拉起App的需求用的,现在居然从我的App跳转微信App也需要配,没办法,他说要配那就只能配了。

Universal Link使用前提:

-有注册域名,并且支持https可通过 SSL 访问
-需要上传一个apple-app-site-association文件到域名根目录
-仅支持iOS 9及以上版本
-只支持真机调试

下面为Universal Link配置步骤

假设我们的域名为https://www.test.com

1、进入苹果开发者平台,登录账号,进入Identifiers,选择对应的App,进去后选中Associated Domains,然后Save。


Associated Domains

2、如果你是手动建的Profile描述文件,记得要去Profiles中更新描述文件,老的已经不能用了。如果是XCode自动生成的,需要参考下图去XCode中的Build Setting中把Code Signing Entitlements内容清空,让XCode再自动生成一份描述文件。(手动生成无需清空)
注:由于删掉该记录会导致capabilities数据移除,需要重新添加capability。


借用图片

3、在XCode工程中,添加Associated Domains,并将Universal Links域名上,这里的域名就为:applinks:www.test.com,不需要加任何前缀后缀

Domains

4、在info.plist中的LSApplicationQueriesSchemes里添加weixinULAPI


weixinULAPI

5、接下去配置apple-app-site-association文件,文件为json格式,但是要把.json后缀去掉。

在WWDC2019,苹果更新了apple-app-site-association文件的配置方法,推荐使用新写法,拥有更强的配置能力,参考链接
放一张参考图和一些引用的解释,途中灰色的就为老的配置方法。

参考图

  • apps 这个字段只有在 iOS 上有用,tvOS/macOS 这个字段可以忽略
  • details 字段结构大幅度变化
    • 以前是字典 appID 为 Key,现在是数组,并且支持 appIDs 这样的 key,可以一套配置适配多个 appID,大幅度减少工作量
    • 新增 components 字段,可以进一步约束 Universal Link 的生效条件
      • 可以通过 / 来配置支持的 path 格式条件
      • 可以通过 # 来配置支持的锚点条件
      • 可以通过 ? 来配置支持的字段条件
      • exclude 是排除字段,符合这个条件的 Universal Link 不生效

我们这边可以这样配置,配置https://www.test.com/ios/后面的任意页面都适用Universal Link

{
    "applinks": {
        //"apps": [],
        "details": [
            {
                //"appID": "TeamID.BundleID",
                "appIDs": [ "TeamID.BundleID1", "TeamID.BundleID2" ],
                //"paths": [ "/ios/*" ],
                "components": [
                 {
                      "/": "/ios/*",
                      // "/": "*",如果要https://www.test.com下所有的页面都适用就这样配,但是推荐还是分一下路径,毕竟一个公司下可能会有多款App
                      "comment": "Matches any URL whose path starts with /ios/"
                 }
               ]
            }
        ]
    }
}
TeamID如何获取
TeamID

6、配置后请后台管理人员把apple-app-site-association文件放在https://www.test.com根目录下,然后测试一下用浏览器打开https://www.test.com/apple-app-site-association,如果能显示文件内容或下载下来文件,则说明配置成功。

到这一步,真机重新运行App,然后真机打开Safari,浏览器输入https://www.test.com/ios/,页面虽然显示空白,但是往下拉一下,页面顶部已经显示了可以打开App了。

Safari

注:如果没效果,尝试删除一下App,重新运行。
如删除服务器上的apple-app-site-association文件,发现删除APP重新安装后,还是会显示顶部打开App,这个时候尝试删除App并重启手机。
如发现将apple-app-site-association文件重新放上服务器后,重新安装App后测试网页也不显示顶部栏,这时候尝试删除App并Clean一下Build,重新Build一下再安装。

7、去微信开发平台对应的应用中的iOS配置中配置一下Universal Link:https://apitest.mshchina.com/ios/

8、微信SDK初始化代码

[WXApi registerApp:微信AppID universalLink:@"https://apitest.mshchina.com/ios/"];

好了,再尝试调微信SDK,就可以在我们的App中拉起微信了。

遇到的坑

// URI scheme以及微信SDK处理iOS13以下版本的回调,走这个
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
   // 我们需要的判断跳转
   return YES;
}

// Universal Links以及微信SDK处理iOS13以上版本的回调,走这个,两个方法都要适配
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray *restorableObjects))restorationHandler { 
  // 我们需要的判断跳转
   return YES;
}

结束

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念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

推荐阅读更多精彩内容