Skip to content

Commit

Permalink
同步代码
Browse files Browse the repository at this point in the history
  • Loading branch information
@muyao1987
muyao1987 committed Jun 26, 2022
1 parent d160518 commit 10178a1
Show file tree
Hide file tree
Showing 2 changed files with 130 additions and 63 deletions.
132 changes: 95 additions & 37 deletions CHANGE.md
View file
Original file line number Diff line number Diff line change
@@ -1,112 +1,170 @@
# Mars2D更新日志
# Mars2D版本及更新日志

-------------------------------------------

# 1. Mars2D的版本

Mars2D的版本号包括三个部分，比如版本**3.2.1** 表示主版本号是 3，大版本号是 2，小版本号是 1

版本号是根据本次发布中包含的变更的级别进行递增的。

- 主版本：包含重要的新特性和架构性调整，在升级时会需要由开发人员提供少量的协助才能完成。当升级到新的主版本时，你可能需要运行升级脚本、重构代码、运行其它测试以及学习新的API。

- 大版本：包含新增功能和API优化重构，大版本其中大部分功能是向后兼容的，只有少部分特性是不兼容的(更新日志会说明弃用的API)，参考说明或示例简单调整即可。

- 小版本：包含新的小型特性优化，bug修改等。 小版本是完全向后兼容的，在升级期间，不需要开发人员提供协助。


# 2. 发布频率
我们会定期发布新版本，以便随着 Mars2D 的不断演进，你可以提前计划并协调这些升级工作。

> 这些日期仅供一般性参考，如有更改，恕不另行通知。
通常的发布周期如下：
- 每2年 发布1个主版本
- 每半年 发布1个大版本
- 每月 发布1个小版本


# 3. 弃用策略
"重大变更"（比如移除特定的 API 和特性）有时候是必须的，比如创新、让最佳实践与时俱进、变更依赖关系甚至来自 Web 平台自身的变化。

要让这些转变尽可能的简单，我们会给你下列保证：
- 我们会尽量减少重大变更的数量，并尽可能提供迁移工具。
- 我们会遵循这里所讲的弃用策略，让你有时间把应用升级到最新的 API 和最佳实践。



# 4. 更新日志



---

## 3.1.4 - 2022-6-26
#### 增加 ⚡
- GeoJsonLayer图层增加chinaCRS参数，支持数据自动纠偏

#### 优化 💪
- vue功能示例编辑器重写
- 增加主库和插件库中第3方依赖JS库未引入时的错误提示，方便排查问题

#### 修复 🔧
- graphicLayer.openPopup偶尔报错问题
- GeoJsonLayer图层popupOptions参数未生效




## 3.1.3 - 2022-4-29
#### Breaking Changes 📣
#### 重要说明 📣
- leaflet 升级到v1.8.0
- SDK内部重新架构

#### Additions 🎉
#### 增加 ⚡
- 增加MapSplit双屏对比控件
- 更新mars2d.Token所有默认值
- 增加mars2d.Token.updateAll方法，方便外部更新覆盖

#### Fixes 🔧
#### 修复 🔧
- 修复部分DivGraphic拖拽后的定位存在偏差
- 修复一些已知bug




## 3.0.9 - 2022-3-8
#### Additions 🎉
#### 增加 ⚡
- Circle增加outlineLatlngs属性
- 增加QueryArcServer、QueryGeoServer查询类
- 新增了一批示例

#### Fixes 🔧
#### 修复 🔧
- 自由线绘制的偶尔报错
- 量算的编辑
- GaodePOI 中限定区域无效



## 3.0.8 - 2022-2-25
#### Breaking Changes 📣
#### 重要说明 📣
- 基础项目vue版上线发布
- 功能示例原生JS版优化(与Vue版保持一致性)

#### Additions 🎉
#### 增加 ⚡
- 增加ToolButton控件
- 完善API文档及TS定义



## 3.0.7 - 2022-2-20
#### Breaking Changes 📣
#### 重要说明 📣
- 功能示例vue版上线发布
- 移除axios库，改用 mars2d.Util.fetchJson或sendAjax方法
- 优化pbf图层，vectorTileLayerStyles参数改名style，并简化了参数形式

#### Additions 🎉

#### 增加 ⚡
- wms图层增加click事件和popup支持
- 增加ToolButton控件
- 增加 mars2d.d.ts 对TS支持 (测试中,可能有问题)
- 增加 mars2d.d.ts 对TS支持

#### Fixes 🔧
#### 修复 🔧
- 检查API文档描述错误并修复
- 修复v3.0.5版show修改带来的瓦片图层不展示
- 圆、矩形完成后激活编辑失败
- 测试了一轮并修复了一批bug问题

#### 弃用 & API重构 🔒
- 移除axios库，改用 mars2d.Util.fetchJson或sendAjax方法
- 优化pbf图层，vectorTileLayerStyles参数改名style，并简化了参数形式


## 3.0.5 - 2022-1-17
#### Additions 🎉
#### 优化 💪
- 对图层增加show参数和属性
- 优化状态栏的小分辨率时的显示

#### Fixes 🔧
#### 修复 🔧
- 修复已知的一些bug



