Cómo empezar a trabajar con MQL5 Algo Forge

El nuevo portal MQL5 Algo Forge no es simplemente una lista con sus proyectos, sino toda una red social para desarrolladores. En él podrá seguir fácilmente los cambios, mantener una historia, encontrar personas afines y nuevas ideas. Aquí podrá suscribirse a autores que le resulten interesantes, crear equipos y llevar a cabo proyectos conjuntos sobre trading algorítmico.  

MQL5 Algo Forge se basa en Git, un moderno sistema de control de versiones, y esto significa que todos los desarrolladores dispondrán ahora de una herramienta completa al alcance de la mano para monitorear la historia del proyecto, crear ramas, experimentar y trabajar en equipo. Pero, ¿cómo funciona todo esto?  Este artículo le mostrará cómo empezar a trabajar con MQL5 Algo Forge. 

Qué es el repositorio en MQL5 Algo Forge

La creación de cualquier programa informático suele ser un proceso largo que requiere tiempo y depuración. El código creado no solo debe escribirse y mantenerse, sino también almacenarse de forma segura. Los algoritmos modernos de negociación en los mercados financieros ya no se reducen a simples señales basadas en dos medias móviles, sino que se basan en bibliotecas matemáticas, redes neuronales y aprendizaje automático. Por ello, resulta necesario poder guardar rápida y fácilmente los cambios realizados y obtener código actualizado desde cualquier lugar. 

MQL5 Storage es un repositorio versionado integrado en el MetaEditor. Antes utilizaba para su trabajo el sistema de control de versiones Subversion 1.7. Este sistema estaba centralizado: toda la historia se almacenaba en el servidor de MetaQuotes. Sin conexión a Internet, no era posible confirmar cambios, revertir una versión o ver la historia. Hoy en día, ha sido completamente reemplazado por una herramienta más potente y flexible: MQL5 Algo Forge.

Ahora MQL5 Algo Forge funciona de forma distinta:

	MQL5 Algo Forge (en Git)	MQL5 Storage (versión anterior)
Almacenamiento de la historia	De manera local y en la nube	Solo en la nube MetaQuotes
Trabajo sin Internet	Completo (commits, rollbacks, diff)	Limitado o imposible
Rapidez de las operaciones	Instantáneas, localizadas	Depende de la red y del servidor

Algo Forge ofrece libertad. Podrá trabajar tranquilamente en el tren, crear ramas para experimentos, guardar los resultados intermedios y luego fusionarlos en la rama principal.

El repositorio de proyectos en Algo Forge no es solo una carpeta en la nube: es un repositorio estructurado que vive en el disco duro del usuario y también se sincroniza con un servidor en la nube en MQL5 Algo Forge.  Consta de varios niveles:

Directorio de trabajo en el MetaEditor

	Estos serán sus archivos .MQ5, .MQH , .SET y otros que edite en el MetaEditor. Aquí es donde se escribe el código del asesor experto, se conectan los indicadores y se prueban las estrategias. A menos que usted lo especifique explícitamente, el sistema Algo Forge no tendrá en cuenta los cambios.

Área de preparación (índice)

	Antes de enviar cambios a la historia del proyecto, habrá que prepararlos. Con el comando "Git Add" se seleccionan los archivos a incluir en la siguiente confirmación. Esto permite añadir cambios por partes, por ejemplo, primero podrá guardar los cambios en la lógica del algoritmo comercial, y luego los cambios en la interfaz o la configuración.

Repositorio local

	Después de confirmar (Git Commit), Forge guardará una instantánea del estado actual de los archivos en el repositorio local, directamente en su computadora. Así, podrá ver en cualquier momento lo que había antes, volver a la versión anterior o entender qué cambios han afectado al asesor experto.

Repositorio remoto en Algo Forge

	Cuando todo esté listo, podrá enviar commits al servidor MQL5 Algo Forge ( Git Push ). Esto creará una copia de seguridad fiable y pondrá los cambios a disposición de los compañeros de equipo. Incluso si trabaja solo, le resultará útil: su código siempre se podrá recuperar desde la nube, y no perderá su historia de desarrollo.

