Cesium源码编译过程
1. 操作环境
NodeJS V12.12.0
Git
注:不需要全局安装gulp,devDependencies中已经包含该依赖。
2. 主要步骤
-
通过Git在Github上拉取指定版本的代码;
- 以tag 1.70.1为例 git clone -b 1.70.1 https://github.com/CesiumGS/cesium.git
注:不建议直接下载Release的压缩包,编译过程中会报错缺少部分文件,需要再下载对应文件,比较麻烦。
-
安装npm依赖;
npm install
-
执行命令进行编译;
npm run release
3. 参考链接
4. 源码扩展
只编译源码没有任何意义,了解编译源码的过程主要是为了在源码基础上进行扩展,以扩展传感器形状渲染
为例。
背景介绍:
Cesium最开始是由AGI公司发起的开源项目,其实它还有扩展版本Cesium ion SDK,扩展功能并不是开源的,需要联系他们的销售人员购买。
其中有一个扩展功能就是对传感器图形的渲染,
其实这个功能AGI公司原本在GitHub上开源过代码,原地址为:https://github.com/AnalyticalGraphicsInc/cesium-sensors,后来不知什么原因仓库没了,但是有人提前Fork过仓库,并且一直随着Cesium的升级在同步维护,直接搜索
cesium-sensor
可以搜到很多。使用的话直接通过<script>
标签引入Cesium.js
和cesium-sensor.js
就可以,但是由于项目中是通过npm依赖的方式引入Cesium,当引入cesium-sensor.js
后发现Cesium.CzmlDataSource.updaters
确实多了内容,但是渲染就是不生效,最后只能尝试将cesium-sensor.js
中的内容编译到源码中去。
用到的源码可以在Gitee上获取,直接将代码文件放到对应目录下即可,然后通过命令npm run release
进行编译。
注:在React中引用Cesium时其实是引用的Source目录下的文件,因此如果要实现传感器渲染需要将文件复制到node_modules/cesium/Source文件夹下。