Как внести свой вклад в открытый исходный код: начало работы с Git

Статус: устарело

Эта статья устарела и больше не поддерживается.

Причина

Теперь мы предоставляем инструкции по настройке Git для каждой платформы отдельно.

Смотрите вместо этого

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

• Как установить Git в Ubuntu 20.04

Введение

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

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

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

Участие в проектах с открытым исходным кодом

Программное обеспечение с открытым исходным кодом — это программное обеспечение, которое свободно доступно для использования, распространения и модификации.

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

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

Лучший способ начать вносить свой вклад в проекты с открытым исходным кодом — начать с участия в программном обеспечении, которое вы уже используете. Как пользователь конкретного инструмента, вы лучше всего понимаете, какие функции будут наиболее ценными для проекта. Обязательно сначала прочтите любую доступную документацию по программному обеспечению. На самом деле, многие проекты с открытым исходным кодом имеют файл CONTRIBUTING.md в корневом каталоге, который вы должны внимательно прочитать, прежде чем вносить свой вклад. Вы также можете получить представление о взаимодействии между другими разработчиками в сообществе, если есть доступные форумы о проекте.

Наконец, если вы начинаете с участия в разработке программного обеспечения с открытым исходным кодом, рекомендуется начать с чего-то небольшого — каждый вклад ценен. Вы можете начать с исправления опечаток, добавления комментариев или написания более четкой документации.

Одной из самых популярных систем контроля версий программного обеспечения является Git. Git был создан в 2005 году Линусом Торвальдсом, создателем ядра Linux. Первоначально использовавшийся для разработки ядра Linux, Джунио Хамано в настоящее время является сопровождающим проекта.

Многие проекты хранят свои файлы в репозитории Git, а такие сайты, как GitHub, GitLab и Bitbucket, упростили процесс обмена и внесения кода. Каждый рабочий каталог в Git — это полноценный репозиторий с полной историей и отслеживанием, не зависящим от доступа к сети или центрального сервера.

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

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

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

Проверьте, установлен ли Git

Во-первых, вам нужно проверить, установлены ли на вашем компьютере инструменты командной строки Git. Если вы создавали репозитории собственного кода, то, скорее всего, на вашем локальном компьютере установлен Git. Некоторые операционные системы также поставляются с установленным Git, поэтому стоит проверить его перед установкой.

Вы можете проверить, установлен ли Git и какую версию вы используете, открыв окно терминала в Linux или Mac или окно командной строки в Windows и введя следующую команду:

git --version

Однако, если Git не установлен, вы получите сообщение об ошибке, подобное следующему:

-bash: git: command not found

'git' is not recognized as an internal or external command, operable program, or batch file.

В этом случае вам следует установить Git на свой компьютер. Давайте пройдем установку для нескольких основных операционных систем.

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

Безусловно, самый простой способ установить Git и подготовить его к использованию — использовать вашу версию репозиториев Linux по умолчанию. Давайте рассмотрим, как установить Git на ваш локальный компьютер с Linux, используя этот метод.

Установка Git на Ubuntu или Debian

Вы можете использовать инструменты управления пакетами APT для обновления локального индекса пакетов. После этого вы можете скачать и установить программу:

sudo apt update
sudo apt install git

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

Отсюда вы можете перейти к разделу «Настройка Git».

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

Мы будем использовать yum, собственный менеджер пакетов CentOS, для поиска и установки последнего пакета Git, доступного в репозиториях CentOS.

Давайте сначала убедимся, что yum обновлен, выполнив эту команду:

sudo yum -y update

Флаг -y используется для оповещения системы о том, что мы знаем о внесении изменений, не позволяя терминалу запрашивать подтверждение.

Теперь мы можем продолжить и установить Git:

sudo yum install git

Хотя это самый быстрый способ установки Git, его версия может быть старше самой новой версии. Если вам нужна последняя версия, рассмотрите возможность компиляции Git из исходного кода, следуя варианту 2 из этого руководства.

Отсюда вы можете перейти к разделу «Настройка Git».

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

Пакеты Git для Fedora доступны как через yum, так и через dnf. Представленный в Fedora 18, DNF или Dandified Yum стал менеджером пакетов по умолчанию для Fedora, начиная с Fedora 22.

В окне терминала обновите dnf и установите Git:

sudo dnf update
sudo dnf install git

Если у вас более старая версия Fedora, вместо этого вы можете использовать команду yum. Давайте сначала обновим yum, а затем установим Git:

sudo yum update
sudo yum install git

Отсюда вы можете перейти к разделу «Настройка Git».

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

На локальном компьютере Macintosh, если вы введете команду Git в окно терминала (как в git --version выше), вам будет предложено установить Git, если он еще не установлен в вашей системе. Когда вы получите это приглашение, вы должны согласиться с установкой Git, следовать инструкциям и отвечать на запросы в окне терминала.

Вы можете установить самую последнюю версию Git на свой Mac, установив ее через бинарный установщик. Существует поддерживаемый установщик OS X Git, доступный для загрузки через веб-сайт Git. Если щелкнуть здесь, загрузка начнется автоматически.

После полной установки Git вы можете перейти к разделу «Настройка Git».

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

Для Windows официальная сборка доступна для загрузки через веб-сайт Git. Если щелкнуть здесь, загрузка начнется автоматически.

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

После полной установки Git вы можете перейти к разделу «Настройка Git».

Настройка Git

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

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

git config --global user.name "Your Name"
git config --global user.email "youremail@domain.com"

Мы можем просмотреть все элементы конфигурации, которые были установлены, набрав:

git config --list

user.name=Your Name
user.email=youremail@domain.com

Как вы могли заметить, это немного другой формат. Информация хранится в вашем файле конфигурации Git, который вы можете при желании отредактировать вручную с помощью текстового редактора, например, такого как nano:

nano ~/.gitconfig

[user]
    name = Your Name
    email = youremail@domain.com

Закончив редактирование файла, вы можете выйти из nano, нажав клавиши управления и x, а когда будет предложено сохранить файл, нажмите y.

Есть много других параметров, которые вы можете установить, но это два основных, необходимых для предотвращения предупреждений в будущем.

Заключение

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

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