H5手把手教微信授权分享

导语

使用微信分享，可以获得更好的传播效果。那如何利用微信公众号向好友进行信息分享呢？

这里以分享 微信红包 为例，手把手教大家实现微信授权与分享。

步骤一. 用户信息获取

1. 注册测试公众号

我们在 https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login 可以申请一个测试账号，在测试号管理的页面中能够看到我们appId等信息，这里有个接口配置信息修改的选项需要我们去填写

这里就要麻烦后端的同学为我们提供URL和Token（URL是开发者用来接收微信消息和事件的接口URL。Token可由开发者任意填写，用作生成签名）该Token会和接口URL中包含的Token进行比对，从而验证安全性。

2. 微信网页授权

在项目中需要获取用户个人信息，比如手机号和微信头像等，这里我们需要微信网页授权才可以实现，首先在微信测试号管理中找到体验接口权限表

点击修改进入：

将你网页的域名添加进去，配置完成后我们对这个路径进行访问https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect 即可拿到code值，从而拿到openid等个人信息。

3. 配置后路径的修改

① .appid为我们测试号中的appid

② .redirect_uri为我们页面路径，访问微信提供的路径会获取code值重定向到我们页面路径（这里的url需要进行urlEncode`处理）

③ . scope的值有两种：

snsapi_base为静默授权，用户无感知，但是只能获取到openid，拿不到其他信息。
snsapi_userinfo是弹框询问授权，确认授权后可以获取到openid进而拿到昵称、头像等信息

这样我们就可以授权得到用户信息：

可能遇到的问题

scope参数错误或没有scope权限，检查scope参数赋值snsapi_base或snsapi_userinfo
redirect_uri参数错误，检查网页授权页面域名配置问题，复制的时候空格也要注意
response_type参数错误，检查url路径是否进行了urlEncode处理

步骤二. 微信JS-SDK使用

微信JS-SDK是微信公众平台面向网页开发者提供的基于微信内的网页开发工具包，通过JS-SDK可以使用微信分享、支付、扫一扫等功能，这里我们使用到了微信分享。

1. js安全域名配置

使用JS-SDK首先找到测试号的JS接口安全域名，配置上页面使用的域名

2. 引入JS-SDK

在项目中我们引入JS-SDk的资源，可通过 http://res.wx.qq.com/open/js/jweixin-1.4.0.js（支持https）或者通过模块化加载引入 import wx from 'weixin-js-sdk'

3. 获取签名配置config

在这一步还需要RD的同学给我们支持，提供一个微信签名的接口，详情见下图

拿到签名后我们对config进行设置，config设置完成后会调用ready方法，我们在ready方法里可以进行业务逻辑处理。

步骤三. 分享接口




getSignature (){ //获取微信签名




  return new Promise((resolve, reject)=>{



    Axios.get(API.getWechatSign,{



    params:{



      appid: appId,



      url: window.location.href.split('#')[0]



    } 



    }).then( res => {



      resolve(res.data)



    }).catch((err)=>{



      reject(err)



    })



  })



},




async setWx(){



  let res = await this.getSignature()



  let {timestamp, nonceStr, appId, signature} = res



  wx.config({



    debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来，若要查看传入的参数，可以在pc端打开，参数信息会通过log打出，仅在pc端时才会打印。




    appId: appId, // 必填，公众号的唯一标识




    timestamp: timestamp, // 必填，生成签名的时间戳




    nonceStr: nonceStr, // 必填，生成签名的随机串




    signature: signature, // 必填，签名




    jsApiList: ["onMenuShareTimeline", "onMenuShareAppMessage"] // 必填，需要使用的JS接口列表




  });



  wx.ready(() => {



    wx.onMenuShareTimeline({



      title: '测试分享', // 分享标题




      link: window.location.href,// 分享链接，该链接域名或路径必须与当前页面对应的公众号JS安全域名一致




      imgUrl: 'http://icon.mobanwang.com/UploadFiles_8971/200910/20091011134333685.png',// 分享图标




      success: function() {



        // 用户点击了分享后执行的回调函数




      }



    });



    wx.onMenuShareAppMessage({



      title: '测试分享', // 分享标题




      desc: '一个测试的分享!!!', // 分享描述




      link: window.location.href, // 分享链接，该链接域名或路径必须与当前页面对应的公众号JS安全域名一致




      imgUrl: 'http://icon.mobanwang.com/UploadFiles_8971/200910/20091011134333685.png', // 分享图标




      type: "", // 分享类型,music、video或link，不填默认为link




      dataUrl: "", // 如果type是music或video，则要提供数据链接，默认为空




      success: function() {



        // 用户点击了分享后执行的回调函数




      }



    })



  })



}



复制代码

这样我们就实现一个微信分享，效果如下图: 分享给好友

分享到朋友圈

常见问题

invalid url domain 检查js安全域名是否正确
invalid signature 这个问题范围比较大：
- 检查签名接口是否正确，微信提供了校验工具http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=jsapisign
- config中写法问题，注意大小写nonceStr
- 签名入参的时候url路径不能含有'#'hash部分
- 分享出去的链接域名必须与公众号js安全域名保持一致
- debug显示config：ok却分享出去没效果，查看分享的方法和js-sdk版本

写在最后

微信网页开发时候最主要的就是环境配置问题，细心配置避免坑点。公众号中js的安全域名可配置三个，网页授权域名为两个,开发项目需要提前留意这些点。还有要关注测试号里的公众号。这样一个红包项目所需要的功能基本完成。

还想说

整个项目开发涉及到很多端支持，以快狗打车为例，有司机端、用户端、支付等。将微信分享功能抽离成一个独立的服务，实现统一化、标准化，以便支持各个业务线使用，这也是我们快狗打车的实战之一。