Cómo compartir su código 4D a través de Github

Traducido automáticamente de Deepl

Así que ha estado probando bases de datos de proyectos… tal vez ha creado una o tal vez ha convertido una aplicación binaria existente. Ahora, es el momento de mostrarle cómo utilizar Git (el sistema de control de revisiones) con Github como servicio de alojamiento para su aplicación 4D.

Bases de datos del proyecto 4D

Antes de continuar, para poder seguir esta entrada del blog, necesitará tener 4D v17 R5 o más reciente. También asumimos que sabe cómo crear una base de datos de proyectos o convertir una aplicación existente en un proyecto. Todo lo que necesita saber sobre estos dos subjetos está cubierto en la documentación y en el blog de 4D.

Git Vs. Github

Es importante tener en cuenta que hay una diferencia entre Git y Github:

Git

¿Te has preguntado alguna vez cómo se llevan a cabo grandes proyectos con equipos distribuidos? ¿Por ejemplo, un proyecto de Linux con cientos de miles de personas trabajando en él al mismo tiempo? Pues la respuesta corta es que utilizan Git. Que es básicamente un sistema de control de versiones(también conocido como VCS) que permite gestionar y hacer un seguimiento del historial del código fuente.

Github

Github es un servicio de alojamiento basado en la nube, donde puedes compartir tu código con otros y gestionar tus repositorios Git.

Instalación de Git

Si ya tienes Git en tu máquina, puedes pasar a la siguiente sección. Sino, descárgalo desde aquí.

Herramientas Gui

Si no te sientes cómodo trabajando con Git desde la interfaz de línea de comandos, hay varios clientes GUI disponibles que acelerarán tu flujo de trabajo (especialmente si eres nuevo en la plataforma). Una de estas herramientas es Github Desktop, que ha sido desarrollada por Github para las plataformas macOS y Windows. La elección es tuya, puedes utilizar una herramienta con interfaz gráfica de usuario o la interfaz de línea de comandos. En esta entrada del blog, vamos a utilizar la interfaz de línea de comandos para ver lo que está pasando detrás de las escenas.

Configuración de Github

A continuación, tendrás que configurar Github. En primer lugar, necesitas una cuenta en Github. Sigue este enlace para crear un perfil, elegir un plan y especificar una experiencia de usuario. El proceso es muy fácil y sencillo.

blank blank

Terminología importante

Antes de ensuciarnos las manos, hay algunos términos recurrentes que utilizaremos al trabajar con Git:

  • Repositorio (repo): un repositorio Git es un directorio que almacena todos los archivos, carpetas y contenidos necesarios para tu proyecto.
  • Remoto: Una copia de la rama original. Cuando clonas una rama, la nueva rama es una remota, o clon.
  • Local: El repositorio local en tu ordenador y tiene todos los archivos y su historial de commits
  • Rama: Una versión del repositorio que diverge del proyecto principal de trabajo (rama maestra). Las ramas pueden ser una nueva versión de un repositorio, cambios experimentales o bifurcaciones personales de un repositorio para que los usuarios puedan alterar y probar los cambios.
  • Confirmación (Commit): Un cambio individual en un archivo o conjunto de archivos.
  • Push: Actualiza los commits realizados en la rama local a una rama remota. Literalmente estás «empujando» tus cambios a la rama remota.
  • Pull: Actualiza los commits realizados en una rama remota en la rama local. Si alguien ha cambiado código en una rama separada de un proyecto y quiere que se revise para añadirlo a la rama maestra, puede crear una solicitud de pull para pedir a los mantenedores del repositorio que revisen los commits realizados y, si son aceptables, fusionen los cambios en la rama local. Un pull se produce al añadir los cambios a la rama maestra.
  • Puesta en escena: Piensa en ello como un caché de archivos que quieres confirmar.

Si estás interesado en saber más, consulta el glosario.

Configuración del proyecto

Aquí está su aplicación 4D esperando a ser alojada:

blank

Abra el terminal y navegue hasta el directorio de su proyecto 4D:

blank

A continuación, tendrá que inicializar un repositorio local. Simplemente escriba el comando git in it:

blank

Dado que git in itfue ejecutado en una carpeta del proyecto 4D, Git ya tiene una lista de archivossin seguimiento disponibles. El comando git status listará todos los archivos modificados (o nuevos) que pueden ser añadidos al repositorio local:

blank

El resultado muestra que tres elementos aún no han sido incluidos en el índice, lo que significa que la confirmación de cambios con estos elementos no puede hacerse por ahora. El comando git add . inspeccionará todo el directorio de trabajo en busca de archivos nuevos, borrados o modificados y los añadirá al índice.

blank

Ejecutar git status una vez más muestra que los archivos están listos para ser confirmados.

blank

Ahora es el momento de enviar nuestros archivos en el área de preparación al repositorio local. Esto puede hacerse con el comando git commit -m «message» . Losmensajes de commit deben ser claros y explícitos para poder hacer copias de seguridad .

Nota: A veces, tenemos algunos archivos o directorios en el directorio de nuestro proyecto que no queremos que sean rastreados. Por eso hay que crear un archivo .gitignore en el que se indique a Git qué archivos, directorios o patrones deben ser ignorados en el repositorio. En nuestro caso, archivos como el diario, las preferencias, .4dd, y la carpeta DerivedData. En una próxima entrada del blog, te mostraremos cómo proceder.

blank

Bien. Ahora que los archivos del directorio de trabajo han sido confirmados con éxito en el repositorio local , el siguiente paso es empujar estos cambios al repositorio remoto para compartirlos con el resto del equipo. Ahora vamos a nuestra cuenta de GitHub y creamos un repositorio:

blank

Haz clic en el botón Clonar o descargar, y verás un enlace. Esta es la URL del repositorio de Github, asegúrate de copiarla.

blank

Ahora volvemos a nuestro terminal y escribimos: git remote add origin seguido del enlace al repositorio de Githubque has copiado previamente. Haz clic en Enter.

blank

Es el momento de enviar nuestra aplicación a Github usando git push origin master. Si te pide el nombre de usuario y/o la contraseña, introduce las credenciales de GitHub que utilizaste para crear tu cuenta.

blank

Puedes comprobar rápidamente en Github que todos tus archivos han sido enviados al repositorio remoto.

blank

Enhorabuena, ¡tu código ya está en la nube!

En esta entrada del blog, hemos aprendido la diferencia entre Git y Github, la terminología más utilizada de Git, hemos creado nuestro primer repositorio, y hemos añadido nuestra aplicación 4D en Github. En una próxima entrada del blog, repasaremos la arquitectura de Git y veremos algunos ejemplos de las acciones más utilizadas para trabajar con Git y su aplicación 4D.

Avatar
• Gerente de Mercadeo de Producto - Intissar ingresó a 4D en 2017 como Gerente de Mercadeo de Producto. Trabaja estrechamente con los equipos de producto, mercadeo, ingeniería y soporte técnico para destacar el "por qué", el "cómo" y el "qué" de las funcionalidades nuevas y actualizadas a diferentes audiencias. Esta proximidad le permite elaborar marcos de mensajería y escribir contenidos en profundidad y muestras de código para el blog y el sitio web de 4D. Después de graduarse como ingeniera en Ciencias de la Computación en la universidad de VINCI, Intissar trabajó en varias startups como ingeniera de software. Su experiencia práctica incluye la especificación, el diseño y el desarrollo de software, la formación y el apoyo a los usuarios y la gestión de equipos.