# Wxjava Upgrade Guide

规划 WxJava 的版本升级与迁移，检查 BOM、模块依赖、Java 版本、配置与公共 API...

- Repository: https://github.com/binarywang/WxJava (33174 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-24
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add binarywang/WxJava --skill wxjava-upgrade-guide -g -a claude-code -y`
Codex: `npx skills add binarywang/WxJava --skill wxjava-upgrade-guide -g -a codex -y`
Cursor: `npx skills add binarywang/WxJava --skill wxjava-upgrade-guide -g -a cursor -y`
Gemini CLI: `npx skills add binarywang/WxJava --skill wxjava-upgrade-guide -g -a gemini-cli -y`

## Description

规划 WxJava 的版本升级与迁移，检查 BOM、模块依赖、Java 版本、配置与公共 API 兼容性，并提供可回滚的验证步骤。适用于用户从旧版升级、切换依赖管理方式、处理兼容性告警或制定升级发布计划时。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# WxJava 升级迁移

1. 收集当前与目标版本、已用模块、JDK、框架、BOM 使用情况、依赖树、代理配置和关键调用路径。
2. 读取 [迁移检查表](references/migration.md)，识别版本、依赖和配置边界。
3. 按 HTTP 客户端、BOM、支付/回调、多账号、企业微信会话存档等变化类型选择迁移分支。
4. 输出分阶段变更：依赖调整、编译、关键回归测试、灰度与明确回滚条件。
5. 将不确定项标为待查，并引导查看目标版本的 release notes、README、Javadoc 与变更记录。

不要猜测废弃 API 或破坏性变更；以官方发布信息、当前代码与实际编译结果为准。默认保持 Java 8，除非目标版本明确改变此约束。不能以关闭验签、固定 token 或跳过测试作为回滚方案。