Ветки позволяют экспериментировать с проектом, не рискуя сломать рабочую версию. Все изменения сначала делаются в отдельной ветке, а уже потом, при необходимости, объединяются с основной (master-ветка).
Шаг 1. В GitHub Desktop есть вкладка Current branch. В ней отображается, в какой ветке мы сейчас работаем. Чтобы создать новую ветку, кликаем Current branch > New branch и даем имя, например, New_UI.
Шаг 2. Вносим изменения в проект UE.
Я добавила блюпринт (BP_Test) и внесла изменения в контроллер.
UE5 отмечает новые и измененные файлы следующими значками:
? (untracked) — новый файл, не добавлен в контроль версий;
+ (staged) — новый файл помечен для добавления в систему контроля версий, но еще не зафиксирован коммитом;
✔ (modified) — файл, который уже находился под контролем версий и был изменен, но его текущие изменения еще не зафиксированы в коммите.
Шаг 3. Фиксируем изменения в текущей ветке.
Переходим Revision Control > Submit Content. Появится окно со списком всех внесенных изменений. В поле Changelist Description кратко описываем, что было сделано, это описание будет отображаться в истории Git. После этого нажимаем Submit, и изменения сохранятся в текущей ветке системы контроля версий.
Изменения можно посмотреть в истории GitHub.
Также текущие изменения можно посмотреть в проекте UE: ПКМ по ассету > Revision Control > Diff Against Depot. Откроется сравнение текущей версии с последней зафиксированной в системе контроля версий.
Историю изменений конкретного ассета можно открыть через: ПКМ по ассету → Revision Control → History. Выбрав нужную ревизию и нажав Diff Against Previous Revision, можно посмотреть, какие изменения были внесены по сравнению с предыдущей версией.
Как объединить ветку с изменениями с master-веткой
Если эксперимент в отдельной ветке оказался удачным, его можно добавить в основную ветку проекта.
Шаг 1. Закрываем проект в Unreal Engine.
Перед слиянием веток Unreal должен быть закрыт, чтобы избежать конфликтов с файлами.
Шаг 2. Открываем GitHub Desktop.
На панели Current repository должен быть выбран нужный проект, а на Current branch — master. Кликаем Current branch > Choose a branch to merge into master.
Выбираем ветку для слияния, в моем случае, это New_UI и кликаем Create a merge commit.
Все. Слияние веток произошло.
Во вкладке History видно, что история master-ветки теперь включает изменения из экспериментальной ветки.
Шаг 3. Удаляем ветку (по желанию).
Если ветка больше не нужна, переключаемся на нее в Current branch и кликаем Branch > Delete.
На этом настройка базового рабочего процесса с Git завершена. Теперь вы можете спокойно экспериментировать с проектом, сохранять изменения и при необходимости добавлять их в основную версию.