源码管理

本文概述源码管理的功能。

Choose your operating system:

Windows

macOS

Linux

虚幻编辑器内置了对源码管理包的支持。源码管理用于管理代码和数据随时间的变化,使团队能够协调他们的游戏开发工作。

默认情况下支持Perforce和SVN。

启用源码管理

您可以通过两种方式之一来启用源码管理:

  • 在关卡编辑器的 偏好设置(Preferences) 窗口。

  • 内容浏览器(Content Browser) 中。

通过编辑器偏好设置(Editor Preferences)启用源码管理

您可以通过编辑器偏好设置(Editor Preferences)窗口( 编辑(Edit)> 编辑器偏好设置(Editor Preferences)> 加载和保存(Loading & Saving) )启用源码管理。

SourceControlPreferences.png

项目

说明

资源修改时是否自动签出(Automatically Checkout on Asset Modification)

选中后,它将自动签出任何已修改的资源。

包修改签出提示(Prompt for Checkout on Package Modification)

选中后,当您对源码管理包进行更改时,将出现一条提示,询问您是否希望签出(锁定)该包。

修改时添加新文件(Add New Files when Modified)

它将在修改时向源码管理添加新的文件。

使用全局设置(Use Global Settings)

使用全局源码管理登录设置,而不非逐项目设置。修改后需重新登录。

对比文本工具(Tool for diffing text)

为对比文本文件的工具指定文件路径。

通过内容浏览器启用源码管理

您还可以在 内容浏览器(Content Browser) 中启用源码管理。为此,右键单击任何资源或文件夹。在上下文菜单底部的 源码管理(Source Control) 部分,单击 连接到源码管理(Connect to Source Control)

Connect to Source Control

这将打开一个登录屏幕,您可以在其中选择源码管理系统并输入任何适当的设置和其他信息。

Source Control Login

输入适当的信息,然后单击 接受设置(Accept Settings) 。启用源码管理后, 内容浏览器(Content Browser) 中资源的显示将发生变化,以反映其源码管理状态,右键单击上下文菜单中将包含一些源码管理选项。

状态图标

*内容浏览器(Content Browser)** 将在资源的右上角显示特殊图标,以提供源码管理的状态。下面是可用的图标以及它们的含义:

CheckedOutByYou.png

CheckedOut.png

MarkedForAdd.png

NotInTheDepot.png

NotHeadRevision.png

已被您签出

已被另一用户签出

已标记进行添加

不在Depot库中

源码管理中存在新版本的文件

源码管理操作

当源码管理处于活动状态,如果您右键单击一个资源,将有以下上下文菜单可用:

SourceControlMenu.png

项目

说明

签出(Check Out)

签出(锁定)此资源进行编辑。它将防止其他用户同时编辑此资源。

刷新(Refresh)

刷新资源的源码管理状态。

历史记录(History)

提供所选资源的修改历史列表,允许您查看之前的编辑。

和Depot中文件进行比较(Diff Against Depot)

它允许您根据当前存储在源码管理Depot的版本检查资源。

签出和签入

要签出资源进行编辑,只需右键单击它并选择 签出(Check Out) 。在迁回资源时,请遵守以下方案:

  • 右键单击资源并选择 签入(Check In) 。将出现一个对话框,其中包含签入所需的变更列表描述。

  • 输入描述,它将被添加到资源的修改历史记录。

  • 完成后,单击 确定(OK)

ChangelistDescription.png

需要变更列表描述,因此在输入描述之后方才启用 确定(OK) 按钮。

内容热重载

内容热重载(Content Hot Reloading) 是一项新功能,当内容被源码管理操作修改时,编辑器内的源码管理使用该功能来自动重载内容。目前,自动重载仅在通过编辑器内的源码管理集成执行源码管理操作时有效,任何外部更改都不会触发重载。我们打算在以后的引擎版本中删除这一需求,这样外部更改也会触发热重载。

内容热重载还提供了从命令中的前一保存状态重载资源的能力。可以通过在 内容浏览器(Content Browser) 中右键单击资源并在 资源操作(Asset Actions) 组下选择 重载(Reload) 选项来实现该功能。如果您对资源进行了未保存的更改并且想要放弃这些修改以恢复到磁盘上的版本,该功能非常有用。

ContentHotReload.png

目前,该功能要求您为您的项目启用源码管理。

停用源码管理

您可能会发现在启用源码管理之后想要停用它。

只有在绝对确定不想要使用源码管理时,才使用此选项。停用源码管理将使您的内容与源码管理系统不同步,并且无法签入更改。

停用源码管理

  1. 在关卡编辑器窗口的右上角,单击绿色双箭头图标( icon_SourceControl.png )。这将打开 源码管理登录(Source Control Login) 屏幕。

  2. 单击 脱离源码管理运行(Run Without Source Control) 按钮。关卡编辑器窗口中的绿色图标将变成一个带斜杠的红色圆圈( icon_CB_SourceControlOff.png ),指示没有使用源码管理。

欢迎帮助改进虚幻引擎文档!请告诉我们该如何更好地为您服务。
填写问卷调查
取消