🖥️GitHub Desktop

Автор: Дмитрий Прокопьев

В предыдущей статье мы поняли, что GitHub это очень удобный сервис. Но если вы уже попробовали выложить туда свой проект, то могли заметить проблему - непонятно, как загрузить туда проект. Первое решение, которое вы могли найти, это кнопка загрузки файлов в главном окне просмотра репозитория:

Кнопка загрзки файлов

Проблема ручной загрузки

Можем ли выкладывать проекты таким способом, вручную указывая файлы для загрузки? Теоретически, да. Но тогда теряется весь смысл Git - инструмента, вокруг которого построен GitHub, так как мы теперь вручную контролируем все файлы и не отслеживаем историю изменений. Было бы лучше работать с Git локально, на своем устройстве, а историю коммитов синхронизировать с GitHub. И это возможно!

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

Создаем и публикуем репозиторий:

cd MyProject
git init
git remote add origin https://github.com/myaccount/myproject

Создаем новый коммит и отправляем его на GitHub:

git commit -m "Fixed all the bugs"
git push

Если привыкнуть, то все просто. Но часто у нас нет времени или возможности разобраться с консольным интерфейсом, поэтому мы рассмотрим другой способ - GitHub Desktop.

GitHub Desktop

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

Создание и настройка репозитория

Для начала создадим репозиторий локально. Для этого нужно открыть GitHub Desktop и перейти в File -> New repository...

Опция создания нового репозитория

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

Name

Название репозитория. Есть ограничения по символам, например знак пробела заменяется на знак "-".

Description

Описание репозитория. Необязательная, но полезная часть, где можно одним предложением описать суть проекта.

Local Path

Локальный путь к репозиторию. Важно верно указать корневую директорию (папку) проекта, чтобы Git считывал изменения во всех файлах.

Git ignore

Файл метаданных .gitignore, зачем он нужен мы рассмотрели в статье про GitHub. Предлагается множество вариантов для популярных движков и фреймворков. Есть и вариант для Unity, который мы будем использовать чаще всего.

License

Файл с лицензией. Нужен в том случае, если вы публикуете проект для массового применения и хотите формально (законно) определить правила его использования. Предлагается множество популярных вариантов на выбор.

Параметры окна создания репозитория

Если опция Initialize this repository with a README выбрана, то GitHub Desktop сам создаст файл README.md, который, как мы помним из статьи про GitHub, содержит в себе подробное описание репозитория для других пользователей.

Теперь репозиторий создан, но он существует только локально. Поэтому его нужно опубликовать, то есть отправить на GitHub. Для этого нужно нажать на кнопку сверху "Publish repository":

Кнопка публикации репозитория

Нажав эту кнопку мы видим еще одно окно настроек со своими параметрами:

Параметры публикации репозитория

Поля Name и Description здесь продублированы из предыдущего окна, но также появилось два новых поля.

ВНИМАНИЕ

Очень важно корректно указать опцию Keep this code private:

1. Если эта опция выбрана, то репозиторий будет приватным, то есть другие пользователи не смогут его увидеть.

2. Если эта опция не выбрана, то репозиторий будет публичным, то есть все пользователи GitHub смогут его увидеть

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

Поле Organization это опция выбора организации, в рамках которой вы публикуете этот проект. Для личных проектов это опция не важна.

Теперь репозиторий настроен и связан с GitHub - пора поместить в него наш проект. Заходим в Unity и создаем новый проект в папке репозитория.

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

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

Так как мы только что создали проект и поработали над ним, множество файлов было создано и изменено, что нам и показывает GitHub Desktop. Закрепим текущий этап разработки новым коммитом:

Окно создания коммита

Локально коммит сделан, не забываем отправить его на сервер:

Кнопка отправки коммита на сервер

Таким образом, мы связали локальный проект с сервером и все вносимые изменения можем в пару нажатий отправить на свой GitHub репозиторий - задача выполнена!