Uso de un cliente Git externo

MQL5 Algo Forge es un sistema de almacenamiento de datos basado en Git. Una vez finalizada la configuración inicial y la instalación de Git en su computadora, podrá utilizar cualquier cliente Git externo.

Entre los clientes Git más populares se encuentran: TortoiseGit, GitHub Desktop, la integración con Git incorporada en Visual Studio Code, GitKraken, Sourcetree y otros. Estos programas facilitan la ejecución de comandos Git, la resolución de conflictos y el trabajo con scripts complejos.

Por defecto, el MetaEditor habilita la compatibilidad con Git solo para ciertas carpetas. Por lo tanto, es importante comprender dónde se encuentran estas carpetas y cómo están estructuradas. Desde el menú superior del MetaEditor, seleccione «Archivo > Abrir directorio de datos».

En el Explorador de archivos se abrirá la carpeta de datos de su instancia de terminal. Dentro de ella hay una carpeta MQL5.

Carpeta MQL5 #

Directorio MQL5 MQL5 es la carpeta de datos principal para los programas de trading algorítmico. Por defecto, la mayoría de los archivos y carpetas dentro de un directorio MQL5 no son monitoreados por Git hasta que usted los agregue explícitamente al control de versiones. En el Navegador del MetaEditor, ejecute el comando agregar en un archivo o carpeta dentro de un directorio MQL5,para agregarlos al commit y enviar los cambios al repositorio remoto mql5:.

El directorio MQL5 es un repositorio privado local vinculado a un repositorio remoto mql5: su cuenta en el sitio web de MQL5 Algo Forge.

Carpeta Shared Projects #

El directorio Shared Projects se encuentra en la carpeta raíz MQL5Sin embargo, su contenido es independiente del repositorio que lo contiene. En la carpeta Shared Projects se almacenan repositorios separados, cada uno con su propia carpeta .git, ramas y otros datos de Git.

Cuando usted crea una bifurcación de un proyecto público en el sitio web de MQL5 Algo Forge, su copia se convierte en un repositorio independiente en su cuenta.

Después de actualizar el contenido de la carpeta Shared Projects en MetaEditor, el nuevo repositorio aparecerá en la lista de proyectos disponibles. Al realizar la clonación en el repositorio, los archivos del proyecto se descargarán y guardarán en la carpeta local de Shared Projects.

Configuración local de Git #

Al crear commits, el MetaEditor utiliza su inicio de sesión MQL5 como valor user.name, y la dirección your-login-mql5@forge.mql5.io como user.email. Al trabajar a través de un cliente Git externo, se utilizan de forma predeterminada las configuraciones globales de Git.

Por lo tanto, antes de crear el primer commit en un cliente Git externo, deberá establecer los mismos valores para cada repositorio local user.name y user.email, que utiliza MetaEditor. Esto evitará indicar incorrectamente el autor de los commits y los problemas asociados a ellos.  

Abra el terminal y navegue hasta la carpeta del repositorio:

cd /path/to/your/repository

Establezca el nombre de usuario:

git config user.name "your-mql5-login"

Introduzca su dirección de correo electrónico:

git config user.email "your-mql5-login@forge.mql5.io"

En lugar de la línea de comandos, puede usar las herramientas de configuración de Git integradas en su cliente. Para obtener información detallada sobre cómo configurar una configuración Git local, consulte la documentación del cliente que esté utilizando, por ejemplo TortoiseGit, GitHub Desktop o GitKraken.

Detalles de inicio de sesión de MQL5 Algo Forge #

Al trabajar con un servidor MQL5 remoto, Algo Forge MetaEditor utiliza automáticamente la sesión MQL5 activa. El cliente Git externo solicita información de inicio de sesión cada vez que necesita contactar con un repositorio remoto, por ejemplo, al descargar o enviar cambios.

Cuando el cliente Git solicite información de inicio de sesión, introduzca su nombre de usuario y contraseña de MQL5. Los pasos siguientes dependerán del cliente Git que esté utilizando y de su versión.

Muchos clientes de Git, incluidos TortoiseGit, VS Code y GitHub Desktop, intentan almacenar la información de inicio de sesión utilizando el Git Credential Manager (GCM) integrado. Si el guardado se realiza correctamente, las credenciales se transferirán al almacenamiento del sistema del Administrador de credenciales de Windows y se guardarán allí.

Algunos clientes, entre ellos TortoiseGit y GitKraken, pueden almacenar los datos de inicio de sesión en su propio entorno o a través del administrador de cuentas integrado. Encontrará más detalles en la documentación del cliente Git que esté utilizando.

El guardado de los datos de la cuenta MQL5 permite que el cliente Git interactúe con el servidor remoto sin tener que introducir el nombre de usuario y la contraseña cada vez.

Tras ajustar correctamente Git y el guardado de datos de inicio de sesión, podrá utilizar un cliente Git externo para realizar todas las operaciones compatibles.