Справка по MetaEditorПроекты и MQL5 Algo ForgeВнешний клиент Git

Использование внешнего Git-клиента

MQL5 Algo Forge — система хранения данных на базе Git. После выполнения первоначальной настройки и установки Git на компьютере вы можете использовать любой внешний Git-клиент.

Среди наиболее популярных Git-клиентов: TortoiseGit, GitHub Desktop, встроенная в Visual Studio Code интеграция с Git, GitKraken, Sourcetree и другие. Эти программы упрощают выполнение команд Git, разрешение конфликтов и работу со сложными сценариями.

По умолчанию MetaEditor включает поддержку Git только для определенных папок. Поэтому важно понимать, где находятся эти папки и как они устроены. В верхнем меню MetaEditor выберите «Файл \ Открыть каталог данных».

Открыть каталог данных

В Проводнике откроется папка данных вашего экземпляра терминала. В ней находится папка MQL5.

Расположение папки экземпляра терминала

Папка MQL5 #

Каталог MQL5 MQL5 является основной папкой данных для программ алгоритмической торговли. По умолчанию большинство файлов и папок внутри каталога MQL5 не отслеживаются Git, пока вы явно не добавите их под контроль версий. В Навигаторе MetaEditor выполните команду добавления на файле или папке внутри каталога MQL5, чтобы добавить их в коммит и отправить изменения в удаленный репозиторий mql5.

Папка MQL5 в Проводнике

Каталог MQL5 представляет собой локальный приватный репозиторий, связанный с удаленным репозиторием mql5 вашего аккаунта на сайте MQL5 Algo Forge.

Веб-страница репозитория MQL5

Папка Shared Projects #

Каталог Shared Projects находится в корневой папке MQL5, однако его содержимое не зависит от содержащего его репозитория. В папке Shared Projects хранятся отдельные репозитории, каждый из которых имеет собственную папку .git, ветки и другие данные Git.

Когда вы создаете форк публичного проекта на сайте MQL5 Algo Forge, его копия становится отдельным репозиторием в вашем аккаунте.

Страница форк-копии

После обновления содержимого папки Shared Projects в MetaEditor новый репозиторий появится в списке доступных проектов. При клонировании репозитория файлы проекта будут загружены и сохранены в локальной папке Shared Projects.

Публичные проекты в Проводнике

Локальная конфигурация Git #

При создании коммитов MetaEditor использует ваш логин MQL5 в качестве значения user.name, а адрес ваш-логин-mql5@forge.mql5.io — в качестве user.email. При работе через внешний Git-клиент по умолчанию используются глобальные настройки Git.

Поэтому перед созданием первого коммита во внешнем Git-клиенте необходимо задать для каждого локального репозитория те же значения user.name и user.email, которые использует MetaEditor. Это позволит избежать неправильного указания автора коммитов и связанных с этим проблем.  

Откройте терминал и перейдите в папку репозитория:

cd /path/to/your/repository

Задайте имя пользователя:

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

Задайте адрес электронной почты:

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

Вместо командной строки можно воспользоваться встроенными средствами настройки Git в вашем клиенте. Подробную информацию о настройке локальной конфигурации Git смотрите в документации используемого клиента, например TortoiseGit, GitHub Desktop или GitKraken.

Данные для входа в MQL5 Algo Forge #

При работе с удаленным сервером MQL5 Algo Forge MetaEditor автоматически использует активную сессию MQL5. Внешний Git-клиент запрашивает данные для входа при необходимости связаться с удаленным репозиторием — например, при получении или отправке изменений.

Когда Git-клиент запросит данные для входа, укажите свой логин и пароль MQL5. Дальнейшие действия зависят от используемого Git-клиента и его версии.

Многие Git-клиенты, включая TortoiseGit, VS Code и GitHub Desktop, пытаются сохранить данные для входа с помощью встроенного Git Credential Manager (GCM). В случае успешного сохранения учетные данные передаются в системное хранилище диспетчера учетных данных Windows и сохраняются там.

Окно диспетчера учетных данных Windows

Некоторые клиенты, включая TortoiseGit и GitKraken, могут сохранять данные для входа в собственной среде или через встроенный менеджер учетных записей. Подробности можно найти в документации используемого Git-клиента.

Сохранение данных аккаунта MQL5 позволяет Git-клиенту взаимодействовать с удаленным сервером без необходимости каждый раз вводить логин и пароль.

После правильной настройки Git и сохранения данных для входа вы сможете использовать внешний Git-клиент для выполнения всех поддерживаемых операций.