Unity & Git

Note

Данная мини-статься предназначена для новичков в Git и тех, кто хочет разобраться, как подключить его к Unity. Здесь вы не найдёте супер-пупер профессиональной информации... Можно сказать, что эта статья является так-же небольшим гайдом по самому Git`у.

Поддержать автора 🦊

Па-ба-баааам... Вы хотите использовать Мерзавца совместно с вашим Единством 6.0000 и вообще не разбираетесь в данном вопросе?! Не беда! Сегодня я расскажу Вам, как это сделать!

Caution

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

Установка Git

Если у Вас еще не установлен Git, скачайте и установите его с официального сайта.

1. Создайте проект Unity

Для начала, необходимо создать проект Unity, если у Вас уже имеется таковой, пропустите этот шаг.

2. Создайте репозиторий

1. Откройте терминал (или командную строку) и перейдите в папку вашего проекта Unity.

Данная команда переместит указатель терминала (или командной строки) в указанную папку

cd <имя_папки_репозитория>

Tip

Так-же вы можете открыть Git bash сразу в необходимой вам директории: ПКМ по пустому месту в проводнике с открытой директорией > Open Git Bash here

Warning

Очень важно создать Git репозиторий в правильном месте!!! Папка .git должна быть размещена в одной папке с: Assets, Plugins, Builds и т.д... .../Ваша_папка_со_всеми_проектами_Unity/Ваш_проект/вот_здесь.

2. Выполните команду:

git init

Данная команда инициализирует репазиторий в выбранной вами директории.

Tip

Если включить отображение скрытых файлов, вы должны увидеть новую, полу-прозрачную парку .git — это и есть ваш репозиторий!

3. Настройте .gitignore

Unity создает множество временных и кэшированных файлов, которые не нужно отслеживать. Создайте файл .gitignore в корне вашего проекта для того чтобы Git игнорировал их.

Tip

Вы можете использовать стандартный .gitignore от GitHub, ради Вашего удобства Я вложил его в репозиторий.

4. Добавьте файлы в репозиторий

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

git add .

Note

"." — означает внесение вообще всех изменений. Если Вам нужно зарегистрировать конкретные файлы, впишите за место "." путь к Вашему файлу.

Tip

Для проверки статуса Вашего репозитория используйте команду:

git status

5. Первый коммит!

Ну чтож... Настало время для Вашего первого коммита! Для этого Вам необходимо вписать данную команду:

git commit -m "Initial commit"

Теперь, вы готовы к работе!!!

Note

За место "Initial commit" в последующих коммиах Вы будите прописывать название комита. Старайтесь уложить в название комита его смысл. Коммиты можно называть и русскими названиями! Однако, ради хорошего тона делайте все коммиты в одном стиле, придумайте его или узнайте как люди обычно коммитят. Если Вы использовали русский язык, старайтесь использовать его до конца, ну или отстаньте от себя наконец и живите в кайф называя коммиты: "jsvekrvkfb Я не знаю что писать 123"))) (шуткую~)

Создание README.md (опционально)

Далее можно создать файл README.md, именно его Вы сейчас и читаете) Такой файлик — лицо вашего проекта, в нём вы можете рассказать про него, про то как его ставить и как с ним работать! (Если Ваш проект SDK или библиотека)

Note

Всю информацию о том, как красиво оформить такой файлик Вы можете найти здесь.

Настройте удаленный репозиторий (опционально)

Если Вы хотите хранить проект на GitHub или другом удаленном сервисе, создайте новый репозиторий на выбранной платформе и свяжите его с вашим локальным репозиторием:

git remote add origin <URL вашего репозитория>

Warning

На GitHub необходимо создать именно пустой проект. Чтобы он был пустым необходимо НЕ создать НИКАКИХ стартовых файлов. Здесь речь идёт именно про предложение GitHub об автоматическом создании README.md,.gitignore и прочих. Отключите это.

Полезные команды для работы с удаленным репозиторием (опционально)

Вот так можно отправлять изменения на удалённый репозиторий:

git push -u origin master

Note

Замените master на имя ветки, если Вы работаете с другой веткой.

Вот так можно клонировать репозиторий на другое устройство:

git clone <URL вашего репозитория>

Если у Вас уже есть Репазиторий и Вы хотите принять все изменения с облачного на него, то используйте:

git pull origin master

Note

Замените master на имя ветки, если Вы работаете с другой веткой.

Разрешение конфликтов (если необходимо)

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

git add <файлы_с_конфликтами>
git commit -m "Resolved merge conflicts"

Таблица всех использованных команд в этой статье:

Команда	Что делает
cd <имя_папки_репозитория>	Переместит указатель терминала (или командной строки) на указанную директорию.
git init	Данная команда инициализирует репазиторий в выбранной вами директории.
git add .	Регистрирует изменения в файлах отслеживаемой директории.
git status	Отображает статус вашего репозитория.
git commit -m "Название вашего коммита"	Сделать коммит.
git push -u origin master	Отправить все изменения на облачный репозиторий. В данном случае: на ветку master.
git clone <URL вашего репозитория>	Клонирует облачный репозиторий на устройство.
git pull origin master	Принимает изменения, произошедшие на облачном сервере. В данном случае: на ветке master.