Como começar a trabalhar com MQL5 Algo Forge

O novo portal MQL5 Algo Forge não é apenas uma lista dos seus projetos, é uma verdadeira rede social para desenvolvedores. Agora é possível acompanhar mudanças facilmente, manter o histórico, encontrar pessoas com os mesmos interesses e descobrir novas ideias. Aqui você pode seguir autores interessantes, criar equipes e desenvolver projetos colaborativos de algotrading.  

O MQL5 Algo Forge é construído com base no Git, um sistema moderno de controle de versões. Isso significa que agora cada desenvolvedor tem em mãos uma ferramenta completa para acompanhar o histórico do projeto, criar ramificações, realizar experimentos e trabalhar em equipe. Mas como tudo isso funciona?  Neste artigo, vamos mostrar como começar a trabalhar com o MQL5 Algo Forge. 

O que é um repositório no MQL5 Algo Forge

A criação de qualquer programa normalmente é um processo longo, que exige tempo e depuração. O código desenvolvido precisa não apenas ser escrito e mantido em ordem, mas também armazenado de forma confiável. Os algoritmos modernos para trading nos mercados financeiros há muito deixaram de se limitar a simples sinais do cruzamento de duas médias móveis; hoje, eles são baseados em bibliotecas matemáticas, redes neurais e aprendizado de máquina. Por isso, é fundamental ter a possibilidade de salvar rapidamente e de maneira conveniente todas as alterações feitas, assim como acessar a versão mais atualizada do código de qualquer lugar. 

MQL5 Storage era o repositório de versões integrado no editor MetaEditor. Ele utilizava a versão 1.7 do sistema de controle de versões Subversion. Esse sistema era centralizado, já que todo o histórico ficava armazenado no servidor da MetaQuotes. Sem conexão com a internet, você não conseguia registrar mudanças, reverter para uma versão anterior ou visualizar o histórico. Hoje, ele foi totalmente substituído por uma ferramenta muito mais poderosa e flexível, o MQL5 Algo Forge.

Agora o MQL5 Algo Forge funciona de outra forma:

	MQL5 Algo Forge (com Git)	MQL5 Storage (versão anterior)
Armazenamento do histórico	Local e na nuvem	Somente na nuvem da MetaQuotes
Trabalho sem internet	Completo (commits, reversões, diff)	Limitado ou impossível
Velocidade das operações	Instantânea, local	Dependente da rede e do servidor

O Algo Forge traz liberdade. É possível trabalhar tranquilamente no trem, criar ramificações para experimentos, salvar resultados intermediários e depois unificá-los na ramificação principal.

O repositório do projeto no Algo Forge não é apenas uma pasta na nuvem. Ele é um repositório estruturado, que fica armazenado no seu disco e também é sincronizado com o servidor em nuvem do MQL5 Algo Forge.  Ele é composto por vários níveis:

#Diretório de trabalho no MetaEditor

	São os seus arquivos .MQ5, .MQH, .SET e outros que você edita no MetaEditor. Aqui você escreve o código do EA, conecta indicadores e testa estratégias. Enquanto você não indicar explicitamente, o sistema Algo Forge não vai considerar as alterações.

Área de preparação (índice)

	Antes de enviar as mudanças para o histórico do projeto, você precisa prepará-las. Com o comando "Git Add" você escolhe os arquivos que serão incluídos no próximo commit. Isso permite adicionar alterações por partes, por exemplo, salvar primeiro as modificações na lógica do algoritmo de trading e depois as mudanças na interface ou nas configurações.

Repositório local

	Depois que você faz um commit (Git Commit), o Forge salva uma cópia do estado atual dos arquivos no repositório local, isto é, diretamente no seu computador. A qualquer momento você pode consultar o que havia antes, voltar para uma versão anterior ou entender quais alterações impactaram o funcionamento do EA.

