Implementación MSI y VSIX ADSL

Puede instalar un lenguaje específico en dispone del equipo o en otros equipos.Visual Studio se debe instalar ya en el equipo de destino.

La elección entre la implementación VSIX y MSI

Hay dos métodos de implementar un lenguaje específico:

Método

Ventajas

VSX (extensión deVisual Studio )

muy fácil implementar: Copie y ejecute el archivo de .vsix de proyectos de DslPackage.

Para obtener más información vea Instalar y desinstalar ADSL mediante el VSX.

MSI (archivo installer)

  • Permite que el usuario abre Visual Studio haciendo doble clic en un archivo ADSL.

  • Asocia un icono al tipo de archivo ADSL en el equipo de destino.

  • Asocia un XSD (esquema XML) al tipo de archivo ADSL.Esto evita advertencias cuando el archivo se carga en Visual Studio.

Debe agregar un proyecto de instalación a la solución para crear el MSI.

Para obtener más información, vea Implementar ADSL mediante un archivo MSI.

Instalar y desinstalar ADSL mediante el VSX

Cuando ADSL se instala con este método, el usuario puede abrir un archivo ADSL dentro de Visual Studio, pero el archivo no se puede abrir desde el Explorador de Windows.

Para instalar ADSL mediante el VSX

  1. En el equipo, busque el archivo de .vsix compilado en el proyecto paquete ADSL.

    1. En Explorador de soluciones, haga clic con el botón secundario en el proyecto de DslPackage , y haga clic en Abrir carpeta en el Explorador de Windows.

    2. Busque el archivo bin\*\SuProyecto.DslPackage.vsix

  2. Copie el archivo de .vsix en el equipo de destino en el que desea instalar ADSL.Puede tratarse de su propio equipo o de otro.

  3. En el equipo de destino, haga doble clic en el archivo .vsix.

    El Instalador de extensiones de Visual Studio se abre e instala la extensión.

  4. Inicie o reinicie Visual Studio.

  5. Para probar un DSL, utilice Visual Studio de crear un nuevo archivo que tiene la extensión que se define para ADSL.

Para desinstalar ADSL que se instaló utilizando VSX

  1. En el menú Herramientas, haga clic en Administrador de extensiones.

  2. Expanda Extensiones instaladas.

  3. Seleccione la extensión en la que un DSL es definido, y haga clic en Desinstalar.

En contadas ocasiones, una extensión defectuosa no se carga y crea un informe en la ventana de error, aunque no aparece en el Administrador de extensiones.En ese caso, puede quitar la extensión eliminando el archivo de:

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

Implementar ADSL en MSI

Definiendo un archivo MSI (Windows Installer) para DSL, puede permitir que los usuarios abran archivos ADSL del Explorador de Windows.También puede asociar un icono y una breve descripción con la extensión de nombre de archivo.Además, MSI puede instalar un XSD que se puede utilizar para validar los archivos ADSL.Si lo desea, puede agregar otros componentes en MSI que se instala al mismo tiempo.

Para obtener más información sobre los archivos MSI y otras opciones de implementación, vea Implementar aplicaciones y componentes.

Para compilar MSI, agrega un proyecto de instalación a la solución de Visual Studio .El método más fácil de crear un proyecto de instalación es utilizar la plantilla de CreateMsiSetupProject.tt, que puede descargar de. sitio de VMSDK

Para implementar un DSL en MSI

  1. Establezca InstalledByMsi en la extensión manifiesto.Esto evita que el VSX está instalado y que desinstalado excepto por MSI.Esto es importante si incluye otros componentes en MSI.

    1. DslPackage abierto \ source.extension.tt

    2. inserte la siguiente línea antes de <SupportedProducts>:

      <InstalledByMsi>true</InstalledByMsi>
      
  2. Cree o edite un icono que representa un DSL en el Explorador de Windows.por ejemplo, edición DslPackage\Resources\File.ico

  3. Asegúrese de que los siguientes atributos ADSL son correctos:

    • En el Explorador ADSL el nodo raíz, y en la ventana Propiedades, revise:

      • Descripción

      • Versión

    • Haga clic en el nodo de Editor y en la ventana Propiedades, haga clic Icon.Establezca el valor para hacer referencia a un archivo de icono en DslPackage\Resources, como File.ico

    • En el menú de Generar , Administrador de configuraciónabierto, y seleccione la configuración que desea compilar, por ejemplo Liberar o Depurar.

  4. Va visualización y modelado de la página principal de SDK, y de la ficha de Descargas , descargue CreateMsiSetupProject.tt.

  5. Agregue CreateMsiSetupProject.tt al proyecto del ADSL.

    Visual Studio creará un archivo denominado CreateMsiSetupProject.vdproj.

  6. En el Explorador de Windows, copie ADSL \*.vdproj to a new folder named Setup.

    Si lo desea, ahora puede excluir CreateMsiSetupProject.tt de proyecto del ADSL.)

  7. en Explorador de soluciones, agregue Setup\*.vdproj como proyecto existente.

  8. En el menú Proyecto, haga clic en Dependencias del proyecto.

    En el cuadro de diálogo de Dependencias del proyecto , seleccione el proyecto de instalación.

    Seleccione el cuadro situado junto a DslPackage.

  9. Recompilar la solución.

  10. En el Explorador de Windows, busque el archivo MSI integrado en el proyecto de instalación.

    Copie el archivo MSI en un equipo en el que desea instalar ADSL.Haga doble clic en el archivo MSI.Ejecuta el instalador.

  11. En el equipo de destino, cree un nuevo archivo con la extensión de archivo ADSL.Compruebe lo siguiente:

    • En la vista de lista del Explorador de Windows, el archivo aparece con el icono y la descripción que ha definido.

    • Al hacer doble clic en el archivo, Visual Studio inicia, abrir el archivo ADSL en el editor de ADSL.

Si lo prefiere, puede crear el proyecto de instalación manualmente, en lugar de utilizar la plantilla de texto.Para un tutorial que incluya este procedimiento vea el capítulo 5 de Visualización y modelado de laboratorio de SDK.

Para desinstalar ADSL que se instaló MSI

  1. En Windows, abra el panel de control de programas y características .

  2. Desinstale ADSL.

  3. Reinicie Visual Studio.