第一次写博客,有错误请提出,如需转载请注明出处。
微信官方文档:https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421141115
- 注意看文档,不要忽略任何细节,比如下面几段话
备注:支持使用 AMD/CMD 标准模块加载方法加载
同一个url仅需调用一次,对于变化url的SPA的web app可在每次url变化时进行调用,目前Android微信客户端不支持pushState的H5新特性,所以使用pushState来实现web app的页面会导致签名失败,此问题会在Android6.2中修复
对于用户触发时才调用的接口,则可以直接调用,不需要放在ready函数中。
- jssdk是可以通过AMD/CMD标准来加载的 例:
const wx = require('包名')
- SPA: 单页面应用。诸如react、vue等框架都会使用router,在history模式下默认都是通过pushState的方式去操作浏览器历史记录。而android和ios的对于pushState的反应也不同。实际测试发现android6.2以上的pushstate(切换路由大多基于这个实现的)不会导致签名失败(6.2之前版本无测试).ios在pushState的动作下会发生不可思议的事情。比如react 我依次进入两个路由
www.hello.com/foo
=>www.hello.com/bar
。在微信浏览器的界面确实是显示/bar
路由对应的页面,但是你把链接复制出来会发现复制出来的是/foo的路由。这导致了jssdk在使用wx.config获取签名的时候微信理解的url和你传入的url不同导致签名失败
- 解决方案:
- 特殊解决方案: react-router提供一个forceRefresh的props使用,可以将所有的pushState强制换成刷新。(要考虑副作用,例如mobx的状态管理数据可能丢失)
ReactDOM.render(
<BrowserRouter
basename={dir}
forceRefresh={true}>
<Root />
</BrowserRouter>,
document.getElementById('root')
);
- 暴力解决:强制刷新使url变化成正确url
- 优雅一点: (我没试过),在进入页面之前先将url存储起来,在路由pushState行为后进入到你需要分享的页面路由获取签名时使用该url。(参考下面三个链接)
- 网上解决方式:(大牛比我说的明白。)
参考
https://segmentfault.com/a/1190000012339148?utm_source=tag-newest
https://cauu.github.io/2016/10/React-pushState-in-wechat/
https://stackoverflow.com/questions/43512450/react-router-v4-route-onchange-event
坑
- 微信分享链接有长度限制,官方没说,但是实际测试上链接过长ios端无法进行成功分享。(自定义内容和缩略图不显示)。解决方案:给你的项目添加一个接口,将需要分享的数据通过API传给后端。并返回一个id。这样如果你需要分享的参数就由多个变成一个。被分享页面只要通过url取得这个id向后端请求数据进行渲染即可。
例:www.hello.com/a
是分享页面。我需要用户点击分享出来的链接是进入到www.hello.com/b?name=xxx&id=adjoqjdiqwjdoiqwjdoijdiojd&day=123&str=qwjdoiqwdoqndoiqd
到达一个非常长的状态。这个时候将这些参数通过API的方式换取一个id。就可以将需要分享的链接缩短成www.hello.com?shareid=xxx
这里没有详细测试最长长度。也有可能是根据参数个数限制的 - 分享缩略图只能传入图片的cdn地址.不能直接使用base64格式图片(如
import { default as pic } from '@images/hello.png'
, 不能直接使用pic作为参数传入wx的分享接口) - 官方文档说使用jssdk的API都必须进行wx.config但是实际情况是某些api在wx.config失败或者不进行wx.config也能使用.比如预览图片接口
previewImage
- 二次分享链接自动添加参数的问题。(二次分享是别人点击你分享的链接,这时候别人也想分享出去。就是二次分享)简单只要主要分享出来的链接微信会给你自动添加一些参数,比如你的原来分享出去的链接是
www.hello.foo?name=刘某
然后别人点击你分享出来的链接是这样的www.hello.foo?name=刘某&from=singlemessage&isappinstalled=0
。只要在分享链接做一层处理就行。