Leaflet 1.0-rc1 发布公告

← 返回博客文章列表

发布日期：2016 年 4 月 18 日作者：Iván Sánchez

Leaflet 1.0 的旅程仍在继续 - 我们很高兴能将第一个 1.0 版本的候选发布版本发布到公共平台。

Leaflet 1.0-rc1 关闭了 beta2 中存在的边缘情况和 API 不一致问题。完整的更改列表在1.0.0-rc1 changelog 中，包含约 50 个错误修复，十几个改进以及少量 API 更改。

值得注意的更改

分数缩放控制：在 beta2 中，开发者只能通过代码设置分数缩放级别，例如运行 map.setZoom(8.5)。现在，地图具有选项 (zoomSnap 和 zoomDelta) 以便用户可以通过分数缩放级别进行导航。
当使用 <canvas> 渲染器时，更好地处理矢量层，尤其是在层不可交互且线条为虚线时。
第一个 Microsoft Edge 漏洞修复（处理 Win10 触控屏上不一致的 dblclick 行为）
使用 prosthetic-hand 进行单元测试，确保触控交互行为一致。这有其自己的博客文章。

API 文档更改

API 文档现在由 docstrings 生成，这得益于一个名为 🍂doc（或“leafdoc”）的新工具。

以前，API 文档是手动编辑的。这涉及大量的复制粘贴 - 随着时间的推移 - 部分代码开始与文档不匹配。

大多数复杂的软件项目使用某种形式的docstrings 和像JavaDoc、NaturalDocs 或 JSdoc 这样的工具将 docstrings 转换为网页。

但是 Leaflet 的文档需要一些特殊的片段 - docstrings 包含方法和属性，但它们不包含选项或事件，并且我们希望保持当前文档的外观和感觉。🍂doc 的诞生是为了克服这些限制。

Leaflet 广泛使用类继承，旧文档有时对此并不清楚。一些用户难以找到某些类的可用方法，并且继承的选项有时会提到，有时不会。🍂doc 通过默认情况下折叠所有继承方法/选项/事件/属性的文档来修复此问题。

Collapsed inheritances for L.Polygon

构建系统现在构建一个包含 API 文档的 HTML 文件，与压缩后的 leaflet.js 文件放在一起。文档将在每次发布时根据该文件更新，并且对 gh-pages 分支的文档修复的拉取请求将被自动拒绝。

获取候选发布版本

与之前的版本一样，您可以使用我们的 CDN

<link rel="stylesheet" href="http://cdn.leafletjs.com/leaflet/v1.0.0-rc.1/leaflet.css" />
<script src="http://cdn.leafletjs.com/leaflet/v1.0.0-rc.1/leaflet.js"></script>

Javascript 文件的非压缩版本也可用作

<script src="http://cdn.leafletjs.com/leaflet/v1.0.0-rc.1/leaflet-src.js"></script>

此发布版本也可以通过 NPM (npm install leaflet@rc)、GitHub 下载和 CDN 下载获取。我们不建议使用 Bower。

团队成员

此候选发布版本是在大多数 Leaflet 团队成员在马德里聚会一个周末修复错误并讨论架构决策时发布的，他们还讨论了哪些重大功能应该包含在 1.0 版本中，哪些应该推迟。

这张照片可能经过数字修改，以包含那些那个周末无法来马德里的人。

Iván 和 Yohan 想要特别感谢那卷卫生纸。

我们很高兴能见面并一起解决错误。事实证明这是一件非常有效的事情，因为那天大约有 20 个问题得到了解决。希望很快能再举行一次面对面的会议，并发布另一个版本！

我们希望您能像我们编写代码一样享受 Leaflet 1.0-rc1！

最好的祝愿，Iván & Vladimir & Yohan & Per & Zsolt。