# deeptwins-cesium

> deeptwins-cesium

Latest version **0.1.6** (published 2026-07-21) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install deeptwins-cesium
pnpm add deeptwins-cesium
yarn add deeptwins-cesium
bun add deeptwins-cesium
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score; popular repo.

Warnings: low downloads; large bundle; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.1.6 |
| Published | 2026-07-21 |
| First published | 2025-04-22 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=22.0.0 |
| Dependencies | 2 |
| Unpacked size | 55.5 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 15853 |
| Maintainers | shenduzhilian |
| Keywords | 3D, webgl, geospatial, map, globe |

## Links

- npm: https://www.npmjs.com/package/deeptwins-cesium
- Repository: https://github.com/CesiumGS/cesium
- Homepage: http://cesium.com/cesiumjs/
- Issues: https://github.com/CesiumGS/cesium/issues
- npm.io page: https://npm.io/package/deeptwins-cesium

## Dependencies (2)

- [deeptwins-cesium-engine](https://npm.io/package/deeptwins-cesium-engine.md) 0.1.6
- [deeptwins-cesium-widgets](https://npm.io/package/deeptwins-cesium-widgets.md) 0.1.6

## Recent versions

- 0.1.6 (latest) — 2026-07-21
- 0.1.5 — 2026-07-10
- 0.1.4 — 2026-07-02
- 0.1.3 — 2026-07-01
- 0.1.2 — 2026-07-01
- 0.1.1 — 2026-07-01
- 0.1.0 — 2026-06-30
- 0.0.43 — 2026-06-30
- 0.0.42 — 2026-06-30
- 0.0.41 — 2026-06-30
- 0.0.40 — 2026-06-30
- 0.0.39 — 2026-06-30
- 0.0.38 — 2026-06-30
- 0.0.37 — 2026-06-30
- 0.0.36 — 2026-01-06
- … 32 more at https://npm.io/package/deeptwins-cesium/versions

## README

# deeptwins-CesiumJS

deeptwins CesiumJS fork。项目使用 npm workspaces 管理以下包：

- `deeptwins-cesium-engine`
- `deeptwins-cesium-widgets`
- `deeptwins-cesium`

## 环境要求

- Node.js `>=18.18.0`
- npm
- 可用的 npm registry 发布权限

安装依赖：

```sh
npm install
```

## 本地构建

开发构建：

```sh
npm run build
```

单独构建 workspace：

```sh
npm run build --workspace "deeptwins-cesium-engine"
npm run build --workspace "deeptwins-cesium-widgets"
```

生成 TypeScript 类型：

```sh
npm run build-ts
```

完整 release 构建：

```sh
npm run release
```

该命令会生成可发布产物，并同时生成类型和文档。

## 打包

生成 release zip：

```sh
npm run make-zip
```

产物位于仓库根目录，文件名格式为：

```text
Cesium-<version>.zip
```

发布 npm 前建议先用 `npm pack` 检查实际包内容：

```sh
npm pack -w "deeptwins-cesium-engine"
npm pack -w "deeptwins-cesium-widgets"
npm pack
```

检查生成的 `.tgz` 后再发布。确认无误后可以删除这些本地 `.tgz` 文件，避免误提交。

## 发布前检查

发布前至少执行：

```sh
npm run build
npm run build-ts
npm run test -- --failTaskOnError
```

如果要验证压缩后的 release 产物：

```sh
npm run make-zip
npm run test -- --failTaskOnError --release
```

如果本次变更涉及第三方依赖，更新许可清单：

```sh
npm run build-third-party
```

## 版本号

发布前需要同时检查三个 `package.json` 的版本和依赖关系：

- 根包：`package.json`
- engine：`packages/engine/package.json`
- widgets：`packages/widgets/package.json`

workspace 版本可以使用 npm version 更新，例如：

```sh
npm version patch -w "deeptwins-cesium-engine" --no-git-tag-version
npm version patch -w "deeptwins-cesium-widgets" --no-git-tag-version
```

根包版本需要同步更新：

```sh
npm version patch --no-git-tag-version
```

注意：如果 engine 版本变化，依赖 engine 的 widgets 和根包依赖版本也必须同步。

## npm 发布

发布顺序必须保持从底层依赖到上层包：

```sh
npm run build
npm run build-ts
npm publish -w "deeptwins-cesium-engine"
npm publish -w "deeptwins-cesium-widgets"
npm publish
```

如果发布到私有 registry，在命令中显式指定 registry：

```sh
npm publish -w "deeptwins-cesium-engine" --registry "<registry-url>"
npm publish -w "deeptwins-cesium-widgets" --registry "<registry-url>"
npm publish --registry "<registry-url>"
```

首次发布或 token 失效时，先登录：

```sh
npm login --registry "<registry-url>"
```

## 发布后验证

在一个干净项目中安装并验证：

```sh
npm install deeptwins-cesium
```

如果只使用 workspace 包，也分别验证：

```sh
npm install deeptwins-cesium-engine deeptwins-cesium-widgets
```

确认应用能正常导入：

```js
import * as Cesium from "deeptwins-cesium";
```

---
_Source: https://npm.io/package/deeptwins-cesium · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._