Loca 升级指南 最后更新时间: 2021年01月22日

本文主要内容是介绍 Loca 新老版本功能差异，以及指导开发者如何进行版本升级。如果在新版版本升级过程中有任何问题，请在页面下方通过提交工单的方式与我们联系，我们会及时处理您的反馈。

版本说明

1. 本次升级后，在引用 Loca 时需要显示指定版本号 v=x.x.x。
2. 之前没有显式指定版本号的情况，我们会将版本指向到 1.1.3。
3. 1.1.3 版本稳定且绘制性能有大幅提升，我们将在此之前的版本统一升级至 1.1.3，以保证更好的体验。
4. 我们强烈建议您升级至 JSAPI 最新版本（1.4.10 以上），以保证 Loca 最新功能的支持。过低版本的 JSAPI 会导致部分功能异常及报错。

如果在升级后发现有报错的情况，请查阅参考手册的最新使用方法。如果有更多问题可以通过工单联系我们。

差异说明

自 1.2.0 开始，Loca 进行了部分功能上的调整，具体内容如下：

1. Loca 默认开启 3D 模式，全面支持 3D 模式的渲染。
   即创建 Loca 时的属性 viewMode 默认为 3D。如果开发者需要使用 2D 模式，请显式设置 viewMode: '2D'。
   这里需要说明的是，自 v1.2.0 版本起，所有版本中的 2D 绘制功能将不再维护和升级。
2. 部分 AttrOptions 属性名称变更，同时向下兼容 1.1.3 版本的配置项。
   升级至 1.2.0 的用户建议使用最新属性进行开发，1.1.3 版本的用户可以继续保持原属性不变。
   具体属性名对应见下表：