Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
42 commits
Select commit Hold shift + click to select a range
56ebb03
Update README.md
binarywang Oct 4, 2016
711a2e4
Update README.md
binarywang Oct 4, 2016
86fd57f
Update README.md
binarywang Oct 7, 2016
d948afe
Update README.md
binarywang Oct 7, 2016
63a1558
Update README.md
binarywang Oct 7, 2016
4ce5ef3
Update README.md
binarywang Oct 7, 2016
3a4b9ed
Update README.md
binarywang Oct 11, 2016
67c8b61
Update README.md
binarywang Oct 17, 2016
3dce698
Update README.md
binarywang Oct 21, 2016
c20e02b
Update README.md
binarywang Oct 23, 2016
cf6559a
Update README.md
binarywang Oct 23, 2016
f5a6219
Update README.md
binarywang Oct 24, 2016
858ebb7
Update README.md
binarywang Oct 24, 2016
d241e54
Update README.md
binarywang Oct 24, 2016
8c759bc
Update README.md
binarywang Oct 24, 2016
953892b
Update README.md
binarywang Oct 25, 2016
1a46826
Update README.md
binarywang Oct 25, 2016
98a83ef
Update README.md
binarywang Oct 27, 2016
beaa7fc
Update README.md
binarywang Oct 27, 2016
f2e3c53
Update README.md
binarywang Oct 27, 2016
7b8d7f3
Update .travis.yml
binarywang Oct 28, 2016
c71d4df
Update .travis.yml
binarywang Oct 28, 2016
1f15cc8
Merge branch 'develop'
binarywang Oct 31, 2016
f73cc99
Update README.md
binarywang Nov 4, 2016
a0c9696
Update README.md
binarywang Nov 4, 2016
ddd16f6
Update README.md
binarywang Nov 4, 2016
5566ab4
Update README.md
binarywang Nov 4, 2016
27fe891
Update README.md
binarywang Nov 8, 2016
16e4c48
Update README.md
binarywang Nov 8, 2016
283101e
Update README.md
binarywang Nov 10, 2016
6b7b421
Update README.md
binarywang Nov 14, 2016
83d2996
Update README.md
binarywang Nov 14, 2016
266f9a6
Update README.md
binarywang Nov 14, 2016
df47af2
修改WxCpMessage中agentId的数据类型, String-> Integer
Nov 16, 2016
59feeba
Merge pull request #75 from withinthefog/agentid-type
binarywang Nov 16, 2016
3640f0d
Revert "修改WxCpMessage中agentId的数据类型, String-> Integer"
binarywang Nov 16, 2016
e7d7030
Merge pull request #76 from wechat-group/revert-75-agentid-type
binarywang Nov 16, 2016
f629ccb
Update README.md
binarywang Nov 16, 2016
3ebf393
Update README.md
binarywang Nov 16, 2016
878ebb1
Update README.md
binarywang Nov 16, 2016
1e35375
Update README.md
binarywang Nov 17, 2016
2a63e12
Update README.md
binarywang Nov 17, 2016
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .travis.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,12 @@ language: java
jdk:
- oraclejdk7

script: "mvn clean install -Dmaven.test.skip=true"
script: "mvn clean package -Dmaven.test.skip=true"

branches:
only:
- develop

notifications:
email:
- binarywang@qq.com
- binaryw@qq.com
51 changes: 40 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
# Weixin Java Tools 微信公众号/企业号开发Java SDK
## ![Maven Central](https://img.shields.io/maven-central/v/com.github.binarywang/weixin-java-parent.svg) [![Build Status](https://travis-ci.org/wechat-group/weixin-java-tools.svg?branch=develop)](https://travis-ci.org/wechat-group/weixin-java-tools) [![Join QQ Group](http://pub.idqqimg.com/wpa/images/group.png)](http://jq.qq.com/?_wv=1027&k=40lRskK)

Weixin Java Tools 微信公众号/企业号开发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)

### 注意:
1. ***本项目Fork自chanjarster/weixin-java-tools,但由于原项目已停止维护,故单独维护和发布,且发布到maven上的groupId也会不同,详细信息见下文。***
Expand All @@ -11,20 +12,22 @@
===========

