MPS 2020.1 ヘルプ

MPS と ant の使い方

MPS と ant を使った作業

編集コードはもちろん MPS エディターを必要とします。しかしモデルの生成と
自動テストと統合するためにコマンドラインからテストを実行することができます。
構築します。基礎として Ant が使用されます。このセクションでは MPS の使い方を説明します
ant を介してコマンドラインから。

すべての例で、build.properties ファイルを使用します。
次の 2 つの特性

mps.home = // installation directory of MPS itself mbeddr.home = // the root directory relative to which all other directories // to projects etc. are specified

この build.properties ファイルは、このセクションで説明するすべてのビルドスクリプトに含まれています。さらに、ant の taskdef 要素を使用して一連の MPS 固有のタスクを定義する必要があります。また、いくつかの JVM オプションが何度も再利用されています。したがって、以下は、これから説明するすべてのビルドファイルの骨子です。

<project name="com.mbeddr.core build and test" default="all"> <property file="build.properties"/> <path id="mps.ant.path"> <pathelement location="${mps.home}/lib/mps-backend.jar"/> <pathelement location="${mps.home}/lib/jdom.jar"/> <pathelement location="${mps.home}/lib/log4j.jar"/> <pathelement location="${mps.home}/lib/mps-core.jar"/> </path> <taskdef resource="jetbrains/mps/build/ant/antlib.xml" classpathref="mps.ant.path"/> <jvmargs id="myargs"> <arg value="-ea"/> <arg value="-Xss1024k"/> <arg value="-Xmx1024m"/> <arg value="-XX:MaxPermSize=92m"/> <arg value="-XX:+HeapDumpOnOutOfMemoryError"/> </jvmargs> <!-- here is the place where all the following example code goes --> </project>

プロジェクトで言語を構築する

プロジェクトの内容を構築することから始めます。これが必要な ant コードです。
上記のスケルトン Ant ファイルで囲む必要があります。

<property name="project.mpr" value="relative/path/to/project/project.mpr"/> <target name="build-languages-in-project"> <mps.generate> <jvmargs refid="myargs"/> <project file="${mbeddr.home}/${project.mpr}"/> </mps.generate> </target>

プロジェクト内のすべてのモジュールが生成されます。モジュールのサブセットのみが
プロジェクトを生成する必要があります。modules ファイルセットを使用できます。の
次のコードは、プロジェクト内のすべての言語を生成します。通常、彼らは住んでいます
プロジェクトの languages ディレクトリ。定義する方法に注意してください
プロジェクトディレクトリを指す異なるプロパティ
プロジェクト .mps ファイル。

<property name="project.mpr" value="relative/path/to/project/project.mpr"/> <property name="project.dir" value="relative/path/to/project"/> <mps.generate> <jvmargs refid="myargs"/> <project file="${mbeddr.home}/${project.mpr}"/> <modules dir="${mbeddr.home}/${project.dir}/languages"/> </mps.generate>

プロジェクトをコンパイル可能にするために他の言語にアクセスする必要がある場合があります。
これらは、dir 属性が必要とするライブラリ要素とともに追加できます。
（直接またはそに）必要なディレクトリを含むディレクトリを指定します。
言語

<property name="some.other.project.dir" value="relative/p/to/other/project"/> <mps.generate> <jvmargs refid="myargs"/> <project file="${mbeddr.home}/${project.mpr}"/> <library name="irrelevantName" dir="${mbeddr.home}/${some.other.project.dir}/languages"/> </mps.generate>

生成 / 構築ソリューション

DSL で書かれたコードを含むソリューションを構築することは基本的にはありません
言語の構築とは異なります。しかし、それを設定することが重要です。
それらは言語を含むディレクトリを指す
ソリューションで使用されています。

<!-- project with solutions that should be built --> <property name="solutionproject.dir" value="path/to/some/solution/project"/> <!-- two projects that contain languages used by solutionproject --> <property name="langproject.dir" value="path/to/some/project"/> <property name="other.langproject.dir" value="path/to/other/project"/> <target name="build-solutions"> <mps.generate> <jvmargs refid="myargs"/> <!-- set up libs to point to the lang projects --> <library name="langproject" dir="${mbeddr.home}/${langproject.dir}"/> <library name="other.langproject" dir="${mbeddr.home}/${other.langproject.dir}"/> <!-- generate two solutions in the project --> <modules dir="${mbeddr.home}/${solutionproject.fit}/solutions/solution1"/> <modules dir="${mbeddr.home}/${solutionproject.fit}/solutions/solution2"/> </mps.generate> </target>

テストの実行

MPS はテストに使用できる特別なテスト言語をサポートします
制約、型システム規則、エディター機能。これらのテストは実行することができます
ソリューションまたはモデルのコンテキストメニューから実行オプションを使用して UI から
（下図参照）

runtests

これらのテストはコマンドラインからも実行できます。これが必要とするコードです：

<!-- make this point to some temp directory --> <property name="mps.platform.caches" value="tmp"/> <!-- path to project .mpr with the tests in it --> <property name="project.mpr" value="relative/path/to/project/project.mpr"/> <target name="run-tests"> <delete dir="${mps.platform.caches}"/> <junit haltonfailure="true" showoutput="true" fork="true" dir="${mps.home}"> <jvmarg value="-ea"/> <jvmarg value="-Xss1024k"/> <jvmarg value="-Xmx1200m"/> <jvmarg value="-XX:MaxPermSize=128m"/> <jvmarg value="-XX:+HeapDumpOnOutOfMemoryError"/> <sysproperty key="idea.system.path" value="${mps.platform.caches}/system"/> <sysproperty key="idea.config.path" value="${mps.platform.caches}/config"/> <sysproperty key="idea.plugins.path" value="${mps.platform.caches}/plugins"/> <sysproperty key="mps.junit.project" value="${mbeddr.home}/${project.mpr}"/> <sysproperty key="mps.junit.pathmacro.mbeddr.home" value="${mbeddr.home}"/> <classpath> <fileset dir="${mps.home}/lib"> <include name="**/*.jar"/> </fileset> <fileset dir="${mps.home}/plugins"> <include name="**/*.jar"/> </fileset> </classpath> <test name="jetbrains.mps.testbench.junit.suites.DefaultTestSuite"/> <formatter type="xml"/> </junit> </target>

ここで重要な成分は、2 つのシステム特性です。
mps.junit.project と mps.junit.pathmacro.mbeddr.home 最初の 1 つ
テストを含むプロジェクトを指定します。二つ目はもう少しです
関与した。構文 mps.junit.pathmacro.XXX はパスの値を設定します。
MPS プロジェクト内の変数 XXX テストを正しく実行するために、
プロジェクトファイルを指すプロジェクト内の TestInfo ノードになります。この
パス変数（MPS 設定で定義されている）を使用して、その間で移植可能にします。
ファイルシステム内のさまざまなマシンとさまざまな場所。の
mps.junit.pathmacro.mbeddr.home ものはの値を提供するために使用されます
コマンドラインからマクロ。

testinfo

ビルド言語 IntelliJ IDEA 言語プラグインの構築