Система контроля версий

Locus работает без системы контроля версий. Если в Unreal активен поставщик, Locus применяет правила с учётом поставщика и владения каждым типом содержимого.

Владение определяет поведение поставщика

Содержимое	Поведение поставщика
Общие заметки	Для новых — Пометить для добавления; для контролируемых — явное получение для редактирования, состояние и безопасное удаление
Личные заметки	Нет запросов к поставщику и операций поставщика
Общие метки	Для новых — Пометить для добавления; для контролируемых — явное получение для редактирования, состояние и безопасное удаление
Личные метки	Нет запросов к поставщику и операций поставщика
Документы	Принадлежат проекту; создаются как Неотслеживаемые, затем явно Пометить для добавления; для контролируемых — получение для редактирования, состояние и безопасное удаление

Личные материалы хранятся локально в области Saved проекта. Для Личных заметок и меток Locus никогда не опрашивает поставщика и не выполняет через него операции.

Локальный режим

Если провайдер не настроен, Locus переходит в локальный режим. Локальные и неотслеживаемые файлы остаются доступными для редактирования без предупреждений провайдера или фоновых вызовов; заметка, метка и документ не отображают статус поставщика, индикатор, подсказку, руководство, а также доступность Пометить для добавления или Получить для редактирования. Общий контент остается в корнях, принадлежащих проекту.

Настроенный, но недоступный поставщик отличается от других и обеспечивает защиту известного контролируемого контента. Если это возможно, в строке состояния используется стандартный значок контроля версий Unreal. Показать статус системы контроля версий управляет только индикаторами компактных рядов; чистые гусеничные ряды остаются тихими там, где это задокументировано.

Получение для редактирования и состояния только для чтения

Выбор, открытие или чтение чистого контролируемого содержимого не проверяет его. Общий заметка требует явного Получить для редактирования. Поддерживаемая мутация управляемого общего метка автоматически запрашивает извлечение и выполняется только тогда, когда это разрешено; неудача оставляет его защищенным.

Контролируемые документы остаются доступными для чтения, но их авторитетные действия Markdown Режим редактирования и Сохранить недоступны до успешного получения для редактирования. Та же защита действует, если контролируемый файл получен другим пользователем или клиентом, устарел, отключён от нужного поставщика или находится в состоянии, которое Locus не может проверить. Экспортировать копию остаётся доступным для документов, если применимо.

После восстановления подключения к поставщику при необходимости обновите Систему контроля версий или Locus. Контролируемое состояние вернётся, но чистый файл останется доступным только для чтения до явного получения для редактирования.

Locus не предоставляет обход Make Writable для контролируемого файла, доступного только для чтения.

Новые файлы и Пометить для добавления

Новые общие заметка сохраняют свой запрос Пометить для добавления после создания; сбой оставляет действительный файл для повторной попытки. Новые общие метка остаются Untracked до тех пор, пока они не будут добавлены явно, включая соответствующий множественный выбор. Общий снимок метка — это отдельный образ с собственным состоянием добавления или извлечения.

Новые документы намеренно остаются Неотслеживаемыми. Сначала создайте, организуйте, переименуйте, переместите и измените документ, затем используйте Пометить для добавления, когда его окончательный путь стабилен. Неотслеживаемый документ можно переименовать или переместить, если это в остальном безопасно. Документ, помеченный для добавления или уже контролируемый, нельзя переименовать или переместить через Locus, поскольку Locus не может гарантировать транзакционное перемещение, нейтральное к поставщику. Locus не использует обход Make Writable и не предлагает отключать систему контроля версий для обхода этой границы.

Локальный файл не становится общим для команды, пока не будет добавлен и отправлен обычным рабочим процессом проекта. После отправки файл контролируется и для дальнейших изменений использует Получить для редактирования; повторная пометка для добавления не выполняется.

Безопасность важнее удобства

Locus отказывается от операции, которую не может синхронизировать с системой контроля версий, вместо того чтобы молча оставить файл и состояние поставщика по разным путям.

Удаление

Удаление требует подтверждения. Для контролируемых файлов Locus проверяет сообщённое состояние и направляет удаление через поставщика до локальной очистки. Удаление блокируется, если другой пользователь владеет получением для редактирования, файл устарел или безопасность невозможно установить.

Locus не отправляет изменения

Locus не отправляет файлы, не создаёт и не администрирует changelist, не синхронизирует рабочую область и не изменяет конфигурацию репозитория. Проверяйте и отправляйте изменения обычными инструментами системы контроля версий Unreal или команды.

Рекомендации для Perforce

Perforce — поставщик, для которого есть текущие подтверждения проверки проекта. Типичный выбор typemap для совместной работы с заметками и метками:

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

Так JSON-файлы рассматриваются как текст с исключительной блокировкой. Документы Markdown — обычные текстовые файлы; выберите подходящую для репозитория политику .md. Locus никогда не изменяет typemap Perforce.

Остальные поставщики системы контроля версий Unreal поддерживаются без гарантий и не проверялись для версии 1.0. Перед использованием проверьте поведение поставщика в тестовом проекте, где потеря данных не будет проблемой.

Perforce — сертифицированный поставщик для версии 1.1. Другие поставщики Unreal Source Control прилагают все усилия и не проверены; протестируйте их в одноразовом проекте.

Восстановление и внешние конфликты

Снимки восстановления защищают несохранённую локальную работу и не заменяют систему контроля версий. Внешний конфликт возникает, когда содержимое на диске меняется, пока локальный редактор имеет ожидающие изменения; Locus блокирует незаметную перезапись и предлагает безопасные действия для разрешения конфликта. Состояние устаревания системы контроля версий и конфликты редактора связаны, но являются разными условиями.

См. разделы восстановления в Заметках, Метках и Документах или воспользуйтесь разделом Устранение неполадок.