版本控制集成
Integrate Unity with version control systems.
阅读时间8 分钟最后更新于 2 个月前
Unity 能够与两种版本控制系统集成:Perforce 和 Plastic SCM。要在 Unity 中进行版本控制集成,必须为 Unity 项目设置 Perforce 或 Plastic SCM 服务器。
在 Unity 中设置版本控制
打开一个 Unity 项目,选择编辑 (Edit) > 项目设置 (Project Settings),然后选择版本控制 (Version Control) 类别。
属性 | 描述 | |
|---|---|---|
| 模式 | 选择版本控制模式。 | |
| Hidden Meta Files | 在 Operating System 的文件资源管理器中隐藏 .meta 文件。无论选择哪种模式,Unity 都不会在 项目视图图中显示 .meta 文件。 | |
| Visible Meta Files | 选择此选项可使用 Unity 不Support的版本控制系统。这是默认设置。然后,您可以使用您选择的版本控制系统来管理这些Assets的音频源Assets和元数据。 | |
| Perforce | 如果使用 Perforce 作为版本控制系统,请选择此选项。 | |
| 用户名 | 进入与 Perforce 帐户关联的用户名。仅当模式设置为 Perforce 时,此属性才可见。 | |
| 密码 | 进入与 Perforce 帐户关联的密码。仅当模式设置为 Perforce 时,此属性才可见。 | |
| --workspace | 进入您的工作空间。例如, | |
| --server | 进入 Unity Project 所在的 Server ON。例如,localhost:1666。仅当模式设置为 Perforce 时,此属性才可见。 | |
| Host | 进入希望计算机模拟的主机名。例如,工作站123.Perforce.COM。仅当模式设置为 Perforce 时,此属性才可见。 | |
| 日志级别 | 选择要在 Unity 控制台日志中接收的版本控制信息量。 | |
| --verbose | 日志记录与版本控制相关的每个操作。此选项提供非常Detailed的日志记录,如果要调试版本控制设置,此选项非常有用。仅当模式设置为 Perforce 时,此属性才可见。 | |
| Info | 日志错误、警告以及与版本控制相关的信息。 | |
| 通知 | 日志错误和警告。 | |
| 致命 | Unity 仅向控制台输出致命错误。 | |
| 状态 | 显示与版本控制系统的连接状态的 ON 信息。如果未连接,请选择 Connect 以连接到已配置的 System。仅当模式设置为 Perforce 时,此属性才可见。 | |
| Automatic add | 已启用此设置When,将文件添加到ProjectWhen,通过 Editor 或磁盘ON的Folder自动将文件添加到版本控制系统。Disabled此设置When,需要手动将文件添加到版本控制系统。默认情况下已启用此设置。仅当模式设置为 Perforce 时,此属性才可见。 | |
| 离线工作 | 启用此设置可Work offline。已启用此设置When,您需要在 P4V 中协调离线工作,或使用 P4 中的 reconcile 命令使 Perforce 服务Server仓库与您离线时所做的工作保持同步。有关更多信息,请参阅脱机使用 Perforce。仅当模式设置为 Perforce 时,此属性才可见。 | |
| 异步更新 | 启用此设置可使使用异步版本控制状态查询。已启用When,Perforce 会更新文件的版本控制状态,而不会使 Unity Editor 停顿。When与版本控制服务Server的连接具有高延迟时,请使使用此设置。 注意:只有状态查询是异步的。Unity 同步执行更改文件状态或需要了解文件状态最新信息的操作。仅当模式设置为 Perforce 时,此属性才可见。 | |
| 显示失败签出 | 启用此属性可在 Perforce 无法执行检查操作When显示对话框。如果失去连接,或者其他用户已专门 Checked out 要编辑的资源,则可能会出现这种情况。仅当模式设置为 Perforce 时,此属性才可见。 | |
| 覆盖失败的签出资源 | Enable此设置When,Unity 会保存无法Checked outAnyAssets。这意味着即使 Perforce 无法检查出文件,Unity 也会强制完成文件的 Save。默认情况下会启用此选项。如果禁用此属性,Unity 不会在 Perforce 无法检查文件时力Save文件。仅当模式设置为 Perforce 时,此属性才可见。 | |
| Smart Merge | Smart Merge 使 Unity 更容易合并同一线上有更改的文件。如果多个 Users 同时处理同一项目,这将很有用。仅当模式设置为 Perforce 时,此属性才可见。 | |
| 关 | 禁用 Smart Merge。 | |
| Ask | 启用 Smart Merge,但如果发生冲突,则在 MERGE 之前接收通知。这是默认设置。 | |
| 首爾梅日 | 自动使用 Smart Merge。 | |
| 项目外的版本包 | 跟踪对位于 Unity Project目根文件Folder之外的磁盘ON的包所做的更改,同时这些包仍在本地工作空间中。仅当模式设置为 Perforce 时,此属性才可见。 | |
| 覆盖图标 | 启用此设置可在 Editor 中显示版本控制状态图标。仅当模式设置为 Perforce 时,此属性才可见。 |
配置__版本控制 (Version Control)__ 设置,然后选择状态区域旁边的__连接 (Connect)__ 按钮以连接到版本控制系统。Unity 连接到系统后,状态区域将显示__已连接 (Connected)__。
要调整版本控制工具,请打开__偏好设置 (Preferences),然后选择__外部工具 (External Tools) 部分。可以在__版本控制差异/合并 (Revision Control Diff/Merge)__ 下面选择一个新工具。
在 Unity 中使用版本控制
在将 Editor 设置为与版本控制系统一起使用时,您可以通过 Editor 执行版本控制操作,而不必在版本控制客户端中执行这些操作。为此,请右键单击项目 (Project) 视图中的资源。
版本控制操作根据您使用的版本控制方式而异。下表显示了每种版本控制方式可以使用的操作:
版本控制操作 | 描述 | Perforce | Plastic SCM |
|---|---|---|---|
| 获取最新 (Get Latest) | 这将更新计算机上的文件以使这些文件与版本控制系统中的文件匹配。 | 是 | 否。要获取最新更改并更新文件,需要使用版本控制窗口(窗口 (Window) > 资源管理 (Asset Management) > 版本控制 (Version Control))。 |
| 提交 (Submit) | 将文件的当前状态提交到版本控制系统。 | 是 | 是 |
| 签出 (Check Out) | 允许对文件进行更改。 | 是 | 是 |
| Check Out (Other) | 选择是要签出资源及其 .meta 文件,仅签出资源,还是仅签出 .meta 文件。 | 是 | 否 |
| 标记添加 (Mark Add) | 将文件添加到版本控制中。 | 是 | 是 |
| 还原 (Revert) | 放弃对打开的已更改文件所做的更改。 | 是 | 是 |
| 还原未更改内容 (Revert Unchanged) | 从先前已签出但尚未修改的文件中删除“已签出”状态。 | 是 | 是 |
| 解决冲突 (Resolve Conflicts) | 解决已被多个用户更改的文件的冲突。 | 是 | 否。冲突出现在版本控制菜单中,但是您需要在 Plastic SCM GUI 中解决冲突。 |
| 锁定 (Lock) | 阻止其他用户提交对文件的更改。 | 是 | 否。要在 Plastic SCM 中锁定或解锁文件,必须在外部编辑特定的 Plastic SCM 锁定文件。有关更多信息,请参阅 Plastic SCM 集成页面。 |
| 解锁 (Unlock) | 解锁,并允许任何人提交更改。 | 是 | 否。要在 Plastic SCM 中锁定或解锁文件,必须在外部编辑特定的 Plastic SCM 锁定文件。有关更多信息,请参阅 Plastic SCM 集成页面。 |
| Diff | 比较计算机上的本地文件和服务器上的文件之间的差异。您可以选择仅比较资源文件,或比较资源文件及其 .meta 文件。 | 是 | 是 |
签出文件
在某些版本控制系统(例如 Perforce)中,默认情况下,版本控制文件为只读,并且要求您在编辑文件之前先将它们签出(除非启用了__脱机工作 (Work offline) 设置)。从 Editor 中处理版本化的资源时,检视面板 (Inspector) 将显示用于启用文件编辑的__签出 (Check Out) 按钮。此外,项目设置 (Project Settings) 检视面板还具有 Checkout 按钮,可用于签出特定的项目设置。
如果您的自定义 Editor 脚本代码禁用了只读资源的另一个自定义编辑工具的某些部分,或者如果您要手动写入版本化文件,请使用 AssetDatabase.IsOpenForEdit 和 AssetDatabase.MakeEditable API 检查文件是否可编辑,并执行签出操作。
版本控制集成还公开了 Provider.PreCheckoutCallback 和 Provider.PreSubmitCallback C# 回调,用于自定义版本控制操作验证逻辑。
Unity 执行__保存项目 (Save Project)__ 操作时,会将您在 Editor 中修改或标记为已修改的所有资源写入磁盘中。然后会根据需要在版本控制中签出资源。即使没有对文件进行实际更改,这也可能导致资源被签出。如果 Editor 脚本在资源上调用 EditorUtility.SetDirty 但不检查资源是否已修改,通常会发生这种情况。
**注意:**如果 Unity 无法将更改提交到版本控制客户端(例如,如果服务器关闭或发生许可证问题),它会将更改存储于单独的变更集中。
在您保存了对 .scene 文件的更改后,Unity 会自动将该文件签出。如果使用 Plastic SCM,则还会自动签出自动生成的资源,例如光照贴图。
版本控制窗口
可以使用版本控制窗口来查看位于变更列表中的文件。要访问该窗口,请导航到__窗口 (Window) > 资源管理 (Asset Management) > 版本控制 (Version Control)__。
传出 (Outgoing) 选项卡列出了所有等待提交到版本控制中的本地更改。传入 (Incoming) 选项卡列出了需要从版本控制中拉取的所有更改。
在窗口中右键单击资源或变更列表可对它们执行操作。要在变更列表之间移动资源,只需将资源从一个变更列表拖动到目标变更列表的标题上。
图标
Editor 会显示以下图标来指示文件和资源的版本控制状态:
Icon | 目的 |
|---|---|
![]() | 本地添加的文件,等待添加到版本控制中。 |
![]() | 由另一个用户添加到版本控制中的文件,等待添加到版本控制中。 |
![]() | 文件已在本地签出。 |
![]() | 文件已被另一个用户远程签出。 |
![]() | 合并此文件时存在冲突并且需要解决。 |
![]() | 文件已在本地删除,在版本控制中等待删除。 |
![]() | 文件已被另一个用户删除,在版本控制中等待删除。 |
![]() | 文件尚未受版本控制可以使用__标记添加 (Mark Add)__ 操作来手动添加文件。 |
![]() | 文件已被您锁定,其他用户无法对其进行修改。 |
![]() | 文件已被另一个用户锁定,您无法对其进行修改。 |
![]() | 另一个用户已签入此文件的新版本使用__应用传入更改 (Apply Incoming Changes)__ 操作可获取最新版本。 |
![]() | 服务器正在请求此文件的版本控制状态,或正在等待响应。仅当使用集中式版本控制系统(如 Perforce)时才会显示。 |











