纯新手如何安装 Vue 以及引入 SuperMap iClient3D for WebGL 包

作者：jjz

  本文介绍了初次接触Vue时详细的安装和配置方法，对于 Vue2 和 Vue3 均有详细说明。第一部分内容涉及配置 NodeJS、下载速度更快的淘宝镜像 npm、安装 Vue 和 Vue-Cli。第二部分则介绍了在 Vue 项目中引入 SuperMap iClient3D for WebGL，并给出示例代码，如何加载出三维球。文末提供实用连接，请务必参考。

Vue 安装

安装 NodeJS

1. 官网下载 NodeJS

NodeJS 官网链接
推荐最新稳定版（左侧），安装时目录从C改成其他非系统盘。

2. 安装 msi 文件

命令行 (cmd) 输入 node -v 验证是否安装成功。

检查 NPM 版本

3. 查看 npm 版本

npm -v 验证 npm 版本高于3。

4. 查看 npm 本地目录

npm list –global

发现在C盘，需要挪回D盘。首先在nodejs安装目录新建两个文件夹 node_global 和 node_cache。然后将 nodejs 安装目录的“完全控制”权限给当前 user，不然下一步会报错 ERR! Error: EPERM: operation not permitted，具体操作请参考这篇百度经验的1 - 6步 。然后 cmd 以下两句将本地目录挪到 D 盘，需要替换为自己的目录。

npm config set prefix  "D:\Program Files\nodejs\node_global"
npm config set cache  "D:\Program Files\nodejs\node_cache"  

重新检查下npm本地目录，发现目录已经改变。

5. 淘宝镜像 NPM

国内访问 npm 下载慢，用淘宝镜像解决这一问题。

npm install -g cnpm --registry=https://registry.npm.taobao.org
npm config list #检查是否安装成功。
npm config get registry #检查是否正确设置镜像站，应返回 https://registry.npmjs.org/

获取并安装 Vue

6. 检查是否能正确获取 Vue 信息

npm info vue 返回类似 [email protected] | MIT | deps: none | versions: 309 等为正常，ERR .... 则需为文件夹设置用户权限。

7. 检查 PATH 并新增 NODE_PATH

检查系统环境变量中有nodejs的安装目录；加入 node_global 路径。在环境中新建NODE_PATH，路径为 node_global/node_modules 所在目录。

8. 安装 Vue 和 Vue-cli

# vue 3 安装
cnpm install vue@next
# vue-cli 安装
cnpm install vue -global
cnpm install -g @vue/cli #（最新版安装方法）
vue -V #（大写）安装完毕后测试查看是否安装成功

创建 Vue 项目

9. 创建新的 Vue 项目

首先 cmd 切到项目所在盘，如E盘，然后创建文件夹并 cd 到该文件夹。

1. vue-cli 2.0版本创建项目
   vue init webpack testVueApp
   提示要先执行 cnpm i -g @vue/cli-init

2. vue-cli 4.0版本创建项目
   vue create test_app （项目名称不能有大写）
   完成后执行新项目创建，会自动安装 package.json 中的依赖，如果项目目录下没有 node_modules 就手动运行 cnpm install 即可。

WebGL 包引入

配置 WebGL 环境

1. 加入 Cesium 环境

将 SuperMap iClient3D for WebGL 包中的 Cesium 放到 Vue 项目的 static (Vue 2.0) 或者public (Vue 3.0) 目录下。

2. 参考 Vue 官网开始开发

Vue 官网 API

加载三维球

3. Vue2 加载三维球

请参考Vue开发环境配置入门或者动态引入资源。

4. Vue3 Composition API 加载球

// Composition API: https://vue3js.cn/vue-composition-api/
import { onMounted } from "vue";
// 页面上其他组件引入，加载球不需要
import setup from "../Locations";

export default {
 name: "CesiumViewer",
 components: { "comp-setup": setup },
 props: {
   sceneURL: {
     type: String,
   },
 },
 setup() {
   onMounted(() => {
     try {
       initViewer();
     } catch (error) {
       console.log(error);
     }
   });
   return {};
 },
};

function initViewer(params) {
 if (window.viewer) {
   window.viewer.destroy();
   window.viewer = null;
 }
 let viewer = new Cesium.Viewer("cesiumContainer", { navigation: false });
 window.viewer = viewer;
}

其他参考资料

1. Vue3 配套资料
2. Composition API 组合式 API 资料
3. 支持中心教程
   注：Vue 3.0 不再需要 /* eslint-disable */ 也可正常运行
4. 支持中心动态引用 Cesium 资源教程
5. Webpack + Vue