Как загрузить свои проекты с открытым исходным кодом на GitHub с помощью Visual Studio
Если вы следите за моей серией статей «Облачение моего приложения», вы знаете, что я преобразовываю свое приложение из приложения, ориентированного на Windows, в приложение, ориентированное на облако. Часть моего оригинального приложения для Windows обрабатывает лицензирование моего программного обеспечения. Недавно я решил опубликовать свой лицензионный код на GitHub. В этой статье и сопроводительном видео я научу вас основам загрузки вашего решения на GitHub с помощью Visual Studio.
[tg_youtube video_id="1LcOe0LnYcc"]
Кстати, если вы хотите узнать некоторые основы Git, ознакомьтесь с моей статьей Gotta Git Git.
Открытый исходный код или частный?
Прежде чем публиковать что-либо на GitHub, вы должны знать, что существует два уровня доступа. Первый уровень бесплатный. На бесплатном уровне вы можете создавать проекты с открытым исходным кодом и публиковать практически все, что вам нравится. Конечно, разместив свой код на бесплатном уровне, любой может получить к нему доступ.
Следующий уровень для вашей учетной записи — платная учетная запись. С платной учетной записью вы можете создавать частные репозитории Git. Эти частные учетные записи позволяют вам загружать код, который не видят другие. Вы можете поделиться своим проектом с другими людьми, но, предположительно, это члены команды, которым вы доверяете и которым разрешено просматривать или редактировать.
В моем случае у меня есть довольно большое приложение, которое помогает профессиональным авторам и издателям создавать электронные книги. Большинство продуктов, которые создают электронные книги на рынке, являются бесплатными или с открытым исходным кодом, но я могу продавать свой продукт, потому что он предлагает привлекательные функции, которых нет в других продуктах. Поскольку я продаю коммерческое программное обеспечение, я не собираюсь предлагать свой продукт как решение с открытым исходным кодом, но когда я делаю что-то, что не является уникальным для моего продукта, я хочу предложить свою работу сообществу.
Почему с открытым исходным кодом?
В моем случае я купил продукт под названием WooCommerce Software Add-on. Дополнение позволяет людям приобретать лицензии на мое программное обеспечение. К сожалению, надстройка имеет документацию только для языка программирования PHP и поэтому не слишком полезна для меня и моего приложения на C#. Я провел большую часть месяца, работая с разработчиком программного обеспечения, чтобы получить необходимую информацию и научиться правильно работать с продуктом.
Выяснив, как заставить мое C#-приложение с надстройкой, я поделился этим с группой людей на местной встрече здесь, в Сан-Франциско. На Meetup некоторые люди спрашивали, могу ли я поделиться кодом. Конечно, есть элементы моего кода, которые являются секретными (например, как я привязываю серийный номер к компьютеру пользователя), но я не видел смысла скрывать базовый код от других, так как он мог быть очень полезен, и не было никакой интеллектуальной собственности. Я подумал, что стоит защищать.
Visual Studio и GitHub
Если вы используете Visual Studio, вы можете создать локальный репозиторий Git для своего проекта. Это позволяет вам управлять своим кодом локально. Если вы хотите поделиться своим кодом на GitHub, Microsoft и GitHub объединились, чтобы предоставить надстройку. С Visual Studio 2017 вы получаете встроенную интеграцию с GitHub. Если я не ошибаюсь (а я могу ошибаться), вам нужно загрузить бесплатную интеграцию GitHub с веб-сайта Microsoft.
Вы можете выполнять всю свою работу с GitHub с помощью CLI (интерфейса командной строки) или использовать визуальный пользовательский интерфейс. В видео, сопровождающем эту статью, я покажу вам, как использовать визуальные инструменты.
Шаги процесса
Прежде чем отправлять код на GitHub, необходимо выполнить несколько шагов:
- Создайте проект Visual Studio.
- Добавьте проект Visual Studio в репозиторий Git (посмотрите мое видео, чтобы ознакомиться).
- Протестируйте свой код и убедитесь, что он работает. Конечно, вам не этого делать — вы можете просто пометить код как — но я сначала подождал, пока код не будет в хорошей форме.
- Синхронизируйте свой код с GitHub.
- Обновите файл README.md. (Технически это может произойти в любое время.)
- Обновите решение с помощью файла README.md.
После обновления проекта вы можете продолжать поддерживать его на своем компьютере, а затем вносить изменения по своему усмотрению. Вы также можете обнаружить, что люди разделяют интерес к вашему проекту и вносят изменения. Еще одна вещь, которая может случиться, это то, что люди могут зарегистрировать проблему, потому что код не работает или у них есть рекомендация.
Эти совместные элементы делают GitHub очень популярным, но вам также нужно решить, какие усилия вы хотите приложить к проекту. Лучше всего указать свои намерения в файле README.md. Например, если вы просто делитесь кодом, но не заинтересованы во внесении изменений, это нормально, но вы должны заявить о том, что у людей, использующих ваш код, должны быть правильные ожидания. И наоборот, если вы хотите, чтобы люди отправляли изменения или регистрировали проблемы, вы также должны указать это в своем файле README.md.