Introducción a la plantilla de proyecto de VSIX

  • Artículo

Puede usar la plantilla proyecto vsix para crear una extensión o empaquetar una extensión existente para la implementación. La plantilla Proyecto VSIX tiene versiones de Visual Basic y Visual C# y se instala como parte del SDK de Visual Studio.

La plantilla proyecto VSIX solo consta de un source.extension.vsixmanifest archivo, que contiene información sobre la extensión y los recursos que distribuye.

Para buscar la plantilla de proyecto VSIX, debe instalar el SDK de Visual Studio. Para obtener más información, vea SDK de Visual Studio.

Implementación de una plantilla de proyecto personalizada mediante la plantilla de proyecto VSIX

Los pasos siguientes muestran cómo usar el proyecto VSIX para empaquetar una plantilla de proyecto que puede compartir con otros desarrolladores o cargar en la Galería de Visual Studio.

  1. Cree una plantilla de proyecto.

    1. Abra el proyecto desde el que se va a crear una plantilla. Este proyecto puede ser de cualquier tipo de proyecto.

    2. En el menú Proyecto, haga clic en Exportar plantilla. Complete los pasos del asistente.

      Se crea un .zip archivo en %USERPROFILE%\My Documents\Visual Studio {version}\My Exported Templates\.

  2. Cree un proyecto VSIX vacío.

    Seleccione Archivo>Nuevo>Proyecto. En el cuadro de búsqueda, escriba "vsix" y seleccione la versión de C# o Visual Basic del proyecto VSIX.

  3. Agregue el archivo .zip al proyecto. Establezca su propiedad Copiar en el directorio de salida en Copy Always.

  4. En Explorador de soluciones, haga doble clic en el archivo source.extension.vsixmanifest para abrirlo en el Diseñador de manifiestos VSIX y, a continuación, realice los cambios siguientes:

    • Establezca el campo Nombre del producto en Mi plantilla de proyecto.

    • Establezca el campo Id. de producto en MyProjectTemplate - 1.

    • Establezca el campo Autor en Fabrikam.

    • Establezca el campo Descripción en Mi plantilla de proyecto.

    • En la sección Activos , agregue un tipo Microsoft.VisualStudio.ProjectTemplate y establezca su ruta de acceso al nombre del archivo .zip .

  5. Guarda y cierra el archivo source.extension.vsixmanifest.

  6. Compile el proyecto.

  7. En el directorio de salida, haga doble clic en el .vsix archivo.

  8. Aparece un cuadro de mensaje del instalador de VSIX. Siga las instrucciones para instalar la extensión.

  9. Cierre Visual Studio y vuelva a abrirlo.

  10. Seleccione Administrar extensiones (en el menú Extensiones) y seleccione la categoría Plantillas. Una de las extensiones disponibles debe ser Mi plantilla de proyecto.

  11. La nueva plantilla de proyecto aparece en el cuadro de diálogo Nuevo proyecto en el mismo lugar que la plantilla de proyecto original. Por ejemplo, si ha creado una plantilla denominada CONSOLA DE VB desde una aplicación de consola de Visual Basic, la consola de VB aparece en el mismo panel que la plantilla aplicación de consola de Visual Basic.

Para especificar la ubicación de la plantilla en el cuadro de diálogo Nuevo proyecto

  1. Las carpetas de plantilla se encuentran en los {Visual Studio Installation Path}\Common7\IDE\ProjectTemplates directorios y {Visual Studio Installation Path}\Common7\IDE\ItemTemplates . Los nombres de las secciones de nivel superior del cuadro de diálogo Nuevo proyecto no coinciden exactamente con los nombres de las carpetas de plantilla. Donde difieren, use el nombre de la carpeta de plantilla.

    Cambie la extensión de .vsix archivo a .zipy abra el archivo.

  2. Cree una nueva carpeta con el mismo nombre que la sección del cuadro de diálogo Nuevo proyecto en el que debería aparecer la plantilla.

  3. Si la plantilla debe aparecer en una subsección, cree una subcarpeta con el mismo nombre.

  4. Mueva el archivo de plantilla .zip a la nueva carpeta.

  5. Cambie la .zip extensión a .vsix.

  6. Abra el manifiesto VSIX.

  7. En el manifiesto VSIX, actualice la ruta de acceso del recurso de la plantilla para que apunte a la raíz del árbol de directorios que contiene el archivo de plantilla. Por ejemplo, si la plantilla está en \CSharp\Windows, la referencia debe apuntar a \CSharp.