release 2.0.1

chore: 升级 GitHub Action 文件相关依赖版本
chore: 移除 package-lock.json，避免影响 GitHub Action CI 流程 (yarn)
2025-06-12 07:20:48 +08:00 · 2025-06-12 07:19:01 +08:00 · 2025-06-12 07:12:29 +08:00 · 2025-06-12 07:05:34 +08:00 · 2025-06-12 07:00:06 +08:00 · 2025-06-12 06:33:18 +08:00
11 changed files with 149 additions and 71 deletions
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -12,11 +12,11 @@ jobs:
    name: 'Build-Test'
    steps:
      - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
      - name: Use Node.js
-        uses: actions/setup-node@v2
+        uses: actions/setup-node@v4
        with:
-          node-version: '16'
+          node-version: '22'
      - name: Install Deps
        run: yarn install
      - name: Build
@@ -27,18 +27,18 @@ jobs:
    strategy:
      matrix:
        os: [ubuntu-latest]
-        node_version: ['16']
+        node_version: ['22']
        include:
          - os: macos-latest
-            node_version: 16
+            node_version: 22
          - os: windows-latest
-            node_version: 16
+            node_version: 22
    name: 'Demo-Build-Test: node-${{ matrix.node_version }}, ${{ matrix.os }}'
    steps:
      - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
      - name: Set node version to ${{ matrix.node_version }}
-        uses: actions/setup-node@v2
+        uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node_version }}
      - name: Package Install deps
--- a/.github/workflows/publish-to-npm.yml
+++ b/.github/workflows/publish-to-npm.yml
@@ -7,11 +7,11 @@ jobs:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
      - name: Setup Node
-        uses: actions/setup-node@v2
+        uses: actions/setup-node@v4
        with:
-          node-version: '16.x'
+          node-version: '22.x'
          registry-url: 'https://registry.npmjs.org'
      - name: Install dependencies and build
        run: npm install && npm run build
--- a/.gitignore
+++ b/.gitignore
@@ -4,3 +4,4 @@ dist
 demo/public
 yarn.lock
 pnpm-lock.yaml
+package-lock.json
--- a/.publish.md
+++ b/.publish.md
@@ -0,0 +1,8 @@
+## 发包步骤
+
+```sh
+nrm use npm
+npm adduser
+npm publish
+nrm use taobao
+```
--- a/2
+++ b/2
@@ -1,6 +1,6 @@
 MIT License

-Copyright (c) 2021 Nshen
+Copyright (c) 2025 coder-xiaomo, 2021 Nshen

 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
