Cesium 源碼打包入門 [ver1.72]

不好意思沒有頭圖了...

1. 源碼包和分發包
2. npm/node版本
3. 打包指令大全
- 3.1. 架起本地開發者站點&文檔服務（使用分發包）
- 3.2. 傻瓜式打包 - 打包成官方的那個分發包（使用源碼包）
- 3.3. 釋出式打包（使用源碼包）
- 3.4. 常用打包指令大全（使用源碼包）

源碼包隻有兩種方式得到

當然，如果github通路困難的同志可以借助gitee或者coding。

官方提供了分發包（也就是“預編譯”的包，适合生産上線用），即https://github.com/CesiumGS/cesium/releases 中的

Cesium-<版本号>.zip

。

分發包能通過源碼包運作npm打包指令得來。

分發包與源碼包最大的差別在于，提供了兩個版本的打包API，提供了API文檔，删除了部分生産用不着的打包配置檔案。注意，分發包保留了源碼目錄，但是有關打包指令可能失效。打包請使用源碼包。

根據官方釋出日志，Cesium 1.63全面啟用ES6子產品化機制，但實作上依舊是ES5，僅僅子產品機制變換。

若要正确打包，請使用配對的node/npm版本。不熟悉npm和node是什麼的朋友請到segment fault或知乎簡書搜搜下下安安裝裝。

本例适用于nodejs -v 12.16和npm 6.13，以及Cesium 版本1.67~最新版本。

根據回報，如果打包不成功，請回退node版本到10.x有可能能成功。

node問題在1.68版本中已解決，可以用12.x版本了。

任意指令行下，定位到源碼包解包的根目錄（即package.json同級别目錄下），使用指令

npm install && npm run start
# 如果指令行不支援&&連接配接指令的，請分開兩句使用

即可運作起本地開發者站點&文檔服務。通路localhost:8080，不出意外會出現以下界面：

note：Cesium的開發者站點和文檔服務使用的是express架起來的，端口為8080，寫在包的根目錄下的server.cjs（1.67之前是server.js）檔案内。

與3.1前述步驟一樣，指令為：

npm install && npm run makeZipFile
# 如果指令行不支援&&連接配接指令的，請分開兩句使用

則會在根目錄生成一個"Cesium-<版本号>.zip"壓縮包，與官方提供的分發包是一模一樣的。

指令：

npm install && npm run release
# 如果指令行不支援&&連接配接指令的，請分開兩句使用

在根目錄下生成Build檔案夾，内含Cesium子目錄、CesiumUnminified子目錄、Documentation子目錄。

release指令會生和官方分發包一樣的兩個版本API，即Cesium子目錄、CesiumUnminified子目錄，分别代表

實際上，打包指令除了3.2和3.3這兩條之外，還有其他的，故給出一張圖，僅供參考。

如果不知道怎麼選擇，直接下載下傳分發包就行，别掙紮了

（實際上就是從package.json裡摳出來的）

注意了，release = combine + minifyRelease + 打包API文檔。

打包前請npm install。不支援&&連接配接指令的，請分開兩句使用。

轉載請聲明。B站/知乎/小專欄/部落格園/CSDN @秋意正寒

繼續閱讀