Programování

Open source projekty Java: GitHub

Pokud jste byli zvědaví na GitHub, pak tento krátký návod v Open source projekty Java série je pro vás. Získejte přehled úložiště zdrojového kódu, které změnilo způsob práce mnoha vývojářů, a to jednotlivě i společně. Pak vyzkoušejte GitHub sami, pomocí běžných příkazů Git se rozvětvte a odevzdejte svůj vlastní open source projekt.

GitHub je webová stránka pro sociální kódování a hostování zdrojového kódu, která používá Git jako svůj systém pro správu verzí. GitHub, který byl spuštěn v roce 2008, se již může pochlubit téměř 1,7 miliony lidí, kteří hostují téměř 3 miliony úložišť. Stejně jako většina sociálních sítí umožňuje GitHub uživatelům vytvářet a sledovat kanály spojené s projekty ostatních. Rovněž rozšiřuje sociální paradigma o síťové grafy, které ukazují využití úložiště. O GitHubu můžete uvažovat jako o sociální síti, a la Facebook, ale jen pro vývojáře softwaru.

Spojením sociálních prvků s bezplatným úložištěm pro hostování projektů open source si GitHub klade za cíl pěstovat podpůrnou a aktivní komunitu pro zlepšení softwarového průmyslu. Čím aktivnější je projekt, tím více lidí ho najde a doufejme, že k němu přispěje. GitHub také nabízí podporu komerčních projektů za nominální cenu.

Kromě následujících projektů umožňuje GitHub uživatelům sledovat jednotlivé vývojáře softwaru. Díky tomu je snadné držet krok s tím, co dělají přátelé a kolegové, zkontrolovat jejich kód a také vyhledat známé programátory a sledovat jejich práci. Pravidelně aktualizovaný zdroj představuje příležitost sledovat, jak někdo cvičí své řemeslo. Pro vývojáře je toho hodně co se učit při vzájemném studiu kódu a metodiky; například možnost vidět, jaký kód ostatní vývojáři tlačí do svých projektů, a kdy, je skvělý způsob, jak se na vysoké úrovni učit o vývojovém cyklu vydání.

Sledujte příběh na JavaWorld

  • Proč vývojáři volí Git pro správu verzí
  • Jakmile se rozvětvení stane normou, připravte se na GitHub
  • GitHub získává investice ve výši 100 milionů dolarů

Sociální kódování s GitHub umožňuje vývojářům učit se navzájem novým způsobem při ukládání a aktualizaci kódu pomocí populárního dobře vybaveného systému pro správu verzí. V tomto vydání Open source projekty Java Pomůžu vám začít s GitHubem. Nejprve poskytnu přehled platformy, poté představím některé základy Git, včetně možností příkazového řádku, které budete v GitHubu často používat. Nakonec projdu jednoduchým rozdíl-na-spáchat příklad, který demonstruje každodenní sílu tohoto úložiště distribuovaného kódu.

Začněte s GitHub

Účty GitHub přicházejí v několika variantách, seskupené podle jednotlivých nebo komerčních účtů a podle veřejného nebo soukromého úložiště. Vývojáři s otevřeným zdrojovým kódem mají povoleno neomezené veřejné úložiště, nebo za malý poplatek mohou zvolit hostování mezi pěti a 20 soukromými úložišti. Komerční vývojáři platí více (asi dvakrát tolik než vývojáři s otevřeným zdrojovým kódem od tohoto psaní) a mohou se škálovat až na 125 soukromých úložišť. Na domovské stránce GitHub najdete kompletní seznam plánů a cen.

Abyste mohli postupovat podle tohoto článku, budete potřebovat účet GitHub. Přejděte na web GitHub a klikněte na odkaz Registrace a cena v horní části stránky. Klikněte na „Vytvořit bezplatný účet“ a dokončete proces vytváření účtu.

Pokud chcete pokyny pro nastavení operačního systému, podívejte se na výukový program GitHub. Všimněte si, že proces instalace automaticky nainstaluje klienta grafického uživatelského rozhraní a vyzve vás k ruční instalaci nástrojů příkazového řádku GitHub. Doporučuji použít tuto možnost pro případ, že byste někdy chtěli něco rychle udělat na příkazovém řádku.

Git: Základní nátěr

