Programmēšana

Atvērtā koda Java projekti: GitHub

Ja jums ir bijusi interese par GitHub, tad šī īsā apmācība Atvērtā koda Java projekti sērija ir domāta jums. Iegūstiet pārskatu par pirmkodu krātuvi, kas ir mainījusi daudzu izstrādātāju darbu gan individuāli, gan sadarbojoties. Pēc tam izmēģiniet GitHub pats, izmantojot filiāles Git, lai sazarotos un paveiktu pats savu atvērtā pirmkoda projektu.

GitHub ir sociālās kodēšanas vietne un pirmkodu mitināšanas pakalpojums, kas Git izmanto kā versiju kontroles sistēmu. GitHub, kas tika izveidots 2008. gadā, jau lepojas ar gandrīz 1,7 miljoniem cilvēku, kuros ir gandrīz 3 miljoni krātuvju. Tāpat kā lielākā daļa sociālo tīklu, arī GitHub ļauj lietotājiem izveidot un sekot plūsmām, kas saistītas ar otra projektiem. Tas arī paplašina sociālo paradigmu, iekļaujot tīkla grafikus, kas parāda krātuves izmantošanu. Jūs varat domāt par GitHub kā sociālo tīklu, a la Facebook, bet tikai programmatūras izstrādātājiem.

Apvienojot sociālos elementus ar bezmaksas krātuvi, lai uzņemtu atvērtā koda projektus, GitHub mērķis ir izkopt atbalstošu un aktīvu kopienu programmatūras nozares uzlabošanai. Jo aktīvāks ir projekts, jo vairāk cilvēku to atradīs un, cerams, tajā piedalīsies. GitHub piedāvā arī komerciālu projektu atbalstu par nominālajām izmaksām.

Papildus sekojošiem projektiem GitHub ļauj lietotājiem sekot atsevišķiem programmatūras izstrādātājiem. Tas ļauj viegli sekot līdzi tam, ko dara draugi un kolēģi, un pārskatīt viņu kodu, kā arī meklēt pazīstamus programmētājus un sekot viņu darbam. Regulāri atjaunināta plūsma sniedz iespēju vērot, kā kāds praktizē savu amatu. Izstrādātājiem ir daudz jāmācās, studējot viens otra kodu un metodiku; piemēram, spēja redzēt, kādu kodu citi izstrādātāji virzās uz saviem projektiem un kad tas ir lielisks veids, kā augstā līmenī uzzināt par laidiena izstrādes ciklu.

Sekojiet stāstam vietnē JavaWorld

  • Kāpēc izstrādātāji versiju kontrolei izvēlas Git
  • Kad dakša kļūst par normu, sagatavojieties GitHub
  • GitHub saņem 100 miljonu dolāru ieguldījumu

Sociālā kodēšana ar GitHub ļauj izstrādātājiem mācīties viens no otra jaunā veidā, vienlaikus saglabājot un atjauninot kodu, izmantojot populāru, labi piedāvātu versiju kontroles sistēmu. Šajā izdevumā Atvērtā koda Java projekti Es jums palīdzēšu sākt darbu ar GitHub. Vispirms es sniegšu pārskatu par platformu, pēc tam iepazīstināšu ar dažiem Git pamatiem, ieskaitot komandrindas opcijas, kuras jūs bieži izmantosiet GitHub. Visbeidzot, es eju cauri vienkāršam dif-to-apņemties piemērs, kas parāda šī izplatītā koda repozitorija ikdienas spēku.

Sāciet darbu ar GitHub

GitHub kontiem ir vairākas garšas, grupējot tos pēc individuāla vai komerciāla konta un pēc valsts vai privāta krātuves. Atvērtā koda izstrādātājiem ir atļauts neierobežoti publiski glabātavas, vai arī viņi par nelielu samaksu var izvēlēties mitināt no pieciem līdz 20 privātiem krātuvēm. Komerciālie izstrādātāji maksā vairāk (apmēram divreiz vairāk nekā atvērtā koda izstrādātāji nekā šajā rakstā) un var palielināt līdz pat 125 privātiem krātuvēm. Pilnu plānu un cenu sarakstu skatiet GitHub mājaslapā.

Lai sekotu šim rakstam, jums būs nepieciešams GitHub konts. Dodieties uz GitHub vietni un lapas augšdaļā noklikšķiniet uz saites Reģistrēties un cenu noteikšana. Noklikšķiniet uz "Izveidot bezmaksas kontu" un pabeidziet konta izveides procesu.

Ja vēlaties iestatīšanas instrukcijas savai operētājsistēmai, skatiet GitHub apmācību. Ņemiet vērā, ka instalēšanas procesā automātiski tiek uzstādīts GUI klients un tiek piedāvāts manuāli instalēt GitHub komandrindas rīkus. Es iesaku jums izmantot šo iespēju, ja kādreiz vēlaties kaut ko ātri izdarīt komandrindā.

Git: grunts

