Mnoho vývojářů 4D využívá možnosti komponent třetích stran, které lze nalézt na GitHubu, zejména těch, které jsou uvedeny v tématu 4d-component. 4D 20 R6 přináší fantastickou novinku: přímou integraci těchto komponent do Správce komponent.

Tento příspěvek na blogu se věnuje podrobnostem, které vám usnadní a zefektivní proces vývoje.

Mnoho komponent 4D je k dispozici na GitHubu, ať už je vyvinuly třetí strany, nebo jste si je vytvořili sami.
Tato platforma nabízí jednoduchý způsob distribuce komponent: vydání.
Než budete pokračovat, doporučujeme vám přečíst si příspěvek o Správci komponent, abyste se lépe seznámili s níže popsanými koncepty.

Automatické stahování vydání úložiště

Správce komponent integruje nejen místní komponenty, ale také automaticky stahuje komponenty uložené ve vydáních úložiště.

V dialogovém okně Závislosti projektu jsou komponenty GitHub snadno odlišitelné od lokálních pomocí malé ikony vedle označení umístění komponenty.

Funguje to následovně:

1. Zkomprimujte komponentu do formátu ZIP.
2. Archiv pojmenujte stejným názvem jako úložiště.
3. Zařaďte jej do vydání úložiště.

Tento proces lze automatizovat například pomocí kódu 4D nebo akcí GitHub. Po dokončení deklarujte komponentu v souboru dependencies.json vašeho projektu:

{
    "dependencies": {
        "myComponent": {
            "github": "anyAccount/myComponent"
        }
    }
}

Restartujte projekt a komponenta se automaticky načte. Je to tak jednoduché!

Značky a sémantické verze

Při vytváření verze v úložišti zadáte značku a verzi.

Značky jsou texty, které jednoznačně odkazují na vydání. V souborech dependencies.json můžete uvést značku vydání, kterou chcete v projektu použít. Například :

{
    "dependencies": {
        "myComponent": {
            "github": "anyAccount/myComponent",
            "tag": "textTag"
        }
    }
}

Stejným způsobem je verze identifikována verzí. Systém verzování je založen na konceptu sémantického verzování, který se používá nejčastěji. Každé číslo verze je určeno takto: majorNumber.minorNumber.patchNumber. Stejným způsobem jako u značek můžete uvést verzi komponenty, kterou chcete v projektu použít, jako v tomto příkladu:

{
    "dependencies": {
        "myComponent": {
            "github": "anyAccount/myComponent",
            "version": "2.1.3"
        }
    }
}

Verze slouží k určení, které verze lze použít. Zde je několik příkladů:

• „latest“: verze s odznakem „latest“ ve vydáních úložiště.
• „*“: nejnovější vydaná verze.
• „1.*“: všechny verze hlavní verze 1.
• „1.2.*“: všechny opravy menší verze 1.2.
• „^1.2.3“ nebo „>=1.2.3“: nejnovější verze 1, počínaje verzí 1.2.3.
• „~1.2.3“ nebo „>1.2.3“: nejnovější hlavní verze 1, počínaje verzí hned po 1.2.3.
• „<=1.2.3“: nejnovější verze až po verzi 1.2.3.
• „1.0.0 – 1.2.3“ nebo „>=1.0.0 <=1.2.3“: verze mezi 1.0.0 a 1.2.3.

• „<1.2.3 || >=2“: verze, která není mezi 1.2.3 a 2.0.0.

Pokud nezadáte značku ani verzi, 4D automaticky načte „nejnovější“ verzi.

Soukromá úložiště

Pokud chcete integrovat komponentu umístěnou v soukromém úložišti, musíte 4D sdělit, aby pro přístup k ní použil spojovací značku. Za tímto účelem vytvořte na svém účtu GitHub „klasický“ token s přístupovými právy k „repo“. Poté vložte vygenerovaný klíč do souboru environment4d.json.
Zde je příklad souboru environment4d.json:

{
    "github": {
        "token": "ghp_a0B1cDEf2gHi3JKl4mNo5P6qRST7UvW8x9yZ"
    }
}

Tato nová funkce zjednodušuje práci s komponentami 4D. Jsme přesvědčeni, že pro vás bude tato integrace cenná. Podporuje efektivnější proces vývoje a využívá obrovskou sílu spolupráce vývojářů 4D. Neváhejte sdílet své komponenty 4D v repozitářích GitHub a označovat je tématem 4d-component. Připojíte se ke skvělé komunitě vývojářů 4D komponent a budete uvedeni v seznamu 4D Components.
Neváhejte se podělit o svou zpětnou vazbu!