@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。

安装与依赖

你的应用需要安装：

npm install @wangyoumo/gis-manager cesium

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

# 在本库根目录
npm run build
npm link

# 在你的测试应用目录
npm link @wangyoumo/gis-manager cesium
npm install cesium --save

关键配置：CESIUM_BASE_URL 与静态资源

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

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

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

脚本

构建与测试：

npm run build
npm test

故障排查

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

许可证

MIT