Развертывание доменного языка с использование MSI и VSIX

Вы можете установить язык, зависящий от домена, на своем компьютере или на других компьютерах. Visual Studio уже должен быть установлен на целевом компьютере.

Выбор между развертыванием VSIX и MSI

Существует два способа развертывания конкретного домена языка:

Способ	Льготы
VSX (расширение Visual Studio)	Очень легко развернуть: скопируйте и выполните VSIX-файл из проекта DslPackage. Дополнительные сведения см. в статье об установке и удалении DSL с помощью VSX.
MSI (файл установщика)	— Позволяет пользователю открывать Visual Studio, дважды щелкнув DSL-файл. — связывает значок с типом файла DSL на целевом компьютере. — связывает XSD (XML-схему) с типом файла DSL. Это позволяет избежать предупреждений при загрузке файла в Visual Studio. Для создания MSI необходимо добавить проект установки в решение. Дополнительные сведения см. в статье "Развертывание DSL с помощью MSI-файла".

Установка и удаление DSL с помощью VSX

При установке DSL с помощью этого метода пользователь может открыть DSL-файл из Visual Studio, но файл не может быть открыт из проводника Windows.

Установка DSL с помощью VSX

1. Найдите VSIX-файл, созданный проектом пакета DSL:

   1. В Обозреватель решений щелкните правой кнопкой мыши проект DslPackage и щелкните "Открыть папку" в проводник.

   2. Найдите двоичный файл\*\YourProject. DslPackage.vsix

2. Скопируйте VSIX-файл на целевой компьютер, на котором требуется установить DSL. Это может быть как ваш собственный компьютер, так и любой другой.

   • Целевой компьютер должен иметь один из выпусков Visual Studio, поддерживающих DSLs во время выполнения. Дополнительные сведения см. в статье "Поддерживаемые выпуски Visual Studio" для пакета SDK для визуализации и моделирования.

   • Целевой компьютер должен иметь один из выпусков Visual Studio, указанных в DslPackage\source.extensions.manifest.

3. На целевом компьютере дважды щелкните VSIX-файл .

   Откроетсяустановщик расширений Visual Studio , который устанавливает расширение.

4. Запустите или перезапустите Visual Studio.

5. Чтобы протестировать DSL, используйте Visual Studio для создания нового файла с расширением, определенным для DSL.

Удаление DSL, установленного с помощью VSX

1. В меню Сервис щелкните пункт Расширения и обновления.

2. Разверните узел Установленные расширения.

3. Выберите расширение, в котором определен DSL, и нажмите кнопку "Удалить".

   В редких случаях не удается загрузить неисправное расширение, в результате чего в окне ошибок создается отчет, который не отображается в диспетчере расширений. В этом случае расширение можно удалить, удалив файл из следующей папки:

   LocalAppData \Microsoft\VisualStudio\10.0\Extensions

Развертывание DSL в MSI

Определив файл MSI (установщик Windows) для DSL, вы можете разрешить пользователям открывать ФАЙЛЫ DSL из проводника Windows. Вы также можете связать значок и краткое описание с расширением имени файла. Кроме того, MSI может установить XSD, который можно использовать для проверки файлов DSL. Если вы хотите, вы можете добавить другие компоненты в MSI, которые будут установлены одновременно.

Дополнительные сведения о MSI-файлах и других вариантах развертывания см. в разделе "Развертывание приложений, служб и компонентов".

Чтобы создать MSI, добавьте проект установки в решение Visual Studio. Самый простой способ создания проекта установки — использовать шаблон CreateMsiSetupProject.tt, который можно скачать с сайта VMSDK.

Развертывание DSL в MSI

1. Задайте InstalledByMsi в манифесте расширения. Это предотвращает установку и удаление VSX, за исключением MSI. Это важно, если вы добавите другие компоненты в MSI.

   1. Открытие DslPackage\source.extension.tt

   2. Вставьте следующую строку перед <SupportedProducts>:

      <InstalledByMsi>true</InstalledByMsi>
      

2. Создайте или измените значок, который будет представлять DSL в проводнике Windows. Например, измените DslPackage\Resources\File.ico

3. Убедитесь, что правильны следующие атрибуты DSL:

   • В обозревателе DSL щелкните корневой узел и в окно свойств проверьте:

     • Description

     • Версия

   • Щелкните узел редактора и в окно свойств щелкните значок. Задайте значение для ссылки на файл значка в DslPackage\Resources, например File.ico

   • В меню "Сборка" откройте Configuration Manager и выберите нужную конфигурацию, например выпуск или отладку.

4. Перейдите на домашнюю страницу пакета SDK для визуализации и моделирования, а затем на вкладке "Загрузки" скачайте CreateMsiSetupProject.tt.

5. Добавьте CreateMsiSetupProject.tt в проект Dsl.

   Visual Studio создаст файл с именем CreateMsiSetupProject.vdproj.

6. В проводнике Windows скопируйте dsl\*.vdproj в новую папку с именем установки.

   (Если вы хотите, теперь можно исключить CreateMsiSetupProject.tt из проекта Dsl.)

7. В Обозреватель решений добавьте setup\*.vdproj в качестве существующего проекта.

8. В меню "Проект" щелкните "Зависимости проекта".

   В диалоговом окне "Зависимости проекта" выберите проект установки.

   Выберите поле рядом с DslPackage.

9. Заново постройте решение.

10. В проводнике Windows найдите встроенный MSI-файл в проекте установки.

    Скопируйте MSI-файл на компьютер, на котором требуется установить DSL. Дважды щелкните MSI-файл. Установщик запускается.

11. На целевом компьютере создайте файл с расширением DSL. Проверьте следующее:

    • В представлении списка Проводника отображается файл со значком и описанием, заданным вами.

    • При двойном щелчке файла Visual Studio запускается и открывает файл DSL в редакторе DSL.

    Если вы предпочитаете, можно создать проект установки вручную, а не использовать текстовый шаблон. Пошаговое руководство, включающее эту процедуру, см. в главе 5 лаборатории sdk для визуализации и моделирования.

Удаление DSL, установленного из MSI

1. В Windows откройте панель управления "Программы и компоненты ".

2. Удалите DSL.

3. Перезапустите Visual Studio.