Lai efektīvi izmantotu GitHub, jums vismaz jāpārzina Git. Lielāko daļu geeksu interesējošais ir tas, ka Git izstrādāja un izstrādāja Linux dibinātājs Linuss Torvalds. Šajā sadaļā es sniedzu pārskatu par Git un aprakstīju, kā tas darbojas. Raksta beigās es sniedzu pārskatu par dažām populārākajām komandām, lai palīdzētu jums ātri kļūt produktīviem. Šī nekādā ziņā nav izsmeļoša apmācība, taču tai vajadzētu palīdzēt jums sākt darbu.

Kad programmatūras izstrādātāji domā par versiju kontroles sistēmu (VCS), mums ir tendence domāt par centrālo repozitoriju, kuru izmantosim, lai lejupielādētu pirmkodu, veiktu izmaiņas lokāli un pēc tam šīs izmaiņas iesniegtu centrālajā repozitorijā. Gits ir nedaudz atšķirīgs. Tas ir izplatīta versiju vadība sistēma, kas nozīmē, ka tā patiešām nav centrālā krātuve, bet gan vairāki krātuvju kloni. Tātad "galvenā krātuve" kaut kur pastāv (piemēram, GitHub), bet mēs lokāli strādājam pie klonu krātuvēm.

Git izplatītā arhitektūra sniedz ievērojamu labumu salīdzinājumā ar neizplatītām versiju vadības sistēmām, jo ​​izstrādātāji var lokāli reģistrēties un izrakstīties kodu, izveidot filiāles un daudz ko citu. Lai veiktu būtiskas izmaiņas tradicionālajā VCS, izveidojiet personīgo filiāli un pārbaudiet kodu šajā filiālē. Kad esat pabeidzis izmaiņas, jūs šo filiāli apvienotu ar galveno atzaru.

Izplatītā versijas vadība

Git maina VC paradigmu, jo jūs varat strādāt lokāli un visas izmaiņas apvienot vienskaitļa apņemšanās laikā (apvienojoties varat saglabāt vietējo vēsturi vai apvienot visas izmaiņas vienā reģistrēšanās reizē). Tātad centrālajā krātuvē nav daudz zaru un desmitiem vēsturisku piezīmju, bet tikai informācija par veiktajām pazīmju izmaiņām. Būtībā Git izmanto filiāles, kā tās bija paredzētas: lai izstrādātu jaunu funkciju kopu, lai saglabātu laidienu vai novērstu ar laidienu saistītās kļūdas.

Instalējot vietējā datorā Git un "klonējot" krātuvi, jūs saņemat visu krātuvi, ieskaitot vēsturisko informāciju par visu projekta avota kodu. Pēc tam jūs strādājat pret vietējo repozitoriju, pievienojot jaunus failus, noņemot failus un mainot failus pakāpeniskajā vidē, līdz jūs tos faktiski nododat vietējam repozitorijam. Git uztur versiju informāciju par visām jūsu izmaiņām, un jūs varat viegli pāriet uz jebkuru savas vēstures punktu. Visbeidzot, kad esat gatavs, varat sinhronizēt vietējo repozitoriju ar attālo.

Izmaiņas tiek sinhronizētas ar attālo repozitoriju, izmantojot a grūst kamēr izmaiņas attālajā repozitorijā tiek sinhronizētas ar vietējo repozitoriju, izmantojot a vilkt. Tā kā jums ir pilns repozitorija klons lokāli, jūs neaprobežojaties tikai ar darbu pret šīs repozitorija galveno filiāli. Jūs varat izveidot filiāles, lai saturētu jūsu veiktās izmaiņas, un pēc tam vai nu nospiediet vai velciet tās atbilstoši.

Skatiet resursus, ja jums ir nepieciešams pilnīgāks Git apmācības ievads. Es koncentrēšos uz GitHub par atlikušo šī raksta daļu.

Sociālā kodēšana ar GitHub

Kad esat izveidojis GitHub kontu, varat sākt sekot citu programmatūras izstrādātāju darbam vai skatīties jūs interesējošos projektus. Jūs varat atrast cilvēkus vai projektus, kuriem sekot, tos tieši meklējot; vai, ja meklējat idejas, varat izmantot GitHub funkciju "Izpētīt", lai atrastu projektus, kas balstīti uz jūsu interesi. Pārlūkot GitHub tiek parādīti populāri krātuves, kā arī piedāvātie krātuves. Papildus tiem varat izpētīt visus krātuves, rīkjoslā noklikšķinot uz pogas "Krātuves". Ja vēlaties meklēt projektus, kas kodēti noteiktā programmēšanas valodā, rīkjoslā varat noklikšķināt uz "Valodas", pēc tam izvēlieties valodu, kuru vēlaties izpētīt. 1. attēlā redzamākās (t.i., tendences) Java krātuves šīs rakstīšanas laikā.

Storm bija pārbaudītākajā laikā visvairāk skatītais Java krātuve vietnē GitHub. Kad esat atradis jūs interesējošu projektu, noklikšķiniet uz tā un redzēsiet iespēju "Skatīties", kā parādīts 2. attēlā.

Ja noklikšķināsit uz "Skatīties", jūs abonēsit, lai sekotu projektam, un varēsit redzēt tajā veiktās izmaiņas savā GitHub mājaslapā. 3. attēlā parādīta mana GitHub mājas lapa, kurā ir dažādu pavasara projektu atjauninājumu saraksts.

