From 9db5276b695ca074f871f83aa0be2bb16cc08c95 Mon Sep 17 00:00:00 2001 From: Binary Wang Date: Thu, 5 Mar 2026 12:03:47 +0800 Subject: [PATCH 1/4] docs: add README optimization analysis report --- docs/readme-optimization-analysis.md | 107 +++++++++++++++++++++++++++ 1 file changed, 107 insertions(+) create mode 100644 docs/readme-optimization-analysis.md diff --git a/docs/readme-optimization-analysis.md b/docs/readme-optimization-analysis.md new file mode 100644 index 000000000..a4c5be72b --- /dev/null +++ b/docs/readme-optimization-analysis.md @@ -0,0 +1,107 @@ +# README.md 优化分析（内容与展示） + +本文基于仓库根目录 `README.md` 当前内容，从信息架构、可读性、转化路径、维护成本等角度给出优化建议。 + +## 一、现状亮点 + +1. **权威性强**：徽章、版本、构建状态、社区奖项、案例、贡献者信息完整。 +2. **覆盖面广**：对模块、版本策略、HTTP 客户端选择都做了说明。 +3. **社区导向明显**：有交流群、问题反馈路径、贡献指南入口。 + +## 二、主要可优化点 + +## 1) 信息架构：入口信息被“长内容”稀释 + +- 当前前半段有大量“重要信息/其他说明/赞助展示”，但新用户最关心的“我该怎么 3 分钟跑起来”入口不够靠前。 +- 建议把首页改成“漏斗结构”： + 1. 你是什么（项目定位） + 2. 我该选哪个模块（模块选择矩阵） + 3. 我如何快速接入（3 步示例） + 4. 常见坑（FAQ Top 5） + 5. 深入链接（Wiki、Demo、Javadoc） + +## 2) 首屏展示：品牌信息强，但任务导向弱 + +- 徽章、推荐卡、赞助内容占据首屏较大区域。 +- 建议在首屏增加 `快速开始` 区块（最多 10 行），例如： + - 选择模块（支付 / 小程序 / 公众号 / 企业微信 / 开放平台 / 视频号） + - Maven 坐标 + - 最小代码片段 + - 文档入口 + +## 3) 新手路径：缺少“场景→模块”决策表 + +- README 已解释 `weixin-java-open` 与移动端 SDK 的边界，但分散在 Maven 章节里。 +- 建议新增“**我该用哪个模块？**”表格，按业务场景列出： + - 登录授权 + - 支付 + - 公众号消息 + - 企业微信通讯录 + - 小程序 API + - 第三方平台代理 + +## 4) 示例策略：有依赖配置，但缺“端到端最小可运行样例” + +- 当前有依赖与 HTTP 客户端配置说明，但缺 1 个完整最小示例（如公众号获取 access token）。 +- 建议每个核心模块给 8~20 行最小示例，并统一放在折叠块中。 + +## 5) 可维护性：时间敏感信息硬编码较多 + +- 如“2026-01-03 发布 4.8.0 正式版”。 +- 建议把动态信息尽量改为自动徽章或外链，减少手动维护。 + +## 6) 可读性：段落信息密度高，扫描成本偏高 + +- “重要信息/其他说明”有很多长句，且包含多重括号。 +- 建议： + - 单条不超过 2 行 + - 每条只保留一个动作（阅读 Wiki / 提 Issue / 入群方式） + - 使用小标题分组：`新手必读`、`提问前检查`、`参与贡献` + +## 7) 展示一致性：Markdown 与 HTML 混用较重 + +- 赞助区大量 HTML table 在移动端展示兼容性一般。 +- 建议改为 Markdown 图片网格或简单列表，降低渲染差异。 + +## 8) 社区治理信息：可进一步产品化 + +- 目前已有“提问的智慧”“Issue 入口”等。 +- 可新增“提问模板快捷链接”和“最小复现模板”入口，降低低质量问题处理成本。 + +## 三、推荐改版结构（建议目录） + +1. 项目简介（1 段） +2. 快速开始（3 分钟） +3. 模块选择指南（表格） +4. 安装与版本（Maven/Gradle） +5. 最小示例（按模块折叠） +6. 常见问题（Top 5） +7. 社区与支持（Issue / Wiki / 群） +8. 贡献方式 +9. 版本策略与变更日志入口 +10. 赞助与致谢（折叠） + +## 四、优先级建议（按投入产出比） + +- **P0（本周可做）** + - 增加目录（TOC） + - 添加“快速开始”区块 + - 添加“模块选择矩阵” +- **P1（下个迭代）** + - 为核心模块补最小代码样例 + - 精简“重要信息/其他说明”并分组 +- **P2（持续优化）** + - 收敛 HTML table，优化移动端阅读 + - 维护自动化（版本信息徽章化） + +## 五、度量指标（建议） + +- README 到 Wiki 点击率 +- README 到 Demo 点击率 +- 首次 Issue 中“已读文档”占比 +- 新手重复问题占比（优化前后对比） +- Star / Fork 转化趋势 + +## 六、一句话总结 + +当前 README 已具备“信息全面”的优势，下一步应重点提升“新用户 3 分钟上手”能力与移动端扫描体验，使其从“资料汇总页”升级为“任务导向首页”。 From 82b8bb52211845b216bc5fdc3f68e815a26cbc17 Mon Sep 17 00:00:00 2001 From: Binary Wang Date: Thu, 5 Mar 2026 12:20:58 +0800 Subject: [PATCH 2/4] docs: provide multiple README revamp options --- docs/readme-optimization-analysis.md | 223 +++++++++++++++++---------- 1 file changed, 142 insertions(+), 81 deletions(-) diff --git a/docs/readme-optimization-analysis.md b/docs/readme-optimization-analysis.md index a4c5be72b..8fa23ec33 100644 --- a/docs/readme-optimization-analysis.md +++ b/docs/readme-optimization-analysis.md @@ -1,107 +1,168 @@ -# README.md 优化分析（内容与展示） +# README.md 改版方案（可直接对比） + +> 目标：不是只做问题分析，而是给出可落地、可对比、可直接执行的 README 改版方案。 + +## 0. 现状简述（基于当前 README） -本文基于仓库根目录 `README.md` 当前内容，从信息架构、可读性、转化路径、维护成本等角度给出优化建议。 +当前 README 信息很全（徽章、版本、模块、交流群、案例、贡献者等），但新用户首屏的“上手路径”不够聚焦。核心问题是：**信息完整 > 任务导向**，导致首次访问者很难在 3 分钟内完成“选模块 + 引依赖 + 跑通最小功能”。 -## 一、现状亮点 +--- -1. **权威性强**：徽章、版本、构建状态、社区奖项、案例、贡献者信息完整。 -2. **覆盖面广**：对模块、版本策略、HTTP 客户端选择都做了说明。 -3. **社区导向明显**：有交流群、问题反馈路径、贡献指南入口。 +## 方案 A：轻量优化（最小改动，低风险） + +### 适用场景 +- 希望**尽量不改原有内容**； +- 希望一周内快速上线； +- 对现有社区内容、赞助区块位置不做大调整。 + +### 核心动作 +1. 在 README 顶部新增目录（TOC）。 +2. 在首屏徽章后新增“3 分钟快速开始”。 +3. 新增“我该选哪个模块”表格（场景 -> artifactId）。 +4. 保留原“重要信息/其他说明”，仅做分组和精简。 -## 二、主要可优化点 +### 优点 +- 改动小、合并风险低； +- 不打破老用户阅读习惯； +- 快速提升新手转化。 -## 1) 信息架构：入口信息被“长内容”稀释 +### 缺点 +- 结构层面的历史包袱仍在； +- 文档总体长度依旧偏长。 -- 当前前半段有大量“重要信息/其他说明/赞助展示”，但新用户最关心的“我该怎么 3 分钟跑起来”入口不够靠前。 -- 建议把首页改成“漏斗结构”： - 1. 你是什么（项目定位） - 2. 我该选哪个模块（模块选择矩阵） - 3. 我如何快速接入（3 步示例） - 4. 常见坑（FAQ Top 5） - 5. 深入链接（Wiki、Demo、Javadoc） +### 预计工作量 +- 0.5 ~ 1 天。 -## 2) 首屏展示：品牌信息强，但任务导向弱 +--- -- 徽章、推荐卡、赞助内容占据首屏较大区域。 -- 建议在首屏增加 `快速开始` 区块（最多 10 行），例如： - - 选择模块（支付 / 小程序 / 公众号 / 企业微信 / 开放平台 / 视频号） - - Maven 坐标 - - 最小代码片段 - - 文档入口 +## 方案 B：中度重构（推荐） -## 3) 新手路径：缺少“场景→模块”决策表 +### 适用场景 +- 希望兼顾新手体验与历史信息保留； +- 愿意做一次有节奏的 README 重排； +- 接受“内容分层+折叠”的结构变化。 -- README 已解释 `weixin-java-open` 与移动端 SDK 的边界，但分散在 Maven 章节里。 -- 建议新增“**我该用哪个模块？**”表格，按业务场景列出： - - 登录授权 - - 支付 - - 公众号消息 - - 企业微信通讯录 - - 小程序 API - - 第三方平台代理 +### 核心动作 +1. 重排为“任务漏斗结构”： + - 项目简介 + - 快速开始 + - 模块选择 + - 安装与版本 + - 最小示例 + - FAQ + - 社区与贡献 + - 赞助与案例（折叠） +2. 将“重要信息 / 其他说明”合并为： + - 新手必读 + - 提问前检查 + - 参与贡献 +3. 增加每个核心模块 8~20 行最小示例（先放 2 个代表模块也可）。 +4. 时间敏感内容改为动态链接/徽章（减少手工维护）。 -## 4) 示例策略：有依赖配置，但缺“端到端最小可运行样例” +### 优点 +- 新手上手路径明显改善； +- 老信息依然可查（通过折叠和分层保留）； +- 维护成本下降。 -- 当前有依赖与 HTTP 客户端配置说明，但缺 1 个完整最小示例（如公众号获取 access token）。 -- 建议每个核心模块给 8~20 行最小示例，并统一放在折叠块中。 +### 缺点 +- 需要一次性重排，评审成本中等； +- 对旧版阅读习惯有轻微影响。 -## 5) 可维护性：时间敏感信息硬编码较多 +### 预计工作量 +- 1 ~ 2 天。 -- 如“2026-01-03 发布 4.8.0 正式版”。 -- 建议把动态信息尽量改为自动徽章或外链，减少手动维护。 +--- -## 6) 可读性：段落信息密度高，扫描成本偏高 +## 方案 C：深度改版（产品化文档首页） -- “重要信息/其他说明”有很多长句，且包含多重括号。 -- 建议： - - 单条不超过 2 行 - - 每条只保留一个动作（阅读 Wiki / 提 Issue / 入群方式） - - 使用小标题分组：`新手必读`、`提问前检查`、`参与贡献` +### 适用场景 +- 希望 README 充当“文档门户”； +- 后续愿意持续维护文档指标与模板； +- 可以接受较大改动与多次迭代。 -## 7) 展示一致性：Markdown 与 HTML 混用较重 +### 核心动作 +1. README 只保留“导航型内容 + 最小样例”，把长文本拆到 `docs/`。 +2. 增加角色化入口： + - 新手接入 + - 生产稳定性 + - 多模块集成 + - 贡献开发 +3. 增加 FAQ Top5 + 提问模板 + 最小复现模板。 +4. 建立“文档更新准则”（版本升级时检查清单）。 -- 赞助区大量 HTML table 在移动端展示兼容性一般。 -- 建议改为 Markdown 图片网格或简单列表，降低渲染差异。 +### 优点 +- 长期体验最佳； +- 结构清晰、扩展性强； +- 降低重复提问。 -## 8) 社区治理信息：可进一步产品化 +### 缺点 +- 改动最大； +- 对维护协作要求更高。 -- 目前已有“提问的智慧”“Issue 入口”等。 -- 可新增“提问模板快捷链接”和“最小复现模板”入口，降低低质量问题处理成本。 +### 预计工作量 +- 3 ~ 5 天（按分阶段）。 -## 三、推荐改版结构（建议目录） +--- -1. 项目简介（1 段） -2. 快速开始（3 分钟） -3. 模块选择指南（表格） -4. 安装与版本（Maven/Gradle） -5. 最小示例（按模块折叠） -6. 常见问题（Top 5） -7. 社区与支持（Issue / Wiki / 群） -8. 贡献方式 -9. 版本策略与变更日志入口 -10. 赞助与致谢（折叠） +## 对比结论（建议选择） + +| 维度 | 方案 A 轻量优化 | 方案 B 中度重构（推荐） | 方案 C 深度改版 | +|---|---|---|---| +| 改动风险 | 低 | 中 | 高 | +| 上手体验提升 | 中 | 高 | 很高 | +| 历史兼容性 | 很高 | 高 | 中 | +| 维护成本优化 | 低 | 中高 | 高 | +| 落地速度 | 快 | 中 | 慢 | + +**建议优先选 B**：投入产出比最好，既能显著提升新用户体验，也不会过度扰动现有社区信息。 + +--- + +## 你可以直接拍板的执行版本（推荐：B1/B2） + +### B1（两步走，稳妥） +- 第一步：只做结构重排 + 模块选择表 + 快速开始。 +- 第二步：补最小示例 + FAQ + 模板链接。 + +### B2（一次到位） +- 一次 PR 完成 B 方案全部动作，评审后合并。 + +--- + +## 可直接复用的 README 新目录模板 + +```markdown +## WxJava - 微信开发 Java SDK + +### 快速开始（3分钟） +- 1) 选择模块 +- 2) 引入依赖 +- 3) 跑最小示例 + +### 我该选哪个模块？ +| 场景 | 模块 | +|---|---| +| 公众号开发 | weixin-java-mp | +| 小程序 | weixin-java-miniapp | +| 微信支付 | weixin-java-pay | +| 企业微信 | weixin-java-cp | +| 开放平台/第三方平台 | weixin-java-open | +| 视频号/微信小店 | weixin-java-channel | + +### 安装与版本 +### 最小示例 +### FAQ（提问前必读） +### 社区与支持 +### 贡献指南 +### 赞助与致谢（可折叠） +``` -## 四、优先级建议（按投入产出比） +--- -- **P0（本周可做）** - - 增加目录（TOC） - - 添加“快速开始”区块 - - 添加“模块选择矩阵” -- **P1（下个迭代）** - - 为核心模块补最小代码样例 - - 精简“重要信息/其他说明”并分组 -- **P2（持续优化）** - - 收敛 HTML table，优化移动端阅读 - - 维护自动化（版本信息徽章化） +## 建议你现在怎么选 -## 五、度量指标（建议） +- 如果你要**今天就改并发版**：选 **方案 A**。 +- 如果你要**本周改完且效果明显**：选 **方案 B（推荐）**。 +- 如果你要**把 README 变成长期文档门户**：选 **方案 C**。 -- README 到 Wiki 点击率 -- README 到 Demo 点击率 -- 首次 Issue 中“已读文档”占比 -- 新手重复问题占比（优化前后对比） -- Star / Fork 转化趋势 - -## 六、一句话总结 - -当前 README 已具备“信息全面”的优势，下一步应重点提升“新用户 3 分钟上手”能力与移动端扫描体验，使其从“资料汇总页”升级为“任务导向首页”。 +如果你确认方案（A/B/C 或 B1/B2），我下一步可以直接按你选的方案改 `README.md` 正文（不是分析文档），并给你一个可直接合并的版本。 From a62cf873df808acf17333c7217408efdf793a75b Mon Sep 17 00:00:00 2001 From: Binary Wang Date: Thu, 5 Mar 2026 12:21:03 +0800 Subject: [PATCH 3/4] docs: apply B2 README restructure with quick-start and module matrix --- README.md | 338 ++++++++++++++++++++++++++---------------------------- 1 file changed, 160 insertions(+), 178 deletions(-) diff --git a/README.md b/README.md index ab1d82352..5d729d322 100644 --- a/README.md +++ b/README.md @@ -9,115 +9,111 @@ [![使用IntelliJ IDEA开发维护](https://img.shields.io/badge/IntelliJ%20IDEA-支持-blue.svg)](https://www.jetbrains.com/?from=WxJava-weixin-java-tools) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) -
- - Featured｜HelloGitHub - - - binarywang%2FWxJava | 趋势转变 - -
+### 微信 `Java` 开发工具包，支持微信支付、开放平台、公众号、企业微信、视频号、小程序等后端开发。 -### 微信`Java`开发工具包，支持包括微信支付、开放平台、公众号、企业微信、视频号、小程序等微信功能模块的后端开发。 -
- 特别赞助 - - - - - - - - - - - - - -
- - ccflow - -
- - 计全支付Jeepay,开源支付系统 - - - - Mall4j - -
- - mp qrcode - - - 赞助商招募中 - - - ad - -
-
+--- + +### 目录 +- [快速开始（3分钟）](#快速开始3分钟) +- [我该选哪个模块？](#我该选哪个模块) +- [安装与版本](#安装与版本) +- [最小示例](#最小示例) +- [HTTP 客户端支持](#http-客户端支持) +- [FAQ（提问前必读）](#faq提问前必读) +- [社区与支持](#社区与支持) +- [贡献方式](#贡献方式) +- [版本说明](#版本说明) +- [应用案例](#应用案例) +- [赞助与致谢](#赞助与致谢) + +--- + +### 快速开始（3分钟） +1. 根据业务场景选择模块（见下方“我该选哪个模块？”） +2. 引入 Maven 依赖并使用最新稳定版本 +3. 参考最小示例初始化 `Service` 并调用 API -### 重要信息 -1. [`WxJava` 荣获 `GitCode` 2024年度十大开源社区奖项](https://mp.weixin.qq.com/s/wM_UlMsDm3IZ1CPPDvcvQw)。 -2. 项目合作洽谈请联系微信`binary0000`（在微信里自行搜索并添加好友，请注明来意，如有关于SDK问题需讨论请参考下文入群讨论，不要加此微信）。 -3. **2026-01-03 发布 [【4.8.0正式版】](https://mp.weixin.qq.com/s/mJoFtGc25pXCn3uZRh6Q-w)**！ -5. 贡献源码可以参考视频：[【贡献源码全过程（上集）】](https://mp.weixin.qq.com/s/3xUZSATWwHR_gZZm207h7Q)、[【贡献源码全过程（下集）】](https://mp.weixin.qq.com/s/nyzJwVVoYSJ4hSbwyvTx9A) ，友情提供：[程序员小山与Bug](https://space.bilibili.com/473631007) -6. 新手重要提示：本项目仅是一个SDK开发工具包，未提供Web实现，建议使用 `maven` 或 `gradle` 引用本项目即可使用本SDK提供的各种功能，详情可参考 **[【Demo项目】](demo.md)** 或本项目中的部分单元测试代码； -7. 微信开发新手请务必阅读【开发文档】（[Gitee Wiki](https://gitee.com/binary/weixin-java-tools/wikis/Home) 或者 [Github Wiki](https://github.com/binarywang/WxJava/wiki)）的常见问题部分，可以少走很多弯路，节省不少时间。 -8. 技术交流群：想获得QQ群/微信群/钉钉企业群等信息的同学，请使用微信扫描上面的微信公众号二维码关注 `WxJava` 后点击相关菜单即可获取加入方式，同时也可以在微信中搜索 `weixin-java-tools` 或 `WxJava` 后选择正确的公众号进行关注，该公众号会及时通知SDK相关更新信息，并不定期分享微信Java开发相关技术知识； -9. 钉钉技术交流群：`32206329`（技术交流2群）, `30294972`（技术交流1群，目前已满），`35724728`（通知群，实时通知Github项目变更记录）。 -10. 微信开发新手或者Java开发新手在群内提问或新开Issue提问前，请先阅读[【提问的智慧】](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/master/README-zh_CN.md)，并确保已查阅过 [【开发文档Wiki】](https://github.com/binarywang/WxJava/wiki) ，避免浪费大家的宝贵时间； -11. 寻求帮助时需贴代码或大长串异常信息的，请利用 http://paste.ubuntu.com - --------------------------------- -### 其他说明 -1. **阅读源码的同学请注意，本SDK为简化代码编译时加入了`lombok`支持，如果不了解`lombok`的话，请先学习下相关知识，比如可以阅读[此文章](https://mp.weixin.qq.com/s/cUc-bUcprycADfNepnSwZQ)；** -2. 如有新功能需求，发现BUG，或者由于微信官方接口调整导致的代码问题，可以直接在[【Issues】](https://github.com/binarywang/WxJava/issues)页提出issue，便于讨论追踪问题； -3. 如果需要贡献代码，请务必在提交PR之前先仔细阅读[【代码贡献指南】](CONTRIBUTING.md)，谢谢理解配合； -4. 目前本`SDK`最新版本要求的`JDK`最低版本是`8`，使用`7`的同学可以使用`WxJava` `3.8.0`及以前版本，而还在使用`JDK`6的用户请参考[【此项目】]( https://github.com/binarywang/weixin-java-tools-for-jdk6) ，而其他更早的JDK版本则需要自己改造实现。 -5. [本项目在开源中国的页面](https://www.oschina.net/p/weixin-java-tools-new)，欢迎大家积极留言评分 🙂 -6. SDK开发文档请查阅 [【开发文档Wiki】](https://github.com/binarywang/WxJava/wiki)，部分文档可能未能及时更新，如有发现，可以及时上报或者自行修改。 -7. **如果本开发工具包对您有所帮助，欢迎对我们的努力进行肯定，可以直接前往[【托管于码云的项目首页】](http://gitee.com/binary/weixin-java-tools)，在页尾部分找到“捐助”按钮进行打赏，多多益善 😄。非常感谢各位打赏和捐助的同学！** -8. 各个模块的Javadoc可以在线查看：[weixin-java-miniapp](http://binary.ac.cn/weixin-java-miniapp-javadoc/)、[weixin-java-pay](http://binary.ac.cn/weixin-java-pay-javadoc/)、[weixin-java-mp](http://binary.ac.cn/weixin-java-mp-javadoc/)、[weixin-java-common](http://binary.ac.cn/weixin-java-common-javadoc/)、[weixin-java-cp](http://binary.ac.cn/weixin-java-cp-javadoc/)、[weixin-java-open](http://binary.ac.cn/weixin-java-open-javadoc/) -9. 本SDK项目在以下代码托管网站同步更新: -* 码云：https://gitee.com/binary/weixin-java-tools -* GitHub：https://github.com/binarywang/WxJava - ---------------------------------- -### Maven 引用方式 -注意：最新版本（包括测试版）为 [![Maven Central](https://img.shields.io/maven-central/v/com.github.binarywang/wx-java.svg)](https://central.sonatype.com/artifact/com.github.binarywang/wx-java/versions)，以下为最新正式版。 +--- + +### 我该选哪个模块？ + +| 业务场景 | 模块 | artifactId | +|---|---|---| +| 微信公众号开发 | MP | `weixin-java-mp` | +| 微信小程序开发 | MiniApp | `weixin-java-miniapp` | +| 微信支付 | Pay | `weixin-java-pay` | +| 企业微信 | CP | `weixin-java-cp` | +| 微信开放平台（第三方平台） | Open | `weixin-java-open` | +| 视频号 / 微信小店 | Channel | `weixin-java-channel` | + +> 移动端（iOS/Android）微信登录、分享等能力仍需集成微信官方客户端 SDK；本项目为服务端 SDK。 + +--- + +### 安装与版本 + +最新版本（含测试版）请查看： +[![Maven Central](https://img.shields.io/maven-central/v/com.github.binarywang/wx-java.svg)](https://central.sonatype.com/artifact/com.github.binarywang/wx-java/versions) ```xml com.github.binarywang - （不同模块参考下文） + （按模块选择） 4.8.0 ``` - - 微信小程序：`weixin-java-miniapp` - - 微信支付：`weixin-java-pay` - - 微信开放平台：`weixin-java-open` - - 微信公众号：`weixin-java-mp` - - 企业微信：`weixin-java-cp` - - 微信视频号/微信小店：`weixin-java-channel` +常用模块： +- 微信小程序：`weixin-java-miniapp` +- 微信支付：`weixin-java-pay` +- 微信开放平台：`weixin-java-open` +- 微信公众号：`weixin-java-mp` +- 企业微信：`weixin-java-cp` +- 微信视频号/微信小店：`weixin-java-channel` -**注意**： -- **移动应用开发**：如果你的移动应用（iOS/Android App）需要接入微信登录、分享等功能： - - 微信登录（网页授权）：使用 `weixin-java-open` 模块，在服务端处理 OAuth 授权 - - 微信支付：使用 `weixin-java-pay` 模块 - - 客户端集成：需使用微信官方提供的移动端SDK（iOS/Android），本项目为服务端SDK -- **微信开放平台**（`weixin-java-open`）主要用于第三方平台，代公众号或小程序进行开发和管理 +--- +### 最小示例 ---------------------------------- -### HTTP 客户端支持 +
+公众号（MP）示例：获取 AccessToken + +```java +WxMpDefaultConfigImpl config = new WxMpDefaultConfigImpl(); +config.setAppId("your-app-id"); +config.setSecret("your-secret"); -本项目同时支持多种 HTTP 客户端实现，默认推荐使用 **Apache HttpClient 5.x**（最新稳定版本）。 +WxMpService wxMpService = new WxMpServiceImpl(); +wxMpService.setWxMpConfigStorage(config); -#### 支持的 HTTP 客户端类型 +String accessToken = wxMpService.getAccessToken(); +System.out.println(accessToken); +``` + +
+ +
+小程序（MiniApp）示例：code2Session + +```java +WxMaDefaultConfigImpl config = new WxMaDefaultConfigImpl(); +config.setAppid("your-app-id"); +config.setSecret("your-secret"); + +WxMaService wxMaService = new WxMaServiceImpl(); +wxMaService.setWxMaConfig(config); + +WxMaJscode2SessionResult result = wxMaService.getUserService().getSessionInfo("js-code"); +System.out.println(result.getOpenid()); +``` + +
+ +--- + +### HTTP 客户端支持 + +本项目支持多种 HTTP 客户端，默认推荐 **Apache HttpClient 5.x**。 | HTTP 客户端 | 说明 | 配置值 | 推荐程度 | |------------|------|--------|---------| @@ -126,10 +122,6 @@ | OkHttp | Square OkHttp 客户端 | `OkHttp` | ⭐⭐⭐ 可选 | | Jodd-http | Jodd 轻量级 HTTP 客户端 | `JoddHttp` | ⭐⭐ 可选 | -#### 配置方式 - -**Spring Boot 配置示例：** - ```properties # 使用 HttpClient 5.x（推荐，MP/MiniApp/CP/Channel/QiDian 模块默认） wx.mp.config-storage.http-client-type=HttpComponents @@ -144,108 +136,98 @@ wx.mp.config-storage.http-client-type=OkHttp wx.mp.config-storage.http-client-type=JoddHttp ``` -**注意**：如果使用 Multi-Starter（如 `wx-java-mp-multi-spring-boot-starter`），枚举值需使用大写下划线格式： +Multi-Starter（如 `wx-java-mp-multi-spring-boot-starter`）请使用大写下划线格式： + ```properties -# Multi-Starter 配置格式 -wx.mp.config-storage.http-client-type=HTTP_COMPONENTS # 注意使用大写下划线 +wx.mp.config-storage.http-client-type=HTTP_COMPONENTS ``` -**注意事项：** -1. **MP、MiniApp、Channel、QiDian 模块**已完整支持 HttpClient 5.x，默认推荐使用 -2. **CP 模块**的支持情况取决于具体使用的 Starter 版本，请参考对应模块文档 -3. 如需使用 OkHttp 或 Jodd-http，需在项目中添加对应的依赖（scope为provided） -4. HttpClient 4.x 和 HttpClient 5.x 可以共存，按需配置即可 +--- +### FAQ（提问前必读） +- 本项目是 SDK，不提供 Web 实现，建议直接通过 Maven/Gradle 引入并参考 [Demo](demo.md)。 +- 新手请先阅读 [开发文档 Wiki](https://github.com/binarywang/WxJava/wiki) / [Gitee Wiki](https://gitee.com/binary/weixin-java-tools/wikis/Home)。 +- 提问前建议先看 [提问的智慧](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/master/README-zh_CN.md)。 +- 贴长代码或异常日志建议使用 http://paste.ubuntu.com 。 ---------------------------------- -### 版本说明 +--- -
-点此展开查看 - -1. 本项目定为大约每半年左右发布一次正式版，遇到重大问题需修复会及时提交新版本，欢迎大家随时提交 `Pull Request`； -2. 每次代码更新都会自动构建出新版本方便及时尝鲜，版本号格式为 `x.x.x-时间戳`; -3. 发布正式版时，`develop` 分支代码合并进入 `release` 分支），版本号格式为 `X.X.0`（如`2.1.0`，`2.2.0`等）； -4. 每隔一段时间后，会发布测试版本（如`3.6.8.B`，即尾号不为0，并添加B，以区别于正式版），代码仅存在于 `develop` 分支中； -5. 目前最新版本号为 [![Maven Central](https://img.shields.io/maven-central/v/com.github.binarywang/wx-java.svg)](http://mvnrepository.com/artifact/com.github.binarywang/wx-java) ，也可以通过访问以下链接分别查看各个模块最新的版本： -[【微信支付】](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-pay/versions) 、[【小程序】](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-miniapp/versions) 、[【公众号】](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-mp/versions) 、[【企业微信】](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-cp/versions)、[【开放平台】](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-open/versions)、[【视频号】](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-channel/versions) +### 社区与支持 +- 技术交流群：关注公众号 `WxJava`（或搜索 `weixin-java-tools`）后通过菜单获取最新加群方式。 +- 钉钉技术交流群：`32206329`（技术交流2群）、`30294972`（技术交流1群，已满）、`35724728`（通知群）。 +- 问题反馈与需求建议：请在 [Issues](https://github.com/binarywang/WxJava/issues) 提交。 +--- -
+### 贡献方式 +- 提交 PR 前请先阅读 [代码贡献指南](CONTRIBUTING.md)。 +- 贡献源码可参考视频： + - [贡献源码全过程（上集）](https://mp.weixin.qq.com/s/3xUZSATWwHR_gZZm207h7Q) + - [贡献源码全过程（下集）](https://mp.weixin.qq.com/s/nyzJwVVoYSJ4hSbwyvTx9A) + +--- + +### 版本说明 +1. 正式版通常约半年发布一次，重大问题会及时发版； +2. 日常更新会构建尝鲜版本（`x.x.x-时间戳`）； +3. 正式版发布时 `develop` 合并到 `release`，版本号一般为 `X.X.0`； +4. 测试版本（如 `3.6.8.B`）仅存在于 `develop` 分支； +5. 各模块版本： +[微信支付](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-pay/versions)、[小程序](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-miniapp/versions)、[公众号](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-mp/versions)、[企业微信](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-cp/versions)、[开放平台](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-open/versions)、[视频号](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-channel/versions) + +--- ----------------------------------- ### 应用案例 -完整案例登记列表，请[【访问这里】](https://github.com/binarywang/WxJava/issues/729)查看，欢迎登记更多的案例。 +完整案例登记列表请见 [Issue #729](https://github.com/binarywang/WxJava/issues/729)。
-以下为节选的部分案例， 点此展开查看 +节选案例（点击展开） -#### 开源项目： -- 基于微信公众号的签到、抽奖、发送弹幕程序：https://github.com/workcheng/weiya +#### 开源项目 - Jeepay 支付系统：https://gitee.com/jeequan/jeepay -- 微同商城：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 -- SAAS微信小程序电商：https://gitee.com/wei-it/weiit-saas +- WePush：https://github.com/rememberber/WePush +- 基于若依开发的公众号管理系统：https://gitee.com/joolun/JooLun-wx - mall4j 电商商城系统：https://gitee.com/gz-yami/mall4j -#### 小程序： -- （京东）友家铺子，友家铺子店长版，京粉精选 -- [喵星人贴吧助手(扫码关注)](http://p98ahz3tg.bkt.clouddn.com/miniappqrcode.jpg) -- 树懒揽书+ -- 广廉快线，鹏城巴士等 -- 当燃挑战、sportlight轻灵运动 -- 360考试宝典 -- 民医台 -- 来一团商家版 -- 史必达（史丹利） -- 嘀嗒云印 -- 维沃吼吼 -- 王朝社区（比亚迪新能源社区） -- 极吼吼手机上门回收换新 -- 未来信封 -- 5G惠享 -- 生菜wordpress转小程序 -- 丽日购 - -#### 公众号： -- 中国电信上海网厅（sh_189） -- E答平台 -- 宁夏生鲜365 -- 通服货滴 -- 神龙养车 -- 沃音乐商务智能 -- 光环云社群 -- 手机排队 -- [全民约跑健身便利店](http://www.oneminsport.com/) -- 民医台 -- YshopMall -- 好行景区直通车以及全国40多个公众号 -- 我奥篮球公众号 -- 未来信封官微 -- 银川智云问诊 -- 5G惠享 - -#### 企业微信： -- HTC企业微信 -- 掌上史丹利 -- 药店益 - -#### 其他： -- 高善人力资源 -- 小猪餐餐 -- 餐饮系统 -- 微信公众号管理系统：http://demo.joolun.com +#### 企业用户（节选） +- 中国电信上海网厅（公众号） +- HTC 企业微信 - 锐捷网络：Saleslink
----------------------------------- +--- + +### 赞助与致谢 + +
+ 特别赞助 + + + + + + + + +
+ + ccflow + +
+ + 计全支付Jeepay,开源支付系统 + + + + Mall4j + +
+
+ ### 贡献者列表 -特别感谢参与贡献的所有同学，所有贡献者列表请在[此处](https://github.com/binarywang/WxJava/graphs/contributors)查看，欢迎大家继续踊跃贡献代码！ +特别感谢参与贡献的所有同学，完整列表见 [contributors](https://github.com/binarywang/WxJava/graphs/contributors)。 From c41abf9228adcf4b8601aff1f600a4774bfc7ea7 Mon Sep 17 00:00:00 2001 From: Binary Wang Date: Thu, 5 Mar 2026 12:48:17 +0800 Subject: [PATCH 4/4] docs: restore README content and move sponsor section upfront --- README.md | 293 +++++++++++++++++++++++++++++++++++------------------- 1 file changed, 191 insertions(+), 102 deletions(-) diff --git a/README.md b/README.md index 5d729d322..6d93da2f9 100644 --- a/README.md +++ b/README.md @@ -9,31 +9,75 @@ [![使用IntelliJ IDEA开发维护](https://img.shields.io/badge/IntelliJ%20IDEA-支持-blue.svg)](https://www.jetbrains.com/?from=WxJava-weixin-java-tools) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) -### 微信 `Java` 开发工具包，支持微信支付、开放平台、公众号、企业微信、视频号、小程序等后端开发。 +
+ + Featured｜HelloGitHub + + + binarywang%2FWxJava | 趋势转变 + +
---- +### 微信 `Java` 开发工具包，支持包括微信支付、开放平台、公众号、企业微信、视频号、小程序等微信功能模块的后端开发。 -### 目录 +### 特别赞助 +
+ 特别赞助 + + + + + + + + + + + + + +
+ + ccflow + +
+ + 计全支付Jeepay,开源支付系统 + + + + Mall4j + +
+ + mp qrcode + + + 赞助商招募中 + + + ad + +
+
+ +### 目录索引 - [快速开始（3分钟）](#快速开始3分钟) - [我该选哪个模块？](#我该选哪个模块) -- [安装与版本](#安装与版本) +- [重要信息](#重要信息) +- [其他说明](#其他说明) +- [Maven 引用方式](#maven-引用方式) - [最小示例](#最小示例) - [HTTP 客户端支持](#http-客户端支持) -- [FAQ（提问前必读）](#faq提问前必读) -- [社区与支持](#社区与支持) -- [贡献方式](#贡献方式) - [版本说明](#版本说明) - [应用案例](#应用案例) -- [赞助与致谢](#赞助与致谢) - ---- +- [特别赞助](#特别赞助) +- [贡献者列表](#贡献者列表) ### 快速开始（3分钟） 1. 根据业务场景选择模块（见下方“我该选哪个模块？”） -2. 引入 Maven 依赖并使用最新稳定版本 -3. 参考最小示例初始化 `Service` 并调用 API - ---- +2. 引入 Maven 依赖并选择对应模块 +3. 参考最小示例完成初始化并调用 API ### 我该选哪个模块？ @@ -48,31 +92,61 @@ > 移动端（iOS/Android）微信登录、分享等能力仍需集成微信官方客户端 SDK；本项目为服务端 SDK。 ---- - -### 安装与版本 - -最新版本（含测试版）请查看： -[![Maven Central](https://img.shields.io/maven-central/v/com.github.binarywang/wx-java.svg)](https://central.sonatype.com/artifact/com.github.binarywang/wx-java/versions) +### 重要信息 +1. [`WxJava` 荣获 `GitCode` 2024年度十大开源社区奖项](https://mp.weixin.qq.com/s/wM_UlMsDm3IZ1CPPDvcvQw)。 +2. 项目合作洽谈请联系微信`binary0000`（在微信里自行搜索并添加好友，请注明来意，如有关于SDK问题需讨论请参考下文入群讨论，不要加此微信）。 +3. **2026-01-03 发布 [【4.8.0正式版】](https://mp.weixin.qq.com/s/mJoFtGc25pXCn3uZRh6Q-w)**！ +5. 贡献源码可以参考视频：[【贡献源码全过程（上集）】](https://mp.weixin.qq.com/s/3xUZSATWwHR_gZZm207h7Q)、[【贡献源码全过程（下集）】](https://mp.weixin.qq.com/s/nyzJwVVoYSJ4hSbwyvTx9A) ，友情提供：[程序员小山与Bug](https://space.bilibili.com/473631007) +6. 新手重要提示：本项目仅是一个SDK开发工具包，未提供Web实现，建议使用 `maven` 或 `gradle` 引用本项目即可使用本SDK提供的各种功能，详情可参考 **[【Demo项目】](demo.md)** 或本项目中的部分单元测试代码； +7. 微信开发新手请务必阅读【开发文档】（[Gitee Wiki](https://gitee.com/binary/weixin-java-tools/wikis/Home) 或者 [Github Wiki](https://github.com/binarywang/WxJava/wiki)）的常见问题部分，可以少走很多弯路，节省不少时间。 +8. 技术交流群：想获得QQ群/微信群/钉钉企业群等信息的同学，请使用微信扫描上面的微信公众号二维码关注 `WxJava` 后点击相关菜单即可获取加入方式，同时也可以在微信中搜索 `weixin-java-tools` 或 `WxJava` 后选择正确的公众号进行关注，该公众号会及时通知SDK相关更新信息，并不定期分享微信Java开发相关技术知识； +9. 钉钉技术交流群：`32206329`（技术交流2群）, `30294972`（技术交流1群，目前已满），`35724728`（通知群，实时通知Github项目变更记录）。 +10. 微信开发新手或者Java开发新手在群内提问或新开Issue提问前，请先阅读[【提问的智慧】](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/master/README-zh_CN.md)，并确保已查阅过 [【开发文档Wiki】](https://github.com/binarywang/WxJava/wiki) ，避免浪费大家的宝贵时间； +11. 寻求帮助时需贴代码或大长串异常信息的，请利用 http://paste.ubuntu.com + +-------------------------------- +### 其他说明 +1. **阅读源码的同学请注意，本SDK为简化代码编译时加入了`lombok`支持，如果不了解`lombok`的话，请先学习下相关知识，比如可以阅读[此文章](https://mp.weixin.qq.com/s/cUc-bUcprycADfNepnSwZQ)；** +2. 如有新功能需求，发现BUG，或者由于微信官方接口调整导致的代码问题，可以直接在[【Issues】](https://github.com/binarywang/WxJava/issues)页提出issue，便于讨论追踪问题； +3. 如果需要贡献代码，请务必在提交PR之前先仔细阅读[【代码贡献指南】](CONTRIBUTING.md)，谢谢理解配合； +4. 目前本`SDK`最新版本要求的`JDK`最低版本是`8`，使用`7`的同学可以使用`WxJava` `3.8.0`及以前版本，而还在使用`JDK`6的用户请参考[【此项目】]( https://github.com/binarywang/weixin-java-tools-for-jdk6) ，而其他更早的JDK版本则需要自己改造实现。 +5. [本项目在开源中国的页面](https://www.oschina.net/p/weixin-java-tools-new)，欢迎大家积极留言评分 🙂 +6. SDK开发文档请查阅 [【开发文档Wiki】](https://github.com/binarywang/WxJava/wiki)，部分文档可能未能及时更新，如有发现，可以及时上报或者自行修改。 +7. **如果本开发工具包对您有所帮助，欢迎对我们的努力进行肯定，可以直接前往[【托管于码云的项目首页】](http://gitee.com/binary/weixin-java-tools)，在页尾部分找到“捐助”按钮进行打赏，多多益善 😄。非常感谢各位打赏和捐助的同学！** +8. 各个模块的Javadoc可以在线查看：[weixin-java-miniapp](http://binary.ac.cn/weixin-java-miniapp-javadoc/)、[weixin-java-pay](http://binary.ac.cn/weixin-java-pay-javadoc/)、[weixin-java-mp](http://binary.ac.cn/weixin-java-mp-javadoc/)、[weixin-java-common](http://binary.ac.cn/weixin-java-common-javadoc/)、[weixin-java-cp](http://binary.ac.cn/weixin-java-cp-javadoc/)、[weixin-java-open](http://binary.ac.cn/weixin-java-open-javadoc/) +9. 本SDK项目在以下代码托管网站同步更新: +* 码云：https://gitee.com/binary/weixin-java-tools +* GitHub：https://github.com/binarywang/WxJava + +--------------------------------- +### Maven 引用方式 +注意：最新版本（包括测试版）为 [![Maven Central](https://img.shields.io/maven-central/v/com.github.binarywang/wx-java.svg)](https://central.sonatype.com/artifact/com.github.binarywang/wx-java/versions)，以下为最新正式版。 ```xml com.github.binarywang - （按模块选择） + （不同模块参考下文） 4.8.0 ``` -常用模块： -- 微信小程序：`weixin-java-miniapp` -- 微信支付：`weixin-java-pay` -- 微信开放平台：`weixin-java-open` -- 微信公众号：`weixin-java-mp` -- 企业微信：`weixin-java-cp` -- 微信视频号/微信小店：`weixin-java-channel` + - 微信小程序：`weixin-java-miniapp` + - 微信支付：`weixin-java-pay` + - 微信开放平台：`weixin-java-open` + - 微信公众号：`weixin-java-mp` + - 企业微信：`weixin-java-cp` + - 微信视频号/微信小店：`weixin-java-channel` + +**注意**： +- **移动应用开发**：如果你的移动应用（iOS/Android App）需要接入微信登录、分享等功能： + - 微信登录（网页授权）：使用 `weixin-java-open` 模块，在服务端处理 OAuth 授权 + - 微信支付：使用 `weixin-java-pay` 模块 + - 客户端集成：需使用微信官方提供的移动端SDK（iOS/Android），本项目为服务端SDK +- **微信开放平台**（`weixin-java-open`）主要用于第三方平台，代公众号或小程序进行开发和管理 ---- + +--------------------------------- ### 最小示例
@@ -109,11 +183,12 @@ System.out.println(result.getOpenid());
---- - +--------------------------------- ### HTTP 客户端支持 -本项目支持多种 HTTP 客户端，默认推荐 **Apache HttpClient 5.x**。 +本项目同时支持多种 HTTP 客户端实现，默认推荐使用 **Apache HttpClient 5.x**（最新稳定版本）。 + +#### 支持的 HTTP 客户端类型 | HTTP 客户端 | 说明 | 配置值 | 推荐程度 | |------------|------|--------|---------| @@ -122,6 +197,10 @@ System.out.println(result.getOpenid()); | OkHttp | Square OkHttp 客户端 | `OkHttp` | ⭐⭐⭐ 可选 | | Jodd-http | Jodd 轻量级 HTTP 客户端 | `JoddHttp` | ⭐⭐ 可选 | +#### 配置方式 + +**Spring Boot 配置示例：** + ```properties # 使用 HttpClient 5.x（推荐，MP/MiniApp/CP/Channel/QiDian 模块默认） wx.mp.config-storage.http-client-type=HttpComponents @@ -136,98 +215,108 @@ wx.mp.config-storage.http-client-type=OkHttp wx.mp.config-storage.http-client-type=JoddHttp ``` -Multi-Starter（如 `wx-java-mp-multi-spring-boot-starter`）请使用大写下划线格式： - +**注意**：如果使用 Multi-Starter（如 `wx-java-mp-multi-spring-boot-starter`），枚举值需使用大写下划线格式： ```properties -wx.mp.config-storage.http-client-type=HTTP_COMPONENTS +# Multi-Starter 配置格式 +wx.mp.config-storage.http-client-type=HTTP_COMPONENTS # 注意使用大写下划线 ``` ---- - -### FAQ（提问前必读） -- 本项目是 SDK，不提供 Web 实现，建议直接通过 Maven/Gradle 引入并参考 [Demo](demo.md)。 -- 新手请先阅读 [开发文档 Wiki](https://github.com/binarywang/WxJava/wiki) / [Gitee Wiki](https://gitee.com/binary/weixin-java-tools/wikis/Home)。 -- 提问前建议先看 [提问的智慧](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/master/README-zh_CN.md)。 -- 贴长代码或异常日志建议使用 http://paste.ubuntu.com 。 - ---- +**注意事项：** +1. **MP、MiniApp、Channel、QiDian 模块**已完整支持 HttpClient 5.x，默认推荐使用 +2. **CP 模块**的支持情况取决于具体使用的 Starter 版本，请参考对应模块文档 +3. 如需使用 OkHttp 或 Jodd-http，需在项目中添加对应的依赖（scope为provided） +4. HttpClient 4.x 和 HttpClient 5.x 可以共存，按需配置即可 -### 社区与支持 -- 技术交流群：关注公众号 `WxJava`（或搜索 `weixin-java-tools`）后通过菜单获取最新加群方式。 -- 钉钉技术交流群：`32206329`（技术交流2群）、`30294972`（技术交流1群，已满）、`35724728`（通知群）。 -- 问题反馈与需求建议：请在 [Issues](https://github.com/binarywang/WxJava/issues) 提交。 ---- - -### 贡献方式 -- 提交 PR 前请先阅读 [代码贡献指南](CONTRIBUTING.md)。 -- 贡献源码可参考视频： - - [贡献源码全过程（上集）](https://mp.weixin.qq.com/s/3xUZSATWwHR_gZZm207h7Q) - - [贡献源码全过程（下集）](https://mp.weixin.qq.com/s/nyzJwVVoYSJ4hSbwyvTx9A) +--------------------------------- +### 版本说明 ---- +
+点此展开查看 + +1. 本项目定为大约每半年左右发布一次正式版，遇到重大问题需修复会及时提交新版本，欢迎大家随时提交 `Pull Request`； +2. 每次代码更新都会自动构建出新版本方便及时尝鲜，版本号格式为 `x.x.x-时间戳`; +3. 发布正式版时，`develop` 分支代码合并进入 `release` 分支），版本号格式为 `X.X.0`（如`2.1.0`，`2.2.0`等）； +4. 每隔一段时间后，会发布测试版本（如`3.6.8.B`，即尾号不为0，并添加B，以区别于正式版），代码仅存在于 `develop` 分支中； +5. 目前最新版本号为 [![Maven Central](https://img.shields.io/maven-central/v/com.github.binarywang/wx-java.svg)](http://mvnrepository.com/artifact/com.github.binarywang/wx-java) ，也可以通过访问以下链接分别查看各个模块最新的版本： +[【微信支付】](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-pay/versions) 、[【小程序】](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-miniapp/versions) 、[【公众号】](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-mp/versions) 、[【企业微信】](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-cp/versions)、[【开放平台】](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-open/versions)、[【视频号】](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-channel/versions) -### 版本说明 -1. 正式版通常约半年发布一次，重大问题会及时发版； -2. 日常更新会构建尝鲜版本（`x.x.x-时间戳`）； -3. 正式版发布时 `develop` 合并到 `release`，版本号一般为 `X.X.0`； -4. 测试版本（如 `3.6.8.B`）仅存在于 `develop` 分支； -5. 各模块版本： -[微信支付](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-pay/versions)、[小程序](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-miniapp/versions)、[公众号](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-mp/versions)、[企业微信](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-cp/versions)、[开放平台](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-open/versions)、[视频号](https://central.sonatype.com/artifact/com.github.binarywang/weixin-java-channel/versions) ---- +
+---------------------------------- ### 应用案例 -完整案例登记列表请见 [Issue #729](https://github.com/binarywang/WxJava/issues/729)。 +完整案例登记列表，请[【访问这里】](https://github.com/binarywang/WxJava/issues/729)查看，欢迎登记更多的案例。
-节选案例（点击展开） +以下为节选的部分案例， 点此展开查看 -#### 开源项目 +#### 开源项目： +- 基于微信公众号的签到、抽奖、发送弹幕程序：https://github.com/workcheng/weiya - Jeepay 支付系统：https://gitee.com/jeequan/jeepay +- 微同商城：https://gitee.com/fuyang_lipengjun/platform - 微信点餐系统：https://github.com/sqmax/springboot-project -- WePush：https://github.com/rememberber/WePush -- 基于若依开发的公众号管理系统：https://gitee.com/joolun/JooLun-wx +- 专注批量推送的小而美的工具：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 +- SAAS微信小程序电商：https://gitee.com/wei-it/weiit-saas - mall4j 电商商城系统：https://gitee.com/gz-yami/mall4j -#### 企业用户（节选） -- 中国电信上海网厅（公众号） -- HTC 企业微信 +#### 小程序： +- （京东）友家铺子，友家铺子店长版，京粉精选 +- [喵星人贴吧助手(扫码关注)](http://p98ahz3tg.bkt.clouddn.com/miniappqrcode.jpg) +- 树懒揽书+ +- 广廉快线，鹏城巴士等 +- 当燃挑战、sportlight轻灵运动 +- 360考试宝典 +- 民医台 +- 来一团商家版 +- 史必达（史丹利） +- 嘀嗒云印 +- 维沃吼吼 +- 王朝社区（比亚迪新能源社区） +- 极吼吼手机上门回收换新 +- 未来信封 +- 5G惠享 +- 生菜wordpress转小程序 +- 丽日购 + +#### 公众号： +- 中国电信上海网厅（sh_189） +- E答平台 +- 宁夏生鲜365 +- 通服货滴 +- 神龙养车 +- 沃音乐商务智能 +- 光环云社群 +- 手机排队 +- [全民约跑健身便利店](http://www.oneminsport.com/) +- 民医台 +- YshopMall +- 好行景区直通车以及全国40多个公众号 +- 我奥篮球公众号 +- 未来信封官微 +- 银川智云问诊 +- 5G惠享 + +#### 企业微信： +- HTC企业微信 +- 掌上史丹利 +- 药店益 + +#### 其他： +- 高善人力资源 +- 小猪餐餐 +- 餐饮系统 +- 微信公众号管理系统：http://demo.joolun.com - 锐捷网络：Saleslink
---- - -### 赞助与致谢 - -
- 特别赞助 - - - - - - - - -
- - ccflow - -
- - 计全支付Jeepay,开源支付系统 - - - - Mall4j - -
-
- +---------------------------------- ### 贡献者列表 -特别感谢参与贡献的所有同学，完整列表见 [contributors](https://github.com/binarywang/WxJava/graphs/contributors)。 +特别感谢参与贡献的所有同学，所有贡献者列表请在[此处](https://github.com/binarywang/WxJava/graphs/contributors)查看，欢迎大家继续踊跃贡献代码！