Можно установить GitHub Desktop в поддерживаемых операционных системах Windows и macOS.
About GitHub Desktop installation
You can install GitHub Desktop on supported operating systems, which currently include macOS 10.13 or later and Windows 10 64-bit or later. If you have an account on GitHub or GitHub Enterprise, you can connect your account to GitHub Desktop. For more information about creating an account, see «Signing up for a new GitHub account.»
Downloading and installing GitHub Desktop
Что такое Git, регистрируемся на GitHub, для чего нужен GitHub Desktop, установим и рассмотрим его базовое использование
Так как эти темы довольно обширные, в статье рассмотрим их обзорно, с минимально необходимой информацией, для общего понимания и базовой работы с GitHub Desktop.
Что такое Git
Определение из Wikipedia
Git (произносится «гит») — распределённая система управления версиями.
Система управления версиями — определение из Wikipedia
Система управления версиями (от англ. Version Control System, VCS или Revision Control System) — программное обеспечение для облегчения работы с изменяющейся информацией. Система управления версиями позволяет хранить несколько версий одного и того же документа, при необходимости возвращаться к более ранним версиям, определять, кто и когда сделал то или иное изменение, и многое другое.
Если мы верстаем или программируем, не используя систему Git, то в нашем распоряжении только тот код, который пишем сейчас.
При использовании системы Git мы запоминаем версии кода на нужных нам этапах. Имеем доступ к ранним версиям. Можем смотреть изменения, которые были сделаны между версиями. Можем отменить изменения до любой из версий.
В статье часто будем использовать термин Git, чтобы проще было понять, представим, что Git это условная “записная книжка”, в которую будем записывать, какие изменения происходят в нашем проекте. Добавили файл — записываем, что файл добавлен. Изменили файл — записываем изменения, которые были сделаны в файле. Удалили файл — записываем что файл был удален. И все эти записи храняться в “записной книжке” Git
Технически Git для проекта — это скрытая папка .git
в папке вашего проекта. Скрытая папка .git
содержит служебные файлы, которые нельзя изменять и удалять
У Git много возможностей, но на данный момент рассматриваем только базовые
Информация из Wikipedia
GitHub — крупнейший веб-сервис для хостинга IT-проектов и их совместной разработки.
Введем еще один термин, который также будет часто встречаться в статье и в работе с GitHub Desktop — репозиторий.
Репозиторий — определение из Wikipedia
Репозито́рий (англ. repository), хранилище — место, где хранятся и поддерживаются какие-либо данные. Чаще всего данные в репозитории хранятся в виде файлов, доступных для дальнейшего распространения по сети.
Если говорить совсем просто, то репозиторий — это наш проект (папка с файлами и системой Git)
Репозиторий может храниться локально на компьютере или чаще всего на таких веб-сервисах, как GitHub
Для чего нужен Github Desktop
Работа с Git подразумевает работу через командную строку, но компания GitHub выпустила приложение, которое сильно упрощает использование Git
Для работы с GitHub Desktop, необходимо зарегистрироваться на GitHub
Регистрация на GitHub
Переходим на официальный сайт GitHub
На главной странице заполняем форму справа и нажимаем “Sign up for GitHub”
Проходим проверку и нажимаем “Join a free plan”
На следующей странице можно заполнить небольшую анкету (можно не заполнять)
На этой же странице спускаемся в самый низ и нажимаем “Complete setup”
Далее для завершения регистрации просят подтвердить свой email адрес.
Проверяем свою почту. Если письмо пришло, переходим к следующему пункту.
Если письмо не пришло, нажимаем “Resend verification email”.
Если по-прежнему письмо не приходит, можно проверить и изменить настройки — нажимаем “Change your email settings”
В письме от Github нажимаем “Verify email address”
Аккаунт GitHub успешно создан
Установка GitHub Desktop
Переходим на официальный сайт GitHub Desktop
Нажимаем “Download for Windows (64bit)” (операционная система может отличаться)
Запускаем скачанный файл. После установки в появившемся окне нажимаем “Sign in to GitHub.com”
В открывшемся окне браузера вводим в форму свои данные, как при регистрации, и нажимаем “Sign in”
Если браузер запросит, то подтвердить, что нужно “Открыть приложение GitHub Desktop”
Далее регистрационные данные перенесутся в форму конфигурации (настроек) Git — нажимаем “Continue”
Отключаем пункт “Yes, submit periodic usage stats”, если не хотите периодически передавать статистику работы GitHub Desktop и нажимаем “Finish”
Далее видим начальное окно GitHub Desktop
“Create a tutorial repository…“ — создать обучающий репозиторий
“Clone repository from the Internet…“ — клонировать (скопировать/скачать) репозиторий из GitHub к себе на компьютер
“Create a New Repository on your hard drive…“ — создать новый репозиторий на вашем жестком диске (на вашем компьютере) и добавить систему Git в проект
“Add an Existing Repository from your hard drive…“ — добавить на GitHub репозиторий, который уже есть на вашем компьютере и использует Git
Справа будут отображаться ваши репозитории, которые уже загружены на GitHub, но если только что зарегистрировались, то список будет пуст.
Создаём новый репозиторий
Создаём у себя на компьютере (например, на диске C:) папку projects, где локально будут храниться все наши репозитории.
Переходим в Github Desktop, нажимаем на начальном экране “Create a New Repository on your hard drive…“ или File > New Repository
В открывшемся окне в поле Name пишем название репозитория. В поле Description — описание репозитория, если необходимо. В Local Path выбираем созданную на диске C: папку projects, остальное оставляем по-умолчанию и нажимаем “Create repository”
В папке projects появился репозиторий Project-1
В репозитории Project-1 на данный момент находятся только необходимые служебные файлы Git.
На данный момент репозиторий расположен только локально на компьютере в папке Project-1. Чтобы репозиторий появился в аккаунте GitHub и хранился там, нажимаем “Publish repository”
В появившемся окне оставляем все по-умолчанию. Пункт “Keep this code private” оставляем отмеченным, чтобы репозиторий, пока что, был виден только нам, потом в любой момент репозиторий можно будет сделать открытым, чтобы его видели другие пользователи GitHub. Нажимаем “Publish repository”
Теперь репозиторий скопирован в аккаунт GitHub. Переходим в браузере на GitHub. Сверху справа нажимаем на круглую иконку аккаунта и выбираем пункт “Your repositories”
На странице наших репозиториев появился созданный репозиторий Project-1
Откроем страницу репозитория, нажав на название репозитория в списке. На данный момент в репозитории только служебные файлы.
Создадим на компьютере в папке Project-1 файл index.html и напишем в нем минимальную разметку.
На данный момент файл index.html расположен только локально в папке Project-1. Локальная система Git, которая была создана вместе с репозиторием, об этом файле ничего не знает.
Чтобы Git узнала, что в репозиторий добавился файл, необходимо сообщить это через команду Commit.
Commit — фиксирование текущего состояния файлов, звучит как коммит.
Коммитам необходимо давать названия.
Откроем Github Desktop. Во вкладке Changes видим созданный index.html.
Вводим в поле ниже название коммита — add index.html
. Затем нажимаем “Commit to main”, чтобы зафиксировать данное состояние файлов в локальную систему Git. (На данный момент не будем углубляться в ветвление Git)
На данный момент мы зафиксировали файлы в текущем состоянии и сделали запись об этом в локальную систему Git.
Далее, чтобы передать изменения в репозиторий на GitHub, нажимаем “Push origin”
Переходим в наш репозиторий на GitHub и убеждаемся, что файл index.html был добавлен
Далее внесем изменения в файл index.html — добавим заголовок <h1>Project-1</h1>
Переходим в GitHub Desktop, видим что index.html был изменен, вводим название нового коммита — add h1
и нажимаем “Commit to main”
И снова передаем изменения в репозиторий на GitHub — нажимаем “Push origin”
Видим, что index.html был изменен при коммите add h1
Нажав на название файла index.html, убеждаемся что заголовок добавлен
На данный момент умеем создать репозиторий, делать коммиты, и передавать на GitHub
Далее рассмотрим работу с GitHub Desktop с нескольких рабочих мест
Клонирование репозитория
Предположим, мы работаем с проектом дома на компьютере и в офисе на ноутбуке. Чтобы на ноутбуке у нас была актуальная версия проекта, мы должны получить ее из репозитория на GitHub — это действие называется “клонирование”.
Создадим теперь на ноутбуке папку для репозиториев, например notebook projects
Устанавливаем на ноутбук GitHub Desktop, заходим под своим аккаунтом. Нажимаем File > Clone Repository
В списке выбираем необходимый репозиторий
В пункте Local path, нажимаем кнопку “Choose…“ и выбираем созданную папку notebook projects. Далее нажимаем “Clone…“
Репозиторий клонирован (скопирован) в папку Project-1.
Если в GitHub Desktop посмотреть вкладку History, то увидим всю историю коммитов
Внесем изменения в index.html на ноутбуке, добавим <p>Add text from Notebook</p>
и сделаем коммит c названием add text from notebook
, далее нажимаем “Commit to main”
Отправим коммит в репозиторий на GitHub — нажимаем “Push origin”
Коммит виден в репозитории на GitHub
В index.html добавлен <p>Add text from Notebook</p>
Теперь возвращаемся из офиса домой, открываем GitHub Desktop на компьютере, и чтобы получить изменения, сделанные на ноутбуке, нажимаем “Fetch origin” — проверяем, есть ли отличия локального репозитория на компьютере и репозитория на GitHub
Отличия есть, поэтому далее нажимаем “Pull origin”
И получаем актуальный проект со всеми изменениями
Преимущества
Мы рассмотрели только базовое использование Git, GitHub, GitHub Desktop, но уже можем выделить достаточно много преимуществ (на самом деле их намного больше, как и возможностей)
- Возможность фиксировать состояния проекта на необходимых этапах, и иметь доступ к ранним версиям
- Умение пользоваться Git очень часто встречается в вакансиях — будет вашим преимуществом
- На любом устройстве, в любой момент можете получить доступ до актуального проекта
- Возможность делиться своим проектом с другими пользователями GitHub
- Иметь проекты на GitHub большой плюс при поиске работы
- Возможность пользоваться всеми преимуществами Git без командной строки
Итоги
Возможно, на первый взгляд, покажется сложным, но после небольшой практики, вся базовая работа с GitHub Desktop на начальном этапе сойдется к тому, что вы поработали с проектом на работе > сделали коммит (“Commit to main”) > отправили на GitHub (“Push origin”). Пришли домой > получили изменения из GitHub (“Pull origin”) и продолжаете работу дома.
- “Commit to main”
- “Push origin”
- “Pull origin”
Возможно, через некоторое время напишу статью про другие возможности GitHub Desktop
Больше информации на официальном сайте GitHub Desktop
In this tutorial, we find two different ways to install the GitHub Desktop app on Windows 10 or 11 one is using the Command line, and the other is GUI.
GitHub Desktop is a free and open-source Desktop application available to run on Windows. It is developed by GitHub to provide a Git GUI client to manage repositories graphically instead of command line. Users will have an easy-to-use interface for managing and organizing repositories hosted on the GitHub platform. The software is written in TypeScript and uses React. Using it developers of all skill levels can easily collaborate and work together on projects, making it an ideal choice for both beginners and experienced developers alike. However, it seems like the developers of the GitHub Desktop app have ignored Linux users because it is only for Windows and MacOS.
So, in this guide, we discuss the step-by-step process of installing GitHub Desktop on your Windows 10 or 11 systems.
#1st Method using GUI.
Step 1: Download GitHub Desktop
Those who don’t want to use the command line for installing GitHub Desktop can manually download it from the official website. Visit the link to get the executable setup file on your system using the “Download for Windows 64-bit” button. As you click it, a pop-up will appear to save the GitHubDesktopSetup-x64 .exe file.
After finishing the downloading process, the setup file will be on your system. Double-click on it to start the Installation process for GitHub Desktop. Wait for a few seconds, soon the system will launch the software automatically, as it is done with the setup operations. Learn the Advantages of Using GitHub desktop.
#2nd Method using Command prompt or PowerShell
Step 3: Using Command prompt or PowerShell
If you are not interested in the GUI way to install it as shown in Step 2 of this tutorial which involves the manual visit of the website to get the software copy. Then, use the easy-to-use and straightforward command prompt (CMD) or Powershell to install the GitHub Desktop application. For that, here we are using Windows 10 or 11’s inbuilt Package manager called Winget.
The command to follow is:
For Stable version:
winget install GitHub.GitHubDesktop
For Beta Version:
winget install GitHub.GitHubDesktop.Beta
Step 4: Launch GitHub Desktop
We can run the GitHub Desktop app like any other Windows 10 or 11 application, doesn’t matter which method you have used to install it. Click on the Start menu and search for the app, as its icon appears, click to run the same.
However, there are a couple of steps we need to follow further to integrate the GitHub Account into its Desktop app. Here are those.
- Once the installation is completed, click on the “Sign in to Github.com” button or Enterprise as per your plan. If you are not interested in connecting the GitHub Hosting account and want to use the application to manage the local repository then can use the Skip this Step option.
- Enter your GitHub.com Account username and password to log in
- Review the access the app is going to take and click on the Authorize Desktop button.
- Check the box, when a pop-up appears to run GitHub-Desktop.exe and click on the Open button.
- Click on the Finish button and Start cloning your available repositories.
- The final interface of the application.
Step 6: Create a New Repository
To start with the application, let’s create a new repository. For that click on the “File” menu and select “New Repository” or use the keyboard shortcut – Ctrl+N. We have to give some name to the repo we want to create so that we will able to identify it easily. The desktop application will prompt for that.
To save the Repos files, the application will choose the default location configured by it, however, you can choose some other, if required. Further, you can configure Git to ignore some particular language, can initialize it will a README file, or even can select the license for your repository. Once done, just click on the Create button.
Step 6: Clone an Existing Repository
To start with an existing repo on the GitHub Desktop app, we can clone it. Click on the “File” menu and select “Clone Repository” or use the keyboard shortcut – Ctrl+Shift+O. You will be prompted by the software to enter the name of your Repo that needs to be cloned. Alternatively, we can use the GitHub URL of other available code repositories as well.
Step 7: Start Working on Your Project
Existing users of the GitHub web platform will not find any difficulty to use its Desktop app. They immediately can start working on their projects after setting up the app. With the help of a few clicks, a user can create new files, edit the existing ones, push or pull the origin, and a lot more. Further, being a Git version control platform, GitHub Desktop will keep track of the changes and allow you to revert to previous versions if necessary.
Conclusion
Installing GitHub Desktop on a Windows 10 or 11 machine is a quite simple and easy task that can be done in a few minutes. Offering users ample control over their Git repositories, the app makes it effortless to work on projects on Windows PC or laptops. Therefore, if your all repositories are on the GitHub Platform then its Desktop app is an ideal choice for anyone who needs to harness the power of Git on their computer.
FAQs
Do I need a GitHub account to use GitHub Desktop?
Yes, we need a GitHub account to use GitHub Desktop which is free to create by anyone using the web platform of this Git hosting service.
Is GitHub Desktop only available for Windows 10 or 11?
No, GitHub Desktop is also available for macOS.
Can I use GitHub Desktop to work on projects with a team?
Of course, we can use the application to collaborate and work with a team. Along with options to track other users and the changes made by the Team members to code.
Is GitHub Desktop open-source software?
Yes, GitHub Desktop is open-source software, therefore free to use, and its source code is available to review and contribute by anyone.
Does GitHub Desktop support other Git hosting services?
No, this Git Client GUI app is developed to manage the repositories hosted only on GitHub. If you want to work with repositories hosted on another Git hosting service, you’ll need to use a different Git client such as SourceTree.
Самая короткая инструкция о том, как сохранить файлы в GitHub и ничего не сломать. И самое главное — никакой консоли, всё через окошки и с помощью мышки. Для этого используем GitHub Desktop.
Внимание! GitHub Desktop не работает на Windows 7×32, поэтому если у вас эта версия системы, обновитесь до Windows 10 или воспользуйтесь программой GitKraken.
В этой статье идёт рассказ о системах контроля версий. Если вы совсем ничего о них не знаете, прочитайте статьи «Словарь терминов для Git и GitHub» и «Введение в системы контроля версий», чтобы понять терминологию и разобраться, зачем мы вообще это делаем.
Регистрация и вход
После первого входа в GitHub Desktop вас попросят ввести ваши логин и пароль от GitHub.com. После этого у вас появится доступ ко всем репозиториям, сохранённым в профиле.
Создание репозитория
Если вы никогда не пользовались гитхабом, нужно будет создать репозиторий для работы над проектом. На главном экране GitHub Desktop выберите пункт «Create a New Repository on your hard drive».
Нужно будет ввести название репозитория, его описание и выбрать папку на компьютере, куда будут сохраняться файлы.
После этого нажимаем на Create repository, ждём несколько секунд и готово — на компьютере появилась папка, которой можно пользоваться для разработки вашего проекта.
Клонирование репозитория
Если у вас уже какой-нибудь репозиторий на Гитхабе, его можно клонировать. Клонировать — это скачать все файлы к себе на компьютер, чтобы можно было их изменять и потом загружать обратно.
Выбираем Add -> Clone Repository…
В открывшемся окне выбираем один из имеющихся репозиториев. В данном случае он называется zaverstai
, но у вас может быть любой другой.
После этого файлы репозитория начнут скачиваться — если их много, то это займет некоторое время.
Работа с репозиторием. Меняем файлы и сохраняем обратно
Вне зависимости от того, создали вы репозиторий или клонировали его, так выглядит GitHub Desktop с открытым репозиторием, в котором мы пока ничего не меняли.
Слева — поле для измененных файлов, справа — служебная информация. Слева снизу — поле для коммитов.
Если не усложнять, то склонированный репозиторий это просто каталог на компьютере. Можно нажать Show in Finder на Mac или Show in Explorer в Windows и откроется папка, где лежат все файлы, которые есть в репозитории.
Давайте добавим какой-нибудь файл. Например, я добавил в локальный репозиторий (скопировал в папку) файл index.html, который взял отсюда. Вы можете загрузить файл с кодом вашего проекта или изменить уже существующий.
Сразу после добавления или изменения файла в окне GitHub Desktop будет видно, что изменилось — если мы добавили целый новый файл, то все строчки будут с плюсиками и зелёные. Это значит, что они были добавлены в файл и GitHub Desktop раньше их никогда не видел.
Загружаем новый репозиторий на GitHub
Если вы не создавали новый репозиторий, а склонировали старый, то можете пропустить этот пункт.
После того, как мы добавили какой-то код в свежесозданный репозиторий, нужно сделать коммит, то есть зафиксировать все сохранённые изменения и дать им название. Текст должен быть лаконичным и в то же время сообщать о том, что делает коммит. Например, «добавляет имя наставника в Readme», «вводит функцию сортировки изображений», «правит ошибку в поиске городов на карте». Вводим имя жмём большую синюю кнопку «Commit to main»
Изменения, которые мы внесли и сохранили, пока локальны. Их нужно послать на GitHub. Чтобы опубликовать свежесозданный репозиторий на GitHub, нажмите Publish repository.
Появится подтверждение о публикации репозитория — проверяем название и описание, если нужно, ставим галочку о том, что код приватный, и публикуем.
Готово — после этого репозиторий появится в вашем профиле на GitHub. com.
Добавляем код и коммитим изменения
Репозиторий создан и загружен на GitHub, теперь нужно добавить немного кода.
Когда вы допишете код в файлы, которые находятся в репозитории, вы сможете просмотреть все их изменения в окне GitHub Desktop. Вот здесь, например, мы изменили «второй» на «третий» в тексте страницы — и изменения сразу видны, можно проверить, что всё исправленное будет загружено.
Дальше действуем по проверенной схеме — коммитим изменения.
В центре главного экрана появится предложение запушить коммит в удалённый репозиторий. Соглашаемся и жмём Push origin.
Готово! Теперь, если зайти на GitHub.com, в наш репозиторий, увидим изменённый файл, который мы только что отправили.
Всё получилось — теперь вы можете создать или склонировать репозиторий, добавить туда файлы, опубликовать всё это на GitHub.com, не прикасаясь к консоли.
Мы поработали только с основной веткой репозитория. Если вы хотите разобраться, как создавать новые ветки и добавлять их в основную ветку, прочитайте статью «Работа с git через консоль».
«Доктайп» — журнал о фронтенде. Читайте, слушайте и учитесь с нами.
ТелеграмПодкастБесплатные учебники
Table of contents
- For macOS
- Install
- Login to GitHub on Desktop
- First time configure your Name and Email
- For Windows
- Download GitHub Desktop for Windows
- Install
- Login and Authorize GitHub Desktop
- First time configure your Name and Email
- Done
Open the GitHub Desktop Download Page. Choose the correct version for your computer. If you’re using an Apple silicon M1 chip, click “Apple silicon machines.” to download.
For macOS
Install
After you download GitHub Desktop and click the installation package, you will get a GitHub Desktop.app file. Move it to the Application folder.
Login to GitHub on Desktop
The first time you open GitHub Desktop it will look like this:
Authorize GitHub Desktop
Click “Sign in to GitHub.com”.
If you have a GitHub account signed in, you should see a similar page as below. Click “Authorize desktop”.
No GitHub account yet? Follow Create an Account on GitHub to register a new account and then go back and refresh the page again.
First time configure your Name and Email
For Windows
Download GitHub Desktop for Windows
Go to https://desktop.github.com/ and download the GitHub Desktop for Windows.
Install
After downloading GitHub Desktop, click on the file to start the installation process.
Login and Authorize GitHub Desktop
Now you have installed GitHub Desktop successfully. Click “Sign in to GitHub.com”. It will automatically open a web page.
Don’t have a GitHub account? Click “Create an account” or you can follow Create an Account on GitHub to register a new account and then go back.
After you sign in, this web page will want to open GitHub Desktop. Click “Open”.
First time configure your Name and Email
Done
Click “Finish”. You should now have a workable GitHub Desktop on Windows.