@uavs/3d-model-map 0.1.0 → 0.1.1

package/README.md

@@ -32,38 +32,24 @@ pnpm config set @uavs:registry <registry-url>
 pnpm add @uavs/3d-model-map
 ```
 
-`@uavs/3d-model-map` 会把 `vue`、`mars3d`、`mars3d-cesium`、`@turf/turf` 作为 peer dependencies 使用。业务项目里已经有这些依赖时，不需要重复安装，只要版本兼容即可。
-
-如果某个接入项目缺少这些依赖，再按需补装：
-
-```bash
-pnpm add <缺失的包名>
-```
-
-### 推荐补装依赖
-
-如果接入项目缺少运行时 peer dependencies，推荐按下面的版本补装：
-
-```bash
-pnpm add mars3d@3.11.2 mars3d-cesium@1.140.0 @turf/turf@^7.3.5
-```
+`@uavs/3d-model-map` 会随包安装 `mars3d`、`mars3d-cesium`、`@turf/turf` 和 Cesium 静态资源复制插件。业务项目通常只需要自己已有的 `vue` 和 `vite`。
 
-Vue 项目通常已经安装了 `vue`；如果没有，再补装：
+如果业务项目还没有 Vue，再补装：
 
 ```bash
-pnpm add vue@^3.5.16
+pnpm add vue
 ```
 
-Vite 项目使用包内 `createCesiumStaticPlugins` 时，不需要单独安装 `vite-plugin-static-copy`，它会随 `@uavs/3d-model-map` 一起安装；宿主项目本身仍需要有 `vite`。
+Vite 项目使用包内 `createCesiumStaticPlugins` 时，不需要单独安装 `vite-plugin-static-copy`，也不需要单独安装 `mars3d`、`mars3d-cesium` 或 `@turf/turf`。
 
 ## Cesium 依赖
 
-组件会按下面的顺序使用 Cesium：
-
-1. 如果业务项目已经初始化了 `window.Cesium`，直接复用。
-2. 如果没有 `window.Cesium`，从 peer dependency `mars3d-cesium` 动态加载 Cesium 和 `Widgets/widgets.css`。
-
-接入项目只要本身已经依赖 `mars3d-cesium`，并且构建工具可以正常处理 `mars3d-cesium/Build/Cesium/Widgets/widgets.css` 即可。
+组件会按下面的顺序使用 Cesium：
+
+1. 如果业务项目已经初始化了 `window.Cesium`，直接复用。
+2. 如果没有 `window.Cesium`，从宿主应用的 `BASE_URL + lib/Cesium/Cesium.js` 加载 Cesium，并设置 `window.CESIUM_BASE_URL`。
+
+接入项目必须在 Vite 配置里调用 `createCesiumStaticPlugins()`，它会在开发环境提供 `/lib/Cesium/*` 静态资源，并在构建时把 Cesium 资源复制到产物的 `lib/Cesium` 目录。
 
 如果地图配置里用到了底图预览图片，也需要在业务项目里准备：
 
@@ -78,20 +64,17 @@ public/img/basemaps
 使用 Vite 的项目建议在 `vite.config.ts` 中加入 Cesium 静态资源插件、Mars3D Cesium shim 和依赖预构建排除：
 
 ```ts
-import { fileURLToPath, URL } from 'node:url'
 import { defineConfig, loadEnv } from 'vite'
 import vue from '@vitejs/plugin-vue'
 import { createCesiumStaticPlugins, createMapdataProxy } from '@uavs/3d-model-map/vite/cesium'
 
-const cesiumSource = fileURLToPath(new URL('./node_modules/mars3d-cesium/Build/Cesium', import.meta.url))
-
 export default defineConfig(({ mode }) => {
   const env = loadEnv(mode, import.meta.dirname)
 
   return {
     plugins: [
       vue(),
-      ...createCesiumStaticPlugins(cesiumSource)
+      ...createCesiumStaticPlugins()
     ],
     resolve: {
       alias: [
@@ -115,7 +98,7 @@ export default defineConfig(({ mode }) => {
 })
 ```
 
-如果项目的 `mars3d-cesium` 不在当前项目根目录的 `node_modules` 下，可以把 `cesiumSource` 改成实际路径，但必须指向 `mars3d-cesium/Build/Cesium`。
+`createCesiumStaticPlugins()` 默认会从 `@uavs/3d-model-map` 自己的依赖里解析 `mars3d-cesium/Build/Cesium`。如果项目确实需要指定自定义 Cesium 资源目录，也可以传入实际路径，但必须指向 `mars3d-cesium/Build/Cesium`。
 
 ## 基础用法
 
@@ -380,7 +363,7 @@ pnpm --filter @uavs/3d-model-map publish
 ## 接入项目检查清单
 
 - 已安装 `@uavs/3d-model-map`。
-- 业务项目已有并满足版本要求的 peer dependencies：`vue`、`mars3d@3.11.2`、`mars3d-cesium@1.140.0`、`@turf/turf@^7.3.5`。
+- 业务项目已有 Vue/Vite；`mars3d`、`mars3d-cesium`、`@turf/turf` 会随 `@uavs/3d-model-map` 安装。
 - 已导入 `@uavs/3d-model-map/style.css`。
 - Vite 项目已从 `@uavs/3d-model-map/vite/cesium` 接入 `createCesiumStaticPlugins`。
 - Vite 项目已把 `mars3d-cesium` alias 到 `@uavs/3d-model-map/runtime/mars3d-cesium-shim`。