479686314@qq.com
479686314@qq.com
  • 发布:2019-06-12 20:03
  • 更新:10 小时前
  • 阅读:653

微信内H5使用JSSDK分享

分类:uni-app

最近一直有人问jssdk的问题,官方贴也太简单,没有说明。所以这里再写一篇简单教程,附有代码。其实这个sdk还是比较简单的,只是因为uni-app的h5端是SPA单页应用,所以容易出现签名错误,或者配置没有正确初始化的问题。

服务端计算签名

文档地址:https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421141115

引入JSSDK

推荐使用npm安装,参考 http://ask.dcloud.net.cn/article/35380

创建一个js文件,封装微信相关功能

笔者是放在common目录,文件名称是wechat.js
代码如下:

import request from './request'; //笔者自己封装的网络请求类,也可以直接使用uni.request  
var jweixin = require('jweixin-module');  

export default {  
        //判断是否在微信中  
    isWechat:function(){  
        var ua = window.navigator.userAgent.toLowerCase();  
        if(ua.match(/micromessenger/i) == 'micromessenger'){  
            return true;  
        }else{  
            return false;  
        }  
    },  
        //初始化sdk配置  
    initJssdk:function(callback ,url){  
                //服务端进行签名 ,可使用uni.request替换。 签名算法请看文档  
        request.post('/api/oauth/wechat/sign',{url:url},function(res){  
            if(res.data){  
                jweixin.config({  
                     debug: false,  
                     appId: res.data.appId,  
                     timestamp:res.data.timestamp,  
                     nonceStr: res.data.nonceStr,  
                     signature:res.data.signature,  
                     jsApiList: [  
                         'checkJsApi',  
                         'onMenuShareTimeline',  
                         'onMenuShareAppMessage'  
                     ]  
                });  
                //配置完成后,再执行分享等功能  
                if(callback){  
                    callback(res.data);  
                }  
            }  

        });  
    },  
        //在需要自定义分享的页面中调用  
    share:function(data ,url){  
        url =url ? url :window.location.href;  
        if(!this.isWechat()){  
            return ;  
        }  
                //每次都需要重新初始化配置,才可以进行分享  
        this.initJssdk(function(signData){  
            jweixin.ready(function(){    
                var shareData = {  
                     title: data&&data.title ? data.title: signData.site_name,  
                     desc: data&&data.desc ? data.desc: signData.site_description,  
                     link: url,  
                     imgUrl: data&&data.img ?data.img :signData.site_logo,  
                     success: function (res) {  
                                                 //用户点击分享后的回调,这里可以进行统计,例如分享送金币之类的  
                        request.post('/api/member/share');  
                     },  
                     cancel: function (res) {  
                     }  
                 };  
                 //分享给朋友接口  
                 jweixin.onMenuShareAppMessage(shareData);  
                 //分享到朋友圈接口  
                 jweixin.onMenuShareTimeline(shareData);  
            });  
        } ,url);  
    }  
}  

全局引用

在main.js中引入

// #ifdef H5  
import wechat from './common/wechat'  
if(wechat.isWechat()){  
    Vue.prototype.$wechat =wechat;  
}  
// #endif  

在页面中调用

例如,在文章详情页面自定义分享内容。

// #ifdef H5  
if (this.$wechat && this.$wechat.isWechat()) {  
     this.$wechat.share({  
          desc: article.title,  
          img: article.image  
    });  
}  
// #endif  

注意事项

1 测试时,可以将debug设置为true,可以看到日志信息
2 签名建议在服务端,签名的url必须和当前页面的url一致,否则自定义分享无效
3 每个页面都需要单独初始化配置,即jweixin.config()
4 在公众号后台设置安全域名
5 笔者的例子是在history模式下,Android、IOS手机均已正常上线使用。若您使用的是hash模式,请自行测试,理论上应该也可以,如果有问题,请检查上述几点。如果还不行,请尝试在签名的事哈去掉url上的 '#'以后部分(含'#')
6 如有遗漏或建议,欢迎下面留言