--- a/README.md
+++ b/README.md
@@ -1,3 +1,43 @@
+# ⚡ vite-plugin-cesium-next
+
+> 本仓库 fork 自 [nshen/vite-plugin-cesium](https://github.com/nshen/vite-plugin-cesium)
+
+本仓库在原仓库代码基础上，主要针对性修复/优化了以下问题
+- 相对路径问题：本仓库已支持在 vite.config.ts 中配置以下类型的 base: `'./'`, `'/'`, `'/foo/bar'`, `''`, `(不设置)` (新创建的项目 base 默认为 `'./'`，而原仓库针对 `'./'` 没有做很好的处理)
+- 资源请求路径：当 base 形如 `'/foo/bar'` 时，cesium 静态文件由 `/cesium...` 改为请求 `/foo/bar/cesium...`
+鉴于原仓库作者可能不再维护此项目(详见：[issue](https://github.com/nshen/vite-plugin-cesium/issues/62#issuecomment-2957419669))，故 fork 本仓库 ([coder-xiaomo/vite-plugin-cesium-next](https://github.com/coder-xiaomo/vite-plugin-cesium-next)) 继续维护，欢迎提交 Issue / Pr ！
+
+## Install
+
+```bash
+npm i cesium vite-plugin-cesium-text vite -D
+# yarn add cesium vite-plugin-cesium-text vite -D
+```
+
+## Usage
+
+add this plugin to `vite.config.js`
+
+```js
+import { defineConfig } from 'vite';
+import cesium from 'vite-plugin-cesium-next'; // 👈 添加这一行
+
+export default defineConfig({
+  plugins: [
+    // ...
+    cesium(), // 👈 添加这一行
+
+    // 或者如果你需要自定义配置，可以这样写 👇
+    // cesium({ /* 这里可以添加配置 */ }),
+  ]
+});
+```
+
+
+---
+
+以下是原仓库 README
+
 # ⚡ vite-plugin-cesium

 [![npm](https://img.shields.io/npm/v/vite-plugin-cesium.svg)](https://www.npmjs.com/package/vite-plugin-cesium)
--- a/demo/index.html
+++ b/demo/index.html
@@ -1,14 +1,16 @@
 <!DOCTYPE html>
 <html lang="en">
-  <head>
+
+<head>
  <meta charset="UTF-8" />
  <meta http-equiv="X-UA-Compatible" content="IE=edge" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>cesium-vite</title>
  <script type="module" src="/src/index.ts"></script>
-  </head>
+</head>

-  <body>
+<body>
  <div id="cesiumContainer"></div>
-  </body>
+</body>
+
 </html>
--- a/demo/package.json
+++ b/demo/package.json
@@ -9,8 +9,8 @@
    "serve": "vite build && vite preview"
  },
  "devDependencies": {
-    "cesium": "1.96.0",
-    "vite": "3.0.4",
-    "vite-plugin-cesium": "link:.."
+    "cesium": "1.129.0",
+    "vite": "file:../node_modules/vite",
+    "vite-plugin-cesium-next": "file:.."
  }
 }
--- a/demo/vite.config.ts
+++ b/demo/vite.config.ts
@@ -1,6 +1,12 @@
 import { defineConfig } from 'vite';
-import cesium from 'vite-plugin-cesium';
+import cesium from 'vite-plugin-cesium-next';

 export default defineConfig({
-  plugins: [cesium()]
+  // base: './',
+  // base: '/',
+  base: '/foo/bar',
+
+  plugins: [
+    cesium(),
+  ],
 });
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
-  "name": "vite-plugin-cesium",
-  "version": "1.2.23",
+  "name": "vite-plugin-cesium-next",
+  "version": "2.0.1",
  "description": "Cesium library plugin for Vite",
  "main": "./dist/index.js",
  "module": "./dist/index.mjs",
@@ -25,29 +25,32 @@
    "vite-plugin",
    "cesium"
  ],
-  "author": "nshen <nshen121@gmail.com>",
+  "author": "coderxiaomo <codingzhang@126.com>",
+  "contributors": [
+    "nshen <nshen121@gmail.com>"
+  ],
  "license": "MIT",
  "repository": {
    "type": "git",
-    "url": "git+https://github.com/nshen/vite-plugin-cesium"
+    "url": "git+https://github.com/coder-xiaomo/vite-plugin-cesium-next"
  },
  "bugs": {
-    "url": "https://github.com/nshen/vite-plugin-cesium/issues"
+    "url": "https://github.com/coder-xiaomo/vite-plugin-cesium-next/issues"
  },
  "dependencies": {
-    "fs-extra": "^9.1.0",
+    "fs-extra": "^11.3.0",
    "rollup-plugin-external-globals": "^0.6.1",
-    "serve-static": "^1.14.1"
+    "serve-static": "^1.16.2"
  },
  "devDependencies": {
-    "@tsconfig/node12": "^1.0.7",
-    "@types/fs-extra": "^9.0.8",
-    "@types/node": "^14.14.31",
-    "@types/serve-static": "^1.13.9",
-    "prettier": "^2.2.1",
-    "tsup": "^6.2.1",
-    "typescript": "^4.2.2",
-    "vite": "^3.0.4"
+    "@tsconfig/node22": "^22.0.2",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.15.31",
+    "@types/serve-static": "^1.15.8",
+    "prettier": "^3.5.3",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
+    "vite": "^6.1.0"
  },
  "peerDependencies": {
    "cesium": "^1.95.0",
--- a/src/index.ts
+++ b/src/index.ts
@@ -13,6 +13,7 @@ interface VitePluginCesiumOptions {
  cesiumBuildRootPath?: string;
  cesiumBuildPath?: string;
  cesiumBaseUrl?: string;
+  viteBase?: string;
 }

 export default function vitePluginCesium(options: VitePluginCesiumOptions = {}): Plugin {
@@ -21,35 +22,52 @@ export default function vitePluginCesium(options: VitePluginCesiumOptions = {}):
    devMinifyCesium = false,
    cesiumBuildRootPath = 'node_modules/cesium/Build',
    cesiumBuildPath = 'node_modules/cesium/Build/Cesium/',
-    cesiumBaseUrl = 'cesium/'
+    cesiumBaseUrl = 'cesium/',
+    viteBase = undefined,
  } = options;

-  let CESIUM_BASE_URL = cesiumBaseUrl;
-  if (!CESIUM_BASE_URL.endsWith('/')) {
-    CESIUM_BASE_URL += '/';
+  const CESIUM_BASE_URL = cesiumBaseUrl.endsWith('/')
+    ? cesiumBaseUrl
+    : (cesiumBaseUrl + '/');
+
+  const globalVars: {
+    outDir: string,
+    base: string,
+    isBuild: boolean,
+    cesiumRelativeUrl: string,
+  } = {
+    outDir: 'dist',
+    base: '/',
+    isBuild: false,
+    cesiumRelativeUrl: '',
  }
-  let outDir = 'dist';
-  let base: string = '/';
-  let isBuild: boolean = false;

  return {
-    name: 'vite-plugin-cesium',
+    name: 'vite-plugin-cesium-next',

    config(c, { command }) {
-      isBuild = command === 'build';
-      if (c.base !== undefined) {
-        base = c.base;
-        if (base === '') base = './';
+      // 项目中 vite.config.ts 配置的 base 路径
+      if (viteBase) {
+        globalVars.base = viteBase;
+      } else if (c.base) {
+        globalVars.base = c.base;
+      } else {
+        globalVars.base = '/';
      }
+      // 是否是打包命令
+      globalVars.isBuild = command === 'build';
+      // 输出路径
      if (c.build?.outDir) {
-        outDir = c.build.outDir;
+        globalVars.outDir = c.build.outDir;
      }
-      CESIUM_BASE_URL = path.posix.join(base, CESIUM_BASE_URL);
+      // 项目浏览器中运行时，Cesium 资源的相对路径
+      globalVars.cesiumRelativeUrl = path.posix.join(globalVars.base, CESIUM_BASE_URL);
+
      const userConfig: UserConfig = {};
-      if (!isBuild) {
+      if (!globalVars.isBuild) {
        // -----------dev-----------
        userConfig.define = {
-          CESIUM_BASE_URL: JSON.stringify(CESIUM_BASE_URL)
+          CESIUM_BASE_URL: JSON.stringify(globalVars.cesiumRelativeUrl)
        };
      } else {
        // -----------build------------
@@ -60,7 +78,7 @@ export default function vitePluginCesium(options: VitePluginCesiumOptions = {}):
            chunkSizeWarningLimit: 5000,
            rollupOptions: {
              output: {
-                intro: `window.CESIUM_BASE_URL = ${JSON.stringify(CESIUM_BASE_URL)};`
+                intro: `window.CESIUM_BASE_URL = ${JSON.stringify(globalVars.cesiumRelativeUrl)};`
              }
            }
          };
@@ -79,7 +97,7 @@ export default function vitePluginCesium(options: VitePluginCesiumOptions = {}):

    configureServer({ middlewares }) {
      const cesiumPath = path.join(cesiumBuildRootPath, devMinifyCesium ? 'Cesium' : 'CesiumUnminified');
-      middlewares.use(path.posix.join('/', CESIUM_BASE_URL), serveStatic(cesiumPath, {
+      middlewares.use(path.posix.join('/', globalVars.cesiumRelativeUrl), serveStatic(cesiumPath, {
        setHeaders: (res, path, stat) => {
          res.setHeader('Access-Control-Allow-Origin', '*')
        }
@@ -87,14 +105,14 @@ export default function vitePluginCesium(options: VitePluginCesiumOptions = {}):
    },

    async closeBundle() {
-      if (isBuild) {
+      if (globalVars.isBuild) {
        try {
-          await fs.copy(path.join(cesiumBuildPath, 'Assets'), path.join(outDir, CESIUM_BASE_URL, 'Assets'));
-          await fs.copy(path.join(cesiumBuildPath, 'ThirdParty'), path.join(outDir, CESIUM_BASE_URL, 'ThirdParty'));
-          await fs.copy(path.join(cesiumBuildPath, 'Workers'), path.join(outDir, CESIUM_BASE_URL, 'Workers'));
-          await fs.copy(path.join(cesiumBuildPath, 'Widgets'), path.join(outDir, CESIUM_BASE_URL, 'Widgets'));
+          await fs.copy(path.join(cesiumBuildPath, 'Assets'), path.join(globalVars.outDir, CESIUM_BASE_URL, 'Assets'));
+          await fs.copy(path.join(cesiumBuildPath, 'ThirdParty'), path.join(globalVars.outDir, CESIUM_BASE_URL, 'ThirdParty'));
+          await fs.copy(path.join(cesiumBuildPath, 'Workers'), path.join(globalVars.outDir, CESIUM_BASE_URL, 'Workers'));
+          await fs.copy(path.join(cesiumBuildPath, 'Widgets'), path.join(globalVars.outDir, CESIUM_BASE_URL, 'Widgets'));
          if (!rebuildCesium) {
-            await fs.copy(path.join(cesiumBuildPath, 'Cesium.js'), path.join(outDir, CESIUM_BASE_URL, 'Cesium.js'));
+            await fs.copy(path.join(cesiumBuildPath, 'Cesium.js'), path.join(globalVars.outDir, CESIUM_BASE_URL, 'Cesium.js'));
          }
        } catch (err) {
          console.error('copy failed', err);
@@ -108,15 +126,15 @@ export default function vitePluginCesium(options: VitePluginCesiumOptions = {}):
          tag: 'link',
          attrs: {
            rel: 'stylesheet',
-            href: normalizePath(path.join(CESIUM_BASE_URL, 'Widgets/widgets.css')),
+            href: normalizePath(path.join(globalVars.cesiumRelativeUrl, 'Widgets/widgets.css')),
          }
        }
      ];
-      if (isBuild && !rebuildCesium) {
+      if (globalVars.isBuild && !rebuildCesium) {
        tags.push({
          tag: 'script',
          attrs: {
-            src: normalizePath(path.join(CESIUM_BASE_URL, 'Cesium.js')),
+            src: normalizePath(path.join(globalVars.cesiumRelativeUrl, 'Cesium.js')),
          }
        });
      }
Author	SHA1	Message	Date
小墨	52c6655b7a	release 2.0.1	2025-06-12 07:20:48 +08:00
小墨	266517ac08	chore: 升级 GitHub Action 文件相关依赖版本	2025-06-12 07:19:01 +08:00
小墨	d32625d649	chore: 移除 package-lock.json，避免影响 GitHub Action CI 流程 (yarn)	2025-06-12 07:12:29 +08:00
小墨	e915298dfc	chore: update LICENSE copyright year	2025-06-12 07:05:34 +08:00
小墨	a8d9479375	chore: demo 项目跑通	2025-06-12 07:00:06 +08:00
小墨	3c8bad430b	升级依赖版本	2025-06-12 06:33:18 +08:00
小墨	564a6ece40	提交 package-lock.json 文件	2025-06-12 06:14:32 +08:00
小墨	436466b519	README 中更新使用指南	2025-06-12 06:12:51 +08:00
小墨	352ba1eba5	vite-plugin-cesium 更名为 vite-plugin-cesium-next，为发布做准备	2025-06-12 06:07:48 +08:00
小墨	08e0da60dd	当 base 配置为 /foo/bar 格式时，cesium 资源路径改为 /foo/bar/cesium	2025-06-12 05:57:04 +08:00
小墨	50b3f7d545	修复 Cesium 引入相对路径问题	2025-06-12 05:56:48 +08:00