## 开发交流方式及注意事项:
1. QQ群:343954419 [![Join QQ Group](http://pub.idqqimg.com/wpa/images/group.png)](http://jq.qq.com/?_wv=1027&k=40lRskK)
1. QQ群:343954419(推荐点击按钮入群: [![Join QQ Group](http://pub.idqqimg.com/wpa/images/group.png)](http://shang.qq.com/wpa/qunwpa?idkey=731dc3e7ea31ebe25376cc1a791445468612c63fd0e9e05399b088ec81fd9e15) 或 [![Join QQ Group](http://pub.idqqimg.com/wpa/images/group.png)](http://jq.qq.com/?_wv=1027&k=40lRskK),如果无反应,可以自行搜索群号进行添加 )
1. 由于群容量有限即将爆满,现开启付费入群模式,并不定期清理长时间不活跃人士;
1. 微信群: 因微信群已达到100人限制,故如有想加入微信群的,请入QQ群后联系管理员,提供微信号以便邀请加入;
1. 新手提问前,请先阅读此文章:http://t.cn/RV93MRB
1. 寻求帮助时需贴代码或大长串异常信息的,请利用http://paste.ubuntu.com
1. 有功能需求或由于微信官方接口调整导致的代码问题,可以直接提出issue,便于讨论追踪问题;
1. 详细开发文档请看 [Wiki](https://github.com/wechat-group/weixin-java-tools/wiki),部分文档可能未能及时更新,如有发现,可以及时上报或者自行修改。
1. 微信公众号官方文档入口地址:http://mp.weixin.qq.com/wiki (注意,从网上搜到的文档有的虽然地址前面跟这个一样,但明显左侧菜单不一致,是旧的文档,注意不要看错了文档)。
1. 微信公众号官方文档入口地址:http://mp.weixin.qq.com/wiki (注意,从网上搜到的文档有的虽然地址前面跟这个一样,但明显左侧菜单不一致,是旧的文档,注意不要看错文档)。
1. 各个模块的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. 本项目定为每月发布一次正式版,版本号格式为X.X.0(如2.1.0,2.2.0等),月初或月底发布新版本,遇到重大问题需修复会及时提交新版本,欢迎大家随时提交Pull Request;
1. BUG修复和新特性一般会先发布成小版本作为临时版本(如2.0.1,2.0.2等,即尾号不为0,以区别于正式版);
1. 目前最新版本号为 ![Maven Central](https://img.shields.io/maven-central/v/com.github.binarywang/weixin-java-parent.svg) ,也可以通过访问链接 [【公众号】](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)
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-mp%22) 、[【企业号】](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22com.github.binarywang%22%20AND%20a%3A%22weixin-java-cp%22)
分别查看所有最新的版本。

## Maven & Gradle
Expand Down Expand Up @@ -69,16 +72,42 @@ compile 'com.github.binarywang:weixin-java-cp:2.3.0'
* https://git.coding.net/binarywang/weixin-java-tools.git

===========
## 目前可参考的Demo项目有三个(目前都是公众号的,风格不同,欢迎提供更多的demo供新手参考):
1. https://github.com/wechat-group/weixin-mp-demo
1. https://github.com/wechat-group/weixin-mp-demo-springboot
## 可参考的Demo项目
#### 目前都是公众号的,风格不同,欢迎提供更多的demo供新手参考:
1. https://github.com/wechat-group/weixin-mp-demo
1. https://github.com/wechat-group/weixin-mp-multi-demo (支持多公众号)
1. https://github.com/wechat-group/weixin-java-tools-springmvc
1. https://github.com/wechat-group/weixin-mp-demo-springboot


===========
## 关于代码贡献
1. 非常欢迎和感谢对本项目发起Pull Request的同学,本项目代码风格为使用2个空格代表一个Tab,因此在提交代码时请注意一下,否则很容易在IDE格式化代码后与原代码产生大量diff,这样会给其他人阅读代码带来极大的困扰。
1. 为了便于设置,本项目引入editorconfig插件,请使用eclipse的同学在贡献代码前安装相关插件,IntelliJ IDEA则自带支持,无需额外安装插件。
1. 本项目可以采用两种方式接受代码贡献:
* 第一种就是基于[Git Flow](https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow)开发流程,因此在发起Pull Request的时候请选择develop分支,详细步骤参考后文。
* 另外一种贡献代码的方式就是加入SDK Developers开发组,前提是对自己的代码足够自信就可以申请加入,加入之后可以随时直接提交代码,但要注意对所做的修改或新增的代码进行单元测试,保证提交代码没有明显问题,具体加入方式,请咨询QQ群管理员[![点击这里给我发消息](http://wpa.qq.com/pa?p=2:1211415707:51)](http://wpa.qq.com/msgrd?v=3&uin=1211415707&site=qq&menu=yes)。

1. 第一种就是基于[Git Flow](https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow)开发流程,因此在发起Pull Request的时候请选择develop分支。
1. 另外一种贡献代码的方式就是加入SDK Developers开发组,前提是对自己的代码足够自信就可以申请加入,加入之后可以随时直接提交代码,但要注意对所做的修改或新增的代码进行单元测试,保证提交代码没有明显问题,具体加入方式,请咨询管理员。
## PR方式贡献代码步骤
* 在 GitHub 上 `fork` 到自己的仓库,如 `my_user/weixin-java-tools`,然后 `clone` 到本地,并设置用户信息。
```
$ git clone git@github.com:my_user/weixin-java-tools.git
$ cd weixin-java-tools
$ git config user.name "yourname"
$ git config user.email "your email"
```
* 修改代码后提交,并推送到自己的仓库。
```
$ #do some change on the content
$ git commit -am "Fix issue #1: change something"
$ git push
```
* 在 GitHub 网站上提交 Pull Request。
* 定期使用项目仓库内容更新自己仓库内容。
```
$ git remote add upstream https://github.com/wechat-group/weixin-java-tools
$ git fetch upstream
$ git checkout develop
$ git rebase upstream/develop
$ git push -f origin develop
```