#Repositório remoto no MQL5 Algo Forge

	Quando tudo estiver pronto, você pode enviar os commits para o servidor do MQL5 Algo Forge (Git Push). Isso cria uma cópia de segurança confiável e torna as mudanças acessíveis aos colegas de equipe. Mesmo que você trabalhe sozinho, isso é útil: o seu código sempre poderá ser recuperado da nuvem, e você não perderá o histórico de desenvolvimento.

Como se conectar ao MQL5 Algo Forge

Para trabalhar com o site do MQL5 Algo Forge basta ter uma MQL5-account, basta inserir seus dados em https://forge.mql5.io/ e fazer login.  

Depois de se autenticar, você poderá explorar todos os recursos disponíveis, sendo que os projetos públicos ficam em Explore.  Agora, encontrar projetos, estudar seus códigos, compartilhar o seu e se unir a equipes ficou muito mais simples.

Mas o trabalho principal com os projetos você fará, naturalmente, no ambiente de desenvolvimento MetaEditor.  Para se conectar ao MQL5 Algo Forge no editor, basta autenticar-se com os dados da sua conta MQL5 na seção Community

O que é o Git e como ele funciona no MQL5 Algo Forge

O Git é um sistema que registra como os seus arquivos estavam em diferentes momentos no tempo. Ele ajuda a não perder mudanças importantes, a reverter facilmente para versões anteriores, a trabalhar em ramificações separadas e a unir o trabalho de vários desenvolvedores em um único projeto.

Ao mesmo tempo, você não interage diretamente com o Git: no MetaEditor tudo acontece por meio de um menu simples e intuitivo. Mas "por baixo do capô" algumas comandos básicos são usados. Vamos analisar o que cada um deles faz e o que acontece quando você clica nos itens correspondentes no editor MetaEditor.

Vamos criar um novo projeto "Base_EA" na pasta de projetos públicos.

Clicamos com o botão direito no arquivo do projeto e veremos os comandos relacionados ao Git.

1. Git Add File/Folder — Preparando as alterações para salvar

Quando você edita arquivos, o Git ainda não os considera. Para dizer ao sistema: "Estes são os arquivos que eu quero salvar no histórico", você os adiciona ao índice. Isso é feito pelo item "Git Add File/Folder" ou simplesmente ao escolher o arquivo para commit.

O Git registra o estado atual do arquivo e o prepara para ser salvo, como se você tivesse colocado os documentos necessários em uma pasta "Para assinatura".

2. Git Commit — Salvando o estado do projeto

Quando você clica em "Git Commit" no MetaEditor, o Git tira um snapshot do estado do projeto naquele momento. Esse snapshot é adicionado ao histórico de versões.

O que acontece:

• O Git compara os novos arquivos com os anteriores. 
• Salva apenas as diferenças (isso economiza espaço).
•  Registra as mudanças em uma pasta oculta chamada .git 
• Atribui ao commit um identificador numérico único (SHA-1), para que ele possa ser encontrado depois. 

O commit é como um ponto de controle: "Foi assim que o projeto estava neste momento". No futuro, você sempre poderá recuperar o projeto exatamente nesse ponto e continuar o trabalho a partir dali.

3. Git Push — Enviando para a nuvem do MQL5 Algo Forge

Quando você clica em "Git Push", o Git envia os commits acumulados para o repositório remoto no servidor do MQL5 Algo Forge. 

É como se você tivesse enviado um arquivo compactado com a nova versão do projeto para a nuvem, só que com todo o histórico detalhado de mudanças.

Para maior comodidade, o MetaEditor sempre executa automaticamente o comando "Git Push" quando você usa "Git Commit". Isso garante que o desenvolvedor terá sempre no servidor a versão mais recente do projeto e reduz o número de possíveis conflitos.  Mas se, por algum motivo, não for possível enviar as mudanças para o servidor, o comando "Git Push" separado será útil.

4. Git Pull — Obtendo a versão atualizada da nuvem

Se várias pessoas estiverem trabalhando no projeto, alguém pode ter feito alterações e enviado antes de você. Ou você pode ter feito commits em um computador e agora deseja continuar o trabalho em outro (ou até no mesmo computador, mas em outro terminal, acontece). Para receber essas atualizações, é usado o comando "Git Pull", que significa "Atualizar o projeto a partir do Forge".

