wx-java/README.md

WxJava - 微信开发 Java SDK（开发工具包）

支持包括微信支付、开放平台、公众号、企业微信/企业号、小程序等微信功能的后端开发。

重要信息

1. 2020-02-29 发布 【3.7.0正式版】！
2. 新手重要提示：本项目仅是一个SDK开发工具包，未提供Web实现，建议使用 maven 或 gradle 引用本项目即可使用本SDK提供的各种功能，详情可参考 【Demo项目】 或本项目中的部分单元测试代码；另外微信开发新手请务必阅读【开发文档 Wiki 首页】的常见问题部分，可以少走很多弯路，节省不少时间。
3. 技术交流群：想获得QQ群/微信群/钉钉企业群等信息的同学，请使用微信扫描上面的微信公众号二维码关注 WxJava 后点击相关菜单即可获取加入方式，同时也可以在微信中搜索 weixin-java-tools 或 WxJava 后选择正确的公众号进行关注，该公众号会及时通知SDK相关更新信息，并不定期分享微信Java开发相关技术知识；
4. 付费QQ群：（注意：刚入群会有5分钟禁言，稍等片刻即可正常发言） 或 ，或者请自行搜索群号343954419进行添加；当然由于某种原因无法入群的，可关注公众号后获取其他群的加入方式；
5. 钉钉技术交流群： 30294972。
6. 微信开发新手或者Java开发新手在群内提问或新开Issue提问前，请先阅读【提问的智慧】，并确保已查阅过 【开发文档Wiki】 ，避免浪费大家的宝贵时间；
7. 寻求帮助时需贴代码或大长串异常信息的，请利用 http://paste.ubuntu.com

---

其他说明

1. 阅读源码的同学请注意，本SDK为简化代码编译时加入了lombok支持，如果不了解lombok的话，请先学习下相关知识，比如可以阅读此文章；
2. 如有新功能需求，发现BUG，或者由于微信官方接口调整导致的代码问题，可以直接在【Issues】页提出issue，便于讨论追踪问题；
3. 如果需要贡献代码，请务必在提交PR之前先仔细阅读【代码贡献指南】，谢谢理解配合；
4. 本SDK要求的最低JDK版本是1.7，还在使用JDK6的用户请参考【此项目】 ，而其他更早的JDK版本则需要自己改造实现。
5. 开源中国本项目的首页，欢迎大家积极留言评分 🙂
6. SDK开发文档请查阅 【开发文档Wiki】，部分文档可能未能及时更新，如有发现，可以及时上报或者自行修改。
7. 如果本开发工具包对您有所帮助，欢迎对我们的努力进行肯定，可以直接前往【托管于码云的项目首页】，在页尾部分找到“捐助”按钮进行打赏，多多益善 😄。非常感谢各位打赏和捐助的同学！
8. 各个模块的Javadoc可以在线查看：weixin-java-miniapp、weixin-java-pay、weixin-java-mp、weixin-java-common、weixin-java-cp、weixin-java-open
9. 本SDK项目在以下代码托管网站同步更新:
10. 码云：https://gitee.com/binary/weixin-java-tools
11. GitHub：https://github.com/wechat-group/WxJava

---

Maven 引用方式

注意：最新版本（包括测试版）为 ，以下为最新正式版。

<dependency>
  <groupId>com.github.binarywang</groupId>
  <artifactId>（不同模块参考下文）</artifactId>
  <version>3.7.0</version>
</dependency>

• 微信小程序：weixin-java-miniapp
  
• 微信支付：weixin-java-pay
• 微信开放平台：weixin-java-open
  
• 公众号（包括订阅号和服务号）：weixin-java-mp
  
• 企业号/企业微信：weixin-java-cp

---

版本说明

点此展开查看

1. 本项目定为大约每两个月发布一次正式版（同时 develop 分支代码合并进入 master 分支），版本号格式为 X.X.0（如2.1.0，2.2.0等），遇到重大问题需修复会及时提交新版本，欢迎大家随时提交Pull Request；
2. BUG修复和新特性一般会先发布成小版本作为临时测试版本（如3.6.8.B，即尾号不为0，并添加B，以区别于正式版），代码仅存在于 develop 分支中；
3. 目前最新版本号为 ，也可以通过访问链接 【微信支付】 、【微信小程序】 、【公众号】 、【企业微信】、【开放平台】 分别查看所有最新的版本。

---

使用案例

完整案例登记列表，请【访问这里】查看，欢迎登记更多的案例。

以下为部分案例列表：

开源项目：

• 基于微信公众号的签到、抽奖、发送弹幕程序：https://github.com/workcheng/weiya
• XxPay聚合支付：https://github.com/jmdhappy/xxpay-master
• 微同商城：https://gitee.com/fuyang_lipengjun/platform
• 微信点餐系统：https://github.com/sqmax/springboot-project
• 专注批量推送的小而美的工具：https://github.com/rememberber/WePush
• yshop意象商城系统：https://gitee.com/guchengwuyue/yshopmall
• wx-manage（微信公众号管理项目）：https://github.com/niefy/wx-manage
• 基于若依开发的微信公众号管理系统：https://gitee.com/joolun/JooLun-wx

小程序：

• （京东）友家铺子，友家铺子店长版，京粉精选
• 喵星人贴吧助手(扫码关注)
• 树懒揽书+
• 广廉快线，鹏城巴士等
• 当燃挑战、sportlight轻灵运动
• 360考试宝典
• 民医台
• 来一团商家版
• 史必达（史丹利）

公众号：

• 中国电信上海网厅（sh_189）
• E答平台
• 宁夏生鲜365
• 通服货滴
• 神龙养车
• 沃音乐商务智能
• 光环云社群
• 手机排队
• 全民约跑健身便利店
• 洽洽食品、洽洽合伙人
• 民医台
• YshopMall
• 好行景区直通车以及全国40多个公众号

企业号/企业微信：

• 洽洽企业号
• HTC企业微信
• 掌上史丹利

其他：

• 高善人力资源
• 小猪餐餐
• 餐饮系统
• 微信公众号管理系统：http://demo.joolun.com
• 锐捷网络：Saleslink

---

贡献者列表

特别感谢参与贡献的所有同学，所有贡献者列表请在此处查看，欢迎大家继续踊跃贡献代码！

点击此处展开查看贡献次数最多的几位同学

1. chanjarster (Daniel Qian)
2. binarywang (Binary Wang)
3. 007gzs
4. Silloy
5. mgcnrx11
6. kakotor
7. aimilin6688 (Jonk)
8. kareanyi (MillerLin)
9. forfuns
10. tianmu

GitHub Stargazers over time