Atsevišķu izstrādātāju sekošana darbojas tāpat kā projektu sekošana. Piemēram, es nesen nolēmu sekot savam draugam Tomam Akehurstam, kā parādīts 4. attēlā.

No sociālā viedokļa GitHub dod jums iespēju viegli atrast izstrādātājus un projektus, kas jūs varētu interesēt, un saņemt par tiem atjauninājumus. Protams, taisnība ir arī otrā pusē: GitHub ir lieliska vieta, kur parādīt savu darbu un saņemt atsauksmes un atzinību no vienaudžiem.

GitHub izmantošana projekta atjaunināšanai un uzturēšanai

Atcerieties, ka galvenais GitHub virzītājspēks ir veicināt atvērtā pirmkoda programmatūras projektu attīstību. Tātad, ja esat izveidojis kaut ko labu, kāpēc gan nepievienot savu kodu GitHub un padarīt to brīvi pieejamu pasaulei?

Jūs varat izveidot jaunu krātuvi no GitHub vietnes vai no darbvirsmas klienta lietojumprogrammas. Šajā sadaļā vispirms iepazīsimies ar repozitorija izveidi no vietnes, pēc tam es jums parādīšu, kā atjaunināt un izveidot failu, izmantojot komandrindu.

GitHub repozitorija iestatīšana

Pieņemot, ka esat izveidojis kontu, piesakieties un redzēsit kaut ko līdzīgu tam, kas parādīts 5. attēlā. Noklikšķiniet uz "Izveidot repozitoriju", un jūs tiksiet virzīts uz šo procesu. Vispirms augšējā labajā rīkjoslā noklikšķiniet uz pirmā vienuma "Izveidot jaunu repo".

Noklikšķiniet uz šīs saites un piešķiriet savam krātuvei nosaukumu un aprakstu. Es izveidoju jaunu krātuvi savu GeekCap utilītu mitināšanai, kas ir palīgu klašu kopums, kas ietver šķirošanas algoritmus un atkārtoti šķirojamu sarakstu, klasi, kas viegli izvelk ikonas no Java Look-and-Feel Graphics repository, ZIP utilītprogrammām un vairāk. Lai arī tas nav stilīgākais projekts, es to iekļāvu, jo lielākajā daļā citu manu projektu tiek izmantots viens vai vairāki no šiem utilītprogrammām, tāpēc ir labi, ja tos glabā pieejamā vietā. Es nosaucu savu projektu geek-util un deva tai aprakstu: "Geekcap Utilities: noderīgas nodarbības, kuras izmanto citi Geekcap.com projekti."

Kad jūsu projekts ir izveidots, jums vajadzētu redzēt tādu ekrānu kā parādīts 6. attēlā.

6. attēls. Izveidots krātuve (noklikšķiniet, lai palielinātu)

6. attēlā redzamajā ekrānuzņēmumā ir parādīts saraksts ar to, ko jūs varat darīt ar savu jauno krātuvi, kā arī a. Izveides piemērs LASĪT failu un ievietojot to savā repozitorijā. Man ir esošs Maven projekts, kas man jāpievieno pirmo reizi, tāpēc es sāku, pievienojot savu pom.xml failu un manu src direktorijā. Tālāk ir norādītas Git komandas, kuras es ievadīju sākotnējam projekta virzīšanai repozitorijā:

Saraksts 1. Git komandas repozitorija izveidošanai

git init git add src git add pom.xml git saistīt -m 'Sākotnējā saistība' git tālvadības pievienot izcelsmi //github.com/geekcap/geek-util.git git push -u izcelsmes meistars

Ja vēlaties izmantot GitHub, ir svarīga Git pārzināšana. Par laimi, galvenās Git komandas ir samērā intuitīvas:

  • git init izveido tukšu Git repozitoriju. Konkrēti, tas rada .git direktoriju, kuru git komanda tiks atpazīta kā repozitorijs.
  • git pievienot pievieno krātuvei failus; šajā gadījumā es pievienoju savu pom.xml un mans src direktorijā.
  • git apņemties veic izmaiņas krātuvē. Viss, ko es darīju, bija pievienot pom.xml failu un src direktorijā. Jūs izmantosiet šo komandu arī pēc faila satura pārveidošanas vai failu dzēšanas, izmantojot git rm komandu.
  • git tālvadības pievienot izcelsmi pievieno norādīto URL kā izcelsmes serveri Git repozitorijam. Kā redzējāt 6. attēlā, izcelsmes serveris ir izveidots vietnē GitHub, un URL ir norādīts iestatīšanas dokumentācijā.
  • git push augšupielādē visas veiktās izmaiņas norādītajā serverī. Šajā gadījumā es esmu virzījis sākotnējo apņemšanos, kas satur pom.xml un src direktoriju uz izcelsmes serveri, kuru iepriekš iestatīju.

Git varat izmantot no sava IDE vai no komandrindas; Es vienkārši esmu komandrindas junkie. Izpilda git palīdzību parāda visizplatītākās komandas, kuras ir apkopotas 2. sarakstā.

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