Skip to content

v0.4.0 官方工具链 + 版本化知识层

Choose a tag to compare

View all tags
@1na-ko 1na-ko released this 13 Aug 20:05
· 23 commits to main since this release
v0.4.0
d4fb10a

v0.4.0 — 官方工具链通道 + 官方优先版本化知识层

DSH 社区鸿蒙开发助手大版本：把华为官方 DevEco CLI 接为构建/签名/lint/文档通道，并用本机 SDK .d.ts 建立按 API 版本分类的知识层。

新增 / Highlights

  • 18 个工具（12 个 hdc 设备工具 + 6 个 hms_* 工具）
    • hms_setup：环境体检 —— hdc / DevEco Studio / SDK / devecocli / 设备五项 + 目标 API 版本三源解析（项目→设备→SDK）与不一致告警
    • hms_build：官方构建/签名/运行通道（devecocli，含 auth 引导）；CLI 缺失时自动回退本机 hvigorw + hdc 装包启动闭环
    • hms_api：官方优先版本化 API 知识 —— 解析本机 SDK .d.ts（@since/@deprecated/@syscap），按目标 API 版本分类可用/已废弃/不可用
    • hms_docs：官方本地文档检索（开发指南 / API参考 / 最佳实践 / FAQ / 版本说明 / 变更预告）
    • hms_api_change：官方跨版本破坏性 API 变更扫描（devecocli check compat）
    • hms_lint：官方 lint —— 57+ 条本机 codelinter 规则速查 + devecocli check lint
  • 3 个运行时技能：hdc-bridge（设备闭环）、deveco-cli（官方 SKILL.md 改写，MIT 声明保留）、harmonyos-knowledge（官方优先 / 版本纪律 / 许可纪律）
  • 依赖随装：@deveco/deveco-cli（MIT）作为 optionalDependency 随插件自动安装，失败容忍
  • 许可合规：THIRD_PARTY_NOTICES.md + license-check 门禁；SDK .d.ts 与 codelinter 规则仅本机读取、零再分发

实测 / Verified

真实 dsh plugin 安装 + 无头 DSH 实例逐工具 E2E：

  • 设备闭环（真机 API 24 + 模拟器 API 23）回归通过
  • 官方 lint 实测 62 文件 178 条检查
  • 真实 devecocli 构建 BUILD SUCCESSFUL（含签名）
  • 测试中发现并修复 4 个实际问题：PowerShell 调用符、Studio 路径注入、技能 source 字段、devecocli 退出码不可靠

环境要求 / Requirements

  • 设备工具：本机 hdc（DevEco Studio 自带，或 PATH 可用）
  • devecocli 构建/签名/lint：DevEco Studio ≥ 6.1.0（macOS/Windows、Node ≥ 18）；签名需一次人工 devecocli auth login（浏览器 OAuth）
  • hms_api_change（check compat）需更高版本 DevEco Studio（实测 ≥ 26.0.0），版本不足时工具返回官方错误与升级指引
  • build/run/sign 官方标注 [Outside sandbox]，受限沙箱会话需放宽策略或人工执行

安装 / Install

dsh plugin --profile <name> add dsh-hdc-bridge
Assets 2
Loading