规范部分代码

Update README.md
发布3.4.5.B测试版本
chanjarster · hanwei59 · Feb 19, 2020
Unified Split

Showing 1,200 changed files with 85,438 additions and 15,249 deletions.
diff --git a/.editorconfig b/.editorconfig
@@ -0,0 +1,15 @@
+# EditorConfig: http://editorconfig.org/
+
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false
+
diff --git a/.gitee/ISSUE_TEMPLATE.md b/.gitee/ISSUE_TEMPLATE.md
@@ -0,0 +1,19 @@
+强烈建议大家到 `github` 相关页面提交问题，方便统一查询管理，具体页面地址：https://github.com/Wechat-Group/WxJava/issues
+
+当然如果必须在这里提问，请务必按以下格式填写，谢谢配合~
+
+# 提问前，请确保阅读过项目首页说明以及wiki开发文档相关内容，尤其是常见问题部分。完成内容后，请务必移除包括本句在内的无用内容，以免影响阅读，谢谢合作~
+# 另外如果确认属于bug，而且已明确如何修复，请参考贡献指南直接提交PR，省的浪费时间在这里描述问题，非常感谢配合
+
+### 简要描述
+__简单概括描述下你所遇到的问题。__
+
+### 模块版本情况
+* `WxJava` 模块名: 
+* `WxJava` 版本号:
+
+### 详细描述
+__尽量详细描述。请不要使用截图，尽量使用文字描述，代码直接贴上来，日志则请附在后面所示区域。__
+
+### 日志
+__将日志放在 [`Pastebin`](https://paste.ubuntu.com/) 或者其他地方，并将其url地址贴在这里__
diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
@@ -0,0 +1,4 @@
+# These are supported funding model platforms
+
+github: [binarywang]
+custom: https://github.com/Wechat-Group/WxJava/blob/master/images/qrcodes/wepay.jpg?raw=true
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,24 @@
+---
+name: Bug报告
+about: 如果发现Bug，请告诉我们，我们会尽快修复
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+# 提问前，请确保阅读过项目首页说明以及wiki开发文档相关内容，尤其是常见问题部分。完成内容后，请务必移除包括本句在内的无用内容，以免影响阅读，否则直接关闭，谢谢合作~
+# 另外如果确认属于bug，而且已明确如何修复，请参考贡献指南直接提交PR，省的浪费时间在这里描述问题，非常感谢配合
+
+### 简要描述
+__简单概括描述下你所遇到的问题。__
+
+### 模块版本情况
+* WxJava 模块名: 
+* WxJava 版本号:
+
+### 详细描述
+__尽量详细描述。请不要使用截图，尽量使用文字描述，代码直接贴上来，日志则请附在后面所示区域。__
+
+### 日志
+__将日志放在 [pastebin](https://paste.ubuntu.com/) 或者其他地方，并将其url地址贴在这里__
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,16 @@
+---
+name: 请求添加新功能
+about: 如果有什么新功能需要添加，请告诉我们
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+# 提问前，请确保阅读过项目首页说明以及wiki开发文档相关内容，完成内容后，请务必移除包括本句在内的无用内容，以免影响他人阅读，否则直接关闭，谢谢合作~
+
+### 简要描述
+
+
+### 官方文档地址
+__请提供所需功能对应的微信官方文档地址以便进行确认。__
diff --git a/.gitignore b/.gitignore
@@ -1,23 +1,52 @@
-*.class
-test-output
-
-# Mobile Tools for Java (J2ME)
-.mtj.tmp/
-
-# Package Files #
-*.jar
-*.war
-*.ear
-
-# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
-hs_err_pid*
-
-target
-.project
-.classpath
-.settings
-
-sw-pom.xml
-*.iml
-test-config.xml
-.idea
+*.class
+test-output
+
+# Package Files #
+*.jar
+*.war
+*.ear
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+
+target
+bin
+.project
+.classpath
+.settings
+
+sw-pom.xml
+*.iml
+test-config.xml
+.idea
+/.gradle/
+/gradle/
+*.bat
+/gradlew
+**/build/
+
+
+._*
+.DS_Store
+.AppleDouble
+.LSOverride
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.vscode
+.VolumeIcon.icns
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+/.sonar/
+sonar-project.properties
+
+!/.mvn/wrapper/maven-wrapper.jar
+*.versionsBackup
+
+# STS
+.factorypath
diff --git a/.travis.yml b/.travis.yml
@@ -1,13 +1,18 @@
 language: java
-jdk:
-  - oraclejdk7
 
-script: "mvn clean install -Dmaven.test.skip=true"
+
+jdk:
+  - openjdk8
+script: "mvn clean package -DskipTests=true -Dcheckstyle.skip=true"
 
 branches:
   only:
     - develop
 
+cache:
+  directories:
+    - '$HOME/.m2/repository'
+
 notifications:
   email:
-    - chanjarster@gmail.com
+    - binarywang@vip.qq.com
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -0,0 +1,36 @@
+# 代码贡献指南
+1. 首先非常欢迎和感谢对本项目发起Pull Request的同学。
+1. **特别提示：请务必在develop分支提交PR，master分支目前仅是正式版的代码，即发布正式版本后才会从develop分支进行合并。**
+1. 本项目代码风格为使用2个空格代表一个Tab，因此在提交代码时请注意一下，否则很容易在IDE格式化代码后与原代码产生大量diff，这样会给其他人阅读代码带来极大的困扰。
+1. 为了便于设置，本项目引入editorconfig支持，请使用Eclipse的同学在贡献代码前安装相关插件，而IntelliJ IDEA新版本自带支持，如果没有可自行安装插件。
+1. **提交代码前，请检查代码是否已经格式化，并且保证新增加或者修改的方法都有完整的参数说明，而public方法必须拥有相应的单元测试并通过测试。**
+1. 本项目可以采用两种方式接受代码贡献：
+  -  第一种就是基于[Git Flow](https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow)开发流程，因此在发起Pull Request的时候请选择develop分支，详细步骤参考后文，推荐使用此种方式贡献代码。
+  - （***暂停此种方式，请使用第一种***）另外一种贡献代码的方式就是加入SDK Developers开发组，前提是对自己的代码足够自信就可以申请加入，加入之后可以随时直接提交代码，但要注意对所做的修改或新增的代码进行单元测试，保证提交代码没有明显问题。
+
+### PR方式贡献代码步骤
+* 在 GitHub 上 `fork` 到自己的仓库，如 `my_user/WxJava`，然后 `clone` 到本地，并设置用户信息。
+
+```bash
+$ git clone git@github.com:{your-github-username}/WxJava.git
+$ cd WxJava
+$ git config user.name "yourname"
+$ git config user.email "your email"
+```
+* 修改代码后提交，并推送到自己的仓库。
+
+```bash
+$ #do some change on the content
+$ git commit -am "Fix issue #1: change something"
+$ git push
+```
+* 在 GitHub 网站上提交 Pull Request。
+* 定期使用项目仓库内容更新自己仓库内容。
+
+```bash
+$ git remote add upstream https://github.com/Wechat-Group/WxJava
+$ git fetch upstream
+$ git checkout develop
+$ git rebase upstream/develop
+$ git push -f origin develop
+```