本文へスキップ
← 記事一覧

EAソースコード

MetaEditorでMQ5をコンパイルする方法とよくあるエラーの対処法

EABuild Team · · 読了目安 1分

How to Compile MQ5 in MetaEditor and Fix Common Errors – EABuild

このガイドでは、MetaEditorでMQ5をコンパイルする手順と、エラーでビルドが止まったときの対処法を順を追って説明します。コンパイルとは、読める形の.mq5ソースファイルを、MetaTrader 5が実行できる.ex5ファイルに変換する作業です。事前に用意するもの、手順の正確な順序、MetaEditorが表示するメッセージの読み方、そしてプログラムをリアル口座で使う前に結果を確認する方法がわかります。

コンパイル前に必要なもの

コンパイル自体は短時間で終わりますが、ビルドの失敗はコードの誤りよりも、何かが足りないことが原因である場合がほとんどです。まず次の4点を確認してください。

  • MetaEditorを含むMetaTrader 5がインストールされていること。MetaEditorはターミナルに付属しています。プラットフォームをまだインストールしていない場合は、ダウンロードページ(metatrader5.com)から入手できます。
  • ソース一式をダウンロードしていること。プロジェクトには、メインの.mq5ファイルのほかに、.mqhヘッダーファイル(メインファイルが読み込む共通コード)や、場合によっては追加のフォルダーが含まれます。すべて解凍し、フォルダー構成をそのまま保ってください。
  • MQL5向けに書かれたソースであること。.mq4ファイルはMetaTrader 4のコードで、書き換えなしではMT5のプログラムとしてビルドできません。両者の形式の違いは、MQ4とMQ5のソースコードガイドで説明しています。
  • 手を加えていないバックアップ。編集を始める前に、ダウンロードしたままのファイルを別のフォルダーにコピーしておくと、いつでも元の状態に戻れます。

ファイルの置き場所

MetaEditorは、ターミナルのデータフォルダー内にあるファイルをビルドします。MetaTrader 5で「ファイル」から「データフォルダを開く」を選んでください。その中のMQL5フォルダーには、EA(自動で売買を行うプログラム)用のExperts、インジケーター用のIndicators、スクリプト用のScripts、共通ヘッダーファイル用のIncludeがあります。EAのプロジェクトはExpertsの下に、インジケーターはIndicatorsの下に置き、各プロジェクトはダウンロード時と同じ相対的な構成を保ってください。

MQ5コードをコンパイルする手順

以下の手順は、ファイルがすでにデータフォルダー内の正しい場所にあることを前提としています。

  1. MetaTrader 5でF4キーを押すか、ツールバーのMetaEditorボタンをクリックします。MetaEditorが別ウィンドウで開きます。
  2. 左側のナビゲーターパネルでMQL5を展開し、続けてファイルのあるフォルダー(例: Experts)を展開します。
  3. .mq5ファイルをダブルクリックします。コードがエディターで開きます。
  4. F7キーを押すか、ツールバーのコンパイルボタンをクリックします。MetaEditorがビルドを開始します。
  5. ウィンドウ下部のパネルにあるエラータブを開きます。すべてのエラーと警告が一覧表示され、最後に合計を示す行が出ます。
  6. 合計でエラーがゼロであれば、ソースファイルと同じフォルダーを確認してください。同じ名前の新しい.ex5ファイルが、コンパイルされたプログラムです。
  7. ターミナルに戻り、ナビゲーターパネルを更新するかMetaTrader 5を再起動すると、該当する一覧にプログラムが表示され、チャートにアタッチできる状態になります。

完成済みのEAを実行するだけでビルドは不要という場合は、より簡単な手順を説明したMT5へのEAやインジケーターのインストール方法のガイドをご覧ください。

1ファイルだけをコンパイルするか、プロジェクト全体をコンパイルするか

メインの.mq5ファイルをコンパイルすると、それが読み込むヘッダーファイルも一緒にビルドされるため、通常はメインファイルだけをコンパイルします。ヘッダーファイルを単独で開いてF7を押すと、そのファイルは他の場所で定義された内容に依存しているため、プロジェクト全体では発生しないエラーが出ることがあります。コンパイルは必ずメインファイルから行ってください。

「エラー」タブの読み方

「エラー」タブの各行には、説明、ファイル、行、列が表示されます。行をダブルクリックすると、コード内のその位置にカーソルが移動します。メッセージには2種類あります。

  • エラーはビルドを止めます。解消するまで.ex5ファイルは作成されません。
  • 警告はビルドを止めませんが、作者の意図どおりに動作しない可能性があるコードを示しています。無視せずに内容を読んでください。

確認は、一覧の最後ではなく最初のエラーから始めます。括弧の閉じ忘れのような序盤のミス1つが、その後に長いエラーの連なりを引き起こすことがあります。最初のエラーを直してF7をもう一度押し、残りがいくつあるかを確認してください。1か所の修正で一覧が大きく減ることはよくあります。

よくあるコンパイルエラーと対処法

以下の文言は、MetaEditorが通常表示する内容に沿っています。正確なテキストはビルドによって多少異なる場合がありますが、原因と対処法は変わりません。

インクルードファイルを開けない

cannot open fileの後に.mqhで終わる名前が続くメッセージは、コンパイラーがヘッダーを見つけられないことを意味します。よくある原因は、コピーの際にファイルが抜け落ちたか、ファイルが間違ったフォルダーにあることです。ソースの先頭にある#include行を確認してください。山括弧で囲まれた名前はデータフォルダーのIncludeフォルダーを指し、引用符で囲まれた名前はソースファイルと同じ場所から探されます。ヘッダーを、その行が想定している場所へ移動してください。

