新版小程序登录授权的方法
小程序自上线以来,官方一直在调整api,因此也出现了一批被废弃的接口,作为程序员的我们,此时此刻千万不能为这不断的变化而感到头疼,应当与时俱进,不断的更新自己的知识储备和应用技能。
首先近期工作中需要做小程序框架升级,升级成美团开源的mpvue框架;然后因为微信小程序api的改版,所以也顺便将授权登录的逻辑重新设计了。
新旧对比:
旧的方法:旧方法wx.getuserinfo按照用户登录时,弹出需要授权的弹窗,用户点击授权后才能使用。
新方法:open-data的灵活使用方法,不会让你直接获得用户信息,而是小程序点击登录按钮获取用户头像,就是使用 button 组件,并将 open-type 指定为 getuserinfo 类型,获取用户基本信息。
授权登录的逻辑参考了多个小程序,希望能找到最优的模式。下面会配合代码详细讲解整个流程。
模式概览
由于微信小程序的改版导致直接弹出授权的登录方式将逐渐不再支持,受影响的有wx.getuserinfo接口,以及wx.authorize接口传入scope=”scope.userinfo”的情况。所以需要重新设计一套合适的登录授权流程。整体流程如下图:
主动登录
由于app中有些页面默认需要登录的,如[个人中心]页面,需要登录获取到用户信息,才能继续操作。这样的页面就需要在每次进入页面(onshow
)时判断是否授权了。
profile页面
onshow () { login(() => { do something... }) }
关于登录授权相关的逻辑都可以封装在handlelogin.js
中
handlelogin.js
// 开始login function login (callback) { wx.showloading() wx.login({ success (res) { if (res.code) { // 登录成功,获取用户信息 getuserinfo(res.code, callback) } else { // 否则弹窗显示,showtoast需要封装 showtoast() } }, fail () { showtoast() } }) } // 获取用户信息 function getuserinfo (code, callback) { wx.getuserinfo({ // 获取成功,全局存储用户信息,开发者服务器登录 success (res) { // 全局存储用户信息 store.commit('storeupdatewxuser', res.userinfo) postlogin(code, res.iv, res.encrypteddata, callback) }, // 获取失败,弹窗提示一键登录 fail () { wx.hideloading() // 获取用户信息失败,清楚全局存储的登录状态,弹窗提示一键登录 // 使用token管理登录态的,清楚存储全局的token // 使用cookie管理登录态的,可以清楚全局登录状态管理的变量 store.commit('storeupdatetoken', '') // 获取不到用户信息,说明用户没有授权或者取消授权。弹窗提示一键登录,后续会讲 showloginmodal() } }) } // 开发者服务端登录 function postlogin (code, iv, encrypteddata, callback) { let params = { code: code, iv: iv, encrypteddata: encrypteddata } request(apiurl.postlogin, params, 'post').then((res) => { if (res.code == 1) { wx.hideloading() // 登录成功, // 使用token管理登录态的,存储全局token,用于当做登录态判断, // 使用cookie管理登录态的,可以存任意变量当做已登录状态 store.commit('storeupdatetoken', res.data.token) callback && callback() } else { showtoast() } }).catch((err) => { showtoast() }) } // 显示toast弹窗 function showtoast (content = '登录失败,请稍后再试') { wx.showtoast({ title: content, icon: 'none' }) }
到此为止,登录就算完成了。不管使用token还是cookie都可以,都能有正常的登录态了,可以执行后续操作。
整个流程是 wx.login
=> wx.getuserinfo
=> 开发者服务器登录postlogin
。
调用接口
某些页面默认不需要登录,但某些用户操作事件是需要登录状态的,所以一者可以判断全局存储的登录状态管理的变量,如果为false
,那么直接可以弹窗提示需要一键登录。二者如果全局状态为true
,则调用接口看接口返回的code
是否是未登录状态(此情况一般来说是登录态过期),未登录的话也弹窗提示需要一键登录。
某页面(需登录的用户操作)
getplayer () { // 判断全局是否有登录状态,如果没有直接弹窗提示一键登录 islogin(() => { let params = { token: this.token } request(apiurl.getplayer, params).then((res) => { // todo: 删除打印 if (res.code === 1) { store.commit('storeupdateuser', res.data.player_info) } else { // 获取失败了,如果是code是未登录,则去登录,然后执行回调函数this.getplayer // 如果code不是未登录,直接弹窗报错误信息 handleerror(res, this.getplayer) } }).catch((err) => { handleerror(err) }) }) }
handlelogin.js
// 判断是否登录 function islogin (callback) { let token = store.state.token if (token) { // 如果有全局存储的登录态,暂时认为他是登录状态 callback && callback() } else { // 如果没有登录态,弹窗提示一键登录 showloginmodal() } } // 接口调用失败处理, function handleerror (res, callback) { // 规定-3041和-3042分别代表未登录和登录态失效 if (res.code == -3041 || res.code == -3042) { // 弹窗提示一键登录 showloginmodal() } else if (res.msg) { // 弹窗显示错误信息 showtoast(res.msg) } }
到此为止,需要登录的用户操作就可以处理了。如果全局登录状态变量为true
,先去调用接口,根据返回的信息是否是未登录再处理。
弹窗提示
由于微信小程序授权的接口wx.getuserinfo
和wx.authorize
中scope 为 “scope.userinfo” ,新版中调用这两个api是不会主动触发弹出授权窗口的。需要使用<button open-type="getuserinfo"></button>
方法。
上面代码中多处出现的showloginmodal
是用于显示一键登录的。如下:
handlelogin.js
// 显示一键登录的弹窗 function showloginmodal () { wx.showmodal({ title: '提示', content: '你还未登录,登录后可获得完整体验 ', confirmtext: '一键登录', success (res) { // 点击一键登录,去授权页面 if (res.confirm) { wx.navigateto({ url: '授权登录页面地址', }) } } }) }
关于授权登录,我们做了一个专门的页面处理,此处的button
为<button type="primary" v-if="caniuse" open-type="getuserinfo" @getuserinfo="getuserinfo">微信登录</button>
。如下:
getuserinfo (e) { if (e.target.userinfo) { // 点击button弹窗授权,如果授权了,执行login // 因为login流程中有wx.getuserinfo,此时就可以获取到了 login(() => { // 登录成功后,返回 wx.navigateback() }) } }
到此为止,整个授权和登录流程就算走完了。可以回过头梳理一下最开始的流程图,应该就能理清整个逻辑了。