Mars3D开发者中心

外观

SDK授权版说明

约 913 字大约 3 分钟

2024-12-20

在阅读本节前，建议您已阅读：

再进行下面步骤，将社区免费版 SDK（带 Logo）替换为商业授权版 SDK。

1 SDK授权版介绍

Mars3D 社区免费版可免费用于学习、开发与商业项目，但页面四周会显示 Logo，F12 控制台输出通用版权信息；购买商业授权后即可去除页面 Logo，并将控制台授权信息替换为贵单位 / 项目名称。

Mars3D 的示例源码、API 文档与开发教程均免费开放，可直接参考官网资料进行学习与项目开发。建议先使用社区免费版完成开发，在项目交付前再购买商业授权。

更多区别，请访问 Mars3D SDK 大版本授权 或 Mars3D SDK 源代码 了解详细介绍和价格。

2 替换本地SDK为授权版

正常付费购买后，我们会发送mars3d-sdk 授权版.rar文件给贵单位，解压后按下面方式进行覆盖集成即可。

2.1 当是在html的head中直接静态资源方式引入时

将mars3d-sdk 授权版.rar解压后覆盖对应的目录即可，比如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";

image

详细步骤：

  1. 确保项目在使用 npm 社区免费版 mars3d 时正常运行。

  2. 在项目根目录创建/packages/目录

  3. 覆盖授权版：将mars3d-sdk 授权版.rar离线包放到packages目录，并解压到当前目录下，解压后packages的目录结构为：

/mars3d-vue-project
 └─ packages   
   └─ mars3d
     ├─ img
     ├─ mars3d.js
     ├─ mars3d.d.ts
     ├─ mars3d.js  
     └─ package.json  #必须有，如果没有请下载包中拷贝：http://mars3d.cn/download/mars3d-sdk.zip

  1. 修改链接：修改package.json中mars3d包配置为： "mars3d": "file:packages/mars3d",

  2. 【重要】删除node_modules重新npm install安装依赖

  3. 其他说明：

  • 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还存在，也可以在 售后微信群 进行反馈，我们会进行协助集成。 也可以微信扫下面二维码进行沟通：