Muchos desarrolladores 4D aprovechan el poder de los componentes de terceros que se encuentran en GitHub, particularmente aquellos listados en el tópico 4d-component. 4D 20 R6 introduce una nueva característica fantástica: la integración directa de estos componentes en el Administrador de componentes.

Esta entrada de blog se sumerge en los detalles, haciendo su proceso de desarrollo más fácil y eficiente.

Muchos componentes 4D están disponibles en GitHub, ya sean desarrollados por terceros o creados por usted mismo.
Esta plataforma ofrece una forma sencilla de distribuir componentes: releases.
Antes de continuar, le sugerimos que lea el post sobre el Gestor de Componentes para sentirse más cómodo con los conceptos descritos a continuación.

Descarga automática de releases de repositorios

El Gestor de Componentes no sólo integra componentes locales, sino que también recupera automáticamente componentes almacenados en releases de repositorios.

En el cuadro de diálogo Dependencias del proyecto, los componentes de GitHub se distinguen fácilmente de los locales por un pequeño icono junto a la indicación de la ubicación del componente.

Así es como funciona

1. Comprime tu componente en formato ZIP.
2. Nombra el archivo comprimido con el mismo nombre que el repositorio.
3. Intégralo en una versión del repositorio.

Por ejemplo, este proceso puede automatizarse utilizando código 4D o GitHub Actions. Una vez hecho esto, declare el componente en el archivo dependencies.json de su proyecto:

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

Reinicia el proyecto y el componente se cargará automáticamente. Así de sencillo.

Etiquetas y versiones semánticas

Cuando crea una versión en el repositorio, especifica una etiqueta y una versión.

Las etiquetas son textos que hacen referencia única a una versión. En los archivos dependencies.json, puede indicar la etiqueta de versión que desea utilizar en su proyecto. Por ejemplo :

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

Del mismo modo, una versión se identifica mediante una versión. El sistema de versiones se basa en el concepto Semantic Versioning, que es el más utilizado. Cada número de versión se determina de la siguiente manera: majorNumber.minorNumber.patchNumber. Del mismo modo que para las etiquetas, puede indicar la versión del componente que desea utilizar en su proyecto, como en este ejemplo:

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

La versión se utiliza para definir qué versiones se pueden utilizar. He aquí algunos ejemplos:

• «latest»: la versión con el distintivo «latest» en las versiones del repositorio.
• «*»: la última versión publicada.
• «1.*»: todas las versiones de la versión mayor 1.
• «1.2.*»: todos los parches de la versión menor 1.2.
• «^1.2.3» o «>=1.2.3»: la última versión 1, a partir de la versión 1.2.3.
• «~1.2.3» o «>1.2.3»: la última versión mayor 1, empezando por la versión inmediatamente posterior a la 1.2.3.
• «<=1.2.3»: la última versión hasta la 1.2.3.
• «1.0.0 – 1.2.3» o «>=1.0.0 <=1.2.3»: versión entre 1.0.0 y 1.2.3.

• «<1.2.3 || >=2»: versión que no está entre 1.2.3 y 2.0.0.

Si no especifica una etiqueta o una versión, 4D recupera automáticamente la versión «más reciente».

Repositorios privados

Si desea integrar un componente situado en un repositorio privado, debe indicar a 4D que utilice un token de conexión para acceder a él. Para ello, cree un token «clásico» con derechos de acceso a «repo» en su cuenta GitHub. A continuación, inserte la clave generada en su archivo environment4d.json.
He aquí un ejemplo de archivo environment4d.json:

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

Esta nueva función simplifica el trabajo con componentes 4D. Estamos seguros de que esta integración le resultará valiosa. Promueve un proceso de desarrollo más eficiente y aprovecha un enorme poder de colaboración para los desarrolladores 4D. Siéntase libre de compartir sus componentes 4D en los repositorios de GitHub y etiquetarlos con el tema 4d-component. Se unirá a la gran comunidad de desarrolladores de componentes 4D y será referenciado en la lista de Componentes 4D.
¡No dude en compartir sus comentarios!