Ak ste boli zvedaví na GitHub, potom tento krátky návod v Open source projekty Java séria je pre vás. Získajte prehľad o úložisku zdrojových kódov, ktoré zmenilo spôsob práce mnohých vývojárov, a to jednotlivo aj spoločne. Potom vyskúšajte GitHub sami pomocou bežných príkazov Git na rozvetvenie a odovzdanie vlastného projektu otvoreného zdroja.
GitHub je webová stránka so sociálnym kódovaním a hostiteľská služba so zdrojovým kódom, ktorá ako svoj systém riadenia verzií používa Git. Spoločnosť GitHub, ktorá bola uvedená na trh v roku 2008, sa už môže pochváliť takmer 1,7 milióna ľuďmi, ktorí hostia takmer 3 milióny úložísk. Rovnako ako väčšina sociálnych sietí, aj GitHub umožňuje používateľom vytvárať a sledovať kanály spojené s projektmi toho druhého. Rozširuje tiež sociálnu paradigmu o sieťové grafy, ktoré ukazujú využitie úložiska. Môžete premýšľať o GitHube ako o sociálnej sieti, a la Facebook, ale iba pre vývojárov softvéru.
Cieľom GitHubu je spojiť sociálne prvky s bezplatným úložiskom na hosťovanie projektov s otvoreným zdrojom, aby vypestoval podpornú a aktívnu komunitu pre zlepšenie softvérového priemyslu. Čím je projekt aktívnejší, tým viac ľudí ho nájde a dúfajme, že k nemu prispeje. GitHub tiež ponúka podporu komerčných projektov za nominálne náklady.
Okrem nasledujúcich projektov umožňuje GitHub používateľom sledovať jednotlivých vývojárov softvéru. Vďaka tomu je ľahké držať krok s tým, čo priatelia a kolegovia robia, a skontrolovať ich kód, ako aj vyhľadať známych programátorov a sledovať ich prácu. Pravidelne aktualizovaný informačný kanál predstavuje príležitosť sledovať, ako niekto vykonáva svoje remeslo. Pre vývojárov je toho veľa, čo sa môžu naučiť pri vzájomnom štúdiu kódu a metodiky; napríklad možnosť vidieť, aký kód iní vývojári tlačia do svojich projektov, a to je skvelý spôsob, ako sa dozvedieť na vysokej úrovni o vývojovom cykle vydania.
Sledujte príbeh na webe JavaWorld
- Prečo si vývojári pre správu verzií vyberajú Git
- Keď sa vidlica stane normou, pripravte sa na GitHub
- GitHub získava investície vo výške 100 miliónov dolárov
Sociálne kódovanie s GitHub umožňuje vývojárom učiť sa od seba novým spôsobom pri ukladaní a aktualizácii kódu pomocou populárneho dobre vybaveného systému riadenia verzií. V tomto vydaní Projekty Java s otvoreným zdrojom Pomôžem vám začať s GitHubom. Najskôr poskytnem prehľad platformy, potom predstavím základné základy Gitu vrátane možností príkazového riadku, ktoré v GitHube často používate. Na záver si prejdem jednoduchý rozdiel-to-spáchať príklad, ktorý demonštruje každodennú silu tohto úložiska distribuovaných kódov.
Začíname s GitHubom
Účty GitHub majú niekoľko príchutí, zoskupené podľa individuálnych alebo komerčných účtov a podľa verejného alebo súkromného úložiska. Vývojári s otvoreným zdrojovým kódom majú povolené neobmedzené verejné úložiská alebo za malý poplatok môžu hostiť päť až 20 súkromných úložísk. Komerční vývojári platia viac (asi dvakrát toľko ako vývojári s otvoreným zdrojom od tohto písania) a môžu sa škálovať až na 125 súkromných úložísk. Na domovskej stránke GitHub nájdete kompletný zoznam plánov a cien.
Aby ste mohli postupovať podľa tohto článku, budete potrebovať účet GitHub. Prejdite na webovú stránku GitHub a kliknite na odkaz Zaregistrovať sa a ceny v hornej časti stránky. Kliknite na možnosť „Vytvoriť bezplatný účet“ a dokončite proces vytvárania účtu.
Ak chcete pokyny na nastavenie operačného systému, prečítajte si príručku GitHub. Upozorňujeme, že proces inštalácie automaticky nainštaluje klienta grafického používateľského rozhrania a zobrazí výzvu na manuálnu inštaláciu nástrojov príkazového riadku GitHub. Odporúčam vám použiť túto možnosť pre prípad, že by ste niekedy chceli niečo rýchlo urobiť na príkazovom riadku.
Git: Základný náter
Aby ste mohli GitHub efektívne využívať, musíte byť s Gitom aspoň trochu oboznámení. Pre väčšinu geekov je zaujímavé, že Git navrhol a vyvinul Linus Torvalds, zakladateľ Linuxu. V tejto časti uvádzam prehľad Gitu a popisujem, ako funguje. Na konci článku uvádzam prehľad niekoľkých populárnejších príkazov, ktoré vám pomôžu rýchlo dosiahnuť produktivitu. Toto v žiadnom prípade nie je vyčerpávajúci návod, ale mal by vám pomôcť začať.
Keď vývojári softvéru premýšľajú o systéme riadenia verzií (VCS), máme tendenciu myslieť na centrálne úložisko, ktoré použijeme na stiahnutie zdrojového kódu, vykonanie lokálnych zmien a následné odoslanie týchto zmien späť do centrálneho úložiska. Git je trochu iný. Je to riadenie distribuovanej verzie systém, čo znamená, že v skutočnosti nejde o centrálne úložisko, ale skôr o viac klonov úložísk. „Hlavné úložisko“ teda niekde existuje (napríklad v GitHub), ale pracujeme lokálne na klonovaných úložiskách.
Distribuovaná architektúra spoločnosti Git poskytuje oproti nedistribuovaným systémom riadenia verzií významnú výhodu v tom, že vývojári môžu lokálne odbavovať a odhlasovať kód, vytvárať pobočky a ďalšie. Pre zásadnú zmenu v tradičnom VCS by ste vytvorili osobnú pobočku a skontrolovali kód do tejto pobočky. Po dokončení zmien by ste zlúčili túto vetvu s hlavnou.
Kontrola distribuovanej verzie
Git mení paradigmu VC, pretože môžete pracovať lokálne a všetky svoje zmeny zlúčiť v singulárnom potvrdení (pri zlúčení môžete zachovať svoju miestnu históriu alebo môžete všetky zmeny spojiť do jedného prihlásenia). Centrálne úložisko teda nie je posiate vetvami a desiatkami historických poznámok, ale iba informáciami o vykonaných zmenách funkcií. Git v podstate používa vetvy tak, ako boli určené: vyvinúť novú sadu funkcií, udržiavať vydanie alebo opraviť chyby spojené s vydaním.
Keď nainštalujete Git na miestny počítač a „naklonujete“ úložisko, dostanete celé úložisko vrátane historických informácií o všetkých zdrojových kódoch v projekte. Potom pracujete proti miestnemu úložisku, pridávate nové súbory, odstraňujete ich a meníte súbory v pracovnom prostredí, kým ich skutočne neprihlásite do miestneho úložiska. Git udržiava informácie o verziách všetkých vašich zmien a vy sa môžete ľahko vrátiť späť na akékoľvek miesto v histórii. Nakoniec, keď budete pripravení, môžete synchronizovať miestne úložisko so vzdialeným.
Zmeny sa synchronizujú do vzdialeného úložiska pomocou a tam zatiaľ čo zmeny vo vzdialenom úložisku sa synchronizujú s miestnym úložiskom pomocou a ťahať. Pretože máte lokálne celý klon úložiska, neobmedzujete sa iba na prácu proti hlavnej vetve tohto úložiska. Môžete vytvoriť vetvy, ktoré obsahujú vaše zmeny, a potom ich podľa potreby tlačiť alebo ťahať.
Ak potrebujete podrobnejší úvod do Gitu, prečítajte si Zdroje. Po zvyšok tohto článku sa budem venovať GitHubu.
Sociálne kódovanie s GitHub
Po vytvorení účtu GitHub môžete začať sledovať prácu iných vývojárov softvéru alebo sledovať projekty, ktoré vás zaujímajú. Môžete nájsť ľudí alebo projekty, ktoré chcete sledovať, tým, že ich priamo vyhľadáte; alebo, ak hľadáte nápady, môžete pomocou funkcie „Preskúmať“ GitHub vyhľadať projekty podľa vášho záujmu. Preskúmajte GitHub zobrazuje trendy úložiská aj odporúčané. Okrem toho môžete preskúmať všetky úložiská kliknutím na tlačidlo „Úložiská“ na paneli nástrojov. Ak chcete vyhľadať projekty kódované v konkrétnom programovacom jazyku, môžete na paneli nástrojov kliknúť na tlačidlo „Jazyky“ a potom zvoliť jazyk, ktorý chcete preskúmať. Obrázok 1 zobrazuje najsledovanejšie (tj. Trendy) úložiská Java v čase písania tohto článku.
Storm bolo najsledovanejšie Java úložisko na GitHub v čase, ktorý som kontroloval. Akonáhle nájdete projekt, ktorý vás zaujíma, kliknite na neho a uvidíte možnosť „Pozrieť“, ako je to znázornené na obrázku 2.
Ak kliknete na „Pozrieť“, budete prihlásený / -á na sledovanie projektu a zmeny, ktoré ste v ňom vykonali, uvidíte na svojej domovskej stránke GitHub. Obrázok 3 zobrazuje moju domovskú stránku GitHub, ktorá obsahuje zoznam aktualizácií rôznych jarných projektov.
Sledovanie jednotlivých vývojárov funguje rovnako ako sledovanie projektov. Napríklad som sa nedávno rozhodol nasledovať svojho priateľa Toma Akehursta, ako je to znázornené na obrázku 4.
Zo sociálneho hľadiska vám GitHub umožňuje ľahko vyhľadávať vývojárov a projekty, ktoré by vás mohli zaujímať, a dostávať o nich aktualizácie. Samozrejme, platí aj odvrátená strana: GitHub je vynikajúcim miestom na predvádzanie svojej práce a na získanie spätnej väzby a uznania od vašich kolegov.
Používanie GitHubu na aktualizáciu a údržbu projektu
Pamätajte, že hlavnou hybnou silou GitHubu je podpora vývoja softvérových projektov s otvoreným zdrojovým kódom. Takže ak ste vytvorili niečo dobré, prečo neprispieť svojím kódom do GitHubu a voľne ho sprístupniť svetu?
Nové úložisko môžete vytvoriť z webovej stránky GitHub alebo z klientskej aplikácie na pracovnej ploche. V tejto časti najskôr prejdeme vytvorením úložiska z webovej stránky, potom vám ukážem, ako aktualizovať a potvrdiť súbor pomocou príkazového riadku.
Nastavenie úložiska GitHub
Za predpokladu, že máte zriadený účet, prihláste sa a uvidíte niečo podobné tomu, čo je zobrazené na obrázku 5. Kliknite na „Vytvoriť úložisko“ a budete prevedení týmto procesom. Najskôr kliknete na prvú položku v pravom hornom paneli nástrojov „Vytvoriť nové úložisko“.
Kliknite na tento odkaz a pomenujte svoje úložisko názvom a popisom. Vytvoril som nové úložisko na hosťovanie mojich obslužných programov GeekCap, čo je sada pomocných tried, ktoré zahŕňajú triediace algoritmy a zoznam opätovného zaradenia, trieda, ktorá ľahko extrahuje ikony z grafického úložiska Java Look-and-Feel, pomocných programov ZIP a viac. Aj keď nejde o najlepší projekt, zahrnul som ho, pretože väčšina mojich ďalších projektov používa jeden alebo viac týchto nástrojov, takže je dobré ich mať uložené na prístupnom mieste. Pomenoval som svoj projekt geek-util a dal mu popis: „Geekcap Utilities: užitočné triedy, ktoré používajú iné projekty Geekcap.com.“
Akonáhle je váš projekt nastavený, mala by sa vám zobraziť obrazovka, ako je tá na obrázku 6.
Obrázok 6. Vytvorené úložisko (kliknutím ho zväčšite)
Screenshot na obrázku 6 zobrazuje zoznam toho, čo môžete robiť s novým úložiskom, ako aj príklad vytvorenia súboru PREČÍTAJ MA súbor a zatlačte ho do svojho úložiska. Mám existujúci projekt Maven, ktorý musím pridať prvýkrát, a tak začnem pridaním môjho pom.xml spis a môj src adresár. Ďalej sú uvedené príkazy Git, ktoré som zadal pre počiatočné zatlačenie projektu do úložiska:
Zoznam 1. Príkazy Git na vytvorenie úložiska
git init git add src git add pom.xml git commit -m 'Initial commit' git remote add origin //github.com/geekcap/geek-util.git git push -u origin masterTu je miesto, kde je dôležitá znalosť Gitu, ak chcete používať GitHub. Našťastie sú hlavné príkazy Gitu pomerne intuitívne:
- git init vytvorí prázdne úložisko Git. Konkrétne sa tým vytvorí
.gitadresár, ktorýgitpríkaz rozpozná ako úložisko. - git pridať pridáva súbory do úložiska; v tomto prípade som pridal svoje
pom.xmla môjsrcadresár. - git spáchať zaviaže zmeny v úložisku. Jediné, čo som urobil, bolo pridať
pom.xmlspis asrcadresár. Tento príkaz by ste použili aj po úprave obsahu súboru alebo odstránení súborov cezgit rmpríkaz. - git remote add origin pridá zadanú adresu URL ako pôvodný server pre úložisko Git. Ako ste videli na obrázku 6, ikona pôvodný server je pre vás vytvorený na GitHub a adresa URL je uvedená v dokumentácii nastavenia.
- git push nahrá všetky potvrdené zmeny na zadaný server. V tomto prípade som stlačil počiatočné potvrdenie, ktoré obsahuje
pom.xmlasrcadresár na pôvodný server, ktorý som predtým nastavil.
Môžete použiť Git z vášho IDE alebo z príkazového riadku; Len som náhodou narkoman z príkazového riadku. Vykonávanie pomoc git zobrazuje najbežnejšie príkazy, ktoré sú zhrnuté v zozname 2.
