Programavimas

Atvirojo kodo „Java“ projektai: „GitHub“

Jei jums buvo įdomu apie „GitHub“, tai ši trumpa pamoka Atvirojo kodo „Java“ projektai serija skirta tau. Gaukite šaltinio kodo saugyklos apžvalgą, kuri pakeitė daugelio kūrėjų darbo būdus tiek atskirai, tiek bendradarbiaujant. Tada išbandykite „GitHub“ patys, naudodami įprastas „Git“ komandas, kad galėtumėte išsišakoti ir atlikti savo atvirojo kodo projektą.

„GitHub“ yra socialinio kodavimo svetainė ir šaltinio kodo talpinimo paslauga, kuri naudoja „Git“ kaip savo versijų valdymo sistemą. Įkurta 2008 m., „GitHub“ jau gali didžiuotis beveik 1,7 milijono žmonių, talpinančių beveik 3 milijonus saugyklų. Kaip ir dauguma socialinių tinklų, „GitHub“ leidžia vartotojams kurti ir stebėti kanalus, susijusius su vienas kito projektais. Ji taip pat išplečia socialinę paradigmą, įtraukdama tinklo grafikus, rodančius saugyklos naudojimą. Galite galvoti apie „GitHub“ kaip apie socialinį tinklą, a la „Facebook“, bet tik programinės įrangos kūrėjams.

Susivieniję socialinius elementus ir nemokamą saugyklą atvirojo kodo projektams organizuoti, „GitHub“ siekia išugdyti palaikančią ir aktyvią bendruomenę, kad tobulėtų programinės įrangos pramonė. Kuo aktyvesnis projektas, tuo daugiau žmonių jį ras ir, tikiuosi, prisidės prie jo. „GitHub“ taip pat siūlo komercinių projektų paramą už nominalią kainą.

Be sekančių projektų, „GitHub“ leidžia vartotojams sekti atskirus programinės įrangos kūrėjus. Tai leidžia lengvai sekti, ką daro draugai ir kolegos, ir peržiūrėti jų kodą, taip pat ieškoti žinomų programuotojų ir sekti jų darbą. Reguliariai atnaujinamas kanalas suteikia galimybę stebėti, kaip kažkas praktikuoja savo amatą. Kūrėjams yra daug ko išmokti studijuojant vienas kito kodą ir metodiką; pavyzdžiui, galimybė pamatyti, kokį kodą kiti kūrėjai palaiko savo projektuose ir kada, yra puikus būdas aukštu lygiu sužinoti apie leidimo kūrimo ciklą.

Sekite istoriją „JavaWorld“

  • Kodėl kūrėjai versijų valdymui renkasi „Git“
  • Kai šakės tampa įprasta, pasiruoškite „GitHub“
  • „GitHub“ gauna 100 mln. USD investicijas

Socialinis kodavimas naudojant „GitHub“ leidžia kūrėjams mokytis vieniems iš kitų nauju būdu, saugant ir atnaujinant kodą naudojant populiarią, gerai pritaikytą versijų valdymo sistemą. Šiame leidime Atvirojo kodo „Java“ projektai Aš padėsiu jums pradėti naudotis „GitHub“. Pirmiausia pateiksiu platformos apžvalgą, tada pristatysiu keletą „Git“ pagrindų, įskaitant komandų eilutės parinktis, kurias dažnai naudosite „GitHub“. Galiausiai pereisiu paprastą dif-į-įsipareigoti pavyzdys, parodantis šios paskirstytos kodo saugyklos kasdieninę galią.

Pradėkite naudotis „GitHub“

„GitHub“ paskyros yra kelių skonių, sugrupuotos pagal asmeninę ar komercinę sąskaitą ir viešąją ar privačią saugyklą. Atvirojo kodo kūrėjams leidžiama neribotai naudotis viešosiomis saugyklomis arba jie už nedidelį mokestį gali pasirinkti prieglobą nuo penkių iki 20 privačių saugyklų. Komerciniai kūrėjai moka daugiau (maždaug dvigubai daugiau nei atvirojo kodo kūrėjai, palyginti su šiuo raštu) ir gali padidinti iki 125 privačių saugyklų. Išsamų planų ir kainų sąrašą rasite „GitHub“ pagrindiniame puslapyje.

