Git для разработчика SS14 - История изменений

Ser11y: /* Словарь: Внутренние операции Git */

2023-09-27T21:36:01Z

Словарь: Внутренние операции Git

Ser11y: Добавлена информация для Fork

2023-09-27T21:34:38Z

Добавлена информация для Fork

← Предыдущая версия		Версия от 02:34, 28 сентября 2023
Строка 39:		Строка 39:
	[[Файл:GitBashCloneCommand.png\|мини\|центр]]		[[Файл:GitBashCloneCommand.png\|мини\|центр]]
	Проделайте команду <code>git remote add upstream</code> с <code>https://git.arumoon.ru/Workbench-Team/space-station-14</code>, чтобы у Вас была возможность обновлять свои branch'и новыми обновлениями upstream'а.		Проделайте команду <code>git remote add upstream</code> с <code>https://git.arumoon.ru/Workbench-Team/space-station-14</code>, чтобы у Вас была возможность обновлять свои branch'и новыми обновлениями upstream'а.
			===== Fork: =====
			Нажмите <code>Ctrl + N</code> в программе, или File => Clone..., а затем введите адрес репозитория с припиской <code>.git</code> в конце.
			[[Файл:ForkCloneRepositoryButton.png\|мини\|центр]]

			Добавьте удалённый репозиторий, нажав следующую кнопку:
			[[Файл:ForkAddRemoteButton.png\|центр]]
			Введите <code>https://git.arumoon.ru/Workbench-Team/space-station-14.git</code>, чтобы у Вас была возможность обновлять свои branch'и новыми обновлениями upstream'а.
			[[Файл:ForkCreateBranchMenuText.png\|центр]]

	=== Подмодули ===		=== Подмодули ===
