SDK授权版说明

906字约3分钟

2024-12-20

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

集成SDK到自己的项目：已经成功集成使用了免费版本SDK

再进行下面步骤，将免费版本SDK（带logo）替换为授权版本SDK。

1 SDK授权版介绍

目前Mars3D平台虽然对所有用户免费使用，但是它会在页面上四周有logo, 目前我们是通过付费授权的方式除去该Logo。

Mars3D平台所有示例源码、API文档、开发教程是免费开放的方式，当前就可以参考官网教程去免费无限制的使用, 您可以免费进行学习和项目开发。建议您先使用免费开源版进行项目开发，完成所有开发后，在最终项目交付前购买授权版SDK即可。

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

2 替换本地SDK为授权版

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

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

将mars3d-sdk授权版.zip文件覆盖对应的目录即可，比如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/目录
覆盖授权版：将mars3d-sdk授权版.zip离线包放到packages目录，并解压到当前目录下，解压后packages的目录结构为：

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

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