Skip to content
Search

版本控制

Locus 无需版本控制即可运行。如果 Unreal 有活动提供程序,Locus 会根据每种内容类型的所有权应用提供程序感知规则。

内容 提供程序行为
共享笔记 新建时标记为添加;受控后执行显式签出、状态检查和安全删除
私有笔记 不查询或操作提供程序
共享标记点 新建时标记为添加;受控后执行显式签出、状态检查和安全删除
私有标记点 不查询或操作提供程序
文档 项目所有;创建时为未跟踪,然后显式标记为添加;受控后执行签出、状态检查和安全删除

私有表示内容位于项目 Saved 存储边界内。Locus 对私有笔记和标记点严格保持零提供程序交互。

在未配置提供商的情况下,Locus 进入本地模式。本地和未跟踪的文件保持可编辑状态,无需提供商警告或后台调用; 笔记、标记点 和 文档 不显示提供者状态、指示器、工具提示、指导、标记为添加签出 可供性。共享内容保留在项目拥有的根中。

已配置但不可用的提供程序是独特的,并且会保护已知的受控内容。如果可用,状态栏将使用 Unreal 的标准版本控制图标。 显示版本控制状态仅控制紧凑行指示器;干净的跟踪行在记录的地方保持安静。

选择、打开或阅读干净的受控内容不会对其进行检查。共享 笔记 需要显式 签出。受控共享 标记点 的受支持突变会自动请求结帐,并且仅在允许时才继续进行;失败使其受到保护。

受控文档仍可读取,但其权威 Markdown 编辑保存操作在签出成功前不可用。受控文件被其他用户或客户端签出、已过时、与所需提供程序断开连接,或处于 Locus 无法验证的状态时,也会应用相同保护。适用时,文档仍可使用导出副本

重新连接提供程序后,如有需要请刷新版本控制或 Locus。受控状态会恢复,但干净文件仍保持只读,直到明确签出。

Locus 不会为只读受控文件提供强制写入绕过方式。

新共享 笔记 保留其创建后 标记为添加 请求;失败留下有效文件以供重试。新的共享 标记点 保留为 Untracked,直到明确添加为止,包括符合条件的多项选择。共享 标记点 快照是一个单独的映像,具有自己的添加或签出状态。

新文档会有意保持未跟踪。先创建、整理、重命名、移动和编辑文档,再在最终路径稳定后使用标记为添加。未跟踪文档在其他条件安全时可以重命名或移动。已标记为添加或已经受控的文档不能通过 Locus 重命名或移动,因为 Locus 无法保证与提供程序无关的事务性移动。它不会提供设为可写这种绕过方式,也不会要求你禁用版本控制来绕过这一边界。

本地文件只有通过项目的常规工作流添加并提交后才会与团队成员共享。提交后,文件受版本控制,并使用签出进行后续编辑;不会再次标记为添加。

删除需要确认。对于受控文件,Locus 会检查报告的状态,并在本地清理前通过提供程序执行删除。如果其他用户拥有签出、文件已过时或无法建立安全性,Locus 会阻止删除。

Perforce 是当前拥有项目验证证据的提供程序。协作笔记和标记点常用的项目 typemap 选择如下:

text+l //....uenote
text+l //....locuspin

这会将 JSON 文件视为带独占锁的文本。Markdown 文档是普通文本文件;请选择适合存储库的 .md 策略。Locus 不会替你编辑 Perforce typemap。

其他 Unreal Source Control 提供程序在 1.0 中按尽力而为方式支持,且未经验证。依赖前请在一次性项目中验证提供程序行为。

Perforce 是 1.1 的实时认证提供商。其他 Unreal 源代码控制提供商已尽最大努力且未经验证;在一次性项目中测试它们。

恢复快照保护未保存的本地工作,但不替代版本控制。当本地编辑器有待处理更改时磁盘内容发生变化,就会出现外部冲突;Locus 会阻止静默覆盖并提供安全解决操作。版本控制的过时状态和编辑器冲突相关但并非同一条件。

请参阅笔记标记点文档中的恢复部分,或使用故障排除