Ajuda para o MetaEditor → Projetos e MQL5 Algo Forge → Criação e trabalho com projetos

Criação e gerenciamento de projetos

O MetaEditor oferece diversos recursos para gerenciar projetos. Você pode reunir arquivos em uma única estrutura, definir as configurações do projeto e colaborar no desenvolvimento usando o MQL5 Algo Forge e o sistema de controle de versão.

O que é um projeto

Um projeto é um arquivo MQPROJ que armazena as configurações do programa MQL5, os parâmetros de compilação e informações sobre todos os arquivos utilizados.

Um clique duplo em um arquivo MQPROJ abre a guia "Projeto", uma área de trabalho separada para gerenciar projetos na janela Navegador. Nessa guia, todos os arquivos e pastas do projeto são organizados por categorias.

Estrutura e configurações do projeto    

Criação de um projeto #

No menu superior, selecione "Arquivo \ Novo projeto" ou pressione Ctrl+Shift+N. Escolha o tipo de programa e prossiga no Assistente MQL5.

Criação de um novo projeto

Informe o nome do projeto e os demais parâmetros, adicione os parâmetros de entrada e selecione os manipuladores de eventos.

O assistente também permite criar projetos vazios para acomodar estruturas de arquivos que não seguem os modelos padrão. Um projeto vazio contém apenas o arquivo MQPROJ e exige a criação manual dos arquivos de código-fonte.

Criação de um projeto a partir de um arquivo MQ5 #

Clique com o botão direito do mouse no arquivo e selecione "Novo projeto a partir do código-fonte".

Criação de um novo projeto a partir de um arquivo-fonte

Um novo arquivo de projeto MQPROJ com o mesmo nome será criado no diretório. As principais propriedades do programa definidas no arquivo-fonte por meio de #property serão adicionadas automaticamente ao projeto: nome, copyright, versão, link do desenvolvedor e descrição. Todos os arquivos incluídos no código-fonte por meio da diretiva #include serão adicionados à seção "Dependencies" do projeto.

Propriedades do projeto #

As configurações do projeto podem ser alteradas em uma caixa de diálogo separada, sem editar o código-fonte do arquivo MQ5. Para isso, clique duas vezes no arquivo MQPROJ na guia "Projeto".

Estrutura e configurações do projeto

As seguintes configurações estão disponíveis para o projeto:

  • Plataforma: versão da plataforma para a qual o produto é desenvolvido, MetaTrader 4 ou MetaTrader 5.
  • Tipo de programa: tipo do programa, EA (robô de trading), indicador, script ou biblioteca.
  • Copyright: informações de direitos autorais, equivalentes à propriedade "#property copyright..." no código-fonte.
  • Link: link do desenvolvedor, equivalente à propriedade "#property link..." no código-fonte.
  • Versão: versão do programa, equivalente à propriedade "#property version..." no código-fonte.
  • Ícone: ícone do programa, equivalente à propriedade "#property icon..." no código-fonte.
  • Descrição: descrição do programa, equivalente à propriedade "#property description..." no código-fonte.
  • CPU: otimização da compilação para conjuntos específicos de instruções do processador: X64 Regular, AVX, AVX2 + FMA3, AVX512 + FMA3.
  • Otimização máxima: quando esta opção está ativada, os aplicativos são executados mais rapidamente.
  • Verificar divisores de ponto flutuante: com essa verificação desativada, os aplicativos são executados um pouco mais rapidamente, pois erros de divisão por zero não são verificados durante a execução do código.
  • Usar cache de otimização: durante a otimização, o Testador de Estratégias salva em cache todos os resultados das passagens realizadas. Os resultados são armazenados para cada conjunto de parâmetros de entrada. Ao repetir a otimização com os mesmos parâmetros, isso permite reutilizar os resultados já disponíveis sem gastar tempo com novos cálculos.
    No entanto, em algumas tarefas, como cálculos matemáticos, pode ser necessário realizar os cálculos independentemente da existência de resultados anteriores. Nesse caso, desative no projeto a opção "Usar cache de otimização". Os próprios resultados dos testes continuarão sendo armazenados em cache, para que você possa consultar no relatório do Testador de Estratégias todos os dados das passagens realizadas.
  • Calcular o indicador a cada tick no testador: esta opção está disponível apenas para projetos de indicadores. Ela força o cálculo do indicador a cada tick durante a execução no Testador de Estratégias. A configuração afeta apenas o funcionamento no Testador de Estratégias. Na própria plataforma, os indicadores são sempre calculados a cada novo tick recebido.
    Ao testar EAs que utilizam indicadores, o Testador de Estratégias calcula os valores do indicador somente quando seus dados são acessados, ou seja, quando os valores dos buffers do indicador são solicitados. Isso acelera significativamente os testes e a otimização quando o EA não precisa obter os valores do indicador a cada tick. Ative esta opção se o indicador precisar ser calculado a cada tick.
    No Testador de Estratégias, os indicadores também são obrigatoriamente calculados a cada tick nos seguintes casos:
  • durante testes no modo visual
  • quando o indicador contém as funções EventChartCustom, OnChartEvent, OnTimer
  • quando o indicador foi criado por um compilador com número de build inferior a 1916
  • Exibir janela de confirmação antes de executar o script: evita a execução acidental do script.
  • Exibir janela de propriedades antes de executar o script: permite visualizar e alterar os parâmetros de entrada antes da execução do script.

