保持Backstage更新

Backstage 一直在不断改进，因此最好与最新版本保持同步。 Backstage 更像是一个库，而不是应用程序或服务；类似于create-react-app，"......@backstage/create-app该工具为您提供了一个起点，旨在不断发展。

使用 backstage-cli 更新Backstage版本

Backstage CLI 有一条命令可以将所有@backstage你正在使用的软件包和依赖项的最新版本：版本：碰撞.

yarn backstage-cli versions:bump

将所有@backstage软件包之间的依赖关系。

默认情况下，bump 命令将升级@backstage软件包到最新的main对于那些急于追踪"......next每周发布的发布线可以使用--release next选择。

yarn backstage-cli versions:bump --release next

如果使用其他插件，可以通过--pattern选项，以更新不止@backstage/*依赖性。

yarn backstage-cli versions:bump --pattern '@{backstage,roadiehq}/*'

对创建应用程序模板的修改

@backstage/create-app命令创建 Backstage 安装的初始结构。模板该模板在 Backstage 资源库中的源代码会定期更新，但您本地的app和backend在create-app时间，不会自动获得这些模板更新。

因此，对模板所做的任何更改都会连同升级说明一起记录在更新日志的@backstage/create-app我们建议在升级软件包时查看此更新日志，以了解任何适用的更新。 作为替代，可使用升级Backstage助手可以综合查看两个 Backstage 版本之间的所有更改。 您可以在以下位置找到当前安装的 Backstage 版本backstage.json.

有关依赖关系错配的更多信息

Backstage 的结构为单声道，其中包括纱线工作区这意味着app和backend软件包，以及您添加的任何自定义插件，都是独立的软件包，有自己的package.json和依赖关系。

当给定的依赖关系版本是一样不同软件包之间的依赖关系会被挂到主node_modules时，软件包之间将共享 monorepo 根目录下的文件夹。_不同_遇到相同依赖关系的版本时，Yarn 会创建一个node_modules文件夹。

这可能会导致类型定义或任何全局状态的混乱情况。 React背景这可能会导致在 Backstage 中查找 API 或加载配置时出现问题。

为帮助解决这些情况，Backstage CLI 具有以下功能版本：检查这将验证@backstage包，以检查是否有重复定义：

# Add --fix to attempt automatic resolution in yarn.lock
yarn backstage-cli versions:check