更新 Stride
入门
更新 Stride 是一个简单直接的过程，但请仔细遵循步骤以确保平稳过渡。以下是更新 Stride 引擎及现有项目的指导说明。
Note
这里提供的说明可作为更新到任意新版 Stride 的通用指南。
更新 Stride
在 Stride Launcher 中，找到**切换/更新版本（Switch/update version）**部分，点击你正在使用的版本旁边的更新按钮。
主版本（major）和次版本（minor）发布会作为独立版本出现在列表中，需要手动安装。
你也可以从终端使用 Stride CLI 更新引擎：
# 更新所有已安装的引擎版本
stride update
# 更新指定的引擎版本
stride update 4.3
更新你的 IDE
请确保你使用的是所选 IDE 的最新版本，以保证与最新版 Stride 的兼容性。某些 IDE 可能还需要重启计算机才能完全应用更改。
更新你的项目
确保你的项目可以构建。 升级过程可能会修改你的部分代码，这要求所有
.csproj文件都能编译通过。（推荐）将所有更改提交到版本控制。 这将提供一个安全网，让你在出现问题时能够回退此次更新。
使用新版引擎打开你的项目。 系统会询问你是否要升级某个包。请确保选择对解决方案中的每个包执行此操作，然后点击Upgrade。
Tip
如果你没有使用版本控制，建议启用备份已修改文件的选项。这样，如果出现问题，你可以轻松还原这些更改。
Stride 完成项目更新后，立即保存项目至关重要。这一步可以防止项目处于未定义状态，并固化更新过程中所做的更改。
使用 Stride CLI 更新项目
项目更新也可以在终端中通过 Stride CLI 完成。
Note
我们建议使用 CLI 工具而不是 dotnet package update 命令，因为它还会更新你的部分资产和代码，以确保其与新版本正常配合工作。
关闭 Game Studio，确保它不会覆盖任何内容。
确保你的项目可以构建。 升级过程可能会修改你的部分代码，这要求所有
.csproj文件都能编译通过。（推荐）将所有更改提交到版本控制。 这将提供一个安全网，让你在出现问题时能够回退此次更新。
运行以下命令，将你的项目更新到最新版 Stride：
stride upgrade path/to/your/project如果你想更新到指定版本的引擎，可以使用
--version标志指定。stride upgrade --version 4.3 path/to/your/project要查看所有可用标志和参数的列表，请运行以下命令：
stride upgrade --help
回退项目更新
如果更新过程中出了问题，或者新版 Stride 存在导致你的游戏无法正常运行的 bug，你可以将项目回退到之前的引擎版本。
Tip
在回退之前，请尝试查明发生了什么，并在 Stride 的 Github 页面上提交一个 issue 描述你的问题，以便在未来的更新中得到解决。
使用版本控制回退
如果你的项目使用了版本控制，可以轻松将其回退到之前的状态。
关闭 Game Studio，确保它不会覆盖任何内容。
使用你的版本控制软件还原所有已更改的文件。
在 Stride Launcher 中将引擎版本切换为项目之前使用的版本。有关操作方法，请参阅管理版本。
打开你的项目并确认没有问题。
不使用版本控制回退
如果你的项目没有使用版本控制，但在项目升级时选择了备份已修改文件的选项，那么你可以通过该备份将项目恢复到之前的状态。
关闭 Game Studio，确保它不会覆盖任何内容。
打开你的项目文件夹。
找到以
.stride-backup开头的文件夹（根据操作系统不同，你可能需要启用显示隐藏文件）。将其中的所有内容复制到项目的根目录，并选择覆盖现有文件。
在 Stride Launcher 中将引擎版本切换为之前的版本。有关操作方法，请参阅管理版本。
打开你的项目并确认没有问题。
既无版本控制也无备份时回退
如果你的项目没有使用版本控制，且在项目升级时也没有选择备份已修改文件的选项，那么你或许仍可以手动回退所有更改。
Note
这就是我们推荐使用版本控制的原因。