WeChat-offiaccount

微信公众号辅助调试服务器 + 微信官方js-sdk，支持typescript开发

本项目用于搭建一个微信公众号本地测试环境，同时集成了微信官方js-sdk，支持typescript开发，为了简单，我们基于测试号来说明。

非测试号也可以使用，填入正确字段即可，如果有问题，可以issue给我们留言！

如何本地调试？

首先需要在./offiaccount.config.js中填入自己的appID和appsecret。

接入微信公众平台开发

为了接入你首先需要的是“接口配置信息”，这里需要填入./offiaccount.config.js中的token，和“测试号管理”页面的保持一致即可。

然后你把这个项目在外网可以访问的服务器上运行后，配置后即可通过验证，然后就可以依据接口文档实现业务逻辑。

JS-SDK使用

比如你启动后，手机可以通过http://192.168.0.6:20000（无需外网可以访问，如果电脑和手机连同一个wifi，像这里的例子，用局域网ip即可）访问，那么，“JS接口安全域名”中的域名配置成192.168.0.6:20000即可。

然后在微信中打开上面的html页面即可（到此为止，你就可以在你的html页面使用JS-SDK能力了）。

如何在项目中使用？

为了方便随时随地使用，我们发布了npm包，只需要项目中安装后就可以按照下面说明使用需要的能力了：

npm install --save wechat-offiaccount

JS-SDK使用

首先，准备一份配置文件，比如在当前目录下有一个文件offiaccount.config.js，内容如下：

// 具体的改为自己的即可
const config = {
    port:8080,
    appID: "",
    appsecret: ""
}
module.exports = config

然后，在package.json中配置启动命令：

{
    "scripts": {
        "offiaccount": "offiaccount-cli --config offiaccount.config.js"
    }
}

然后执行启动命令：

npm run offiaccount

接着，我们用浏览器最新的fetch举例子：

import wx from "wechat-offiaccount"
fetch("http://" + window.location.hostname + ":8080/JsApiSignature?url=" + window.location.href.split('#')[0], {
    method: "get"
}).then(function (response) {
    response.json()
        .then(function (res) {

            wx.config({
                debug: true,
                appId: res.appId, 
                timestamp: res.timestamp,
                nonceStr: res.nonceStr,
                signature: res.signature,
                jsApiList: ['chooseImage'] // 必填，需要使用的JS接口列表
            })

            wx.error(function (res) {
                console.error(res)
            })

        })
})

上面已经配置好了，并且申请了wx.chooseImage权限，后续用的时候，只需要：

import wx from "wechat-offiaccount"
wx.ready(function () {
    console.log('准备好了！')

    // todo
})

比如访问的地址是：http://192.168.0.6:20000/index.html

接入微信公众平台开发

把当前目录下的文件offiaccount.config.js内容修改如下：

// 具体的改为自己的即可
const config = {
    token: '',
    port: 8080,
    appID: "",
    appsecret: "",
    handler(req, res) {
        // 需要自己处理业务请求
    }
};
module.exports = config

然后需要启动后部署到外网可以访问的服务器上，最后就可以作为微信公众号后台服务器使用，然后进行各种测试学习了。

版权

MIT License

Copyright (c) zxl20070701 走一步，再走一步