Abyste mohli GitHub efektivně využívat, budete muset být alespoň trochu obeznámeni s Gitem. Pro většinu geeků je zajímavé, že Git navrhl a vyvinul Linus Torvalds, zakladatel Linuxu. V této části poskytuji přehled Gitu a popisuji jeho fungování. Ke konci článku uvádím přehled několika populárnějších příkazů, které vám pomohou rychle se stát produktivními. Toto v žádném případě není vyčerpávající výukový program, ale měl by vám pomoci začít.

Když vývojáři softwaru přemýšlejí o systému správy verzí (VCS), máme tendenci uvažovat o centrálním úložišti, které použijeme ke stažení zdrojového kódu, provedení místních změn a následné odeslání těchto změn zpět do centrálního úložiště. Git je trochu jiný. Je to řízení distribuované verze systém, což znamená, že ve skutečnosti nejde o centrální úložiště, ale spíše o více klonů úložišť. „Hlavní úložiště“ tedy někde existuje (například v GitHubu), ale pracujeme lokálně na klonovaných úložištích.

Distribuovaná architektura Git poskytuje významnou výhodu oproti nedistribuovaným systémům řízení verzí v tom, že vývojáři mohou lokálně odbavovat a vydávat kód, vytvářet pobočky a další. Pro zásadní změnu v tradičním VCS byste vytvořili osobní větev a zkontrolovali kód do této větve. Až budete hotovi se svými změnami, sloučíte tuto větev do hlavní větve.

Řízení distribuované verze

Git mění paradigma VC, protože můžete pracovat lokálně a sloučit všechny své změny v singulárním odevzdání (při sloučení můžete zachovat místní historii nebo můžete všechny změny spojit do jednoho odbavení). Centrální úložiště tedy není plné větví a desítek historických poznámek, ale pouze informací o provedených změnách funkcí. Git v podstatě používá větve tak, jak byly zamýšleny: vyvinout novou sadu funkcí, udržovat vydání nebo opravit chyby spojené s vydáním.

Když nainstalujete Git na místní počítač a „naklonujete“ úložiště, obdržíte celé úložiště včetně historických informací o všech zdrojových kódech v projektu. Potom pracujete proti místnímu úložišti, přidáváte nové soubory, odebíráte soubory a měníte soubory v pracovním prostředí, dokud je skutečně nepotvrdíte v místním úložišti. Git udržuje informace o verzích všech vašich změn a můžete se snadno vrátit zpět na jakékoli místo v historii. Nakonec, až budete připraveni, můžete synchronizovat místní úložiště se vzdáleným.

Změny se synchronizují do vzdáleného úložiště pomocí a tam zatímco změny ve vzdáleném úložišti jsou synchronizovány s místním úložištěm pomocí táhnout. Protože máte lokálně plný klon úložiště, nejste omezeni pouze na práci proti hlavní větvi tohoto úložiště. Můžete vytvořit větve, které obsahují vaše změny, a poté je podle potřeby tlačit nebo táhnout.

Pokud potřebujete podrobnější úvod do výukového programu Git, podívejte se na Zdroje. Po zbytek tohoto článku se zaměřím na GitHub.

Sociální kódování s GitHub

Po vytvoření účtu GitHub můžete začít sledovat práci jiných vývojářů softwaru nebo sledovat projekty, které vás zajímají. Můžete najít lidi nebo projekty, které chcete sledovat, tím, že je vyhledáte přímo; nebo, pokud hledáte nápady, můžete použít funkci „Prozkoumat“ na GitHubu a vyhledat projekty podle vašeho zájmu. Prozkoumejte GitHub zobrazuje trendy úložišť i doporučená. Kromě toho můžete prozkoumat všechna úložiště kliknutím na tlačítko „Úložiště“ na panelu nástrojů. Pokud chcete vyhledávat projekty kódované v konkrétním programovacím jazyce, můžete na panelu nástrojů kliknout na „Jazyky“ a poté zvolit jazyk, který chcete prozkoumat. Obrázek 1 ukazuje nejsledovanější (tj. Trendy) úložiště Java v době psaní tohoto článku.

Storm byl v době, kdy jsem to kontroloval, nejsledovanějším Java úložištěm na GitHubu. Jakmile najdete projekt, který vás zajímá, klikněte na něj a uvidíte možnost „Sledovat“, jak je znázorněno na obrázku 2.

Pokud kliknete na „Sledovat“, budete přihlášeni k odběru a budete moci sledovat změny, které v něm byly provedeny, na domovské stránce GitHubu. Obrázek 3 ukazuje mou domovskou stránku GitHub, která obsahuje seznam aktualizací různých jarních projektů.

