DSL の MSI および VSIX 配置
ドメイン固有言語は、自分のコンピューターにもその他のコンピューターにインストールできます。 Visual Studio は、あらかじめターゲット コンピューターにインストールされている必要があります。
VSIX と MSI の配置の選択
ドメイン固有言語を配置するには、次の 2 つの方法があります。
| 方法 | メリット |
|---|---|
| VSX (Visual Studio 拡張機能) | 配置が非常に簡単: DslPackage プロジェクトから .vsix ファイルをコピーして実行します。 詳細については、「VSX を使用した DSL のインストールおよびアンインストール」を参照してください。 |
| MSI (インストーラー ファイル) | - ユーザーが DSL ファイルをダブルクリックして Visual Studio を開くことを許可します。 - ターゲット コンピューターの DSL ファイルの種類にアイコンを関連付けます。 - XSD (XML スキーマ) を DSL ファイルの種類に関連付けます。 これにより、ファイルが Visual Studio に読み込まれるときの警告が回避されます。 MSI を作成するには、ソリューションにセットアップ プロジェクトを追加する必要があります。 詳細については、「MSI ファイルを使用した DSL の配置」を参照してください。 |
VSX を使用した DSL のインストールおよびアンインストール
DSL がこの方法でインストールされている場合、ユーザーは Visual Studio 内から DSL ファイルを開くことができますが、エクスプローラーからファイルを開くことはできません。
VSX を使用して DSL をインストールするには
DSL パッケージ プロジェクトによって作成された .vsix ファイルを見つけます。
ソリューション エクスプローラーで [DslPackage] プロジェクトを右クリックし、[エクスプローラーでフォルダーを開く] をクリックします。
ファイル bin\*\YourProject.DslPackage.vsix を見つけます
DSL をインストールするターゲット コンピューターに .vsix ファイルをコピーします。 自分のコンピューターでも別のコンピューターでもかまいません。
ターゲット コンピューターには、実行時に DSL をサポートする Visual Studio のいずれかのエディションが必要です。 詳細については、「Visualization and Modeling SDK に対してサポートされている Visual Studio のエディション」を参照してください。
ターゲット コンピューターには、DslPackage\source.extensions.manifest で指定されている Visual Studio のいずれかのエディションが必要です。
ターゲット コンピューターで .vsix ファイルをダブルクリックします。
Visual Studio 拡張機能インストーラー が起動され、拡張機能がインストールされます。
Visual Studio を起動または再起動します。
DSL をテストするには、Visual Studio を使用して、DSL 用に定義した拡張機能を含む新しいファイルを作成します。
VSX を使用してインストールされた DSL をアンインストールするには
[ツール] メニューの [拡張機能と更新プログラム]をクリックします。
[インストール済みの拡張機能]を展開します。
DSL が定義されている拡張機能を選択し、[アンインストール] をクリックします。
拡張機能の障害が原因で読み込みが失敗し、エラー ウィンドウにレポートが生成されることがまれにありますが、それは拡張機能マネージャーには表示されません。 その場合は、以下の場所からファイルを削除して、拡張機能を削除します。
LocalAppData \Microsoft\VisualStudio\10.0\Extensions
MSI で DSL を配置する
DSL 用の MSI (Windows インストーラー) ファイルを定義することで、ユーザーに Windows エクスプローラーから DSL ファイルを開くことを許可できます。 また、アイコンと簡単な説明をファイル名拡張子に関連付けることもできます。 また、MSI では、DSL ファイルの検証に使用できる XSD をインストールできます。 必要に応じて、同時にインストールされる他のコンポーネントを MSI に追加することができます。
MSI ファイルとその他の配置オプションの詳細については、アプリケーション、サービス、およびコンポーネントの配置に関するページを参照してください。
MSI をビルドするには、Visual Studio ソリューションにセットアップ プロジェクトを追加します。 セットアップ プロジェクトの最も簡単な作成方法は、VMSDK サイトからダウンロードできる CreateMsiSetupProject.tt テンプレートを使用することです。
DSL を MSI に配置するには
拡張機能マニフェストで
InstalledByMsiを設定します。 これにより、MSI 以外で VSX をインストールおよびアンインストールすることができなくなります。 これは、MSI に他のコンポーネントを含める場合に重要です。DslPackage\source.extension.tt を開きます
<SupportedProducts>の前に次のコード行を挿入します。<InstalledByMsi>true</InstalledByMsi>
Windows エクスプローラーで DSL を表すアイコンを作成または編集します。 たとえば、DslPackage\Resources\File.ico を編集します
DSL の次の属性が正しいことを確認します。
DSL エクスプローラーでルート ノードをクリックし、プロパティ ウィンドウで次の内容を確認します。
説明
バージョン
[エディター] ノードをクリックし、プロパティ ウィンドウの [アイコン] をクリックします。 Dslpackage\Resources でアイコン ファイルを参照するように値を設定します (File.ico など)
[ビルド] メニューの [Configuration Manager] を開き、[リリース] や [デバッグ] など、ビルドする構成を選択します。
Visualization and Modeling SDK のホームページにアクセスし、[ダウンロード] タブから CreateMsiSetupProject.tt をダウンロードします。
Dsl プロジェクトに CreateMsiSetupProject.tt を追加します。
Visual Studio によって、CreateMsiSetupProject という名前のファイルが作成されます。
Windows エクスプローラーで、Dsl\*.vdproj を Setup という名前の新しいフォルダーにコピーします。
(必要に応じて、Dsl プロジェクトから CreateMsiSetupProject.tt を除外できるようになりました。)
ソリューション エクスプローラーで、既存のプロジェクトとして Setup\*.vdproj を追加します。
[プロジェクト] メニューの [プロジェクトの依存関係] をクリックします。
[プロジェクトの依存関係] ダイアログ ボックスで、セットアップ プロジェクトを選択します。
[DslPackage] の横にあるチェックボックスをオンにします。
ソリューションをリビルドします。
Windows エクスプローラーで、セットアップ プロジェクトでビルドされた MSI ファイルを見つけます。
DSL をインストールするコンピューターに MSI ファイルをコピーします。 MSI ファイルをダブルクリックします。 インストーラーが実行されます。
ターゲット コンピューターで、DSL のファイル拡張子を持つ新しいファイルを作成します。 次のことを確認します。
Windows エクスプローラーのリスト ビューでは、定義したアイコンと説明がファイルに表示されます。
ファイルをダブルクリックすると、Visual Studio が起動し、DSL エディターで DSL ファイルが開きます。
必要に応じて、テキスト テンプレートを使用する代わりに、手動でセットアップ プロジェクトを作成することもできます。 この手順が含まれているチュートリアルについては、Visualization and Modeling SDK ラボの第 5 章を参照してください。
MSI からインストールされた DSL をアンインストールするには
Windows で、コントロール パネルの [プログラムと機能] を開きます。
DSL をアンインストールします。
Visual Studio を再起動します。