Jums reikės „GitHub“ paskyros, kad galėtumėte sekti šį straipsnį. Eikite į „GitHub“ svetainę ir puslapio viršuje spustelėkite nuorodą Registracija ir kainodara. Spustelėkite „Sukurti nemokamą paskyrą“ ir užbaikite paskyros kūrimo procesą.

Jei norite savo operacinės sistemos sąrankos instrukcijų, žr. „GitHub“ mokymo programą. Atminkite, kad diegimo procesas automatiškai įdiegia GUI klientą ir paragina rankiniu būdu įdiegti „GitHub“ komandų eilutės įrankius. Aš rekomenduoju naudoti šią parinktį tuo atveju, jei kada nors norite ką nors greitai padaryti komandinėje eilutėje.

Gitas: gruntas

Norėdami efektyviai naudoti „GitHub“, turėsite bent šiek tiek susipažinti su „Git“. Daugumai geeksų įdomu tai, kad „Git“ suprojektavo ir sukūrė „Linux“ įkūrėjas Linusas Torvaldsas. Šiame skyriuje pateikiu „Git“ apžvalgą ir aprašau, kaip ji veikia. Straipsnio pabaigoje pateikiu kelių populiaresnių komandų apžvalgą, kad galėčiau greitai tapti produktyvus. Tai jokiu būdu nėra išsami pamoka, tačiau ji turėtų padėti jums pradėti.

Kai programinės įrangos kūrėjai galvoja apie versijų valdymo sistemą (VCS), mes linkę galvoti apie centrinę saugyklą, kurią naudosime atsisiųsdami šaltinio kodą, atliksime pakeitimus vietoje ir tada pateiksime tuos pakeitimus atgal į centrinę saugyklą. Gitas yra šiek tiek kitoks. Tai yra paskirstytos versijos valdymas sistema, vadinasi, tai tikrai nėra centrinė saugykla, o veikiau keli saugyklų klonai. Taigi „pagrindinė saugykla“ kažkur egzistuoja (pvz., „GitHub“), tačiau mes dirbame vietoje klonų saugyklose.

Paskirstyta „Git“ architektūra teikia didelę naudą prieš nepaskirstytas versijų valdymo sistemas, nes kūrėjai gali vietoje registruotis ir išsiregistruoti, kurti filialus ir dar daugiau. Jei norite pakeisti tradicinį VCS, turėtumėte sukurti asmeninį filialą ir patikrinti kodą. Kai atliksite pakeitimus, tą šaką sujungtumėte su pagrindine šaka.

Paskirstytas versijų valdymas

„Git“ pakeičia VC paradigmą, nes galite dirbti vietoje ir visus savo pakeitimus sujungti vienaskaitos įsipareigojimu (sujungdami galite išsaugoti savo vietos istoriją arba sujungti visus pakeitimus į vieną registraciją). Taigi centrinė saugykla nėra nusėta šakomis ir dešimtimis istorinių užrašų, o tik informacija apie atliktus ypatumus. Iš esmės „Git“ naudoja filialus taip, kaip buvo numatyta: sukurti naują funkcijų rinkinį, išlaikyti leidimą arba pašalinti su leidimu susijusias klaidas.

Kai įdiegiate „Git“ savo vietiniame kompiuteryje ir „klonuojate“ saugyklą, gausite visą saugyklą, įskaitant istorinę informaciją apie visą projekto šaltinio kodą. Tada jūs dirbate prieš savo vietinę saugyklą, įtraukdami naujus failus, pašalindami failus ir keisdami failus sustojimo aplinkoje, kol iš tikrųjų priskiriate juos vietinei saugyklai. „Git“ palaiko versijinę informaciją apie visus jūsų pakeitimus ir galite lengvai grįžti į bet kurį savo istorijos tašką. Galiausiai, kai būsite pasirengę, galėsite sinchronizuoti vietinę saugyklą su nuotoline.