## 3.0.3 - 2021-12-17
#### Breaking Changes 📣
#### 重要说明 📣
- 完成所有 V2 的功能示例的对应 V3 新版开发
- v3.0正式稳定版本发布
- 优化了SDK内部的接口方法，并整理及发布API文档
- 完成了教程的编写

#### Fixes 🔧
#### 修复 🔧
- 完成了一轮测试并修复了所有bug问题


## 3.0.1 - 2021-12-14
#### Breaking Changes 📣
- 优化了SDK内部的接口方法，并整理及发布API文档
- 完成了教程的初步编写
- 增加了一批新的示例



## 3.0.0 - 2021-11-16
#### Breaking Changes 📣
- 发布了v3第一个测试版本。

#### Additions 🎉
- 按“规范、高效率、易学易用”为准则架构，从零开始重构开发的v3.0新版本，并开放开源免费使用。
- 全新设计了矢量数据体系，采用Graphic矢量数据（统一的规范和style设计）和GraphicLayer矢量数据图层来统一管理。
- 设计了新的GeoJsonLayer，采用可在symobl中配置type参数指定Graphic类型来渲染。
## 3.0.0 - 2021-11-16
#### 重要说明 📣
- 发布了 v3.0 版
- 易学：使用和语法都按开发人员用户习惯最优设计，降低开发人员能力要求，只用初级水平开发人员即可上手。
- 规范：API 从顶层统一规范的从零重构、将插件优化至SDK内，并提供统一规范的API。
- 高效率：提高了开发效率和平台的渲染效率。
- 详细的 API 和教程：重新编写了详细的教程文档、自动根据 SDK 注释生成的最详尽的 API 文档，并完全免费开放。
- 功能示例和项目模板：并规划开发了 Vue 版 功能示例和基础项目。
- 免费：SDK无需授权，免费无限制使用

#### 增加 ⚡
- 矢量数据：全新设计了矢量数据体系，采用Graphic矢量数据（统一的规范和style设计）和GraphicLayer矢量数据图层来统一管理。
- GeoJson图层：设计了新的GeoJsonLayer，采用可在symobl中配置type参数指定Graphic类型来渲染。

#### 弃用 & API重构 🔒
- v3.0版与v2.x版本还不兼容(API结构不同)，无法兼容平滑的升级，因为v3所有代码从零开始编写搭建的,不是基于之前的老版本修改的。



-------------------------------------------

## 2.0.0 - 2020-1-1
#### Breaking Changes 📣
#### 重要说明 📣
- 发布了v2.0



## 1.0.0 - 2017-8-25
#### Breaking Changes 📣
#### 重要说明 📣
- 发布了v1.0
61 changes: 35 additions & 26 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -16,50 +16,59 @@
</a>
</p>

当前仓库是 Mars2D 平台所有开源仓库的清单导航页 ，包含最新 SDK 下载包、离线 API 文档和其他仓库导航。
Mars2D所有资料和代码都均是免费开源的公开发布方式，
当前仓库是 Mars2D 平台所有开源仓库的清单导航页 ，包含SDK更新日志、和其他仓库导航。