O Git baixa os novos commits e os mescla com a sua versão local.

5. Git Branch — Criando ramificações para experimentos

Às vezes, você precisa experimentar com o código sem afetar a versão principal. Para isso, são criadas ramificações. Por exemplo, você deseja criar uma versão do EA com sinais de outro indicador ou com um filtro adicional, e assim por diante. Você cria uma ramificação com um nome claro e trabalha nela. Ao mesmo tempo, pode alternar facilmente entre as ramificações.

A ramificação é uma linha paralela de desenvolvimento. Nela você pode fazer quaisquer alterações e depois decidir se vai descartá-las ou unificá-las com a versão principal.

6. Git Difference — Vendo exatamente o que mudou

Esse comando mostra, linha por linha, o que foi adicionado, removido ou alterado em um arquivo antes do commit. É exibido como um painel de comparação de versões (na hora do commit ou ao consultar o histórico).

7. Git Log — visualizar o histórico de mudanças do projeto

O comando log mostra a lista de todos os commits anteriores com data, autor e mensagem. Abre o registro interno de alterações, é possível ver quem alterou o quê e quando.

8.  Git Revert — desfazer um commit específico

O comando "Git Revert" cria um novo commit que anula o efeito de um commit anterior, sem apagá-lo do histórico. É uma forma segura de "reverter" alterações sem quebrar a estrutura do projeto. Mas isso só funciona se for o último commit a ser revertido.

Isso é especialmente útil quando você percebe que algum commit fez o EA parar de funcionar corretamente, já que é possível cancelar rapidamente o efeito dele sem tocar nos demais commits. Porém, se depois do commit que você quer reverter houver outros commits com mudanças nas mesmas partes do código, então ao executar "Git Revert" surgirá um conflito, que terá de ser resolvido manualmente.

Trabalho seguro com projetos

Um dos principais problemas ao trabalhar com sistemas de versionamento é o conflito entre a versão local e a versão na nuvem. Aqui, uma regra simples de "higiene" ajuda, logo após abrir o projeto para continuar o trabalho, faça um Pull para garantir que você está com a versão mais recente da nuvem do Algo Forge.

E a regra inversa também é verdadeira, quer dizer, ao finalizar alterações no projeto, sempre faça Commit+Push para enviar suas mudanças para a nuvem. Isso evita dores de cabeça com resolução de conflitos e garante que você poderá retomar o trabalho a qualquer momento e de qualquer lugar.

MQL5 Algo Forge é tudo o que você precisa para trabalhar com projetos de forma confiável no MetaEditor

Você não precisa digitar comandos manualmente. Todo o Git está integrado à interface do MetaEditor:

• Adicionar arquivos, fazer commits, alternar ramificações — tudo pelo menu de contexto do projeto.
• Push e Pull — dois botões para sincronização com a nuvem.
• Branch e Revert — mais dois comandos para gerenciar o processo de desenvolvimento.
• O histórico de alterações está disponível em um registro visual e intuitivo.

Esses 8 comandos são tudo o que você precisa para usar o MQL5 Algo Forge com confiança. Eles permitem conduzir o desenvolvimento de forma tranquila, estruturada e com total proteção contra perdas.

Simplesmente comece a usar

O MQL5 Algo Forge não é apenas um repositório. É um sistema completo de gerenciamento de projetos para traders algorítmicos. Ele permite acompanhar as mudanças com precisão, experimentar sem riscos, trabalhar em equipe e ter segurança na estabilidade do código.

Se antes você evitava o Git por parecer complicado, com o Forge tudo ficou muito mais simples. O MetaEditor já integra os principais comandos, e tudo o que você precisa fazer é escrever o código, registrar os passos e estar pronto para qualquer reversão.

Bem-vindo ao MQL5 Algo Forge!

Links úteis:

• Guia do MetaEditor
  
• Documentação do Git
• Cheat sheet oficial do Git
• Formatação de .gitignore