安装

插件作为开发依赖安装到 HarmonyOS 项目：

npm

npm install -D osslibraries-hvigor-plugin

pnpm

pnpm add -D osslibraries-hvigor-plugin

Yarn

yarn add -D osslibraries-hvigor-plugin

Bun

bun add -D osslibraries-hvigor-plugin

Deno

deno add --dev npm:osslibraries-hvigor-plugin

Vite+

vp add -D osslibraries-hvigor-plugin

vlt

vlt install -D osslibraries-hvigor-plugin

注册

打开输出目标模块的 hvigorfile.ts（通常是 entry），将插件加入 plugins 数组：

hvigorfile.ts

import { hapTasks } from "@ohos/hvigor-ohos-plugin";
import { ossScanPlugin } from "osslibraries-hvigor-plugin";

export default {
  system: hapTasks,
  plugins: [ossScanPlugin()],
};

注册后，插件会注册名为 ossScanLicenses 的任务；该任务经 postDependencies 排在模块的 CompileArkTS 之后、资源打包之前。每次构建，该任务扫描 oh_modules/，并将元数据写入 src/main/resources/rawfile/osslibraries.json。

验证

运行一次构建，在日志中查找插件的输出：

[osslibraries] scanning OHPM dependencies at /path/to/project
[osslibraries] wrote 128 libraries to .../rawfile/osslibraries.json (JSON)

文件会出现在模块的 rawfile 目录中。接下来安装 UI 包或核心包来渲染它，完整的接入步骤见快速上手。