Cómo conectarse a MQL5 Algo Forge

Para trabajar con el sitio web MQL5 Algo Forge, bastará con tener una cuenta MQL5, solo tendrá que introducir sus datos en https://forge.mql5.io/ e iniciar sesión.  

Una vez autorizado podrá explorar todas sus funcionalidades; encontrará los proyectos públicos en Explore.  Ahora le resultará mucho más fácil buscar proyectos, aprender su código, compartir el suyo y unirse a equipos.

Pero el trabajo principal con los proyectos se realizará, obviamente, en el entorno de desarrollo del MetaEditor.  Para conectarse a MQL5 Algo Forge en el editor, solo tendrá que iniciar sesión con los datos de su cuenta MQL5 en el apartado Community

Qué es Git y cómo funciona en MQL5 Algo Forge

Git es un sistema que recuerda cómo eran sus archivos en diferentes momentos. El sistema le ayudará a no perder cambios importantes, retroceder fácilmente, trabajar en ramas separadas y combinar el trabajo de varios desarrolladores en un mismo proyecto.

Además, no tendrá que tratar con Git directamente: en el MetaEditor, todo se realiza a través de un cómodo menú. No obstante, "bajo el capó" se utilizan algunos comandos básicos. Vamos a desglosar lo que hacen y qué sucede cuando clicamos en los elementos correspondientes en el MetaEditor.

Primero crearemos un nuevo proyecto "Base_EA" en la carpeta de proyectos públicos.

Luego haremos clic con el botón derecho en el archivo del proyecto y veremos los comandos Git.

1. Git Add File/Folder — Preparar los cambios para el guardado

Cuando editamos archivos, Git aún no los tiene en cuenta. Para decirle al sistema: "Estos son los archivos que quiero guardar en la historia", debemos añadirlos al índice. Esto se hace a través de "Git Add File/Folder" o simplemente seleccionando un archivo para el commit.

Git captura el estado actual del archivo y lo prepara para guardarlo, como si hubiéramos apilado los documentos que necesitamos en una carpeta "Para firmar".

2. Git Commit — Guardar el estado del proyecto

Cuando pulsamos "Git Commit" en el MetaEditor, Git toma una instantánea del estado del proyecto en ese momento. Esta instantánea pasará a la historia de versiones.

Qué es lo que sucede:

• Git compara los archivos nuevos con los anteriores. 
• Guarda solo las diferencias (esto ahorra espacio).
•  Escribe los cambios en una carpeta .git especial oculta 
• Asigna un identificador numérico único (SHA-1) a la confirmación para que pueda ser encontrada. 

Commit es como un punto de control: "Así era el proyecto en ese momento". En el futuro, siempre podrá tomar su proyecto en este punto y seguir trabajando en él, si es necesario.

3. Git Push — Envío a la nube de MQL5 Algo Forge

Al pulsar "Git Push", Git transferirá los commits acumulados a un repositorio remoto en el servidor MQL5 Algo Forge. 

Es como subir a la nube un archivo con una nueva versión de un proyecto, solo que con una historia precisa de todos los cambios.

Para mayor comodidad de los usuarios, el MetaEditor siempre ejecuta automáticamente el comando "Git Push" cuando se invoca el comando "Git Commit". Esto garantizará que el desarrollador siempre tenga la versión actual del proyecto en la nube, reduciendo además los posibles conflictos.  Pero si por alguna razón no puede enviar los cambios al servidor, el comando independiente "Git Push" le resultará muy útil.

4. Git Pull — Obtener una nueva versión desde la nube

Si hay más de una persona trabajando en un proyecto, es posible que alguien haga cambios y los envíe antes que usted. O quizá usted haya programado los derechos desde una computadora y ahora quiera seguir trabajando con ellos desde otra (o incluso en la misma computadora pero en un terminal diferente, suele pasar). Para obtener estas actualizaciones, se utilizará el comando "Git Pull", que significa "Actualizar el proyecto desde Forge".

