开始授权包接入
已经拿到 dingnl 交付的离线目录或 zip 时,用本页覆盖 npm 公开包。调用代码与公开包相同,只写 Metobs.*.init / setOption。公开包安装见 快速开始。
和公开包的差别
包名仍是 @dingnl/metobs-chart,入口和方法不变。公开包地址:https://www.npmjs.com/package/@dingnl/metobs-chart。
| 公开 npm 包 | 授权离线包 | |
|---|---|---|
| 图上水印 | 铺满倾斜的 Metobs / DINGNL 字标 | 无水印 |
| 控制台 | 版本、编译日期、版权声明、联系方式 | 授权 客户名 使用 x.y.z 版本,以及版权声明、联系方式 |
| 拿包方式 | pnpm add @dingnl/metobs-chart | 用交付目录覆盖本包 |
| 调用 | Metobs.*.init / setOption | 相同 |
公开包没有关闭水印或控制台信息的接口。授权包也没有 setLicense 一类字段。
限期授权包未到期时与正式授权包相同(无水印、控制台写授权对象和有效期)。到期后图上恢复公开包水印,控制台仍写授权对象并标明已过期。需要续期时重新向 dingnl 申请。
覆盖安装
把交付的目录放到业务项目里(zip 先解压),用 file: 依赖替换 npm 上的同名包。
- 将目录放到项目
packages/metobs-chart/(目录内应有package.json、index.mjs,没有guard.mjs)。 - 在项目
package.json里写:
json
{
"dependencies": {
"@dingnl/metobs-chart": "file:packages/metobs-chart"
}
}- 删除
node_modules后重新安装:
bash
pnpm installnpm 用 npm install,yarn 用 yarn。装完后确认 node_modules/@dingnl/metobs-chart/package.json 来自本地目录,而不是 registry。
用 file 依赖 安装。不要手写 Vite / webpack alias 指到目录里的 index.js:那是浏览器 IIFE,没有 Metobs 命名导出。打包器应走 package.json 的 exports.import(index.mjs)。
调用不用改
ts
import { Metobs } from '@dingnl/metobs-chart'
const el = document.getElementById('chart')
const chart = Metobs.Lidar.init(el)
chart.setOption({
product: 'rcs',
title: { text: '距离修正后的回波信号(532, a.u.)' },
data: { values: records }
})标题、轴、图例等 option 与公开包相同,见 基础配置。
怎么确认接对了
| 现象 | 说明 |
|---|---|
| 图上没有 Metobs / DINGNL 字标 | 已用上授权包 |
| F12 出现「授权 … 使用 … 版本」、版权声明、邮箱和 QQ | 控制台信息完整,须保留 |
| 图上仍有水印 | 仍在使用 npm 公开包,检查依赖是否被 registry 覆盖 |
使用限制
授权包仅限指定对象使用。不得转借、转售,不得改写版权信息后对外提供。须保留控制台版权信息。
尚未拿到离线包、或需要续期:邮件 1981261270@qq.com,或 QQ 1981261270,备注 metobs-chart。