5 关注 分享
DCloud_UNI_GSQ yorick 479686314@qq.com onfireme@163.com 1769794040@qq.com

要回复文章请先登录注册

479686314@qq.com

479686314@qq.com (作者)

回复 JUNHUAing:
首先服务端签名代码不要有问题。history 使用location.href签名, hash模式去掉#以后(含#)的部分签名。
10 小时前
JUNHUAing

JUNHUAing

我的老是报invalid signature,百度的方法都试过了,还是不行啊,求救!
10 小时前
479686314@qq.com

479686314@qq.com (作者)

回复 1324198599@qq.com:
这个提示的意思是你域名不在安全域啊,你微信后台设置安全域名了吗?
12 小时前
1324198599@qq.com

1324198599@qq.com

回复 onfireme@163.com:
找到原因了,我的分享地址里边自定义参数有中文,所以不行,我把自定义参数encodeURIComponent的了一下,就行了
12 小时前
1324198599@qq.com

1324198599@qq.com

回复 onfireme@163.com:
我也不知道我的哪里不对,按照正常流程执行没有问题,单独对分享页面进行刷新,config是OK的,掉分享方法的时候,就出现updateAppMessageShareData:fail link must be in js secure domain list
13 小时前
onfireme@163.com

onfireme@163.com

回复 1324198599@qq.com:
我目前采用的时 location.href ,没有问题
1 天前
1324198599@qq.com

1324198599@qq.com

回复 onfireme@163.com:
我现在遇到在ios端,详情页刷新之后,我重新config了,config成功了,但是分享报fail link must be in js secure domain list,在安卓上没有问题,遇到过这种问题吗
1 天前
onfireme@163.com

onfireme@163.com

回复 479686314@qq.com:
例如我要所有页面关闭微信转发分享功能键,不可能每个页面跳转都使用location.href
2 天前
479686314@qq.com

479686314@qq.com (作者)

回复 onfireme@163.com:
history模式,分享参数自定义没有问题的, 但是签名的时候必需用当前浏览器中的地址,location.href就行了。
4 天前
onfireme@163.com

onfireme@163.com

请问一下作者,项目是在history模式下,并配置了服务器,不报404错误,然而详情页面微信签名会出问题,问题和vue一样,(对于Android,用每个页面的URL做签名参数,对于IOS,使用入口URL进行签名(切记),我是使用VUEX进行url的更新)或者需要再次刷新当前页面,自定义分享才有效果,请问在uniapp中如何解决这个问题呢。谢谢!
4 天前
945618130@qq.com

945618130@qq.com

回复 RandyGump:
你是说template.html吗?
2019-06-18 16:39
479686314@qq.com

479686314@qq.com (作者)

回复 739361287@qq.com:
签名是服务端计算的。使用本机电脑也可以。但是微信内分享是要验证安全域名的,你的域名要和微信公众号后台设置的一致才行。
2019-06-17 15:47
739361287@qq.com

739361287@qq.com

微信的签名需要有服务器及域名吗?本机电脑可以弄嘛?
2019-06-17 14:43
RandyGump

RandyGump

回复 479686314@qq.com:
找到原因了,因为之前尝试用HTML来引入JS,忘记把那个配置删掉,估计先加载那个配置了
2019-06-17 00:46
RandyGump

RandyGump

回复 479686314@qq.com:
各种加载方式都试过,js路径也试过,就是不行,奇怪了
2019-06-16 19:35
479686314@qq.com

479686314@qq.com (作者)

回复 RandyGump:
检查下引入方式是否正确。var jweixin = require('jweixin-module'); 这句,只有npm安装时才可以,否则要指定js路径。
2019-06-16 10:44
RandyGump

RandyGump

我按步骤来的,为什么jweixin最后加载出来是undefined?
2019-06-16 02:33