开始授权包接入
已经拿到 dingnl 交付的离线目录或 zip 时,用本页覆盖 npm 公开包。调用代码与公开包相同,只写 parse / create*Layer / addTo。公开包安装见 快速开始。
和公开包的差别
包名仍是 @dingnl/ltvis-globe,入口和方法不变。解析走 @dingnl/ltvis-globe/parse。
| 公开 npm 包 | 授权离线包 | |
|---|---|---|
| 图上水印 | 容器四边随机一边、沿边移动的一个 Ltvis / DINGNL 字标 | 无水印 |
| 控制台 | 版本、编译日期、版权声明、联系方式 | 授权 客户名 使用 x.y.z 版本,以及版权声明、联系方式 |
| 拿包方式 | pnpm add @dingnl/ltvis-globe | 用交付目录覆盖本包 |
| 调用 | parse / create*Layer / addTo | 相同 |
公开包没有关闭水印或控制台信息的接口。授权包也没有 setLicense 一类字段。
限期授权包未到期时与正式授权包相同(无水印、控制台写授权对象和有效期)。到期后图上恢复公开包水印,控制台仍写授权对象并标明已过期。需要续期时重新向 dingnl 申请。
覆盖安装
把交付的目录放到业务项目里(zip 先解压),用 file: 依赖替换 npm 上的同名包。
- 将目录放到项目
packages/ltvis-globe/(目录内应有package.json、index.mjs)。 - 在项目
package.json里写:
json
{
"dependencies": {
"@dingnl/ltvis-globe": "file:packages/ltvis-globe"
}
}- 删除
node_modules后重新安装:
bash
pnpm installnpm 用 npm install,yarn 用 yarn。装完后确认 node_modules/@dingnl/ltvis-globe/package.json 来自本地目录,而不是 registry。
用 file 依赖 安装。不要手写 Vite / webpack alias 指到目录里的单个文件。打包器应走 package.json 的 exports(index.mjs、parse.mjs、layer.mjs)。解析入口是 @dingnl/ltvis-globe/parse。
调用不用改
ts
import { parse } from '@dingnl/ltvis-globe/parse'
import { createRadarGridLayer } from '@dingnl/ltvis-globe/layer'
const parsed = await parse(buffer, {
format: 'rstm',
// 一次只出这一列
product: 'cr'
})
const layer = createRadarGridLayer({
// 解析出口
data: parsed.values,
// 画哪一列,与 parse 相同
product: 'cr',
// 雷达站心,投影原点
site: parsed.site
})
layer.addTo(globe)云图仍用 createCloudLayer,组网仍用 createMosaicLayer。字段与公开包相同,见 快速开始。
怎么确认接对了
| 现象 | 说明 |
|---|---|
| 图上没有 Ltvis / DINGNL 字标 | 已用上授权包 |
| F12 出现「授权 … 使用 … 版本」、版权声明、邮箱和 QQ | 控制台信息完整,须保留 |
| 图上仍有水印 | 仍在使用 npm 公开包,检查依赖是否被 registry 覆盖 |
使用限制
授权包仅限指定对象使用。不得转借、转售,不得改写版权信息后对外提供。须保留控制台版权信息。
尚未拿到离线包、或需要续期:邮件 1981261270@qq.com,或 QQ 1981261270,备注 ltvis-globe。