Строка 73:		Строка 80:
	[[Файл:GitBashNewBranchCommand.png\|мини\|центр]]		[[Файл:GitBashNewBranchCommand.png\|мини\|центр]]
	Параметр <code>-b</code> в <code>git checkout</code> здесь означает "проверь этот branch, и создай его, если он не существует".		Параметр <code>-b</code> в <code>git checkout</code> здесь означает "проверь этот branch, и создай его, если он не существует".
			===== Fork =====
			Ctrl + Shift + B или кнопка сверху откроет меню создания branch'а:
			[[Файл:ForkCreateBranchButton.png\|мини\|центр\|Кнопка создания branch'а]]
			[[Файл:ForkCreateBranchMenu.png\|мини\|центр\|Меню создания branch'а]]
			Создайте branch с именем funny-feature.

	Переключаться между branch'ами довольно просто: это называется проверкой branch'а. При этом локальные файлы и папки будут изменены в соответствии с веткой, поэтому Git будет кричать на Вас, если у Вас есть локальные изменения, а Вы пытаетесь выполнить проверку.		Переключаться между branch'ами довольно просто: это называется проверкой branch'а. При этом локальные файлы и папки будут изменены в соответствии с веткой, поэтому Git будет кричать на Вас, если у Вас есть локальные изменения, а Вы пытаетесь выполнить проверку.
Строка 78:		Строка 90:
	===== Git Bash =====		===== Git Bash =====
	[[Файл:GitBashCheckoutBranchCommand.png\|мини\|центр]]		[[Файл:GitBashCheckoutBranchCommand.png\|мини\|центр]]
			===== Fork =====
			Два раза нажмите на имя branch'а слева.
			[[Файл:ForkCheckoutBranchButton.png\|центр]]

	Ну а затем внесите любые локальные изменения! Это не имеет значения. Создайте новый файл, удалите всё, измените одну строку в файле и т.д. Это не повлияет на Ваш главный branch, потому что теперь это территория <code>funny-feature</code>!		Ну а затем внесите любые локальные изменения! Это не имеет значения. Создайте новый файл, удалите всё, измените одну строку в файле и т.д. Это не повлияет на Ваш главный branch, потому что теперь это территория <code>funny-feature</code>!
	==== Совмещение branch'ей ====		==== Совмещение branch'ей ====
Строка 104:		Строка 120:
	===== Git Bash =====		===== Git Bash =====
	[[Файл:GitBashCheckStatusCommand.png\|мини\|центр]]		[[Файл:GitBashCheckStatusCommand.png\|мини\|центр]]

			===== Fork =====
			Откройте меню локальных изменений, нажав на кнопку сверху слева:
			[[Файл:ForkCheckStatusCommand.png\|центр]]

	Теперь, когда Вы убедились, что все эти изменения выглядят хорошо, мы добавим их в область staging'а и сделаем commit с ними:		Теперь, когда Вы убедились, что все эти изменения выглядят хорошо, мы добавим их в область staging'а и сделаем commit с ними:
			===== Git Bash =====
	[[Файл:GitBashStashAndCommitCommand.png\|мини\|центр]]		[[Файл:GitBashStashAndCommitCommand.png\|мини\|центр]]

			===== Fork =====
			Добавляйте и убирайте изменения(выделите их) с помощью двух кнопок.
			[[Файл:ForkStashAndCommitMenu.png\|мини\|центр]]
			Напишите название и описание commit'а, а затем подтвердите отправку:
			[[Файл:ForkCommitMenu.png\|центр]]

	Теперь, когда изменения были добавлены в commit и отправлены в branch, они навсегда (вроде как) остаются в истории branch'а. Теперь мы можем сделать многое: объединить(merge) нашу <code>funny-feature</code> с нашим локальным мастер-branch'ем (если захотим, по какой-то причине), загрузить (push) наш branch <code>funny-feature</code> в наш удалённый репозиторий, или полностью удалить ветку. Мы выберем push и сделаем Merge Request.		Теперь, когда изменения были добавлены в commit и отправлены в branch, они навсегда (вроде как) остаются в истории branch'а. Теперь мы можем сделать многое: объединить(merge) нашу <code>funny-feature</code> с нашим локальным мастер-branch'ем (если захотим, по какой-то причине), загрузить (push) наш branch <code>funny-feature</code> в наш удалённый репозиторий, или полностью удалить ветку. Мы выберем push и сделаем Merge Request.

	== Pushing и создание Merge Request'ов ==		== Pushing и создание Merge Request'ов ==
	Merge Request означает, что Вы хотите, чтобы кодовая база объединила Ваши изменения в одного из Ваших branch'ей в один из их branch'ей. Прежде чем мы сможем это сделать, наш удаленный репозиторий GitLab (~~origin~~) должен знать о красивых branch'ах и commit'ах, которые мы создали локально, поэтому мы push'им эти изменения на удаленный репозиторий.		Merge Request означает, что Вы хотите, чтобы кодовая база объединила Ваши изменения в одного из Ваших branch'ей в один из их branch'ей. Прежде чем мы сможем это сделать, наш удаленный репозиторий GitLab (upstream) должен знать о красивых branch'ах и commit'ах, которые мы создали локально, поэтому мы push'им эти изменения на удаленный репозиторий.
	=== Проталкивание commit'ов ===		=== Проталкивание commit'ов ===
	Имейте в виду, что при использовании этих команд Git, скорее всего, запросит Ваши учетные данные GitLab, чтобы убедиться в том, что Вы имеете право выполнять push на этот удаленный репозиторий.		Имейте в виду, что при использовании этих команд Git, скорее всего, запросит Ваши учетные данные GitLab, чтобы убедиться в том, что Вы имеете право выполнять push на этот удаленный репозиторий.
Строка 115:		Строка 144:
	При отправке изменений мы указываем удалённый репозиторий, в который мы их отправляем, и локальный branch, из которого мы их отправляем. Все достаточно просто.		При отправке изменений мы указываем удалённый репозиторий, в который мы их отправляем, и локальный branch, из которого мы их отправляем. Все достаточно просто.

	Push'им наш branch в удалённый репозиторий (~~origin~~):		Push'им наш branch в удалённый репозиторий (upstream):
	===== Git Bash =====		===== Git Bash =====
	[[Файл:GitBashPushCommand.png\|мини\|центр]]		[[Файл:GitBashPushCommand.png\|мини\|центр]]

			===== Fork =====
			[[Файл:ForkPushCommandButton.png\|центр]]

	=== Создание Merge Request'ов ===		=== Создание Merge Request'ов ===
	Весёлая часть. Отправляемся на GitLab и создаём наш Merge Request:		Весёлая часть. Отправляемся на GitLab и создаём наш Merge Request:
Строка 139:		Строка 172:
	Делайте это регулярно и всегда до начала работы над новым branch'ем.		Делайте это регулярно и всегда до начала работы над новым branch'ем.

			===== Fork =====
			[[Файл:ForkPullUpstreamCommandButton.png\|центр]]

	== Приложения ==		== Приложения ==
Строка 183:		Строка 218:
	=== Проверка истории ===		=== Проверка истории ===
	<code>git log --oneline</code> - это Ваш друг. Он показывает короткие hashe'и commit'ов (уникальные идентификаторы), их сообщения, а также их branch'и и tag'и.		<code>git log --oneline</code> - это Ваш друг. Он показывает короткие hashe'и commit'ов (уникальные идентификаторы), их сообщения, а также их branch'и и tag'и.

			В Fork эта функция встроена в UI:
			[[Файл:ForkCommitHistory.png\|мини\|центр]]
	=== Очистка локальных изменений ===		=== Очистка локальных изменений ===
	Возможно, Вы случайно внесли ненужные изменения, и Вам не хочется возиться с созданием совершенно новой ветки или еще чего-нибудь, но Вы еще не сделали commit с ними.		Возможно, Вы случайно внесли ненужные изменения, и Вам не хочется возиться с созданием совершенно новой ветки или еще чего-нибудь, но Вы еще не сделали commit с ними.

Ser11y: /* Что такое branch? */

2023-09-27T20:56:16Z

Что такое branch?

← Предыдущая версия		Версия от 01:56, 28 сентября 2023
Строка 65:		Строка 65:

	Branch'ей можно создавать сколько угодно. Когда Вы создаете branch, он ответвляется от текущего branch'а и становится самостоятельным объектом, в который можно добавлять commit'ы.		Branch'ей можно создавать сколько угодно. Когда Вы создаете branch, он ответвляется от текущего branch'а и становится самостоятельным объектом, в который можно добавлять commit'ы.
	[[Файл:BranchDiagram.png\|центр\|Каждый маленький узел - это отдельный commit, а каждый цвет - отдельный branch.]]		[[Файл:BranchDiagram.png\|мини\|центр\|Каждый маленький узел - это отдельный commit, а каждый цвет - отдельный branch.]]
	==== Зачем это нужно? ====		==== Зачем это нужно? ====
	Технически, конечно, можно просто делать всю работу в одном branch'е и отправлять Merge Request'ы оттуда. Но создание различных branch'ей позволяет легко понять, где Вы находитесь, сколько изменений внесли, и дает возможность работать над несколькими особенностями(новым содержимым) одновременно.		Технически, конечно, можно просто делать всю работу в одном branch'е и отправлять Merge Request'ы оттуда. Но создание различных branch'ей позволяет легко понять, где Вы находитесь, сколько изменений внесли, и дает возможность работать над несколькими особенностями(новым содержимым) одновременно.

Ser11y: /* Что такое branch? */

2023-09-27T20:56:01Z

Что такое branch?

← Предыдущая версия		Версия от 01:56, 28 сентября 2023
Строка 65:		Строка 65:

	Branch'ей можно создавать сколько угодно. Когда Вы создаете branch, он ответвляется от текущего branch'а и становится самостоятельным объектом, в который можно добавлять commit'ы.		Branch'ей можно создавать сколько угодно. Когда Вы создаете branch, он ответвляется от текущего branch'а и становится самостоятельным объектом, в который можно добавлять commit'ы.
	[[Файл:BranchDiagram.png~~\|мини~~\|центр\|Каждый маленький узел - это отдельный commit, а каждый цвет - отдельный branch.]]		[[Файл:BranchDiagram.png\|центр\|Каждый маленький узел - это отдельный commit, а каждый цвет - отдельный branch.]]
	==== Зачем это нужно? ====		==== Зачем это нужно? ====
	Технически, конечно, можно просто делать всю работу в одном branch'е и отправлять Merge Request'ы оттуда. Но создание различных branch'ей позволяет легко понять, где Вы находитесь, сколько изменений внесли, и дает возможность работать над несколькими особенностями(новым содержимым) одновременно.		Технически, конечно, можно просто делать всю работу в одном branch'е и отправлять Merge Request'ы оттуда. Но создание различных branch'ей позволяет легко понять, где Вы находитесь, сколько изменений внесли, и дает возможность работать над несколькими особенностями(новым содержимым) одновременно.

Ser11y: /* Что такое branch? */

2023-09-27T20:55:35Z

Что такое branch?

← Предыдущая версия		Версия от 01:55, 28 сентября 2023
Строка 65:		Строка 65:

	Branch'ей можно создавать сколько угодно. Когда Вы создаете branch, он ответвляется от текущего branch'а и становится самостоятельным объектом, в который можно добавлять commit'ы.		Branch'ей можно создавать сколько угодно. Когда Вы создаете branch, он ответвляется от текущего branch'а и становится самостоятельным объектом, в который можно добавлять commit'ы.
	[[Файл:BranchDiagram\|мини\|центр\|Каждый маленький узел - это отдельный commit, а каждый цвет - отдельный branch.]]		[[Файл:BranchDiagram.png\|мини\|центр\|Каждый маленький узел - это отдельный commit, а каждый цвет - отдельный branch.]]
	==== Зачем это нужно? ====		==== Зачем это нужно? ====
	Технически, конечно, можно просто делать всю работу в одном branch'е и отправлять Merge Request'ы оттуда. Но создание различных branch'ей позволяет легко понять, где Вы находитесь, сколько изменений внесли, и дает возможность работать над несколькими особенностями(новым содержимым) одновременно.		Технически, конечно, можно просто делать всю работу в одном branch'е и отправлять Merge Request'ы оттуда. Но создание различных branch'ей позволяет легко понять, где Вы находитесь, сколько изменений внесли, и дает возможность работать над несколькими особенностями(новым содержимым) одновременно.
Строка 89:		Строка 89:
	[[Файл:MergeRequestExampleImage.png\|мини\|центр]]		[[Файл:MergeRequestExampleImage.png\|мини\|центр]]
	[[Файл:MergeRequestExampleCommitsImage.png\|мини\|центр]]		[[Файл:MergeRequestExampleCommitsImage.png\|мини\|центр]]

	=== Что такое commit? ===		=== Что такое commit? ===
	Commit'ы - это просто упакованные изменения в коде. Как разработчик, Вы выбираете, какие изменения войдут в commit и когда их вносить в branch. Commiting - это создание commit'а, который, по сути, является точкой сохранения, к которой можно вернуться в любое время.		Commit'ы - это просто упакованные изменения в коде. Как разработчик, Вы выбираете, какие изменения войдут в commit и когда их вносить в branch. Commiting - это создание commit'а, который, по сути, является точкой сохранения, к которой можно вернуться в любое время.

Ser11y: Дописано руководство, не включая Fork(GUI)

2023-09-27T20:53:58Z

Дописано руководство, не включая Fork(GUI)

Внесённые изменения

Ser11y в 15:20, 27 сентября 2023

2023-09-27T15:20:28Z

← Предыдущая версия		Версия от 20:20, 27 сентября 2023
Строка 54:		Строка 54:
	Если Вы все же хотите модифицировать движок напрямую или обновлять подмодуль вручную (автоматическое обновление иногда доставляет неудобства), создайте файл <code>DISABLE_SUBMODULE_AUTOUPDATE</code> в каталоге <code>BuildChecker/.</code>.		Если Вы все же хотите модифицировать движок напрямую или обновлять подмодуль вручную (автоматическое обновление иногда доставляет неудобства), создайте файл <code>DISABLE_SUBMODULE_AUTOUPDATE</code> в каталоге <code>BuildChecker/.</code>.

	Если по каким-либо причинам, Вам понадобится вручную обновить RobustToolbox, Вы можете использовать <code>cd RobustToolbox; git checkout v0.4.87</code> (замените <code>v0.4.87</code> на последнюю версию RobustToolbox), затем вы можете использовать <code>cd..\</code>, чтобы вернуться в репозиторий SS14. Это также пример использования cd для навигации по файлам, не выходя из командной строки.		Если по каким-либо причинам, Вам понадобится вручную обновить RobustToolbox, Вы можете использовать <code>cd RobustToolbox; git checkout v0.4.87</code> (замените <code>v0.4.87</code> на последнюю версию RobustToolbox), затем Вы можете использовать <code>cd..\</code>, чтобы вернуться в репозиторий SS14. Это также пример использования cd для навигации по файлам, не выходя из командной строки.
	== Branching & Commits (Ветки и коммиты) ==		== Branching & Commits (Ветки и коммиты) ==

Ser11y: Перевод до Branching & Commits

2023-09-27T15:15:52Z

Перевод до Branching & Commits

@@ Строка 1: / Строка 1: @@
 == Предисловие ==
-Если Вам не ясны какие-либо термины из текста ниже, обратитесь к разделу Словарь: [[Git_для_разработчика_SS14#Словарь:_Внутренние_операции_Git|Словарь: Внутренние операции Git]].
+В тексте будет часто упоминаться GitLab - аналог GitHub, которым также пользуется Workbench Team. Принципиальной разницы нет, все шаги возможны и на GitHub, но лично мне удобнее работать с GitLab.
 == Установка Git ==
 === Fork ===
-=== Git Bash ===
+[https://git-fork.com/ Fork] — быстрый и удобный Git-клиент, позволяющий делать всё, что можно в консоли, но удобнее.
 == Налаживание репозиториев Git ==
 === Создание Вашего remote репозитория ===
 === Создание Вашего локального репозитория ===
 === Подмодули ===
 == Branching & Commits (Ветки и коммиты) ==

Ser11y в 14:11, 27 сентября 2023

2023-09-27T14:11:27Z

← Предыдущая версия		Версия от 19:11, 27 сентября 2023
Строка 1:		Строка 1:
	== Предисловие ==		== Предисловие ==
			Если Вам не ясны какие-либо термины из текста ниже, обратитесь к разделу Словарь: [[Git_для_разработчика_SS14#Словарь:_Внутренние_операции_Git\|Словарь: Внутренние операции Git]].

	== Установка Git ==		== Установка Git ==

Ser11y: Добавлены заголовки

2023-09-27T14:09:38Z

Добавлены заголовки

Новая страница

== Предисловие ==

== Установка Git ==
=== Fork ===
=== Git Bash ===

== Налаживание репозиториев Git ==

=== Создание Вашего remote репозитория ===
=== Создание Вашего локального репозитория ===
=== Подмодули ===

== Branching & Commits (Ветки и коммиты) ==

=== Что такое branch? ===
==== Зачем это нужно? ====
==== Создание и работа с branch'ами ====
==== Совмещение branch'ей ====

=== Что такое commit? ===
==== Отправка commit'ов в branch'и ====

== Pushing и создание Merge Request'ов ==
=== Проталкивание commit'ов ===
=== Создание Merge Request'ов ===

== Обновление репозитория ==
=== Метод fetch + merge ===
=== Метод pull ===

== Приложения ==
=== Что следует помнить ===
=== Краткий пример рабочего процесса ===

== Словарь: Внутренние операции Git ==

== Примечание: Полезные советы и рекомендации ==
=== Разрешение конфликтов при merge ===
=== Проверка истории ===
=== Очистка локальных изменений ===
=== Откат сделанного Вами commit'а ===

← Предыдущая версия		Версия от 02:36, 28 сентября 2023
Строка 187:		Строка 187:

	'''Branches''' - это автономные версии кодовой базы, в которые можно добавлять коммиты. По умолчанию используется ветка master, но их можно создавать сколько угодно.		'''Branches''' - это автономные версии кодовой базы, в которые можно добавлять коммиты. По умолчанию используется ветка master, но их можно создавать сколько угодно.

	'''Репозитории''' - это папки, в которых с помощью Git можно вносить изменения и отслеживать их. Локальные репозитории - это репозитории, которые находятся у Вас на компьютере, а удаленные репозитории - это репозитории, расположенные на таких сайтах, как GitLab Репозитории состоят из множества веток.		'''Репозитории''' - это папки, в которых с помощью Git можно вносить изменения и отслеживать их. Локальные репозитории - это репозитории, которые находятся у Вас на компьютере, а удаленные репозитории - это репозитории, расположенные на таких сайтах, как GitLab Репозитории состоят из множества веток.

	'''Remotes''' - это названия и ссылки на удаленные репозитории, которые может использовать Ваш локальный репозиторий.		'''Remotes''' - это названия и ссылки на удаленные репозитории, которые может использовать Ваш локальный репозиторий.

	'''Подмодули''' - это репозитории, которые находятся внутри другого репозитория.		'''Подмодули''' - это репозитории, которые находятся внутри другого репозитория.

	'''Forks''' - это репозитории, основанные на другом репозитории. Если Вы собираетесь сделать Merge Request для SS14, Вам необходимо сначала сделать Fork.		'''Forks''' - это репозитории, основанные на другом репозитории. Если Вы собираетесь сделать Merge Request для SS14, Вам необходимо сначала сделать Fork.

	'''The working tree''' - это все файлы, папки и т.п., находящиеся в репозитории.		'''The working tree''' - это все файлы, папки и т.п., находящиеся в репозитории.
	'''Staging''' означает добавление (с помощью git add) изменений в 'staging area', где с ними могут быть выполнены некоторые действия
			'''Staging''' означает добавление (с помощью git add) изменений в 'staging area', где с ними могут быть выполнены некоторые действия.

	'''Commits''' - это изменения рабочего дерева репозитория в определенный момент времени. По сути, это точка сохранения. Commit - это просто список файлов, которые были изменены с момента последнего коммита, а изменения, которые были commit'нуты, - это изменения, которые Вы отправили в staging area.		'''Commits''' - это изменения рабочего дерева репозитория в определенный момент времени. По сути, это точка сохранения. Commit - это просто список файлов, которые были изменены с момента последнего коммита, а изменения, которые были commit'нуты, - это изменения, которые Вы отправили в staging area.

	'''Checking out''' - это переключение на другой branch, чтобы работать с ним или просматривать его изменения локально.		'''Checking out''' - это переключение на другой branch, чтобы работать с ним или просматривать его изменения локально.

	'''Merging''' - это интеграция изменений из одного branch'а в другой.		'''Merging''' - это интеграция изменений из одного branch'а в другой.
	Конфликты merge'а" возникают, когда интеграция изменений из одного branch'а в другой не может быть выполнена автоматически, поскольку они оба изменяют одну и ту же область в файле, или их изменения взаимоисключают друг друга каким-либо другим способом.
			'''Конфликты merge'а''' возникают, когда интеграция изменений из одного branch'а в другой не может быть выполнена автоматически, поскольку они оба изменяют одну и ту же область в файле, или их изменения взаимоисключают друг друга каким-либо другим способом.

	'''Fetching''' означает получение branch'ей и commit'ов удаленного репозитория, но на самом деле... еще ничего с ними не делая. Они будут просто обновлены, если вы захотите проверить или объединить их позже.		'''Fetching''' означает получение branch'ей и commit'ов удаленного репозитория, но на самом деле... еще ничего с ними не делая. Они будут просто обновлены, если вы захотите проверить или объединить их позже.

	'''Pulling''' - это акт интеграции изменений из branch'а удаленного репозитория в Ваш локальный branch.		'''Pulling''' - это акт интеграции изменений из branch'а удаленного репозитория в Ваш локальный branch.
	Merge Requests" - это действие, позволяющее запросить слияние Вашего локального branch'а и всех его изменений с branch'а другого репозитория.
			'''Merge Requests''' - это действие, позволяющее запросить слияние Вашего локального branch'а и всех его изменений с branch'а другого репозитория.

	'''Pushing''' - это действие по интеграции локальных изменений в удаленный репозиторий.		'''Pushing''' - это действие по интеграции локальных изменений в удаленный репозиторий.