通过

DSL 的 MSI 和 VSIX 部署

您可以安装域特定语言 (dsl) 在拥有计算机或其他计算机。在目标计算机上必须已安装Visual Studio 。

选择在 VSIX 和 MSI 部署之间

具有部署域特定语言 (dsl) 两个方法:

方法

优点

VSX (Visual Studio 扩展)

极其轻松地部署:复制并从 DslPackage 项目的 .vsix 文件。

有关更多信息 安装和卸载 DSL 使用 VSX请参见。

MSI (安装程序文件)

  • 允许用户通过双击 DSL 文件打开 Visual Studio 。

  • 关联图标与在目标计算机上 DSL 文件类型。

  • 关联 XSD (XML 架构) 使用 DSL 文件类型。文件时，在加载到 Visual Studio时，就警告。

必须将安装项目添加到解决方案创建 MSI。

有关更多信息，请参见 部署使用 MSI 文件的一个 DSL。

安装和卸载 DSL 使用 VSX

当与方法时安装 DSL，用户可以打开 DSL 文件从 Visual Studio中，，但该文件不能从 Windows 资源管理器中打开。

使用 VSX，安装 DSL

  1. 在计算机中，查找由 DSL 包项目生成的 .vsix 文件。

    1. 在 解决方案资源管理器，右击 DslPackage 项目，然后单击 打开在 Windows 资源管理器中的文件夹。

    2. 找到文件 bin\*\您的项目.DslPackage.vsix

  2. .vsix 文件复制到要安装 DSL 的目标计算机上。该计算机可为您自己的计算机或其他计算机。

    • 目标计算机上必须安装支持 DSL 在运行时的某个 Visual Studio 编辑。有关更多信息，请参见 可视化和建模 SDK 支持的 Visual Studio 版本。

    • 目标计算机上 DslPackage\source.extensions.manifest必须有一个 Visual Studio的编辑指定了。

  3. 在目标计算机上，双击 .vsix 文件。

    **“Visual Studio Extension Installer”**将会打开并安装扩展。

  4. 启动或重新启动 Visual Studio。

  5. 测试 DSL，使用 Visual Studio 创建具有扩展为 DSL 定义的新文件。

卸载使用 VSX，已安装的 DSL

  1. 在**“工具”菜单上，单击“扩展管理器”**。

  2. 展开**“已安装的扩展”**。

  3. 选择 DSL 定义的扩展，然后单击 卸载。

在极少数情况下，有错误的扩展无法加载并在错误窗口中创建报告，但不显示在扩展管理器中。在这种情况下，可以通过从以下位置删除文件来移除扩展：

LocalAppData**\Microsoft\VisualStudio\10.0\Extensions**

在 MSI 中部署一个 DSL

通过定义 DSL 的 MSI (Windows Installer) 文件，还允许用户从打开 Windows 资源管理器中 DSL 文件。还可以关联图标和简短描述与文件扩展名。此外， MSI 会安装可用于验证 DSL 文件的 XSD。如果需要，可以添加其他元素添加到将同时安装的 MSI。

有关 MSI 文件和其他部署选项的更多信息，请参见 部署应用程序和组件。

若要生成 MSI，您将安装项目添加到 Visual Studio 解决方案。创建安装项目最简单的方法是使用 CreateMsiSetupProject.tt 模板，可以下载。 VMSDK site

在 MSI 中部署一个 DSL

  1. 将清单该扩展的 InstalledByMsi 。这样可防止 VSX 安装和卸载除由 MSI。，如果在 MSI，包括其他组件这非常重要。

    1. 打开 DslPackage \ source.extension.tt

    2. 插入到 <SupportedProducts>之前的代码行:

      <InstalledByMsi>true</InstalledByMsi>

  2. 创建或编辑将表示在 Windows 资源管理器中 DSL 的图标。例如， " 编辑 DslPackage\Resources\File.ico

  3. 确保 DSL 的以下属性是正确的:

    • 在 DSL 资源管理器单击根节点，然后在 " 属性 " 窗口查看:

      • 说明

      • 版本

    • 单击 编辑 节点并在 " 属性 " 窗口中，单击 图标。将值对 DslPackage\Resources的图标文件，如 File.ico

    • 在 生成 菜单上，打开 配置管理器，并选择要生成的配置，如 版本 或 调试。

  4. 转到和 Visualization and Modeling SDK home page从 下载 选项，下载 CreateMsiSetupProject.tt。

  5. 添加 CreateMsiSetupProject.tt 到 DSL 项目。

    Visual Studio 将创建一个名为 CreateMsiSetupProject.vdproj的文件。

  6. 在 Windows 资源管理器中，复制 DSL \*.vdproj to a new folder named Setup。

    (如果需要，可以从 DSL 项目现在排除 CreateMsiSetupProject.tt。)

  7. 在 解决方案资源管理器，添加 Setup\*.vdproj 为现有项目。

  8. 在**“项目”菜单上单击“项目依赖项”**。

    在 项目依赖项 对话框中，选择安装项目。

    在 DslPackage旁边选择框。

  9. 重新生成解决方案。

  10. 在 Windows 资源管理器中，找到生成的 MSI 文件安装项目。

    MSI 文件复制到要安装 DSL 的计算机。双击 MSI 文件。此安装程序运行。

  11. 在目标计算机，请创建具有 DSL 的文件扩展名的新文件。确认:

    • 在 Windows 资源管理器列表视图，文件显示与该图标和声明和定义。

    • 当双击文件时， Visual Studio 启动，并在 DSL 编辑的 DSL 文件。

如果您愿意，可以手动创建安装项目，而不是使用文本模板。有关包含此过程的演练请参见第 5 章 Visualization and Modeling SDK Lab。

卸载从 MSI 安装的 DSL

  1. 在窗口中，打开 过程和函数 控制面板。

  2. 卸载 DSL。

  3. 重新启动 Visual Studio。