| name | update-sdk |
| description | 更新 jcore-react-native 插件的 JCore SDK 版本。自动拉取极光官网 Changelog,分析新增/移除/变更 API,更新 Android(Maven)和 iOS(CocoaPods)版本引用,同步更新 Native 层(Java/ObjC)和 Bridge 层(JS/TS)代码,展示变更摘要确认后发布到 npm。
Use when: 更新 JCore SDK、升级极光核心库版本、jcore-react-native 发布新版本、RN 插件 SDK 更新。
|
| allowed-tools | ["Bash","Read","Edit","Write","WebFetch"] |
你正在更新 jcore-react-native 插件。
用户参数: $ARGUMENTS
第一步:解析参数
从 $ARGUMENTS 中提取版本号:
--android X.X.X → Android JCore SDK 目标版本
--ios X.X.X → iOS JCore SDK 目标版本
--jpush-ref X.X.X → 查找 JCore API 变更所对应的 JPush 版本号(选填)
如果某端版本号缺失,先询问用户再继续。
关于 --jpush-ref: JCore 官网不单独发布更新日志,JCore 的 API 变更记录在 JPush 的更新日志里。若参数中未提供此值,询问用户:
JCore 的 API 变更记录在哪个 JPush 版本的更新日志中?请提供 JPush 版本号(如 4.9.0),或回复"跳过"以略过 Changelog 拉取步骤。
若用户回复"跳过",记录 jpush_ref = null,直接跳到第三步末尾说明。
第二步:安装依赖
pip3 install requests beautifulsoup4 -q 2>&1 | tail -1
第三步:拉取 SDK Changelog
JCore 的更新日志发布在 JPush 的 changelog 页面中,需以 JPush 版本号查找对应章节,再从中提取 JCore 相关变更。
若 jpush_ref 已提供(非 null),执行:
python3 .claude/skills/update-sdk/scripts/changelog_fetcher.py --android <JPUSH_REF> --ios <JPUSH_REF>
读取 .claude/skills/update-sdk/scripts/.changelog_cache.json 获取 Changelog 内容。
若 jpush_ref = null,跳过此步骤,第四步分析时无 changelog 可读,仅做版本号更新,跳过 API 变更分析。
第四步:AI 分析变更
基于 Changelog,分析并整理:
注意:Changelog 同时包含 JPush 和 JCore 的变更。只关注调用类以 JCore 开头的条目(如 JCoreInterface、JCoreManager 等),忽略类名以 JPush 开头的内容。
- 新增 API:同时存在于 Android 和 iOS 的功能 → 合并为一个插件统一 API;仅单端有的 → 先检查另一端是否已有等价实现(见下方说明),确认缺失才标注平台注释
- 移除/废弃 API:确认是否需要从插件中删除或标记
@deprecated
- 行为变更:影响现有封装逻辑的改动
- 新插件版本号:始终升 patch(如 3.4.9 → 3.5.0,3.9.9 → 4.0.0)
跨平台等价检查:当 Changelog 只在某一端出现新增 API 时,不要直接标为单端 Only。先读取另一端的 Native 文件(android/src/.../JCoreModule.java 或 ios/RCTJCoreModule/RCTJCoreModule.m)和 Bridge 层(index.js),搜索功能相同或名称相近的方法。如果另一端已有对应实现,则合并为统一 API;只有确认另一端完全没有等价功能时,才标注 Android Only / iOS Only。
输出结构化变更计划后再执行后续步骤。
第五步:更新版本号引用
python3 .claude/skills/update-sdk/scripts/plugin_updater.py \
--android <ANDROID_VERSION> \
--ios <IOS_VERSION> \
--bump-patch \
--changelog-summary "<ONE_LINE_SUMMARY>"
第六步:更新 Native 层代码
根据第四步的变更计划,编辑以下文件:
Android — android/src/main/java/cn/jiguang/plugins/core/JCoreModule.java
- 为每个新增 API 添加对应的
@ReactMethod 方法,内部调用 JCoreInterface.newMethod()
iOS — ios/RCTJCoreModule/RCTJCoreModule.m
- 为每个新增 API 添加对应的
RCT_EXPORT_METHOD 块
移除 API:若 SDK 已完全删除则移除封装方法,若仅废弃则保留并添加 @deprecated 注释。
第七步:更新 Bridge 层代码
JavaScript — index.js
- 为每个新增 API 添加对应的导出函数,内部调用
NativeModules.JCoreModule.newMethod()
TypeScript 类型 — index.d.ts
第八步:展示变更摘要并请求确认
展示如下格式的摘要,然后询问是否确认发布:
========== jcore-react-native 更新摘要 ==========
Android JCore SDK: 旧版本 → 新版本
iOS JCore SDK: 旧版本 → 新版本
插件版本: 旧版本 → 新版本
新增 API:
+ methodName(params) // 说明
移除 API:
- methodName()
行为变更:
! 变更说明
修改的文件:
- android/build.gradle
- JCoreRN.podspec
- android/src/.../JCoreModule.java
- ios/RCTJCoreModule/RCTJCoreModule.m
- index.js
- index.d.ts
- package.json
- CHANGELOG.md
==================================================
确认以上变更并发布到 npm? [y/N]
第九步:发布(确认后执行)
用户输入 y 后:
python3 .claude/skills/update-sdk/scripts/publisher.py