Utilizando um cliente Git externo

MQL5 Algo Forge é um sistema de armazenamento de dados baseado em Git. Após a conclusão configuração inicial e instalações Para usar o Git no seu computador, você pode usar qualquer cliente Git externo.

Entre os clientes Git mais populares estão: TortoiseGit, GitHub Desktop, integração do Git incorporada ao Visual Studio Code, *** GitKraken, Sourcetree e outros. Esses programas facilitam a execução de comandos Git, a resolução de conflitos e o trabalho com scripts complexos.

Por padrão, o MetaEditor habilita o suporte ao Git apenas para determinadas pastas. Portanto, é importante entender onde essas pastas estão localizadas e como estão estruturadas. No menu superior do MetaEditor, selecione Arquivo \ Abrir Diretório de Dados.

A pasta de dados da sua instância de terminal será aberta no Explorador de Arquivos. Há uma pasta MQL5 dentro dela.

Pasta MQL5 #

O catálogo MQL5 é a pasta de dados principal para programas de negociação algorítmica. Por padrão, a maioria dos arquivos e pastas dentro de um diretório MQL5 não são rastreados pelo Git até que você os adicione explicitamente ao controle de versão. No Navegador do MetaEditor, execute adicionar comando em um arquivo ou pasta dentro de um diretório MQL5 para adicioná-los ao commit e enviar as alterações para o repositório remoto mql5.

O catálogo MQL5 é um repositório privado local vinculado a um repositório remoto mql5 de sua conta no site MQL5 Algo Forge.

Pasta de Shared Projects #

O catálogo Shared Projects é localizado na pasta raiz MQL5, porém, seu conteúdo é independente do repositório que o contém. Na pasta Shared Projects são armazenados repositórios separados, cada um com sua própria pasta .git, branches e outros dados do Git.

Quando você cria uma bifurcação de um projeto público no site MQL5 Algo Forge, a cópia se torna um repositório separado em sua conta.

Após atualizar o conteúdo da pasta Shared Projects no MetaEditor, o novo repositório aparecerá na lista de projetos disponíveis. Ao clonar o repositório, os arquivos do projeto serão baixados e salvos na pasta local "Shared Projects".

Configuração local do Git #

Ao criar commits, o MetaEditor usa seu login MQL5 como valor user.namee o endereço your-login-mql5@forge.mql5.io, como user.email. Ao trabalhar com um cliente Git externo, as configurações globais do Git são usadas por padrão.

Portanto, antes de criar o primeiro commit em um cliente Git externo, você precisa definir os mesmos valores para cada repositório local user.name e user.email que o MetaEditor utiliza. Isso evitará indicar incorretamente o autor dos commits e os problemas associados a isso.  

Abra um terminal e navegue até a pasta do repositório:

cd /caminho/para/seus/repositórios

Definir nome de usuário:

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

Insira seu endereço de e-mail:

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

Em vez da linha de comando, você pode usar as ferramentas de configuração Git integradas do seu cliente. Para obter informações detalhadas sobre como configurar um ambiente Git local, consulte a documentação do cliente que você está usando, por exemplo TortoiseGit, GitHub Desktop ou GitKraken.

Detalhes de login do MQL5 Algo Forge #

Ao trabalhar com um servidor MQL5 remoto, o Algo Forge MetaEditor utiliza automaticamente a sessão MQL5 ativa. Um cliente Git externo solicita informações de login sempre que precisa contatar um repositório remoto, por exemplo, ao enviar ou receber alterações.

Quando o cliente Git solicitar informações de login, insira seu login e senha do MQL5. Os próximos passos dependem do cliente Git que você está usando e da sua versão.

Muitos clientes Git, incluindo TortoiseGit, VS Code e GitHub Desktop, tentam armazenar informações de login usando o Gerenciador de Credenciais Git (GCM) integrado. Se a operação de gravação for bem-sucedida, as credenciais serão transferidas para o Gerenciador de Credenciais do Windows e armazenadas lá.

Alguns clientes, incluindo TortoiseGit e GitKraken, podem armazenar dados de login em seu próprio ambiente ou por meio do gerenciador de contas integrado. Você pode encontrar mais detalhes na documentação do cliente Git que está usando.

Salvar os dados da conta MQL5 permite que o cliente Git interaja com o servidor remoto sem precisar inserir o login e a senha a cada vez.

Após a correta configuração Git e salvamento dos dados de login você poderá usar um cliente Git externo para executar todas as operações suportadas.