Ayuda de MetaEditor → Proyectos y MQL5 Storage → Crear un proyecto y trabajar con el mismo

Crear y trabajar con un proyecto

El MetaEditor ofrece diversas opciones para trabajar con proyectos. Puede combinar archivos en una única estructura, administrar la configuración del proyecto y colaborar en él usando MQL5 Algo Forge y sistemas de control de versiones.

¿Qué es un proyecto?

Un proyecto es un archivo MQPROJ que almacena la configuración del programa MQL5, los parámetros de compilación e información sobre todos los archivos utilizados.

Al hacer doble clic en un archivo MQPROJ, se abre la pestaña «Proyecto», un espacio de trabajo independiente para trabajar cómodamente con proyectos en la ventana del Navegador. En esta pestaña, todos los archivos y carpetas del proyecto están categorizados.

Estructura y configuración del proyecto    

Creación de un proyecto #

En el menú superior, seleccione «Archivo > Nuevo proyecto» o pulse Ctrl+Mayús+N. Seleccione el tipo de programa y continúe trabajando en el wizard MQL5.

Creación de un nuevo proyecto

Especifique el nombre del proyecto y otros parámetros, agregue parámetros de entrada y seleccione los manejadores de eventos.

El wizard también permite crear proyectos vacíos para dar cabida a estructuras de archivos que no se ajustan a las plantillas estándar. Un proyecto vacío contiene únicamente un archivo MQPROJ y requiere que usted mismo cree los archivos de código fuente.

Creación de un proyecto basado en un archivo MQ5 #

Haga clic con el botón derecho en el archivo y seleccione «Nuevo proyecto desde el código fuente».

Creación de un nuevo proyecto a partir de un archivo fuente.

En el directorio aparecerá un nuevo archivo de proyecto MQPROJ con el mismo nombre. El proyecto incluirá automáticamente las propiedades básicas del programa, especificadas como #property en el archivo fuente: nombre, derechos de autor, versión, enlace del desarrollador y descripción. Todos los archivos incluidos en el código fuente mediante la directiva #include se añadirán a la sección "Dependencias" del proyecto.

Propiedades del proyecto #

La configuración del proyecto se puede modificar en un cuadro de diálogo independiente sin necesidad de editar el código fuente del archivo MQ5. Para ello, haga doble clic en el archivo MQPROJ en la pestaña «Proyecto».

Estructura y configuración del proyecto

Las siguientes configuraciones están disponibles para el proyecto:

  • Plataforma: la versión de la plataforma para la que se está desarrollando el producto: MetaTrader 4 o MetaTrader 5.
  • Tipo de programa: asesor (robot de trading), indicador, script o biblioteca.
  • Derechos de autor: información sobre derechos de autor, similar a la propiedad "#property copyright..." en el código fuente.
  • Enlace: un enlace al desarrollador, similar a la propiedad "#property link ..." en el código fuente.
  • Versión: la versión del programa, similar a la propiedad "#property version..." en el código fuente.
  • Icono: el icono del programa, similar a la propiedad "#property icon ..." en el código fuente.
  • Descripción: una descripción del programa, similar a la propiedad "#property description..." en el código fuente.
  • CPU: optimización de la compilación para conjuntos específicos de instrucciones del procesador: X64 Regular, AVX, AVX2 + FMA3, AVX512 + FMA3.
  • Máxima optimización: cuando esta opción está activada, las aplicaciones se ejecutan más rápido.
  • Comprobación de divisores de punto flotante: las aplicaciones con esta comprobación desactivada se ejecutan un poco más rápido porque no se comprueban los errores de división por cero durante la ejecución del código.
  • Usar caché de optimización: al realizar la optimización, el probador de estrategias guarda en la caché todos los resultados de las pasadas completadas. Los resultados se almacenan para cada conjunto de parámetros de entrada. Al optimizar nuevamente con los mismos parámetros, esto le permitirá obtener resultados ya elaborados sin perder tiempo en cálculos repetidos.
    Pero para algunas tareas, por ejemplo, en cálculos matemáticos, puede ser necesario realizar los cálculos independientemente de la disponibilidad de resultados preelaborados. En este caso, desactive la opción «Usar caché de optimización» en el proyecto. Al mismo tiempo, los resultados de las pruebas se guardarán en la caché para que pueda ver todos los datos de las pasadas completadas en el informe del probador de estrategias.
  • Calcular el indicador en cada tick en el probador: esta opción solo está disponible para proyectos de indicadores. Esto fuerza el cálculo en cada ciclo cuando se trabaja en el probador de estrategias. Esta configuración solo afecta al funcionamiento del probador de estrategias. Los indicadores se calculan directamente en la plataforma al recibir cada nuevo tick.
    Al probar asesores expertos que utilizan indicadores, el probador de estrategias calcula los valores de los indicadores solo cuando accede a sus datos, es decir, cuando solicita los valores de los búferes de indicador. Esto proporciona una aceleración significativa durante las pruebas y la optimización si el experto no necesita obtener los valores del indicador en cada tick. Habilite esta opción si desea que el indicador se calcule en cada tick.
    En el probador de estrategias, los indicadores también se calculan de forma forzada en cada tick en los siguientes casos:
  • al realizar pruebas en modo visual
  • si en el indicador hay funciones EventChartCustom, OnChartEvent, OnTimer
  • si el indicador ha sido creado por un compilador con un número de compilación inferior a 1916
  • Mostrar ventana de confirmación antes de ejecutar el script: esto evita la ejecución accidental del script.
  • Mostrar la ventana de propiedades antes de ejecutar el script: permite ver y cambiar los parámetros de entrada antes de ejecutar el script.

