外观
Cesium版本兼容问题
约 1189 字
在引入 Mars3D SDK 后,正常情况下可以在 F12 打印的信息中看到 Mars3D 和 Cesium 的版本信息。
Mars3D 与 Cesium 的版本对应关系
正常情况下 Mars3D 依赖的 Cesium 均是最新版本,并且对 Cesium 版本无特殊要求,各版本间均是兼容的;但因 Cesium 本身的变更,也存在部分版本间不兼容的情况,目前版本依赖关系如下:
| mars3d版本 | Cesium版本 | 说明 |
|---|---|---|
| v3.5 - 至今 | v1.107及之后,如果版本不匹配F12会打印提示 | 重写glTF架构、改用WebGL2渲染 |
| v3.3 - v3.4 | v1.92 至 v1.96 | 改为原生Promise |
| v3.0 - v3.2 | v1.91 及之前 | |
| v1.0 - v2.0 | v1.91 及之前 | 老版本 |
当 npm 环境使用 Mars3D 时需要指定 mars3d-cesium 的版本,可以这样操作: 搜索 package.json 中的 "mars3d-cesium",改下
"mars3d-cesium": : "~1.95.0",【注意不要 ^】,删除 node_modules 后重新 npm install 安装即可
Cesium 1.102+ 与之前版本不兼容 - 2023-02-01
Cesium v1.102(2023-02-01)默认改为 WebGL2 渲染,与之前版本的 shader 语法部分不兼容。 具体详情参看 1.102更新日志。
相关版本依赖关系是:
- Mars3D
v3.4.x及之前版本,须使用 mars3d-cesiumv1.96及之前的版本(mars3d-cesium 1.97-1.100 未做发布); - Mars3D
v3.5.x及之后版本,须使用 mars3d-cesiumv1.104及之后的版本。
scene 参数下添加 requestWebgl1: true 参数。Cesium 1.97+ 与之前版本不兼容 - 2022-09-01
Cesium v1.97(2022-09-01)的 glTF/3DTiles 与之前版本完全不兼容,采用了新的 glTF 架构代码重写,导致 3DTiles 部分功能无法使用,且部分 glTF/3DTiles 数据会报错。 具体详情参看 1.97更新日志。
相关版本依赖关系是:
- Mars3D
v3.4.x及之前版本,须使用 mars3d-cesiumv1.96及之前的版本(mars3d-cesium 1.97-1.100 未做发布); - Mars3D
v3.5.x及之后版本,须使用 mars3d-cesiumv1.104及之后的版本。
如果使用其他版本会造成以下问题(除此之外不受影响):
- 模型裁剪、压平等功能无法使用;
- 建筑物特效等涉及 3DTiles 模型的地方可能无效;
- 部分 shader 需要改写为 WebGL2 语法,或者在构造 Map 时在
scene参数下添加requestWebgl1: true参数。
Cesium 1.92+ 与之前版本不兼容 - 2022-04-01
Cesium v1.92(2022-04-01)的 Promise 与之前版本不兼容,具体可以参考其 官方说明。
与之对应的是 Mars3D v3.3.x(内部依赖 Cesium v1.92+),所以针对不同情况的处理方式不同。
出现不兼容的场景
- Mars3D
v3.2.x及之前版本需要使用 Cesiumv1.92及之后版本时; - Mars3D
v3.3.x及之后版本需要使用 Cesiumv1.91及之前版本时; - 运行后浏览器提示找不到 Cesium 命名空间之类错误时。
mars3d: [
"Cesium/Widgets/widgets.css", // cesium
"Cesium/Cesium.js",
"mars3d/plugins/compatible/cesium-version.js", // cesium版本间兼容处理
"mars3d/plugins/compatible/cesium-when.js",
"mars3d/mars3d.css", // mars3d
"mars3d/mars3d.js",
]Cesium 1.83+ 仅支持 KTX2 纹理的模型 - 2021-07-01
Cesium 在 1.83 版本(2021-07-01)中正式放弃对 KTX1 和 Crunch 纹理的支持,仅支持 KTX2, 所以在用 1.83+ 版本加载 KTX1 材质的模型时,会出现模型无法展示的问题。
回复需要将 Cesium 版本切换到 1.79 版本加载 KTX1 纹理的模型,或者使用最新版本的相关数据处理工具重新转换处理数据。mars3d: [
"Cesium-1.79/Widgets/widgets.css", // cesium 1.79版
"Cesium-1.79/Cesium.js",
"mars3d/plugins/compatible/cesium-version.js", // cesium版本间兼容处理
"mars3d/plugins/compatible/cesium-when.js",
"mars3d/mars3d.css", // mars3d 最新版
"mars3d/mars3d.js",
]Mars3D V3.x 与之前老版本间不兼容 - 2021-03-01
v3.x 版本与 v1.x、v2.x 老版本之间不兼容(API 结构不同),无法平滑升级,因为 v3 的所有代码是按最优雅的方式从零开始编写设计搭建的,并非基于之前的老版本修改。 老版本的所有功能在新版中都支持,并且 v3 版增加了很多新功能。
