写好 oh-package.json5：包名、版本、入口与依赖一次对齐

专栏：HarmonyOS 三方库适配实战（14/30） 核心问题：哪些包描述字段会直接影响消费者，怎样避免“源码没问题，包却装不上或导不进来”？

摘要

oh-package.json5 不是发布时才补的说明文件，它决定包名、版本、入口和运行依赖。本文逐项检查教学 HAR 的 name、version、main、license 和 dependencies，并把字段错误映射到可观察故障。当前配置已用于真实 HAR/HAP 构建；远程仓库发布没有执行。

当前最小配置

{
\”name\”: \”@demo/text-tool\”,
\”version\”: \”1.0.0\”,
\”description\”: \”Local teaching HAR for the HarmonyOS third-party adaptation series.\”,
\”main\”: \”Index.ets\”,
\”author\”: \”local-reproduction\”,
\”license\”: \”Apache-2.0\”,
\”dependencies\”: {}
}

图 1：每个关键字段都能映射到安装、导入、合规或运行故障。

name：消费方真正写下的标识

name 应稳定、全局可区分，并与示例代码中的导入完全一致：