Compilation steps for v1.080

[kenorb]

Compilation for Windows

Requirements

• Download and install MetaEditor (part of MetaTrader platform).
• Download and install Git client (alternatively GitHub Desktop app).

Steps

Method using Git GUI

To compile the project, follow these steps:

1. Open MetaEditor.

2. Open Experts folder in File Explorer. You can do that from File menu, then choose Open Data Folder and enter MQL?/Experts folder, or by selecting Experts folder and choose Open Folder from the contextual menu.

3. Once the folder is opened in File Explorer, open contextual menu and select Git GUI Here (assuming you've installed Git client, as per above Requirements).

4. In Git GUI, choose Clone Existing Repository and type https://github.com/EA31337/EA31337 as a Source Location and EA31337 (you can choose a different name) as a Target Directory, then Clone it.

5. After Cloning, to checkout the specific version, in Git GUI select Branch menu and Checkout..., then select Tag and choose the version to checkout. For the latest development version, choose master branch.

6. Go back to MetaEditor app, and open Experts/EA31337/src/EA31337.mq4, then Compile.

   ^{Note: For older versions (<v1.076), you also need to clone https://github.com/EA31337/EA31337-classes repository into MQL?/Include folder (similar as above). Make sure you checkout the same version for both repositories.}

7. If you've got any problems, check Troubleshooting section below, raise an issue, or ask at @EA31337.

Method using Git Bash

1. Open MetaEditor.

2. Select Experts folder and choose Open Folder from the context menu.

3. In opened folder, select Git Bash Here and type:

    git clone --recursive https://github.com/EA31337/EA31337
   

4. Now go to Include folder (same level as Experts), open Git Bash and type:

    git clone https://github.com/EA31337/EA31337-classes
   

5. For older versions below v1.076, make the following symbolic link by typing (so both folders are in sync while changing):

    ln -vs ../Experts/EA31337/src/include/EA31337 .
   

6. Now open Experts/EA31337/src/EA31337.mq4 and compile.

7. If you've got any problems, check Troubleshooting section below, raise an issue, or ask at @EA31337.

General method

To compile the project, you need to

1. Download or clone (recursively) this repository into platform's MQL4/Experts folder, for example:

    git clone --recurse-submodules https://github.com/EA31337/EA31337.git
   

   ^{Note: To open that folder, run platform and select File, Open Data Folder from the menu.}

2. Symlink or copy src/include/EA31337 folder into MQL4/Include folder.

3. Clone EA31337-classes repository into MQL4/Include folder.

4. Open the main EA31337.mq4 file in MetaEditor and compile.

   ^{Note: For MQL5, rename or copy the file to have .mq5 extension.}

5. In some cases (different branches/versions), you may also need to clone EA31337-strategies into src/include/EA folder.

   ^{Note: When downloading a ZIP file, it's missing the git submodules, so you need to clone it recursively.}

Compiling specific version

To compile the specific version of the project, use git to checkout the right version, e.g.:

1. After cloning project recursively, run git tag to see all the available versions.

2. Change the code to point to the specific version, for example: git checkout v1.076.

3. For version v1.066 and above, make sure your include files are compatible with the given version.

   For example, when using symbolic links, files in include's folder should be automatically updated. Otherwise you need to copy required dependencies manually.

Troubleshooting

'=' - object required or structure have objects and cannot be copied

This is the platform bug. Please upgrade MetaEditor 5 to at least build 1745. If you can't find it, copy it from MetaTrader 5.