| name | ohpm-publish |
| description | Use when user mentions "发布 SDK"、"ohpm 发布"、"打包发布"、"上传 har"、"publish"、"发版"、"release"、"发布" or "上传" in the context of this SDK |
ohpm-publish
Type: Technique | Discipline: Rigid
将 GrowingIO HarmonyOS SDK 打包并发布到 ohpm 仓库。
模块信息
| 模块名 | 包名 | oh-package.json5 | HAR 输出路径 |
|---|
| GrowingAnalytics | @growingio/analytics | GrowingAnalytics/oh-package.json5 | GrowingAnalytics/build/default/outputs/default/GrowingAnalytics-signed.har |
| GrowingToolsKit | @growingio/tools | GrowingToolsKit/oh-package.json5 | GrowingToolsKit/build/default/outputs/default/GrowingToolsKit-signed.har |
发布流程
按顺序执行以下步骤，每步完成后告知用户进展。
第一步：确认发布模块
询问用户要发布哪个（或哪些）模块：
@growingio/analytics（GrowingAnalytics）@growingio/tools（GrowingToolsKit）- 两个都发布
第二步：更新版本号
读取每个待发布模块的 oh-package.json5，显示当前 version 值，询问用户新版本号是多少。
确认后，直接编辑 oh-package.json5 将 version 字段更新为新版本。
第三步：检查签名配置
读取仓库根目录的 build-profile.json5，检查 app.signingConfigs 数组。
判断条件： 数组非空，且第一个元素的 material 对象包含 storeFile、keyAlias、profile、certpath 字段。
如果签名配置缺失或不完整，停止流程，提示：
⚠️ 缺少发布签名配置，请先在 build-profile.json5 的 app.signingConfigs 中配置以下字段：
storeFile、storePassword、keyAlias、keyPassword、signAlg、profile、certpath
配置完成后重新运行发布流程。
签名配置正常则继续。
第四步：构建 HAR 包
对每个待发布模块，在仓库根目录执行构建命令（告知用户正在构建，可能需要几分钟）：
GrowingAnalytics：
/Applications/DevEco-Studio.app/Contents/tools/node/bin/node \
/Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw.js \
--mode module \
-p product=default \
-p module=GrowingAnalytics@default \
-p buildMode=release \
assembleHar \
--analyze=normal --parallel --incremental --daemon
GrowingToolsKit：
/Applications/DevEco-Studio.app/Contents/tools/node/bin/node \
/Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw.js \
--mode module \
-p product=default \
-p module=GrowingToolsKit@default \
-p buildMode=release \
assembleHar \
--analyze=normal --parallel --incremental --daemon
构建完成后，确认 HAR 文件存在于对应的输出路径（见上方模块信息表）。
若文件不存在，报告构建失败并展示命令输出供排查，不继续发布。
第五步：发布到 ohpm
对每个构建好的模块，使用签名版本的 HAR 文件执行发布命令：
ohpm publish <HAR文件路径>
例如：
ohpm publish GrowingAnalytics/build/default/outputs/default/GrowingAnalytics-signed.har
ohpm publish GrowingToolsKit/build/default/outputs/default/GrowingToolsKit-signed.har
展示 ohpm 的输出结果，告知用户发布结果。
若提示未登录（you are not logged in），提示用户先执行 ohpm login 登录后重试。
注意事项
- 构建命令必须在仓库根目录执行
- 构建可能耗时数分钟，耐心等待即可
- 同时发布两个模块时，逐个处理：先构建第一个模块并发布，成功后再构建第二个模块并发布
Rationalizations
| Excuse | Reality |
|---|
| "版本号不用改也能 publish" | OHPM Registry 拒绝重复版本号；必须先 bump oh-package.json5 的 version |
| "跳过签名直接 publish" | 无签名产物会被 Registry 拒收，且无法在接入方设备上验证完整性 |
| "两个模块一起并行发布快一点" | 构建产物路径和签名状态会相互干扰，必须逐个完成 |
| "发了再测也没事，出问题再回滚" | OHPM Registry 发布后无法删除/覆盖同版本号；出错代价 = 升新版本号重发 |
| "本地跑过示例 App 就算验证通过" | verification-before-completion 要求 hypium 测试全绿 + 构建 HAR 成功；不可跳过 |
| "登录失败再说，先构建" | ohpm login 是前置条件，先确认登录态再走构建避免浪费时间 |
Red Flags — STOP if you catch yourself thinking these
- "版本号不改直接发" → OHPM Registry 拒绝重复版本号，先 bump version
- "签名那步跳过吧" → 无签名产物被 Registry 拒收，没有捷径
- "两个模块并行构建+发布更快" → 构建产物路径会冲突，必须逐个完成
- "发了再测" → OHPM 发布后无法删除同版本号，发错了只能升版本号重发
关联 skill
- 上游触发： 用户明确说"发布 SDK" / "ohpm 发布" / "发版" 等关键词
- 调度 subagent： 无（本 skill 是操作手册，由执行者按步骤执行）
- 完成后交接：
finishing-a-development-branch（发版分支的打 tag / PR / 合并） + jira-ticket（同步更新发版单）
- 替代路径： 预发布验证阶段 → 只构建 HAR 不 publish（验证构建链路）
