Jak sdílet kód 4D přes Github

Takže jste testovali projektové databáze… možná jste ji vytvořili, nebo jste možná převedli stávající binární aplikaci. Nyní je čas, abychom vám ukázali, jak používat Git (systém pro správu revizí) s Githubem jako hostingovou službu pro vaši aplikaci 4D.

Databáze projektů 4D

Než budeme pokračovat dále, abyste mohli sledovat tento příspěvek na blogu, budete potřebovat verzi 4D v17 R5 nebo novější. Předpokládáme také, že víte, jak vytvořit projektovou databázi nebo převést stávající aplikaci na projekt. Vše, co potřebujete vědět o obou těchto podmětech, je popsáno v dokumentaci a na blogu 4D.

Git vs. Github

Je důležité mít na paměti, že mezi systémy Git a Github je rozdíl:

Git

Zajímalo vás někdy, jak se realizují velké projekty s distribuovanými týmy? Například linuxový projekt, na kterém pracují statisíce lidí najednou? Stručná odpověď zní: používají Git. Což je v podstatě systém pro správu verzí(neboli VCS), který umožňuje spravovat a sledovat historii zdrojového kódu.

Github

Github je cloudová hostingová služba, kde můžete sdílet svůj kód s ostatními a spravovat své repozitáře Git.

Instalace systému Git

Pokud již máte systém Git na svém počítači, můžete přeskočit na další část. Vopačném případě si jej stáhněte odtud.

Nástroje Gui

Pokud vám nevyhovuje práce se systémem Git z rozhraní příkazového řádku, je k dispozici několik klientů s grafickým uživatelským rozhraním, které urychlí vaši práci (zejména pokud jste v této platformě nováčky). Jedním z těchto nástrojů je Github Desktop, který byl vyvinut společností Github pro platformy MacOS i Windows. Volba je na vás, můžete použít buď nástroj s grafickým uživatelským rozhraním, nebo rozhraní příkazového řádku. V tomto příspěvku na blogu budeme používat rozhraní příkazového řádku, abychom viděli, co se děje v zákulisí.

Nastavení služby Github

Dále budete muset nastavit Github. Nejprve potřebujete účet na Githubu. Podle tohoto odkazu si vytvoříte profil, vyberete plán a určíte uživatelské prostředí. Proces je velmi snadný a uživatelsky přívětivý.

Důležitá terminologie

Než si zašpiníme ruce, je tu několik opakujících se termínů, které budeme při práci se systémem Git používat:

• Úložiště (repo ): Úložiště Git je adresář, do kterého se ukládají všechny soubory, složky a obsah potřebný pro váš projekt.
• Vzdálený: Git je úložiště, které se nachází v systému Git: Kopie původní větve. Při klonování větve je nová větev vzdálená neboli klon.
• Místní: Místní úložiště: Místní úložiště ve vašem počítači, které obsahuje všechny soubory a jejich historii revizí.
• Větev: Úložiště, v němž je uložena informace o tom, že v úložišti se nachází tzv: Větev: Verze úložiště, která se odchyluje od hlavního pracovního projektu (hlavní větev). Větve mohou být novou verzí repozitáře, experimentálními změnami nebo osobními forky repozitáře pro uživatele, kteří mohou změny měnit a testovat.
• Odevzdání: Oddělení: Jednotlivá změna souboru nebo sady souborů.
• Push: Odeslání změny: Aktualizace revizí provedených v místní větvi do vzdálené větve. Doslova „tlačíte“ své změny do vzdálené větve.
• Pull: Aktualizuje revize provedené ve vzdálené větvi v místní větvi. Pokud někdo změnil kód v samostatné větvi projektu a chce, aby byl zkontrolován a mohl být přidán do hlavní větve, může vytvořit požadavek na stažení a požádat správce úložiště, aby zkontrolovali provedené revize, a pokud jsou přijatelné, sloučili změny do vyšší větve. K pull dochází při přidávání změn do hlavní větve.
• Staging: V případě, že se jedná o větev, která se nachází v záložce, je možné ji použít jako větev: Představte si ji jako mezipaměť souborů, které chcete odevzdat.

Pokud se chcete dozvědět více, podívejte se do slovníčku pojmů.

Nastavení projektu

Zde je vaše aplikace 4D, která čeká na hostování:

Otevřete terminál a přejděte do adresáře projektu 4D:

Dále budete muset inicializovat místní úložiště. Jednoduše zadejte příkaz git init:

Protože byl pří kaz git init spuštěn ve složce projektu 4D, systém Git již má k dispoziciseznam nesledovaných souborů. Příkaz git status zobrazí seznam všech upravených (nebo nových) souborů, které lze přidat do místního úložiště:

Výsledek ukazuje, že tři prvky ještě nebyly zařazeny do indexu, což znamená, že odevzdání změn s těmito prvky nelze prozatím provést. Příkaz git add . prohlédne celý pracovní adresář a vyhledá všechny nové, smazané nebo upravené soubory a přidá je do indexu.

Opětovné spuštění příkazu git status ukáže, že soubory jsou připraveny k odevzdání.

Nyní je čas odeslat naše soubory v oblasti staging do místního úložiště. To lze provést příkazem git commit -m „message“ . Zprávy o odevzdání by měly být jasné a jednoznačné pro účelyzálohování .

Poznámka: Někdy máme v adresáři projektu některé soubory nebo adresáře, které nechceme, aby byly sledovány. Proto je třeba vytvořit soubor .gitignore, ve kterém systému Git zadáte pokyny, které soubory, adresáře nebo vzory mají být v úložišti ignorovány. V našem případě se jedná o soubory jako žurnál, předvolby, .4dd a složku DerivedData. V některém z příštích příspěvků na blogu vám ukážeme, jak postupovat.

Dobré. Nyní, když byly soubory v pracovním adresáři úspěšně odevzdány do místního úložiště, je dalším krokem odeslání těchto změn do vzdáleného úložiště , kde budousdíleny se zbytkem týmu. Nyní přejdeme na náš účet GitHub a vytvoříme úložiště:

Klepněte na tlačítko Klonovat nebo stáhnout a zobrazí se odkaz. Jedná se o adresu URL úložiště Github, nezapomeňte ji zkopírovat.

Nyní se vrátíme do našeho terminálu a zadáme: git remote add origin ,za kterým následuje odkaz na dříve zkopírovaný repozitář Github. Klikněte na tlačítko Enter.

Je čas odeslat naši aplikaci do Githubu pomocí příkazu git push origin master. Pokud budete vyzváni k zadání uživatelského jména a/nebo hesla, zadejte přihlašovací údaje ke službě GitHub, které jste použili při vytváření účtu.

Na Githubu můžete rychle zkontrolovat, zda byly všechny soubory odeslány do vzdáleného úložiště.

Gratulujeme, váš kód je nyní v cloudu!

V tomto příspěvku na blogu jsme se seznámili s rozdílem mezi systémy Git a Github, s nejpoužívanější terminologií systému Git, vytvořili jsme první úložiště a přidali jsme naši aplikaci 4D na Github. V příštím blogovém příspěvku si projdeme architekturu systému Git a ukážeme si několik příkladů nejpoužívanějších akcí pro práci se systémem Git a vaší aplikací 4D.