@wangyoumo/gis-manager

基于 CesiumJS 与 TypeScript 的 GIS 管理库：场景管理、图层管理、相机控制、CZML 支持（导入/导出/编辑），以及 Vue 3 适配器。

特性：
- ESM + CJS 输出，完整类型声明
- 场景（光照/阴影/初始视角/地形/影像）一站式配置
- 图层管理（DEM/DOM/DSM）、相机控制（透视/正交/飞行/路径）、CZML（导入/导出/编辑）
- Vue 3 组件 GisViewer 与组合式 API useGisViewer

注意：Cesium 静态资源（Assets/Widgets/ThirdParty）需要由你的应用托管，并正确配置 CESIUM_BASE_URL。

---

安装与依赖

你的应用需要安装：

``powershell
npm install @wangyoumo/gis-manager cesium
`

如果以本地联调（npm link）方式测试本库：

`powershell

在本库根目录

npm run build
npm link

在你的测试应用目录

npm link @wangyoumo/gis-manager cesium
npm install cesium --save
`

---

关键配置：CESIUM_BASE_URL 与静态资源

Cesium 在浏览器端需要访问静态资源目录（Assets、Widgets、ThirdParty）。请在你的应用里将这三个目录以某个公共路径对外提供，并调用库提供的配置函数：

`ts
import { configureCesiumAssets } from '@wangyoumo/gis-manager';

configureCesiumAssets({ baseUrl: '/cesium' });
// 你的服务器需确保以下路径可访问：
// /cesium/Assets/*
// /cesium/Widgets/*
// /cesium/ThirdParty/*
`

脚本

构建与测试：

`powershell
npm run build
npm test
`

---

故障排查

- 控制台警告 CESIUM_BASE_URL is not configured
- 调用 configureCesiumAssets({ baseUrl: '/cesium' })，并确保静态资源存在
- Widgets 样式未生效
- 确认 ` 已引入
- 影像瓦片 404 或跨域
- 检查影像服务 URL、跨域策略（CORS）、网络代理设置

---

许可证

MIT