Што такое GitHub, навошта патрэбен і як карыстацца ГітХаб, як пачаць выкарыстанне сэрвісу – дапаможнік для пачаткоўцаў.
GitHub – адзін з самых папулярных сэрвісаў, прызначаных для размяшчэння рэпазітароў з адкрытым зыходным кодам. Сайт дазваляе публікаваць прыстасаваныя праекты і адсочваць змены, унесеныя ў кожную ітэрацыю. Іншыя карыстальнікі GitHub могуць прагледзець код карыстальніка і прапанаваць уласныя змены. Дадзенае азначэнне дае толькі кароткае разуменне. Аднак функцыянал сервісу гэтым не абмяжоўваецца. У дадзеным аглядным артыкуле разгледзім Github больш падрабязна.
- Што такое GitHub і як пачаць карыстацца – дапаможнік для пачаткоўцаў
- Git і GitHub – у чым розніца, першае знаёмства з Гіт і ГітХаб
- Што такое Git?
- Што такое GitHub?
- У чым галоўнае адрозненне?
- Цікавыя факты пра Github
- Магчымасці Github
- Як працуе GitHub, функцыі
- Разгалінаванне (forking)
- Запыты на выманне (pull request)
- Аб’яднанне (merging)
- Гайд – як пачаць працу ў Github з нуля
- Крок 0. Устаноўка Git і стварэнне ўліковага запісу на GitHub
- Крок 1. Запуск Git і стварэнне першага лакальнага рэпазітара
- Крок 2. Стварэнне новага файла ў рэпазітары
- Крок 3. Даданне файла ў прамежкавае асяроддзе для адсочвання
- Крок 4. Стварэнне commit
- Крок 5. Стварэнне новай галінкі new branch
- Крок 6. Стварэнне новага рэпазітара на GitHub
- Крок 7: Адпраўка галінкі праекту на GitHub
- Дадаткова
- Крок 8. Стварэнне 1. pull request
- Крок 9. Аб’яднанне pull request
- Крок 10. Адмена змен Github на лакальным кампутары
- Дадатковыя магчымасці Github і Git
- Кланаванне рэпазітара на лакальны кампутар
- Пошук выдаленых рэпазітараў
- Дэсктопная версія гітхаба – што гэта GitHub Desktop, асноўны функцыянал, магчымасці і працэс усталёўкі
- Як усталяваць
- Асноўны функцыянал
- Github API
- Кіраванне і настройка праектаў Github Desktop
- Стварэнне, даданне і кланаванне рэпазітара
- Стварэнне New Branch
- Бяспека
- Настройка палітыкі бяспекі
- Упраўленне графікам залежнасцяў
- Ліцэнзіі
Што такое GitHub і як пачаць карыстацца – дапаможнік для пачаткоўцаў
GitHub – інтэрнэт-партал, у якім распрацоўшчыкі і праграмісты могуць загружаць створаны імі код і сумесна працаваць над яго паляпшэннем. Адметнай асаблівасцю GitHub з’яўляецца яго надзейная сістэма кантролю версій. Кантроль версій дазваляе праграмістам наладжваць ПЗ без шкоды для самога праграмнага забеспячэння. Прапанаваныя змены могуць быць лёгка аб’яднаны ў паўнавартасны рэліз, але толькі пасля таго, як усе змены будуць разгледжаны і ўхвалены.
Git і GitHub – у чым розніца, першае знаёмства з Гіт і ГітХаб
Што такое Git?
Адказ: Хуткая і якая маштабуецца сістэма кантролю версій . Git – гэта бясплатная размеркаваная сістэма кантролю версій з адчыненым зыходным кодам, прызначаная для хуткай і эфектыўнай працы з любымі праектамі, ад невялікіх да вельмі буйных.
Што такое GitHub?
Адказ: магутны хмарны сэрвіс для кіравання прыватнымі распрацоўкамі і праектамі з адкрытым зыходным кодам.
У чым галоўнае адрозненне?
Git уяўляе сабой паўнавартаснае праграмнае забеспячэнне ў катэгорыі «Сістэма кантролю версій», якое ўсталёўваецца на персанальны кампутар карыстальніка. Git дазваляе праз камандны радок (Microsoft PowerShell) уносіць змены ў код, а GitHub дае магчымасць захоўваць праекты ў публічным доступе.
Цікавыя факты пра Github
- Максімальная колькасць карыстальнікаў на сайце ў мінулым годзе (па статыстычных дадзеных 24 ліпеня 2021 г.) склала 45 мільёнаў чалавек.
- У 2018 годзе Microsoft набыла GitHub за 7,5 мільярда долараў.
- На Github ёсць рэпазітар git з адчыненым зыходным кодам. Любы жадаючы можа ўнесці ў яго змены. Праект даступны па спасылцы – https://github.com/git/git?ref=stackshare
Магчымасці Github
- Магчымасць інтэграцыі з найбольш папулярнымі платформамі і сэрвісамі – Amazon, Google Cloud і Code Climate.
- Падтрымка больш за 200 моў праграмавання.
- Высокі ўзровень кансалідацыі і “цэхавай салідарнасці”. Калі карыстач размяшчае свой праект на GitHub, астатнія прадстаўнікі супольнасці праграмістаў могуць загрузіць і ацаніць працу, якасць кода і ступень яго прапрацаванасці. Іншыя карыстальнікі могуць папярэдзіць уладальніка праекта аб магчымых праблемах, канфліктах зменных і г.д.
Як працуе GitHub, функцыі
З найболей важных функцый Github можна вылучыць тры – разгалінаванне, запыты на выманне і аб’яднанне. Варта разгледзець кожную функцыю паасобку.
Разгалінаванне (forking)
Разгалінаванне праекту стварае копію (fork), якая дазваляе карыстачу вольна эксперыментаваць, не ўплываючы на зыходны праект. Стварэнне форкаў і запытаў на выманне: https://youtu.be/nT8KGYVurIU
Запыты на выманне (pull request)
Pull request публікуецца распрацоўшчыкам пасля таго, як ён скончыць працу над выпраўленнем / зменай кода. Пры гэтым сам уладальнік праекту можа прагледзець унесеныя змены і задаць любыя дадатковыя пытанні.
Аб’яднанне (merging)
Пасля таго, як уладальнік ухваліць pull request, ён аб’ядноўвае запыт на выманне і ўжывае змены з разгалінаванага праекту да зыходнага кода.
Гайд – як пачаць працу ў Github з нуля
Дадзены гайд выдатна падыдзе ўсім пачаткоўцам, якія толькі пачынаюць вывучаць Git і Github. Ніжэй прыведзеныя крокі дапамогуць выбудаваць аптымальную сістэму працы з дадзеным праграмным забеспячэннем. Вы навучыцеся ўносіць змены ў кодавую базу, адчыняць запыт на выманне (ствараць pull request) і аб’ядноўваць код у асноўную галіну. Такім чынам, прыступім.
Крок 0. Устаноўка Git і стварэнне ўліковага запісу на GitHub
- Перайдзіце на афіцыйны вэб-сайт Git: https://git-scm.com/downloads
- Націсніце на спасылку для запампоўкі настольнай версіі Git для Windows і дачакайцеся канчаткі загрузкі.
- Выміце і запусціце ўсталёўнік Git падвойным клікам па файле Git.exe.
- Дазвольце з дадаткам уносіць змены ў ПК шляхам націску кнопкі «Так» у якое адкрылася дыялогавым акне «Кіраванне ўліковымі запісамі карыстачоў».
- Запусціце працэс усталёўкі Git. Азнаёмцеся з асноўным дакументам “Публічная ліцэнзія GNU” і націсніце кнопку “Далей”.
- Пазначце месца для ўсталёўкі праграмы ці ж пакіньце значэнні па змаўчанні. Праграма прапануе стварыць тэчку меню “Пуск”. Прапусціце гэты пункт.
- Абярыце тэкставы рэдактар, які збіраецеся выкарыстоўваць сумесна з Git. У выпадальным акне неабходна абраць Notepad++ (або любы іншы тэкставы рэдактар, з якім раней працавалі) і націснуць “Далей”.
- Назавіце назву новай галіны праекта. Значэнне па змаўчанні – “master”. Рэкамендуецца пакінуць гэты параметр па змаўчанні.
- У параметрах магчымасцяў выбару PATH, SSH-кліента, сертыфікатаў сервера, канчаткі радкоў і тэрмінала пакіньце ўсё як ёсць і цісніце кнопку “Далей”.
- Пакіньце ўсе значэнні параметраў па змаўчанні і пачніце ўсталёўку праграмы.
- Пасля завяршэння ўстаноўкі адзначце сцяжкі для прагляду заўваг да выпуску і запусціце Git Bash. Зачыніце акно ўсталёўшчыка.
Зарэгістраваць акаўнт на Github можна па наступнай спасылцы: https://github.com/join. Для гэтага неабходна ўвесці асноўныя рэгістрацыйныя даныя, неабходныя ў далейшым для пацверджання ўліковага запісу.
Крок 1. Запуск Git і стварэнне першага лакальнага рэпазітара
Git мае два рэжыму выкарыстання – bash (Git Bash) і графічны інтэрфейс карыстальніка (Git GUI). Каб запусціць Git Bash, адкрыйце меню “Пуск” – “Windows”, увядзіце git bash і націсніце Enter (ці пстрыкніце два разы левай кнопкай мышы на ярлык праграмы). Для запуску Git GUI, адкрыйце меню “Пуск” – “Windows”, увядзіце git gui і націсніце Enter. У нашым выпадку мы будзем выкарыстоўваць Git Bash.
Стварэнне новага праекту ў праграме Git Bash мяркуе выкарыстанне адмысловых каманд для ініцыялізацыі новага рэпазітара. Для пачатку неабходна адкрыць тэрмінал Bash, націснуўшы клавішу правай кнопкай мышы на працоўным стале, а затым у выпадальным меню Git Bash Here. У акне тэрмінала на лакальным кампутары стварыце новы тэставы каталог (тэчку), увёўшы наступнае:
getrekt:Desktop getrekt $ cd ~/Desktop
getrekt:Desktop getrekt $ mkdir myproject
getrekt:Desktop getrekt $ cd myproject/
Каманда mkdir стварае новую тэчку лакальнага праекту. Ствараем наш першы Github рэпазітар: https://youtu.be/yHCUc6cmhcc
Крок 2. Стварэнне новага файла ў рэпазітары
У тэчцы з праектам дадайце новы тэкставы файл, выкарыстоўваючы каманду touch. Стандартнай выявай каманда створыць пусты тэкставы файл, які будзе мець пашырэнне .txt.
Увага! Git захоўвае змены/кіруе зменамі толькі ў тых файлах, якія ён адсочвае. Пасля стварэння новага файла карыстач можа адсачыць яго статут пры дапамозе каманды git status. Кансоль выдасць спіс файлаў, якія прысутнічаюць у рэпазітары.
Як толькі вы дадасце файл у тэчку, утрымоўвальную рэпазітар git, праграма заўважыць змену ўсярэдзіне праекту. Аднак аўтаматычнае адсочванне не будзе ўключана, неабходна выкарыстоўваць для гэтага адмысловую каманду – git add.
getrekt:myproject getrekt $ touch getrekt.txt
getrekt:myproject getrekt $ ls
getrekt.txt
Крок 3. Даданне файла ў прамежкавае асяроддзе для адсочвання
Дадайце файл у прамежкавае асяроддзе з дапамогай каманды git add.
getrekt:myproject git add . Пры дапамозе гэтай каманды праграма запусціць аўтаматычнае адсочванне ўсіх файлаў, якія будуць створаны ў тэчцы праекту. Праверыць працаздольнасць каманды можна пры дапамозе git status. Вось так выглядаюць логі ў камандным радку Git Bash пасля ўводу каманды: git status:
getrekt : getrekt getrekt
$
git status New filename: getrekt.txt new file: getrekt.txt Каментар да логаў: файл яшчэ не быў дададзены ў коміт, але вось-вось будзе дададзены.
Крок 4. Стварэнне commit
Commit – кантрольная кропка любога рэпазітара. Прасцей кажучы, – пакет змен, які захоўвае інфармацыю аб дададзеных, адрэдагаваных або выдаленых файлах, у якіх захоўваецца вызначаны код.
getrekt:myproject getrekt $ git commit -m “МОЙ ПЕРШЫ КАМІТ, Хлопцы!”
[master (root-commit) b345d9a] МОЙ ПЕРШЫ КАМІТ!
1 file changed, 1 insertion(+)
create mode 100644 getrekt.txt
Каманда для стварэння commit – git commit -m «Назва комміта».
Увага! Паведамленне ў канцы каманды павінна быць асэнсавана і зразумела іншым распрацоўнікам праекту. Не называйце вашыя коміты па тыпе “asdfadsf” ці “foobar”. У адваротным выпадку ніхто нічога не зразумее, і вам давядзецца марнаваць кучу часу на іх выдаленне.
Крок 5. Стварэнне новай галінкі new branch
New branch – гэта паўнавартасная галіна праекта, якая складаецца з цэлай сукупнасці коммітаў. Уяўляе сабой асобны рэліз прадукта, але ў рамках сістэмы кантролю версій. Галіны дазваляюць карыстачу перамяшчацца паміж “станамі” праекту.
У афіцыйнай дакументацыі git, прадстаўлена апісанне branches: “Branch у Git і Github – рухомы паказальнік на адзін з коммітаў рэпазітара”.
Напрыклад, калі карыстач захацеў дадаць новую старонку на свой вэб-сайт, то ён зможа стварыць новую галінку (branch) толькі для гэтай пэўнай старонкі, не закранаючы асноўную частку праекту. Як толькі скончыць з ёй, то зможа аб’яднаць змены са сваёй галіны ў асноўную. У выпадку стварэння новага адгалінавання, Git адсочвае тое, ад якога комміта адбылося разгалінаванне.
Пасля выканання каманды вы можаце прапісаць у кансолі git branch, каб пацвердзіць стварэнне галіны:
getrekt:myproject getrekt $ git branch
master
* my-new-branch Назва my-new-branch са зорачкай паказвае, у якой галіны знаходзіцца карыстальнік у дадзены момант часу.
Нататка: Па змаўчанні самая першая галіна кожнага рэпазітара git завецца «master» (і звычайна выкарыстоўваецца ў якасці асноўнай у праекце). У рамках барацьбы з расізмам некаторыя распрацоўшчыкі сталі выкарыстоўваць альтэрнатыўныя назвы для галіны па змаўчанні, напрыклад, “primary”. Аднак, часцей за ўсё карыстальнікі могуць убачыць “master” або падобныя назвы, якія выкарыстоўваюцца для абазначэння.
Варта мець на ўвазе, што амаль у кожным рэпазітары ёсць асноўная галіна, якую можна разглядаць як афіцыйную версію праекту. Калі гэта вэб-сайт, то галіна – гэта версія, якую бачаць карыстачы. Калі гэта дадатак, то асноўнай галіной з’яўляецца рэліз, які ўсталёўваюць карыстальнікі на свой кампутар ці мабільную прыладу. Менавіта так працуе традыцыйная апрацоўка версій прадуктаў Git і Github. На афіцыйным сайце ёсць больш падрабязная дакументацыя па выкарыстанні розных імёнаў галін па змаўчанні. Інфармацыя даступная на Github па спасылцы https://github.com/github/renaming
У выпадку вяртання ў галіну праекта і стварэння некалькіх коммітаў новы branch не будзе адсочвацца сістэмай кантролю версій, пакуль карыстач не прапіша аўтаматычнае адсочванне.
Крок 6. Стварэнне новага рэпазітара на GitHub
Гэты крок не патрабуецца выконваць, калі вы хочаце адсочваць свой код толькі лакальна. Але калі вы працуеце ў камандзе і прымаеце змены ад іншых праграмістаў, то можаце выкарыстоўваць бягучыя магчымасці GitHub для сумеснай змены кода праекту. Каб стварыць новы рэпазітар на GitHub, неабходна аўтарызавацца ў сістэме і перайсці на галоўную старонку сайта. У галоўным меню націсніце на кнопку “New Repository”, які знаходзіцца пад знакам “+” побач з фатаграфіяй профілю ў правым верхнім куце панэлі навігацыі: Пасля націску на кнопку GitHub папросіць уладальніка праекта даць назву рэпазітара і падаць кароткае апісанне:
Далей націсніце кнопку “Create repository”, каб пацвердзіць стварэнне новага праекту. З’явіцца дыялогавае акно, у якім карыстача спытаюць аб тым, ці жадае ён стварыць рэпазітар з нуля ці дадаць ужо існы, створаны лакальна. У другім выпадку неабходна загрузіць тэчку праекту на Github.
Увага! Загрузка лакальнага рэпазітара можа адбываецца і з выкарыстаннем каманднага радка, а канкрэтней каманд git remote add origin github_url (стварае запіс аб новым падлучэнні да выдаленага рэпазітара), git push -u origin master (усталёўвае сувязь паміж той галінкай, у якой знаходзіцца распрацоўнік і галінкай master на выдаленым серверы).
Вось так выглядаюць логі ў камандным радку Git Bash:
getrekt:myproject getrekt $git remote add origin https://github.com/cubeton/mynewrepository.git
getrekt:
myproject
Writing objects: 100% (3/3), 263 bytes | 0 bytes/s, done.
Total 3 (delta 0), reused 0 (delta 0)
Да https://github.com/cubeton/mynewrepository.git
* [new branch] master -> master
Branch master set up to track remote branch master from origin.
Крок 7: Адпраўка галінкі праекту на GitHub
Новая галіна праекта і рэпазітар былі створаны. Засталося «запушыць» галіну і перанесці ў новы рэпазітар Github. Так іншыя ўдзельнікі супольнасці змогуць бачыць код і ўносіць у яго змены. У выпадку ўхвалення дапрацовак уладальнік праекту можа аб’яднаць змены з асноўнай версіяй праекту. Каб перанесці змены ў новую галінку на GitHub, у камандным радку неабходна ўвесці каманду git push. GitHub аўтаматычна створыць галіну ў выдаленым рэпазітары:
getrekt:myproject getrekt$ git push origin my-new-branch
Counting objects: 3, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 313 bytes | 0 bytes/s, done.
Total 3 (delta 0), з дапамогай 0 (delta 0)
To https://github.com/cubeton/mynewrepository.git
* [new branch] my-new-branch -> my-new-branch Пасля абнаўлення старонкі GitHub, карыстальнік убачыць новую галінку, якая была змешчана ў рэпазітар.
Дадаткова
Што азначае слова origin у камандзе git push origin? Калі карыстач клануе выдалены рэпазітар на свой лакальны кампутар, git стварае для яго амаль ва ўсіх выпадках стандартны псеўданім «origin», які ў сутнасці з’яўляецца скарачэннем URL адрасы выдаленага рэпазітара. Адпраўка праекту на GitHub: https://youtu.be/zM6z57OtR2Q
Крок 8. Стварэнне 1. pull request
Запыт на выманне (або pull request) – гэта спосаб папярэдзіць уладальнікаў рэпазітара аб тым, што распрацоўшчык хоча ўнесці некаторыя змены ў код. Вось так выглядае старонка з даданнем pull request:
Вось так выглядае інтэрфейс часткі пасля стварэння pull request:
Крок 9. Аб’яднанне pull request
Зялёная кнопка “Merge pull request” унізе стварае запыт на зліццё. Пасля яе націску занесеныя змены дадаюцца ў асноўную галіну праекту.
Увага! Пасля зліцця выдаліце галінку. Іх вялікая колькасць можа прывесці да бязладзіцы ў праекце. Для выдалення галіны націсніце шэрую кнопку “Delete branch” у правым ніжнім куце.
Для праверкі бягучага статусу комітаў, націсніце на спасылку «Commits» на самай першай старонцы рэпазітара. Па націску вывядзецца ўвесь спіс комітаў у гэтай галінцы. На скрыншоце паказаны менавіта той, які быў створаны толькі што.
З правага боку пазначаны хэш-код кожнага commit. Хэш-код – гэта ўнікальны ідэнтыфікатар, які можа быць скарыстаны пры падлучэнні API і іншых сэрвісаў. Таксама па ідэнтыфікацыйным нумары можна спасылацца на пэўны коміт у камандным радку настольнай версіі Git Bash.
Крок 10. Адмена змен Github на лакальным кампутары
На дадзены момант рэпазітар у сістэме Github выглядае крыху інакш, чым у карыстальніка на лакальным кампутары. Напрыклад, коміт, які карыстач зрабіў у сваёй галінцы і аб’яднаў у асноўную, не існуе на лакальным кампутары. Для аўтаматычнай сінхранізацыі розных версій праекту неабходна выкарыстоўваць каманду git pull origin master (пры працы з асноўнай галіной) або git pull.
getrekt:myproject getrekt $ git pull origin master
remote: Counting objects: 1, done.
remote: Total 1 (delta 0), reused 0 (delta 0), pack-reused 0
Ад https://github.com/cubeton/mynewrepository
* branch master -> FETCH_HEAD
23242..232433berer3444 master -> origin/master
txt | 1 +
1 file changed, 1 insertion(+)Для праверкі бягучага статуту выканання каманды прапішыце ў камандным радку git log. Яна выведзе спіс усіх коммітаў.
getrekt:myproject getrekt $ git log
commit 32dgt472hf74yh7734hf747fh373hde7r3heduer73hfhf
Merge: 3fg4dd 34fg3u7j7
Author: Mtdes Ethan < getrekt@yandex.ru>
Date: Fri Sep 11 17:48:11 2015 -0400
Merge branch ‘master’ of https://github.com /cubeton/mynewrepository
commit 44hgfh7f74hdu9jt93hf9ifejffe
Author: Mtdes Ethan < getrekt@yandex.ru>
Date: Fri Jan 07 17:48:00 2021 -02356
commit 46thf9496hf9485hkf857tg9hfj8rh4j
Merge: 33fh5d 3689gfh
Author: Mtdes Ethan < getrekt@yandex.ru>
Date: Fri Jan 07 17:51:00 2021 -02356
commit 46thf9496hf9485hkf857tg9hfj8rh4j
Merge: 33fh5d 3689gfh
Author: Mtdes Ethan < getrekt@yandex.ru>
Date: Fri Jan 07 17:55:00 2021 -02356
Added some more text to my file
commit 355904-43hg940fg959hfg0g95jjgdgdfgf57i86f
Merge: 343fggdd 53efhgffddg
Author: Mtdes Ethan < getrekt@yandex.ru>
Date: Fri Jan 07 17:58:00 2021 -02356
This is my first commit! Гатова! Зараз карыстач знаёмы з усімі відамі працы ў сістэме кантролю версій. Git і GitHub курс навучання для пачаткоўцаў, як усталяваць Git і пачаць працаваць з Github, галінкі, рэпазітары, коміты і іншыя паняцці ў практычных занятках па ГітХаб: https://youtu.be/zZBiln_2FhM
Дадатковыя магчымасці Github і Git
Разгледзім іншыя карысныя “фішкі”, якія дазволяць распрацоўніку спрасціць працу над кантролем версій.
Кланаванне рэпазітара на лакальны кампутар
Перайдзіце ў свой рэпазітар на GitHub. У правым верхнім куце над спісам файлаў адкрыйце якое расчыняецца меню «Clone or download». Скапіюйце URL-адрас для кланавання па пратаколе HTTPS.
Калі ласка, вярніцеся ў акно Git Bash і ўвядзіце каманду:
git clone repository_url
repository_url – спасылка бягучага праекта, які неабходна кланаваць. Разам яго ўстаўляецца url рэпазітара.
У прыведзеным прыкладзе каманда клануе рэпазітар па пратаколе HTTPS. Іншы варыянт – кланаванне з дапамогай URL-адрасоў па SSH-ключам. Для гэтага неабходна згенераваць пару SSH-ключоў на Windows і прызначыць адчынены ключ уліковага запісу GitHub.
Пошук выдаленых рэпазітараў
Пасля кланавання ў працоўным каталогу на кампутары павінна з’явіцца копія рэпазітара з GitHub. Праект павінен змяшчаць каталог з назвай і асноўныя файлы. Для таго каб у яго перайсці, неабходна напісаць наступную каманду:
cd git_project
Заўвага: Замяніце git_project фактычным імем загружанага рэпазітара, альбо ўкажыце змесціва бягучага каталога з дапамогай каманды ls. Другі спосаб выкарыстоўваецца ў тых выпадках, калі карыстач не можа ўспомніць назву праекту.
Дэсктопная версія гітхаба – што гэта GitHub Desktop, асноўны функцыянал, магчымасці і працэс усталёўкі
GitHub Desktop – гэта настольнае дадатак, якое забяспечвае ўзаемадзеянне з GitHub на аснове графічнага інтэрфейсу. У адрозненне ад Git дэсктопная версія GitHub дазваляе выконваць тыя ж самыя каманды пры дапамозе карыстацкага інтэрфейсу шляхам націску кнопак, што прыкметна спрашчае працу з рэпазітарамі.
Як усталяваць
- Перайсці па спасылцы – https://desktop.github.com/
- Пачаць спампоўку ўсталявальнага пакета праграмы.
- Двойчы пстрыкнуць на абразок загружанага файла і прыступіць да ўстаноўкі Github Desktop.
- Запусціць праграму праз меню “Пуск”.
- Увайсці ў сістэму GitHub, выкарыстоўваючы дадзеныя ўліковага запісу карыстальніка.
Асноўны функцыянал
- Стварэнне, даданне і кланаванне рэпазітароў.
- Выкарыстанне праграмы для кіравання ўкладкамі праектаў.
- Унясенне змен у галінку.
- Стварэнне issues, pull request і коміты.
- Магчымасць атрымліваць доступ да ранніх версій новых прадуктаў.
Github API
Github REST API – інтэрфейс, які дае распрацоўнікам доступ да дадзеных, праектаў і рэпазітарам Github, а таксама дазваляе адпраўляць серверныя запыты. Па спасылцы https://api.github.com/ знаходзяцца ўсе URL-адрасы, на якія можна адпраўляць найпростыя GET-запыты:
Часцей за ўсё распрацоўшчыкі ствараюць рэквесты на праграмнай мове Python у фармаце JSON. Спачатку неабходна атрымаць асноўную інфармацыю аб рэпазітары па спасылцы – https://api.github.com/user/repos Асноўная інфармацыя ўпісваецца ў канфігурацыйны файл у фармаце JSON. У ім знаходзяцца асноўныя параметры аб карыстальніку – аватар, чытачы, колькасць рэпазітароў, загрузак і г.д. Гэтыя дадзеныя затым перадаюцца на сэрвер.
Кіраванне і настройка праектаў Github Desktop
Пасля ўсталёўкі, рэгістрацыі ўліковага запісу і налады прыкладання карыстач можа пачаць выкарыстоўваць праграму GitHub.
Стварэнне, даданне і кланаванне рэпазітара
Для стварэння новага рэпазітара неабходна абраць “Файл” і націснуць кнопку “Стварыць сховішча”. Для дадання лакальнага праекта неабходна абраць меню “Файл” і націснуць кнопку “Дадаць лакальны рэпазітар”. Для кланавання неабходна абраць меню “Файл” – “Кланаваць рэпазітар”.
Стварэнне New Branch
Для стварэння асобнай галіны праекту адкрыйце падзел Current Branch і націсніце кнопку New Branch. Карыстальнік зможа ўбачыць галінку ў інтэрфейсе GitHub і зрабіць pull request, каб адсочваць змены.
Бяспека
Настольная і вэб-версія Github дазваляе правесці наладу і павысіць узровень бяспекі ўліковага запісу карыстальніка. Увесь функцыянал даступны ў раздзеле “параметры бяспекі для сховішча”. Варта разгледзець больш падрабязна.
Настройка палітыкі бяспекі
На галоўнай старонцы вашага рэпазітара націсніце:
- “Security” – “Security Policy” – “Start Setup”.
- Дадайце інфармацыю аб падтрымліваемых версіях вашага праекта і аб тым, якімі спосабамі паведамляць аб магчымых уразлівасцях.
Упраўленне графікам залежнасцяў
Графік залежнасцяў аўтаматычна ствараецца для ўсіх агульнадаступных рэпазітароў, але для прыватных такой функцыі не прадугледжана. Графік ідэнтыфікуе ўсе выходныя струмені залежнасцяў і дазваляе вызначыць уразлівасці ў праекце. Для ўсталявання графіка залежнасцяў націсніце на “Налады” – “Бяспека і аналіз”. Наадварот графіка націсніце “Уключыць” або “Адключыць”.
Ліцэнзіі
Github ліцэнзаванне прадугледжвае выкарыстанне двух асноўных відаў
ліцэнзіі :
- GPL – від ліцэнзіі, які дазваляе іншым карыстальнікам выкарыстоўваць чужую працу ў іншых праектах з адкрытым зыходным кодам. Аднак камерцыйныя кампаніі не могуць гэтага рабіць.
- LGPL/Commons/MIT/Apache і т. д. – карыстач аддае свой код для бясплатнага выкарыстання. Іншыя могуць зарабляць на гэтым гроша.