Git descargará los nuevos commits y los fusionará con su versión local.

5. Git Branch — Crear ramas para experimentos

A veces resulta necesario experimentar con el código sin influir en la versión principal. Para ello se crean ramas. Por ejemplo, si usted desea crear una versión del asesor experto con señales de otro indicador o con un filtro adicional, etc. Podrá crear una rama con un nombre claro y seguir el desarrollo en ella. Dicho esto, siempre se podrá cambiar fácilmente de una rama a otra.

Una rama es una línea paralela de desarrollo. Podrá hacerle los cambios que quiera y luego descartarla o fusionarla con la base.

6. Git Difference — ver exactamente lo que ha cambiado

Este comando mostrará línea por línea lo que se ha añadido, eliminado o cambiado en el archivo antes del commit. Se mostrará como un panel de comparación de versiones (al realizar el commit o ver la historia).

7. Git Log — ver la historia de cambios del proyecto

El comando log mostrará una lista de todos los commits pasados con fecha, autor y mensaje. Dicho comando abrirá el registro de cambios incorporado: podrá abrirlo y ver quién ha realizado los cambios, cuándo lo ha hecho y qué ha modificado.

8.  Git Revert — cancelar una confirmación específica

El comando "Git Revert" creará un nuevo commit que cancelará el efecto del anterior sin borrarlo de la historia. Se trata de una forma segura de "deshacer" los cambios sin romper la estructura del proyecto. Pero solo si estamos deshaciendo el último commit.

Esto resultará especialmente útil si usted nota que algún commit ha dañado el funcionamiento del asesor experto: podrá deshacer rápidamente su acción sin afectar a otros commits. Pero si después del commit que quiere deshacer hay otros commits con cambios en las mismas secciones de código, entonces "Git Revert" provocará un conflicto que habrá que resolver manualmente.

Trabajo seguro con proyectos

Uno de los problemas fundamentales del sistema de almacenamiento versionado son los conflictos entre la versión local y la almacenada en la nube. Aquí le servirá de ayuda una simple regla de "higiene": inmediatamente después de abrir un proyecto para seguir trabajando en él, haga una solicitud Pull para asegurarse de obtener una versión actualizada desde la nube de Algo Forge.

La regla inversa también es válida: después de completar la edición de un proyecto, ejecute siempre una solicitud Commit+Push para enviar los cambios a la nube. Esto le ahorrará la molestia de resolver conflictos, permitiéndole continuar su trabajo en cualquier momento y desde cualquier lugar.

MQL5 Algo Forge es todo lo que necesita para trabajar de forma fiable con proyectos en el MetaEditor

No tendrá que escribir los comandos manualmente. Todo Git está integrado en la interfaz del MetaEditor:

• Añadir, confirmar, cambiar de rama: podrá hacer todo a través del menú contextual del proyecto.
• Push y Pull: este par de botones sirve para sincronizar con la nube.
• Branch y Revert: este par de comandos sirve para controlar el proceso de desarrollo.
• Historia de cambios: está disponible como registro visual.

Estos 8 comandos son todo lo que necesitará para utilizar con confianza MQL5 Algo Forge. Le permitirán llevar a cabo el desarrollo de forma tranquila, estructurada y con total protección frente a las pérdidas.

Simplemente, empiece a usarlos

MQL5 Algo Forge no es solo un repositorio. Se trata de un completo sistema de gestión de proyectos para tráders algorítmicos. El sistema le permite hacer un seguimiento preciso de los cambios, experimentar sin riesgos, trabajar en equipo y confiar en la estabilidad de su código.

Si usted solía evitar Git debido a su aparente complejidad, las cosas le serán mucho más fáciles con Forge. El MetaEditor ya integra los comandos básicos y todo lo que deberá hacer es escribir su código, guardar los pasos y estar listo para cualquier retroceso.

¡Bienvenido a MQL5 Algo Forge!

Enlaces útiles:

• Guía de ayuda del MetaEditor
  
• Documentación de Git
• "Chuleta" de Git (oficial)
• Formateo .gitignore