Ветки

Ветка - это изолированная линия разработки. Каждая контрольная точка принадлежит ветке, и серия контрольных точек в ветке может отслеживать разработку приложения или определенной функции. Проект PlayCanvas всегда будет иметь хотя бы одну ветку, основную ветку, и часто будет иметь несколько веток. Вы можете объединить изменения из одной ветки в любую другую ветку с помощью панели управления версиями в редакторе.

Основная ветка

Каждый проект имеет ветку с названием "main", которая всегда присутствует и не может быть удалена. Во многих отношениях эта ветка ничем не отличается от любой другой ветки. Однако в некоторых случаях (например, REST API) ветка "main" будет использоваться по умолчанию, если не указана другая ветка. Распространенный сценарий заключается в том, чтобы рассматривать основную ветку как текущее состояние разработки вашего приложения; использовать другую ветку для стабильных выпусков и еще больше веток для разработки функций. Однако вы должны чувствовать себя свободно использовать или не использовать основную ветку так, как это лучше всего соответствует вашим потребностям.

Текущая ветка

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

Создание новой ветки

Чтобы создать ветку, откройте панель управления версиями, выберите контрольную точку, с которой вы хотите начать ветку, и выберите опцию "New Branch" в выпадающем меню контрольной точки.

Вам будет предложено дать имя вашей ветке. Постарайтесь дать вашей ветке описательное имя, например fix-player-bug или refactor-sound-effects. После создания ветки вы автоматически переключитесь на новую ветку, которую только что создали.

Ветки, созданные вами, автоматически будут добавлены в избранное, чтобы вы могли быстро найти их в фильтре веток для избранных.

Фильтрация списка веток

Вы можете фильтровать ветки между:

• Избранные - Ветки, добавленные вами в избранное.
• Открытые - Все открытые ветки.
• Закрытые - Все закрытые ветки.

Добавление ветки в избранное можно сделать следующими способами:

Выпадающее меню

Кнопка выбранной ветки

Поиск ветки

Чтобы найти ветку в текущем списке фильтров, вы можете использовать строку поиска сверху.

Переключение на ветку

Чтобы переключиться на другую ветку, откройте панель управления версиями, выберите ветку, на которую вы хотите переключиться, и выберите опцию "Switch to this branch" в выпадающем меню ветки.

Редактор перезагрузится с вашей текущей веткой, переключенной на выбранную ветку.

Закрытие ветки

Если вы завершили работу над веткой, вы можете закрыть ее, что уберет ее из списка открытых веток.

Чтобы закрыть ветку, откройте панель управления версиями, выберите ветку, которую вы хотите закрыть, и выберите опцию "Close this branch" в выпадающем меню ветки. Обратите внимание, что вы не можете закрыть текущую ветку или основную ветку. Переключитесь на другую ветку сначала, если вы хотите закрыть текущую ветку.

Вам будет предложено подтвердить закрытие ветки, и у вас есть возможность создать контрольную точку перед закрытием. Эта опция включена по умолчанию. Если вы хотите отказаться от этих изменений, вы можете снять флажок здесь.

Примечание: снятие этого флажка приведет к потере всех работ, выполненных в ветке с момента создания последней контрольной точки

Закрытые ветки также могут быть повторно открыты в последующем.

Удаление ветки

Удаление веток поддерживается только при выполнении следующих условий:

• Ветка не была объединена с другой веткой
• Из этой ветки не было создано никаких других веток

Чтобы удалить ветку, откройте панель управления версиями, выберите ветку, которую вы хотите удалить, и выберите опцию "Delete this branch" в выпадающем меню ветки.

Вам будет предложено подтвердить удаление ветки, введя имя ветки в диалоговом окне.

Обратите внимание, удаленные ветки нельзя восстановить после удаления! Если сомневаетесь, лучше закройте ветку.