Se as propriedades definidas no arquivo do projeto forem diferentes das propriedades especificadas no código-fonte, prevalecerão os valores do arquivo do projeto.

Adição e remoção de arquivos do projeto #

Todos os arquivos usados no código-fonte são adicionados automaticamente à estrutura do projeto. Por exemplo, ao incluir um novo arquivo MQH por meio da diretiva #include, ele será exibido automaticamente na seção "Dependencies" do Navegador. Os arquivos de cabeçalho utilizados serão adicionados à seção "Headers", enquanto imagens, sons e outros programas MQL incluídos no projeto como recursos por meio da diretiva #resource serão adicionados à seção "Resources".

A seção Sources exibe os arquivos de código-fonte. Na seção Settings and files, você pode adicionar outros arquivos, como configurações de teste ou templates de gráficos.

Para adicionar manualmente arquivos existentes ao projeto ou removê-los, use os comandos do menu de contexto. Tenha cuidado ao remover um arquivo: você pode apenas retirá-lo do projeto, removendo seu vínculo, ou excluí-lo completamente do disco rígido.

Adição e remoção de arquivos do projeto

O comando "Adicionar pasta existente" permite adicionar de uma só vez ao projeto todos os arquivos suportados do diretório selecionado.

Ao adicionar um arquivo manualmente ao projeto, ele não é incluído no código do programa nem copiado para o diretório do projeto. O arquivo apenas fica vinculado ao projeto para ser exibido no Navegador.

Compilação do projeto #

Para gerar o arquivo executável EX5, você pode abrir o projeto ou o arquivo MQ5 principal do programa e executar o comando de compilação (F7). O arquivo executável será criado no diretório em que se encontra o arquivo de projeto MQPROJ.

Ao compilar um projeto compartilhado, o arquivo executável final (EX5) é copiado automaticamente para a pasta Experts, Indicators ou Scripts, conforme o tipo do programa, facilitando a execução no terminal. Assim, você pode executar imediatamente o programa no terminal sem precisar copiá-lo manualmente para o diretório correspondente.

Projetos compartilhados #

Shared Projects é uma seção especial destinada à colaboração em projetos. Qualquer projeto criado nessa seção é enviado automaticamente ao armazenamento online.

Para criar um novo projeto compartilhado, selecione a pasta Shared Projects e clique em "Novo projeto" no menu de contexto:

Criação de um projeto compartilhado

Em seguida, siga as etapas padrão do Assistente MQL5: defina o tipo, o nome e as propriedades do futuro programa. Para projetos compartilhados, escolha nomes claros e fáceis de distinguir pelos demais participantes. O nome pode conter apenas letras latinas e números; espaços não são permitidos.

Depois de criado, o projeto compartilhado aparecerá no site do MQL5 Algo Forge como um repositório privado na sua conta.

Alteração da visibilidade de projetos compartilhados #

Você pode tornar o repositório público ou conceder acesso a usuários específicos. Clique com o botão direito do mouse na pasta do projeto e selecione "Propriedades do projeto público".

No campo "Acesso", substitua "Projeto privado" pela opção desejada:

  • Projeto privado: somente o autor tem acesso ao projeto.
  • Participação aberta no projeto: qualquer usuário pode participar do projeto.
  • Participação no projeto mediante solicitação: para obter acesso ao projeto, é necessário enviar uma solicitação ao autor.

Configuração de acesso a um projeto compartilhado

Também é possível conceder acesso a um usuário específico. Clique em "adicionar novo usuário" e informe o login MQL5.community dele. Na lista suspensa "Permissões", selecione o nível de acesso:

  • Leitura: o usuário pode visualizar todos os dados do projeto e baixar seus arquivos.
  • Leitura e gravação: o usuário pode visualizar todos os dados do projeto, baixar os arquivos e fazer alterações neles.
  • Administrador: o usuário recebe todas as permissões de leitura e gravação e também pode gerenciar a lista de participantes do projeto.

Projetos públicos #

Um projeto público é um repositório configurado com visibilidade pública. Qualquer usuário MQL5 pode baixar os arquivos de um projeto público, criar um forkpara obter sua própria cópia, colaborar com o proprietário ou com os mantenedores do projeto e propor alterações no código.

A guia "Projetos públicos" do MetaEditor ainda está em desenvolvimento. Os projetos públicos disponíveis podem ser consultados no site do MQL5 Algo Forge, equivalente ao GitHub para a comunidade de desenvolvedores de sistemas de trading algorítmico.

Site de projetos públicos

Depois de criar um fork de um projeto público, a cópia aparecerá no site como um repositório público na sua conta. Depois de clonar o fork no MetaEditor, ele aparecerá na seção Shared Projects.

Alteração da visibilidade dos projetos

Para tornar público um projeto existente, altere suas configurações de visibilidade. Isso pode ser feito por meio de um comando específico diretamente no MetaEditor ou no site do MQL5 Algo Forge:

Na página do repositório, clique em "Configurações" no canto superior direito.

Página de configurações do repositório

Desmarque a opção "Repositório privado" e clique em "Salvar configurações".

Alteração das configurações do repositório