vue3+cesium项目搭建

本文介绍了如何在Vue3项目中搭建Cesium环境,包括选用Cesium的特定版本避免冲突,配置vue.config.js,以及在组件中创建球体的示例代码。在过程中提到了cesiumWorkers、Assets、Widgets、ThirdParty等关键路径的复制,并强调了CesiumBaseURL的设置和Viewer的初始化需要Ion访问令牌。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

前言

最近需要在一个Vue3的项目中使用到cesium,对于一个cesium没有太多了解的人来说,还是比较麻烦的,本篇博文就将自己在这个过程踩的坑记录下来,有需要的可以看一下

1、vue+cesium框架搭建

2、项目运行起来后,球体不出现,只出现星空

持续ing…

一、vue3+Cesium 项目搭建

1、初始化vue3项目框架 vue create project-name
这是最基础的一步,首先我们需要先生成一个vue3框架,这里我采用的是 vue create project-name ,并且选择了vue3-simple模式,这里并没有选择其他太复杂的东西,如果有其他需求,可以自定义加载router、vuex、less、等其他插件。
2、配置cesium

  • 项目初始化完成之后,下面我们执行 npm run serve这个命令,确保项目能够正常启动
  • 接下来 执行 npm install cesium 命令,这个时候敲重点,很多人执行后,就出现问题了,当时我也是遇到了问题,初始化之后,项目一直报错,原因是因为cesium的版本如果太高的,webpack 或者其他相关依赖就有可能起冲突
    我这里用的cesium版本是 ^1.83.0,如果想要指定版本下载cesium的话,可以运行 npm install -S cesium@1.83.0这个命令
  • 安装好cesium之后,我们需要打开 vue.config.js这个文件,进行相关配置
const { defineConfig } = require("@vue/cli-service");

const CopyWebpackPlugin = require("copy-webpack-plugin");
const webpack = require("webpack");
const path = require("path");

let cesiumSource = "./node_modules/cesium/Source/";
const cesiumWorkers = "../Build/Cesium/Workers";

module.exports = defineConfig({
  transpileDependencies: true,
  publicPath: "./",
  outputDir: "dist", // 输出文件目录
  lintOnSave: false, // eslint 是否在保存时检查 关闭语法检查

  configureWebpack: {
    output: {
      sourcePrefix: " ",
    },
    amd: {
      toUrlUndefined: true,
    },
    resolve: {
      alias: {
        "@": path.resolve("src"),
        cesium: path.resolve(__dirname, "./node_modules/cesium/"),
      },
      fallback: { https: false, zlib: false, http: false, url: false },
    },
    plugins: [
      new CopyWebpackPlugin({
        patterns: [
          { from: path.join(cesiumSource, cesiumWorkers), to: "Workers" },
          { from: path.join(cesiumSource, "Assets"), to: "Assets" },
          { from: path.join(cesiumSource, "Widgets"), to: "Widgets" },
          { from: path.join(cesiumSource, "ThirdParty"), to: "ThirdParty" },
        ],
      }),
      new webpack.DefinePlugin({
        CESIUM_BASE_URL: JSON.stringify("./"),
      }),
    ],
    module: {
      rules: [
        {
          test: /\.js$/,
          use: {
            loader: "@open-wc/webpack-import-meta-loader",
          },
        },
        {
          test: /\.(glb|gltf)?$/,
          use: {
            loader: "url-loader",
          },
        },
      ],
    },
  },
});
  • 在node_modules中找到这几个文件夹拉到这个文件夹下
    在这里插入图片描述
  • 打开index.html文件夹,在header中引入这段代码
<link href="<%= BASE_URL %>Cesium/Widgets/widgets.css" rel="stylesheet" />
<script src="<%= BASE_URL %>Cesium/Cesium.js"></script>

好了,现在不出意外的话,你的Vue3项目已经初始化好cesium了,你可以尽情的在你的项目中使用它了

二、使用cesium简单生成一个球体

在生成球体之前,你可以将项目初始化的一些样式还有图片链接直接删除掉

  • 打开 HelloWord.vue这个文件,这个文件中我们就可以编写我们想要的一些效果了
<template>
  <div id="CesiumContainer"></div>
</template>
<script setup>
import { onMounted, ref } from "vue";
import * as Cesium from "cesium";

Cesium.Ion.defaultAccessToken ="xxxxxxxxxxxxxxx"
const viewer = new Cesium.Viewer("CesiumContainer", {
    geocoder: false,
    homeButton: false,
    sceneModePicker: false,
    baseLayerPicker: false,
    navigationHelpButton: false,
    animation: false,
    timeline: false,
    fullscreenButton: false,
  });
</script>

这里我们看到我们插入了一个token,如果不插入这个token的话,页面只会在展示一个蓝色的空白地球
token的获取方法 申请令牌,这样我们就可以看到一个有内容的球了

### 使用Vue 3、Vite 和 Cesium 创建项目 创建基于 Vue 3项目并集成 Cesium 可以通过 Vite 来加速开发流程。以下是具体实现方法: #### 安装依赖项 首先安装 Node.js 环境,确保版本不低于 v14.0.0。接着初始化一个新的 npm 项目,并利用 `vite` 构建工具来快速启动应用。 ```bash npm init vite@latest my-vue-app --template vue cd my-vue-app npm install cesium @vue/runtime-dom ``` 此命令会建立一个名为 `my-vue-app` 的新文件夹,在其中包含了由 Vite 初始化的基础配置以及所需的包[^1]。 #### 配置Cesium 为了使 Cesium 正常工作于 Webpack 或者 Rollup 打包环境中,需调整构建设置以便支持其特殊需求。对于 Vite 而言,则要修改项目的根目录下的 `vite.config.ts` 文件加入如下内容: ```typescript import { defineConfig } from &#39;vite&#39; import vue from &#39;@vitejs/plugin-vue&#39; export default defineConfig({ plugins: [ vue(), ], resolve: { alias: { "cesium": "/node_modules/cesium/Source" } }, }) ``` 这段代码定义了一个别名映射关系,使得后续可以更方便地引入 Cesium 库中的模块[^2]。 #### 编写组件 在 src/components 下新建一个叫做 HelloWorld.vue 组件用于展示地球视图。编辑该文件添加下面所示的模板结构和脚本逻辑: ```html <template> <div id="cesiumContainer"></div> </template> <script setup lang="ts"> import * as Cesium from &#39;cesium&#39;; import &#39;cesium/Build/Cesium/Widgets/widgets.css&#39;; onMounted(() => { const viewer = new Cesium.Viewer(&#39;cesiumContainer&#39;, { terrainProvider : new Cesium.CesiumTerrainProvider({ url : &#39;https://assets.agi.com/stk-terrain/world&#39; }) }); }); </script> <style scoped> #csmViewerDiv{ height:80vh; width:95vw; } </style> ``` 上述代码片段实现了当页面加载完成后自动渲染三维球体的效果,并设置了地形提供者的 URL 地址指向 AGI 提供的服务接口[^3]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值