Sledování jednotlivých vývojářů funguje stejně jako sledování projektů. Například jsem se nedávno rozhodl následovat svého přítele Toma Akehursta, jak ukazuje obrázek 4.

Ze sociálního hlediska vám GitHub umožňuje snadno najít vývojáře a projekty, které by vás mohly zajímat, a dostávat o nich aktualizace. Samozřejmě platí i odvrácená strana: GitHub je vynikající místo, kde můžete předvést svou práci a získat zpětnou vazbu a uznání od svých kolegů.

Používání GitHubu pro aktualizace a údržbu projektu

Nezapomeňte, že hlavní hnací silou GitHubu je podpora vývoje open source softwarových projektů. Takže pokud jste vytvořili něco dobrého, proč nepřispět svým kódem do GitHubu a nezveřejnit ho volně pro celý svět?

Nové úložiště můžete vytvořit z webu GitHub nebo z klientské aplikace na ploše. V této části nejprve projdeme vytvořením úložiště z webu, poté vám ukážu, jak aktualizovat a potvrdit soubor pomocí příkazového řádku.

Nastavení úložiště GitHub

Za předpokladu, že máte vytvořený účet, přihlaste se a uvidíte něco podobného tomu, co je zobrazeno na obrázku 5. Klikněte na „Vytvořit úložiště“ a budete provedeni procesem. Nejprve kliknete na první položku v pravém horním panelu nástrojů „Vytvořit nové úložiště“.

Klikněte na tento odkaz a pojmenujte svůj repozitář názvem a popisem. Vytvořil jsem nové úložiště pro hostování mých obslužných programů GeekCap, což je sada pomocných tříd, které zahrnují třídicí algoritmy a seznam opětovného zařazení, třídu, která snadno extrahuje ikony z úložiště Java Look-and-Feel Graphics Repository, nástrojů ZIP a více. I když nejde o nejúžasnější projekt, zahrnul jsem ho, protože většina mých dalších projektů používá jeden nebo více těchto nástrojů, takže je dobré je mít uložené na přístupném místě. Pojmenoval jsem svůj projekt geek-util a dal mu popis: „Geekcap Utilities: užitečné třídy, které používají jiné projekty Geekcap.com.“

Jakmile je váš projekt nastaven, měla by se zobrazit obrazovka, jako je ta na obrázku 6.

Obrázek 6. Vytvořeno úložiště (kliknutím obrázek zvětšíte)

Snímek obrazovky na obrázku 6 ukazuje seznam toho, co můžete dělat s novým úložištěm, a také příklad vytvoření PŘEČTĚTE SI soubor a zatlačte jej do svého úložiště. Mám existující projekt Maven, který musím přidat poprvé, takže začnu přidáním mého pom.xml soubor a můj src adresář. Níže jsou uvedeny příkazy Git, které jsem zadal pro počáteční zasunutí projektu do úložiště:

Výpis 1. Příkazy Git pro vytvoření úložiště

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 master

Tady je důležité znát Git, pokud chcete používat GitHub. Naštěstí jsou hlavní příkazy Git relativně intuitivní:

  • git init vytvoří prázdné úložiště Git. Konkrétně se tím vytvoří .git adresář, který sakra příkaz rozpozná jako úložiště.
  • git přidat přidává soubory do úložiště; v tomto případě jsem přidal svůj pom.xml a můj src adresář.
  • git commit provede změny v úložišti. Jediné, co jsem udělal, bylo přidat pom.xml soubor a src adresář. Tento příkaz byste také použili po úpravě obsahu souboru nebo smazání souborů pomocí git rm příkaz.
  • git vzdálené přidání původu přidá zadanou adresu URL jako výchozí server pro úložiště Git. Jak jste viděli na obrázku 6, původní server je vytvořeno na GitHubu a adresa URL je uvedena v dokumentaci nastavení.
  • git push nahraje všechny potvrzené změny na zadaný server. V tomto případě jsem posunul počáteční potvrzení, které obsahuje pom.xml a src adresář na původní server, který jsem dříve nastavil.

Git můžete použít ze svého IDE nebo z příkazového řádku; Prostě jsem náhodou feťák z příkazového řádku. Provádění pomoc git zobrazuje nejběžnější příkazy, které jsou shrnuty v seznamu 2.