Si las propiedades especificadas en el archivo del proyecto difieren de las propiedades especificadas en el código fuente, los valores del archivo del proyecto tendrán prioridad.

Agregar y eliminar archivos de un proyecto #

Todos los archivos utilizados en el código fuente se añaden automáticamente a la estructura del proyecto. Por ejemplo, si incluye un nuevo archivo MQH usando la directiva #include, se mostrará automáticamente en la sección "Dependencies" del navegador. La sección "Headers" contendrá los archivos de encabezado utilizados, y la sección "Resources" contendrá imágenes, sonidos y otros programas MQL incluidos en el proyecto como recursos (directiva #resource).

La sección Sources muestra los archivos de código fuente. Puede añadir otros archivos a la sección Settings and files, como por ejemplo ajustes para pruebas o plantillas para gráficos.

Para agregar manualmente archivos existentes a un proyecto o eliminarlos del mismo, utilice los comandos del menú contextual. Tenga cuidado al eliminar: puede eliminar el archivo del proyecto (eliminar el enlace) o borrarlo por completo de su disco duro.

Agregar y eliminar archivos de un proyecto

El comando "Agregar carpeta existente" le permite agregar de forma masiva todos los archivos compatibles del directorio seleccionedo al proyecto.

Al agregar un archivo a un proyecto manualmente, este no se incluye de ninguna manera en el código del programa ni se copia al directorio del proyecto. El archivo solo está vinculado al proyecto para ser mostrado en su navegador.

Compilación del proyecto #

Para obtener un archivo ejecutable EX5, puede abrir el archivo del proyecto o el archivo principal MQ5 del programa y luego ejecutar el comando de compilación (F7). El archivo ejecutable se creará en el directorio donde se encuentra el archivo de proyecto MQPROJ.

Para facilitar su uso, al compilar un proyecto grupal, el archivo ejecutable final (EX5) se copia automáticamente a la carpeta Expertos, Indicadores o Scripts, según el tipo de programa. De esta forma, podrá ejecutar el programa inmediatamente en la terminal sin tener que copiarlo manualmente al directorio deseado.

Proyectos grupales #

La sección Shared Projects es una sección especial para el trabajo colaborativo en proyectos. Cualquier proyecto creado en esta sección se envía automáticamente al almacenamiento en línea.

Para crear un nuevo proyecto de grupo, seleccione la carpeta Shared Projects y haga clic en "Nuevo proyecto" en el menú contextual:

Creación de un proyecto grupal

A continuación, siga los pasos estándar. Wizard en MQL5: establezca el tipo, el nombre y las propiedades del futuro programa. Elija nombres claros y comprensibles para los proyectos grupales, de modo que los demás participantes puedan identificarlos fácilmente. En el nombre solo se permiten letras y números latinos; no se permiten espacios.

Una vez creado, el proyecto compartido aparecerá en el sitio web de MQL5 Algo Forge como un repositorio privado dentro de su cuenta.

Modificar la visibilidad de los proyectos compartidos #

Puede hacer público un repositorio o conceder acceso a usuarios específicos. Haga clic con el botón derecho en la carpeta del proyecto y seleccione «Propiedades públicas del proyecto».

En el campo «Acceso», en lugar de «Proyecto privado», seleccione la opción deseada:

  • Proyecto privado: solo el autor tiene acceso al proyecto.
  • Participación libre en el proyecto: cualquier usuario puede unirse al proyecto.
  • La participación en el proyecto se da por solicitud; para obtener acceso al proyecto, deberá enviar una solicitud al autor.

Configurar el acceso a un proyecto grupal

También puede otorgar acceso a un usuario individual. Haga clic en «Agregar nuevo usuario» e introduzca sus credenciales de inicio de sesión de MQL5.community. En la lista desplegable «Derechos», seleccione el nivel de acceso:

  • Lectura: el usuario puede ver todos los datos del proyecto y descargar los archivos del proyecto.
  • Lectura y escritura: el usuario puede ver todos los datos del proyecto, descargar los archivos del proyecto y realizar cambios en ellos.
  • Administrador: el usuario recibe todos los permisos de lectura y escritura, y también puede gestionar la lista de participantes del proyecto.

Proyectos públicos #

Un proyecto público es un repositorio que tiene visibilidad pública. Cualquier usuario de MQL5 puede descargar los archivos del proyecto público, crear su bifurcaciónpara obtener su propia copia, ponerse en contacto con el propietario del proyecto o los encargados de mantenerlo y proponer cambios en el código.

La pestaña «Proyectos públicos» en MetaEditor está en desarrollo. Puede visualizar los proyectos públicos en el sitio web MQL5 Algo Forge: un equivalente a GitHub para la comunidad de desarrolladores de sistemas de trading algorítmico.

Sitio web de proyectos públicos

Después de crear una bifurcación de un proyecto público, una copia del mismo aparecerá en el sitio como un repositorio público en su cuenta. Después de clonar una bifurcación en MetaEditor, aparecerá en la sección Shared Projects.

Cambiar la visibilidad de los proyectos

Para hacer público un proyecto existente, cambie su configuración de visibilidad. Esto se puede hacer con la ayuda de un comando especial directamente en el MetaEditor o en el sitio web de MQL5 Algo Forge:

En la página del repositorio, haga clic en «Configuración» en la esquina superior derecha.

Página de configuración del repositorio

Desmarque la casilla «Repositorio privado» y haga clic en «Guardar configuración».

Cambiar la configuración del repositorio