weixin-java-tools/readme.md
2017-06-20 10:45:42 +08:00

96 lines
7.0 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

微信支付、小程序、公众号&企业号开发Java SDK
---------------------------------
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.github.binarywang/weixin-java-parent/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.github.binarywang/weixin-java-parent)
[![Build Status](https://travis-ci.org/Wechat-Group/weixin-java-tools.svg?branch=develop)](https://travis-ci.org/Wechat-Group/weixin-java-tools)
#### 声明: ***本项目Fork自chanjarster/weixin-java-tools但由于原项目已停止维护故单独维护和发布且发布到maven上的groupId也会不同详细信息见下文。***
***新人提示本项目仅是一个开发工具包即SDK未提供Web实现建议使用maven或gradle引用本项目即可使用本SDK提供的各种功能详情可参考下文中提到的Demo项目或本项目中的部分单元测试代码另外微信开发新手请务必阅读wiki首页的常见问题部分可以少走很多弯路节省不少时间。***
## Demo项目列表
* https://github.com/wechat-group/weixin-java-miniapp-demo 微信小程序Demo
* https://github.com/wechat-group/weixin-java-pay-demo 微信支付Demo
* https://github.com/wechat-group/weixin-java-cp-demo 企业号Demo
* https://github.com/wechat-group/weixin-java-mp-demo 公众号Demo使用Spring MVC实现
* https://github.com/wechat-group/weixin-java-mp-demo-springboot 公众号Demo使用Spring Boot实现
* https://github.com/wechat-group/weixin-java-tools-springmvc 公众号Demo内含部分微信支付代码
* https://github.com/wechat-group/weixin-java-mp-multi-demo (支持多公众号)
---------------------------------
### 其他信息:
1. 最新更新:**2017-4-13 发布[【2.6.0正式版】](https://github.com/Wechat-Group/weixin-java-tools/releases)**
1. 开源中国网站的本项目介绍的首页链接地址https://www.oschina.net/p/weixin-java-tools-new
1. 自2.0.0版本以来,公众号的接口调整比较大,主要是为了解决主接口类过于庞大不方便管理的问题,将接口实现代码按模块进行拆分。
1. 自2.6.0版本开始微信支付相关功能抽出独立为一个模块详细使用方式请参考相关demo
1. SDK详细开发文档请查阅 [【Wiki】](https://github.com/wechat-group/weixin-java-tools/wiki),部分文档可能未能及时更新,如有发现,可以及时上报或者自行修改。
1. 各个模块的Javadoc可以在线查看有可能是最新的测试版本的请注意观察版本号[weixin-java-pay](https://binarywang.github.io/weixin-java-pay-javadoc/)、[weixin-java-mp](https://binarywang.github.io/weixin-java-mp-javadoc/)、[weixin-java-common](https://binarywang.github.io/weixin-java-common-javadoc/)、[weixin-java-cp](https://binarywang.github.io/weixin-java-cp-javadoc/)
1. 本SDK要求的最低JDK版本是7还在使用JDK6的用户请参考[【此项目】]( https://github.com/binarywang/weixin-java-tools-for-jdk6) 而其他更早的JDK版本则需要自己改造实现。
1. 如有新功能需求发现BUG或者由于微信官方接口调整导致的代码问题可以直接在[【Issues】](https://github.com/Wechat-Group/weixin-java-tools/issues)页提出issue便于讨论追踪问题
1. 如果想贡献代码,请阅读[【代码贡献指南】](contribution.md)
1. **捐助渠道已开通,如有意向请点击[【支付宝二维码】](alipay_qrcode.jpg)捐赠,或者直接前往[【托管于码云的项目首页】](http://git.oschina.net/binary/weixin-java-tools),在评论区上方可以找到“捐助”按钮。非常感谢各位捐助的同学!**
---------------------------------
## SDK使用交流方式说明
1. QQ群 [![加入QQ群](https://img.shields.io/badge/QQ群-343954419-blue.svg)](http://shang.qq.com/wpa/qunwpa?idkey=731dc3e7ea31ebe25376cc1a791445468612c63fd0e9e05399b088ec81fd9e15) 或 [![加入QQ群](https://img.shields.io/badge/QQ群-343954419-blue.svg)](http://jq.qq.com/?_wv=1027&k=40lRskK)推荐点击按钮入群当然如果无法成功操作请自行搜索群号343954419进行添加
1. 由于群容量有限,即将爆满,故开启付费入群模式以保证只有真实交流需求的人进入,如果确实因为各种原因无法付费入群的,请联系群主说明原因即可入群;并为保证群的活跃度,本群将不定期清理长时间不活跃的同学;
1. 微信群: 因微信群已达到100人限制故如有想加入微信群的请入QQ群后联系管理员提供微信号以便邀请加入
1. 新手提问前请先阅读此文章http://t.cn/RV93MRB
1. 寻求帮助时需贴代码或大长串异常信息的请利用http://paste.ubuntu.com
---------------------------------
## 版本说明
1. 本项目定为大约每两个月发布一次正式版版本号格式为X.X.0如2.1.02.2.0等遇到重大问题需修复会及时提交新版本欢迎大家随时提交Pull Request
1. BUG修复和新特性一般会先发布成小版本作为临时测试版本如2.4.5.BETA2.4.6.BETA等即尾号不为0并添加BETA字样以区别于正式版
1. 目前最新版本号为 [![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.github.binarywang/weixin-java-parent/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.github.binarywang/weixin-java-parent) ,也可以通过访问链接 [【微信支付】](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22com.github.binarywang%22%20AND%20a%3A%22weixin-java-pay%22) 、[【公众号】](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22com.github.binarywang%22%20AND%20a%3A%22weixin-java-mp%22) 、[【企业号】](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22com.github.binarywang%22%20AND%20a%3A%22weixin-java-cp%22)
分别查看所有最新的版本。
---------------------------------
#### 本项目在几个著名的代码托管网站同步更新,地址分别是:
* 码云http://git.oschina.net/binary/weixin-java-tools
* GitHub: https://github.com/wechat-group/weixin-java-tools
* Bitbuckethttps://bitbucket.org/binarywang/weixin-java-tools
* Coding: https://git.coding.net/binarywang/weixin-java-tools.git
---------------------------------
## Maven 最新正式版本
* 微信小程序(暂时为测试版本):
```xml
<dependency>
<groupId>com.github.binarywang</groupId>
 <artifactId>weixin-java-miniapp</artifactId>
 <version>2.6.5.BETA</version>
</dependency>
```
* 微信支付:
```xml
<dependency>
<groupId>com.github.binarywang</groupId>
<artifactId>weixin-java-pay</artifactId>
<version>2.6.0</version>
</dependency>
```
* 公众号(订阅号及服务号):
```xml
<dependency>
<groupId>com.github.binarywang</groupId>
<artifactId>weixin-java-mp</artifactId>
<version>2.6.0</version>
</dependency>
```
* 企业号:
```xml
<dependency>
<groupId>com.github.binarywang</groupId>
<artifactId>weixin-java-cp</artifactId>
<version>2.6.0</version>
</dependency>
```