Github：[https://github.com/marsgis/mars2d](https://github.com/marsgis/mars2d)

国内 Gitee：[https://gitee.com/marsgis/mars2d](https://gitee.com/marsgis/mars2d)
国内Gitee：[https://gitee.com/marsgis/mars2d](https://gitee.com/marsgis/mars2d)

## 功能示例

## 功能示例
对平台每个功能编写的案例代码，可以阅读每个示例代码来学习各功能，与官网功能示例一致效果。

对平台每个功能编写的案例代码，可以阅读每个示例代码来学习各功能，与官网功能示例一致效果。
| 说明 | 教程 | 视频 |Github源码 | 国内Gitee源码 |
| ----|---- | ---- | ----| ---- |
|原生JS版 | [查看](http://mars2d.cn/dev/guide/project/example-es5.html) | 暂无 | [mars2d-es5-example](https://github.com/marsgis/mars2d-es5-example) |[mars2d-es5-example](https://gitee.com/marsgis/mars2d-es5-example) |
|Vue版 |[查看](http://mars2d.cn/dev/guide/project/example-vue.html) |[查看](https://www.bilibili.com/video/BV1pb4y1W7NG/)| [mars2d-vue-example](https://github.com/marsgis/mars2d-vue-example) |[mars2d-vue-example](https://gitee.com/marsgis/mars2d-vue-example) |


| 技术栈 | Github | 国内 Gitee | 说明 |
| ------- | ------------------------------------------------------------------- | ------------------------------------------------------------------ | -------------------- |
| **Vue** | [mars2d-vue-example](https://github.com/marsgis/mars2d-vue-example) | [mars2d-vue-example](https://gitee.com/marsgis/mars2d-vue-example) | 功能示例 Vue3 源码 |
| 原生 JS | [mars2d-es5-example](https://github.com/marsgis/mars2d-es5-example) | [mars2d-es5-example](https://gitee.com/marsgis/mars2d-es5-example) | 功能示例原生 JS 源码 |

## 最简项目模板
## 最简项目模板
提供了面向不同技术栈的最简项目模板，您可以直接使用或参考这些项目模板，了解SDK类库在不同技术栈项目中如何引入使用，快速搭建开发自己的项目。

提供了面向不同技术栈的最简项目模板，您可以直接使用或参考这些项目模板，了解 SDK 类库在不同技术栈项目中如何引入使用，快速搭建开发自己的项目。

| 技术栈 | Github | 国内 Gitee | 说明 |
| ------- | --------------------------------------------------------------------- | -------------------------------------------------------------------- | ---------------------- |
| **Vue** | [mars2d-vue-template](https://github.com/marsgis/mars2d-vue-template) | [mars2d-vue-template](https://gitee.com/marsgis/mars2d-vue-template) | Vue 最简的项目模板 |
| 原生 JS | [mars2d-es5-template](https://github.com/marsgis/mars2d-es5-template) | [mars2d-es5-template](https://gitee.com/marsgis/mars2d-es5-template) | 原生 JS 最简的项目模板 |
| uni-app | [mars2d-uni-app](https://github.com/marsgis/mars2d-uni-app) | [mars2d-uni-app](https://gitee.com/marsgis/mars2d-uni-app) | uni-app 的项目模板 |
| 说明 | 视频 | Github源码 | 国内Gitee源码 |
| ----| ----|----| ---- |
|原生JS技术栈 |暂无| [mars2d-es5-template](https://github.com/marsgis/mars2d-es5-template) |[mars2d-es5-template](https://gitee.com/marsgis/mars2d-es5-template) |
|Vue技术栈 |暂无| [mars2d-vue-template](https://github.com/marsgis/mars2d-vue-template) |[mars2d-vue-template](https://gitee.com/marsgis/mars2d-vue-template) |
|React技术栈 |暂无| [mars2d-react-template](https://github.com/marsgis/mars2d-react-template) |[mars2d-react-template](https://gitee.com/marsgis/mars2d-react-template) |
|Angular技术栈 |暂无 | [mars2d-angular-template](https://github.com/marsgis/mars2d-angular-template) |[mars2d-angular-template](https://gitee.com/marsgis/mars2d-angular-template) |
|CS桌面端程序 |暂无| [mars2d-electron](https://github.com/marsgis/mars2d-electron) |[mars2d-electron](https://gitee.com/marsgis/mars2d-electron) |
|APP移动端程序 |暂无|[mars2d-uni-app](https://github.com/marsgis/mars2d-uni-app) |[mars2d-uni-app](https://gitee.com/marsgis/mars2d-uni-app) |


### React 技术栈 & Angular 技术栈

当前未提供，原理和 Vue 类似，可以参考 Vue 项目

## 基础项目

基础项目是具备一个 GIS 项目常见功能的项目模板，只用更换数据及叠加业务即可完成项目交付。
基础项目是具备一个GIS项目常见功能的项目模板，只用更换数据及叠加业务即可完成项目交付。
如果需要更多功能可以考虑购买[付费项目模板](http://mars2d.cn/template.html)。

| 技术栈 | Github | 国内 Gitee | 说明 |
| ------- | ------------------------------------------------------------------- | ------------------------------------------------------------------ | ----------------------------------- |
| **Vue** | [mars2d-vue-project](https://github.com/marsgis/mars2d-vue-project) | [mars2d-vue-project](https://gitee.com/marsgis/mars2d-vue-project) | Vue 开发的基础项目 |
| 原生 JS | [mars2d-es5-project](https://github.com/marsgis/mars2d-es5-project) | [mars2d-es5-project](https://gitee.com/marsgis/mars2d-es5-project) | 原生 JS 开发的(widget 模式)基础项目 |
|说明 |教程 |视频 | Github源码 | 国内Gitee源码 |
|----|---- |---- | ----| ---- |
|基础项目 原生JS版 |[查看](http://mars2d.cn/dev/guide/project/jcxm-es5.html) |暂无 | [mars2d-es5-project](https://github.com/marsgis/mars2d-es5-project) |[mars2d-es5-project](https://gitee.com/marsgis/mars2d-es5-project) |
|基础项目 Vue版|[查看](http://mars2d.cn/dev/guide/project/jcxm-vue.html) |[查看](https://www.bilibili.com/video/BV1DR4y1G75T/)| [mars2d-vue-project](https://github.com/marsgis/mars2d-vue-project) |[mars2d-vue-project](https://gitee.com/marsgis/mars2d-vue-project) |






## 其他

| 技术栈 | Github | 国内 Gitee | 说明 |
| ------ | --------------------------------------------------------- | -------------------------------------------------------- | ------------ |
| ES6 | [mars2d-plugin](https://github.com/marsgis/mars2d-plugin) | [mars2d-plugin](https://gitee.com/marsgis/mars2d-plugin) | 部分开源插件 |
|说明 | Github | 国内Gitee |
|----|---- | ----|
|部分开源插件 | [mars2d-plugin](https://github.com/marsgis/mars2d-plugin) |[mars2d-plugin](https://gitee.com/marsgis/mars2d-plugin) |

## 平台介绍

Expand Down

0 comments on commit 10178a1

Please sign in to comment.