外观
SDK授权版
约 764 字
1 说明
本文面向已经取得 Mars3D 授权版 SDK 发布包的技术人员,说明如何将项目中的 SDK 替换为授权版。
授权版 SDK 与 npm 版的类、方法、参数完全一致,区别只在运行时页面标识与控制台信息,业务代码无需修改。
授权版 SDK 的获取方式、授权范围与商务事宜不在本教程范围,请访问 Mars3D 购买页。
2 替换本地SDK为授权版
取得授权版 SDK 发布包后,按项目当前的集成方式选择对应步骤。
2.1 当是在html的head中直接静态资源方式引入时
将授权版 SDK 发布包解压后覆盖对应的目录即可,比如 lib/mars3d/ 目录。
<!--引入cesium基础lib-->
<script>
// window.CESIUM_BASE_URL = "./lib/Cesium/" //非必须,如jsp、asp.net等非html框架报错时建议取消注释
</script>
<link href="./lib/Cesium/Widgets/widgets.css" rel="stylesheet" type="text/css" />
<script src="./lib/Cesium/Cesium.js" type="text/javascript" ></script>
<script src="./lib/turf/turf.min.js" type="text/javascript" ></script>
<!--引入mars3d库lib-->
<link href="./lib/mars3d/mars3d.css" rel="stylesheet" type="text/css" />
<script src="./lib/mars3d/mars3d.js" type="text/javascript" ></script>
<!--引入mars3d库插件lib(按需引入)-->
<script src="./lib/mars3d/plugins/space/mars3d-space.js" type="text/javascript" ></script>2.2 当是npm安装并import导入使用的方式时
无需修改源码,使用时与 npm 包一致:import * as mars3d from "mars3d";

详细步骤:
确保项目在使用 npm 版 mars3d 时正常运行。
在项目根目录创建
/packages/目录。将授权版 SDK 发布包放到
/packages/目录并解压,解压后的目录结构为:
/mars3d-vue-project
└─ packages
└─ mars3d
├─ img
├─ mars3d.js
├─ mars3d.d.ts
├─ mars3d.js
└─ package.json #必须有,如果没有请从发布包中拷贝修改
package.json中 mars3d 包配置为:"mars3d": "file:packages/mars3d",【重要】删除
node_modules并重新执行npm install。其他说明:
- vite 时需要排除(如果已有 packages 可以忽略修改),如果原有项目有其他配置也不要删除其他值
build: {
commonjsOptions: {
// 默认内部只处理了node_modules,需要将"packages/"也标识处理
include: /node_modules|packages/
}
// 已忽略其他配置
}使用原生 cesium 时,不要安装 mars3d-cesium(不能同时存在 2 个 cesium 包),vite 技术栈时在 vite.config.ts 配置改为
mars3dPlugin({ cesiumPackageName: "cesium" })vite 技术栈时如果无法排除解决问题,也可以在 vite.config.ts 配置改为静态引入
mars3dPlugin({ useStatic: true })编译慢问题:如果 vue2 等技术栈时引入本地版本
build编译很慢时,可以按下面配置修改babel.config.js
module.exports = {
// 已忽略其他配置
ignore: [
"packages/mars3d/mars3d.js", // 改成自己的本地地址
],
};2.3 集成后校验
- 启动项目,确认页面 Logo 已去除、F12 控制台显示授权单位信息。
- 若 Logo 仍存在,依次检查:
package.json中 mars3d 是否已指向file:packages/mars3d;- 是否删除
node_modules并重新安装依赖; - 是否清理构建缓存(
node_modules/.cache、node_modules/.vite); - 是否存在其他依赖重复引入 npm 版 mars3d。
- 仍未生效时,按 发布issues问题 提供版本信息、依赖树与构建日志。
