iOS Universal Links 微信三方登录步骤和坑

简介
随着iOS和微信sdk版本的更新,微信登录比之前配置麻烦了一些


截屏2020-12-30 下午1.38.16.png

新版本,需要配置Universal Links,这里就不赘述Universal Links是什么东东了,感兴趣的小伙伴可以自行百度一下

配置Universal Links
要做的很简单,但是这里比较繁琐,每一步都要小心,容易进坑
1、苹果开发者账号配置
登录自己公司的苹果开发账号,选择Certificates, Identifiers & Profiles选项,按照下图的1和2顺序点击


截屏2020-12-30 下午1.43.01.png

进到如下图页面,把红圈里的选项选中状态
截屏2020-12-30 下午1.48.12.png

2、Xcode工程配置

打开Associated Domains开关,将Universal Links域名加到配置上(注:只写域名即可,不带paths的值,appdelegate里的Universal Links和微信平台的Universal Links需要域名加paths的值),下图红框里
截屏2020-12-30 下午1.52.16.png

如果没有Associated Domains选项,则添加。在箭头处添加

配置URL Types,URL Schemes处填写在微信开放平台申请的AppId
截屏2020-12-30 下午2.06.29.png

截屏2020-12-30 下午2.04.49.png

配置info.plist,“LSApplicationQueriesSchemes“栏添加 "weixin"和"weixinULAPI
截屏2020-12-30 下午2.08.16.png

"
3、配置JSON文件

创建一个空白文件(必须纯文本,命名为apple-app-site-association,去除后缀名)。这里建议让后台人员在其本地创建,避免文件传输时,文件自动被更改格式、后缀自动添加等问题。

内容如下
截屏2020-12-30 下午2.09.48.png
截屏2021-02-26 下午2.28.32.png

说明:appID的格式为"苹果账号的团队ID.项目的BundleID",注意两个ID之间的半角符".",不知道苹果账号的团队ID和项目的BundleID在哪的小伙伴看上边写的“1、苹果开发者账号配置”的图二,图二的右上角被红线遮盖住的就是TeamId和BundleId,
如果多个项目都用到微信三方登录,文件中的paths字段对应的value就不要用“*”这个通配符了,用如图所示的paths起一个项目的名字

4、后台服务器配置
把文件apple-app-site-association,放置在服务器的根目录(不要问我,让后台自己去理解,我们是最后运维帮助弄的),然后让他提供一个https的url地址,格式是“正式域名/apple-app-site-association”,如:https://www.baidu.com/apple-app-site-association。

达到的效果是,浏览器打开这个地址,可以下载这个文件。另外用GET请求这个地址,返回文件的JSON内容(这里通过工具Postman进行试验)
注意:返回的数据不能是乱码,如果是乱码,则文件不对,最好用编辑器去写,我用的mac自带的文本编辑器出错了!

5、微信开放平台中去配置,在红圈里配置


截屏2020-12-30 下午2.17.32.png

6、导入sdk
cocoapods参考微信开发文档吧
手动导入这里需要注意:
(1)将 SDK 文件中包含的 libWeChatSDK.a,WXApi.h,WXApiObject.h 三个文件添加到你所建的工程中
(2)开发者需要在工程中链接上:Security.framework, CoreGraphics.framework, WebKit.framework。
(3)在你的工程文件中选择 Build Setting,在"Other Linker Flags"中加入"-ObjC -all_load",在 Search Paths 中添加 libWeChatSDK.a ,WXApi.h,WXApiObject.h
这里会有一个问题,运行的时候会报错


截屏2020-12-30 上午10.29.08.png

如果有图上这个问题,
截屏2020-12-30 下午2.23.01.png
如图加入libc++

7、初始化代码
// 微信SDK注册,universal link
[WXApi registerApp:APP_ID universalLink: UNIVERSAL_LINK];

补充说明:
如果后台提供的url地址是https://www.baidu.com/apple-app-site-association。那么,
Associated Domains中填写applinks:www.baidu.com,
代码注册方法及微信开放平台中都填https://www.baidu.com/

微信文档中的方法
appdelegate.m文件中实现以下方法

  • (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {
    return [WXApi handleOpenURL:url delegate:self];
    }

  • (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
    return [WXApi handleOpenURL:url delegate:self];
    }

  • (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void(^)(NSArray> * __nullable restorableObjects))restorationHandler {
    return [WXApi handleOpenUniversalLink:userActivity delegate:self];
    }
    -(BOOL)application:(UIApplication )app openURL:(NSURL )url options:(NSDictionary )options{
    return [WXApi handleOpenURL:url delegate:self];
    }
    -(void) onReq:(BaseReq
    )reqonReq{
    }
    -(void) onResp:(BaseResp
    )resp{
    }
    在需要实现微信按钮登录的时候代码
    SendAuthReq
    req =[[SendAuthReq alloc]init];
    req.scope = @"snsapi_userinfo";
    req.state = @"123";
    //第三方向微信终端发送一个SendAuthReq消息结构
    [WXApi sendReq:req completion:^(BOOL success) {
    }];

登录成功时,会回调-(void) onResp:(BaseResp*)resp{
}方法
如果 resp.errCode == 0 则登录成功

登录成功以后,想要获取openid、access_token等,方法为网络请求https://api.weixin.qq.com/sns/oauth2/access_token?appid=%@&secret=%@&code=%@&grant_type=authorization_code
appid为微信三方登录平台注册的AppId,secret为微信三方登录平台注册的secret,需要管理员生成,code为-(void) onResp:(BaseResp*)resp{
}方法回调中的resp.code,根据获取的openid、access_token,可以利用下面的地址去获取昵称等信息https://api.weixin.qq.com/sns/userinfo?access_token=%@&openid=%@,
时间紧就大概写这么多吧,不对的地方欢迎指正

参考文档:
https://www.jianshu.com/p/3a46eb4a107f?from=groupmessage https://www.jianshu.com/p/8e8840dcd54d

你可能感兴趣的:(iOS Universal Links 微信三方登录步骤和坑)