Pakeitimai sinchronizuojami su nuotoline saugykla per stumti o nuotolinės saugyklos pakeitimai sinchronizuojami su jūsų vietine saugykla per traukti. Kadangi jūs turite visą saugyklos kloną vietoje, jūs neapsiribojate vien tuo, kad dirbate prieš pagrindinį tos saugyklos filialą. Galite sukurti šakas, kad jose būtų jūsų pakeitimai, tada atitinkamai stumkite arba traukite.

Žr. Ištekliai, jei jums reikia išsamesnės „Git“ pamokos. Aš sutelksiu dėmesį į „GitHub“ likusioje šio straipsnio dalyje.

Socialinis kodavimas naudojant „GitHub“

Sukūrę „GitHub“ paskyrą galite pradėti sekti kitų programinės įrangos kūrėjų darbą ar žiūrėti jus dominančius projektus. Galite rasti žmonių ar projektų, kuriuos norite sekti, tiesiogiai jų ieškodami; arba, jei ieškote idėjų, galite naudoti „GitHub“ funkciją „Naršyti“, kad rastumėte projektus pagal savo susidomėjimą. Naršyti „GitHub“ rodo populiarias ir siūlomas saugyklas. Be to, galite naršyti visas saugyklas, įrankių juostoje spustelėdami mygtuką „Saugyklos“. Jei norite ieškoti projektų, užkoduotų tam tikra programavimo kalba, įrankių juostoje galite spustelėti „Kalbos“, tada pasirinkite norimą tyrinėti kalbą. 1 paveiksle parodytos žiūrimiausios (t. Y. Populiariausios) „Java“ saugyklos šio rašymo metu.

Tuo metu, kai patikrinau, „Storm“ buvo žiūrimiausia „Java“ saugykla „GitHub“. Radę jus dominantį projektą, spustelėkite jį ir pamatysite parinktį „Žiūrėti“, kaip parodyta 2 paveiksle.

Jei spustelėsite „Žiūrėti“, būsite užsiprenumeravę, kad galėtumėte stebėti projektą ir pamatysite jo pakeitimus savo „GitHub“ pagrindiniame puslapyje. 3 paveiksle parodytas mano „GitHub“ pagrindinis puslapis, kuriame yra įvairių pavasario projektų atnaujinimų sąrašas.

Atskirų kūrėjų sekimas veikia taip pat, kaip ir sekant projektus. Pavyzdžiui, neseniai nusprendžiau sekti savo draugą Tomą Akehurstą, kaip parodyta 4 paveiksle.

Žvelgiant iš socialinės perspektyvos, „GitHub“ suteikia jums galimybę lengvai rasti kūrėjus ir projektus, kurie jus domina, ir gauti apie juos naujienas. Žinoma, teisinga ir atvirkštinė pusė: „GitHub“ yra puiki vieta parodyti savo darbą ir sulaukti bendraamžių atsiliepimų bei pripažinimo.

„GitHub“ naudojimas projektui atnaujinti ir prižiūrėti

Atminkite, kad pagrindinis „GitHub“ variklis yra skatinti atvirojo kodo programinės įrangos projektų kūrimą. Taigi, jei sukūrėte ką nors gero, kodėl neprisidėjus savo kodo prie „GitHub“ ir nepadarius jo laisvai prieinamam pasauliui?

Naują saugyklą galite sukurti iš „GitHub“ svetainės arba iš kliento programos darbalaukyje. Šiame skyriuje pirmiausia apžvelgsime saugyklos kūrimą iš svetainės, tada aš jums parodysiu, kaip atnaujinti ir atlikti failą per komandinę eilutę.

„GitHub“ saugyklos nustatymas

