Mars3D开发者中心

外观

发布issues问题

约 1390 字大约 5 分钟

2024-09-11

发布问题前首先整理下可复现问题的最简单代码，这样也能让您自行定位并解决问题。并且发送重现问题的最简单代码使得他人更快速并高效地解决您的问题。

  • 如果问题比较简单（比如具体类及方法使用相关问题），建议直接功能示例中复现问题，请参看 “一、示例中复现问题”
  • 如果是集成问题或复杂度较高，请参看 “二、最简项目模版中复现问题”

一、示例中复现问题

例子应尽可能以最简单的方式复现你的问题，去除不必要的配置项和数据，这里通过一个例子来说明如何复现问题。

下面我们以一个具体问题来说明如何复现问题。

问题：使用path轨迹绘制实时路径时，项目中更新路径后，停止不动，原先绘制的路径会消失

1. 找到问题的关键代码

找到问题的关键代码 ，正常都是相关错误的相关类对象及方法， 比如这里说的是path轨迹，找到PathEntity的构造代码，如果坐标或部分参数是动态的，可以通过graphic.toJSON()方法获取到矢量对象的构造参数，然后替换到示例中。

替换到示例中可以使用示例map.js中的graphicLayer进行添加，如果没有需要自己添加

  graphicLayer = new mars3d.layer.GraphicLayer() 
  map.addLayer(graphicLayer)

image

2. 选择复现的示例

最好是选择相关性对应的示例，因为部分示例会有依赖的其他文件。

这里使用的是PathEntity,所以选择示例 graphic/entity/path示例 替换这里的代码，删除无关代码，点击运行，看看能不能复现出问题。

如果示例中正常，需要自行对比代码，看看是不是有哪里影响了（所以点击运行的代码应该尽量简洁，只有关键代码可以避免其他代码的影响。）

如果示例中可以复现出问题，可以往下继续进行。

image

3. 复现注意事项

  • 如果数据或者操作是异步的，可以使用setTimeout，异步执行方法进行模拟。

  • 假如数据过多，比如是一个json大文件，可以自己抽出关键数据模拟实现， 也可以通过下载示例的方式，将数据json放到public/目录下，然后在map.js文件中请求数据，在本地代码复现

image

4. 拷贝代码

复现问题后，将代码map.js拷贝到下一步的issue中。

提示

目前回复问题的优先级：问题描述规范清晰>问题描述不清晰、付费用户>免费用户

二、最简项目模版中复现问题

1. 可复现问题的工程

请创建一个干净并可复现问题的工程（建议使用 最简项目模版 ），或自己业务项目的去除不必要的配置项和数据的简化版本

2. 拷贝代码到项目中复现问题

拷贝代码到项目中复现问题，

如果在功能示例中无法复现问题，但可在项目中复现，此时应考虑SDK版本或项目配置的问题。

3. 发生项目代码

将项目代码压缩成zip文件，并发微信、或发送邮件给我们，注意：node_modules目录不要一起压缩进去。

三、发布问题

梳理好问题后，请您直接发布在Gitee码云开源平台: https://gitee.com/marsgis/mars3d/issues

发布问题后，我们会有专职运维人员 24小时内 定时处理回复(有响应) ， 7天内 动态清零(有结果) 所有问题。

1. 新建issues问题

(1) 登录个人gitee账号(可微信扫码登录)后，单击“新建issues”

image

(2) 按上面梳理问题章节要求，填写问题内容，并上传相关代码、截图、附件。

问题的重要相关信息

  • 一次性描述清楚：避免简单的一句话或一张图片(看图猜问题)，可以简短描述清楚问题
  • 版本信息：提供F12打印的版本信息和编译日期截图
  • 运行效果 当前错误效果的截图，复杂的操作可直接录屏或手机拍下视频
  • 问题代码 参考本章节前面说明，提供复现代码

(3)上传复现代码附件：复杂问题，建议基于某个示例复现问题后提供示例的map.js；或上传独立独立运行的项目代码包。

image

代码附件的发送

如无法传附件或代码不方便发送在gitee公网，可发布问题后， 您可以把问题URL链接和附件代码发送代码至mars3d官方运维人员邮箱：whd@marsgis.cn，也可加运维人员企业微信后私发代码（但注意代码不要发群里）。

(4) 完成问题提交，查阅问题

image

(5) 建议微信扫码关注gitee公众号，并绑定个人gitee账号，可及时收到消息提醒。

如果发布issues中遇到问题，可以微信扫下面二维码进行沟通