未宣言の識別子

Undeclared identifierは、コンパイラーがまだ見たことのない名前をコードが使っていることを意味します。典型的な原因は、変数名の入力ミス、別のコードブロックの内側で宣言されたために参照できない変数、MQL5に存在しないMQL4の関数です。まずスペルを見比べてください。名前が関数であれば、MQL5ドキュメントで、その関数が存在するか、MQL5ではどのような名前かを調べてください。

関数が未定義、またはパラメーター数が違う

MetaTrader 4とMetaTrader 5では、注文の扱い方が異なります。注文関数をMT4の方式で呼び出している古いMQL4コードはMT5版と一致しないため、コンパイラーはパラメーター数の誤りや未知の関数を報告します。この場合の対処は小さな修正では済みません。プログラムのその部分をMQL5の取引モデルに合わせて書き直すか、最初からMT5向けに書かれたコードを用意する必要があります。

セミコロン、括弧、または丸括弧が必要

セミコロンの欠落、丸括弧の不一致、波括弧の不足を指摘するメッセージは、入力ミスです。メッセージが示す行に加えて、そのすぐ上の行も確認してください。コンパイラーは問題を1行遅れて検出することがよくあります。開き括弧すべてに対応する閉じ括弧を付ければ、このタイプのエラーはたいてい一度に解消します。

型変換によりデータが失われる可能性がある

これは警告です。値がより小さい型に押し込まれることを示しており、たとえば小数を含む数値が整数用の変数に格納される場合などが該当します。ビルドは完了しますが、格納される値が切り捨てられることがあります。その変換が意図したものかどうかを確認してください。意図したものであれば、キャストで変換を明示でき、コンパイラーに意図的であることを伝えられます。

ビルドは完了したがターミナルに変化がない

「エラー」タブにエラーが表示されていないのにターミナルが以前の動作のままの場合、ターミナルが読み込むフォルダーとは別のフォルダーにあるコピーをコンパイルした可能性があります。.ex5ファイルが、「ファイル」から「データフォルダを開く」で開くデータフォルダーの下にあること、そしてビルド後にチャート上のプログラムをいったん削除してからアタッチし直したことを確認してください。

ソースパッケージをコンパイルする例

ソースコード商品を使うと、実際のプロジェクトでの流れがわかります。Smart Gold Hunter EA Source Code (MQ5)の掲載情報はMetaTrader 5向けで、M5とM15のXAUUSDで取引を行います。掲載のとおり、ZIPにはコンパイル済みファイルが1つ、ソースファイルが1つ、セットファイルが6つ含まれ、DLLは使用されません。セットファイルとは、EAのパラメーター画面から読み込む、入力設定を保存した一覧です。

このようなパッケージでは、ソースファイルをExpertsの下に置き、MetaEditorで開いてF7を押します。これで、自分で読めるコードから自分でビルドした.ex5ファイルができます。掲載情報では、戦略はスキャルピング、経済指標トレード、両建てと説明されており、バージョンは3.5と記載されています。ソースを読めば、それらの部分がどのように書かれているかを、使う前に確認できます。ビルドの次の手順については、MT4とMT5でのセットファイルの読み込み方法のガイドで説明しています。

クリーンなビルド後の確認事項

コンパイルできるプログラムが、正しく動くプログラムとは限りません。コンパイラーが確認するのは文法であり、取引ロジックではありません。ビルドを使う前に、次の短いリストを順に確認してください。

  1. 合計の行がエラーゼロを示していることを確認し、すべての警告を読みます。
  2. プログラムが想定している銘柄と時間足のチャートにアタッチし、アルゴリズム取引を有効にして、ターミナルの「エキスパート」タブにエラーメッセージが出ていないか見守ります。
  3. ストラテジーテスターで実行し、コードが意図したとおりに取引の建玉、管理、決済を行うかを確認します。テスターの実行は保存された価格データを使うものであり、将来について確かなことは何も示しません。
  4. スプレッドの変動や急な相場に対応する様子を確認できる十分な期間、デモ口座でテストします。
  5. リアル口座へ移る前に、設定がご利用のブローカーの契約サイズと口座タイプに合っているかを確認します。

コードを変更する場合は、バックアップを残し、一度に1つだけ変更して、変更のたびにコンパイルしてください。問題なくビルドできる編集であっても、プログラムの取引の仕方が変わってしまうことがあります。また、ご自身で行った変更のデバッグを手伝う義務は誰にもありません。

次に読むもの

ソースからファイルをビルドできるようになれば、他のプロジェクトも同じ方法で読めるようになります。カタログのEAソースコードのダウンロードを閲覧できます。ショップのすべての商品はメンバーシップに含まれています。eabuild.appはデジタルダウンロード商品を販売するショップであり、商品の開発元や発行元ではありません。

外国為替取引およびCFD取引は高いリスクを伴い、すべての投資家に適しているとは限りません。過去の実績は将来の結果を保証するものではありません。失っても問題のない資金の範囲でのみ取引してください。

タグ: EA Source Code, MetaEditor, MQL5

← 記事一覧

メンバーシップで全EAを利用

313 件の製品 · $16.59/月から

プランを見る

EAソースコードのその他の記事