升级到 Flarum 2.0

Flarum 2.0 是一个主版本,包括一些重大变化和新功能。本指南将帮助您更新扩展,使其与 Flarum 2.0 兼容,并利用新增的功能。
提示
如果您在应用这些更改或使用新功能时需要帮助,请在社区论坛上发起讨论。
自动升级
您可以使用Flarum CLI来尽可能自动化升级:
请记住有关升级命令的以下信息:
- 该过程将经历多个步骤,每个步骤都指向相关文档,并提供提示。
- 在每个步骤之后,更改将被提交到Git,以便您始终可以逐个提交更改。
- 期间可能发生错误,在每一步完成后,您可以查看所做的更改,并进行任何必要的调整。
- 除以下情况外,大多数步骤很少需要手动调整:
- 适应访问/扩展延迟加载的Flarum模块。(可能需要一些手动更改)
- 准备JSON:API更改。(需要100%的手动更改)
- 搜索和筛选API更改_(可能需要一些手动更改)_
安装
升级程序只是[@flarum/clinpm包]的另一个命令(https://github.com/flarum/cli#readme)。
npm install -g @flarum/cli@3
CLI的v3仅与Flarum的v2.x兼容,如果希望继续对Flarum v1.x和v2.x使用CLI,则可以将它们一起安装。[阅读有关它的更多信息](cli.md#installation)。