Darant prielaidą, kad esate sukūrę paskyrą, prisijunkite ir pamatysite kažką panašaus į tai, kas parodyta 5 paveiksle. Spustelėkite „Sukurti saugyklą“ ir būsite nukreipti į procesą. Pirmiausia viršutiniame dešiniajame įrankių juostoje spustelėsite pirmąjį elementą „Sukurti naują atpirkimą“.

Spustelėkite šią nuorodą ir suteikite savo saugyklai pavadinimą ir aprašą. Aš sukūriau naują saugyklą, kurioje būtų mano „GeekCap“ komunalinės paslaugos, tai yra pagalbinių klasių rinkinys, kuriame yra rūšiavimo algoritmai ir pakartotinai surūšiuojamas sąrašas, klasė, kuri lengvai išskiria piktogramas iš „Java Look-and-Feel“ grafikos saugyklos, ZIP paslaugų programų daugiau. Nors tai nėra pats šauniausias projektas, įtraukiau jį, nes daugumoje kitų mano projektų naudojama viena ar kelios iš šių komunalinių paslaugų, todėl gerai, kad juos saugome prieinamoje vietoje. Aš pavadinau savo projektą geek-util ir pateikė aprašą: „Geekcap Utilities: naudingi užsiėmimai, kuriuos naudoja kiti Geekcap.com projektai“.

Kai jūsų projektas bus parengtas, turėtumėte pamatyti tokį ekraną, kaip parodyta 6 paveiksle.

6 pav. Sukurta saugykla (spustelėkite, jei norite padidinti)

6 paveiksle pateiktoje ekrano kopijoje pateikiamas sąrašas, ką galite padaryti naudodami savo naują saugyklą, taip pat pavyzdys, kaip sukurti SKAITYK MANE failą ir įstumdami jį į savo saugyklą. Turiu esamą „Maven“ projektą, kurį turiu pridėti pirmą kartą, todėl pradedu pridėdamas savo pom.xml byla ir mano src kataloge. Žemiau pateikiamos „Git“ komandos, kurias įvedžiau pradiniam projekto perkėlimui į saugyklą:

Sąrašai 1. „Git“ komandos kuriant saugyklą

git init git pridėti src git pridėti pom.xml git įsipareigoti -m 'Pirminis įsipareigojimas' git nuotoliniu būdu pridėti kilmę //github.com/geekcap/geek-util.git git push -u origin master

Čia svarbu žinoti „Git“, jei norite naudoti „GitHub“. Laimei, pagrindinės „Git“ komandos yra gana intuityvios:

  • git init sukuria tuščią „Git“ saugyklą. Tiksliau, tai sukuria .git katalogą, kurį git komanda atpažins kaip saugyklą.
  • git pridėti prideda failus į saugyklą; šiuo atveju pridėjau savo pom.xml ir mano src kataloge.
  • git įsipareigoti atlieka saugyklos pakeitimus. Viskas, ką padariau, buvo pridėti pom.xml failą ir src kataloge. Šią komandą taip pat naudosite pakeisdami failo turinį arba ištrindami failus naudodami git rm komandą.
  • git nuotolinio pridėti kilmę prideda nurodytą URL kaip „Git“ saugyklos kilmės serverį. Kaip matėte 6 paveiksle, kilmės serveris yra sukurtas „GitHub“ jums, o URL pateikiamas sąrankos dokumentuose.
  • git stumti įkelia visus atliktus pakeitimus į nurodytą serverį. Šiuo atveju aš nustūmiau pradinį įsipareigojimą, kuriame yra pom.xml ir src katalogą į kilmės serverį, kurį anksčiau nustatiau.

„Git“ galite naudoti iš savo IDE arba iš komandinės eilutės; Aš tiesiog esu komandinės eilės narkomanas. Vykdoma git pagalba rodo dažniausiai pasitaikančias komandas, kurios apibendrintos 2 sąraše.

$config[zx-auto] not found$config[zx-overlay] not found