Extender el Shell aisladoExtending the Isolated Shell

Puede extender el shell aislado de Visual Studio mediante la adición de un paquete VSPackage, una parte del componente de Managed Extensibility Framework (MEF) o un proyecto VSIX genérico a la aplicación de shell aislado.You can extend the Visual Studio isolated shell by adding a VSPackage, a Managed Extensibility Framework (MEF) component part, or a generic VSIX project to your isolated shell application.

Nota

Los pasos siguientes implican, para el que se ha creado una aplicación de shell aislado básico mediante la plantilla de proyecto de Visual Studio Shell aislado.The following steps presuppose that you have created a basic isolated shell application by using the Visual Studio Shell Isolated project template. Para obtener más información acerca de esta plantilla de proyecto, vea Tutorial: crear una aplicación de Shell aislado básica.For more information about this project template, see Walkthrough: Creating a Basic Isolated Shell Application.

Ubicaciones de las plantillas de proyecto del paquete de Visual StudioLocations for the Visual Studio Package Project Template

La plantilla de proyecto del paquete de Visual Studio puede encontrarse en tres ubicaciones diferentes en el cuadro de diálogo Nuevo proyecto :The Visual Studio Package project template can be found in three different locations in the New Project dialog:

  1. En Visual Basic, extensibilidad.Under Visual Basic, Extensibility. El lenguaje predeterminado del proyecto es Visual Basic.The default language of the project is Visual Basic.

  2. En Visual C#, extensibilidad.Under Visual C#, Extensibility. El lenguaje predeterminado del proyecto es C#.The default language of the project is C#.

  3. En otros tipos de proyecto, extensibilidad.Under Other Project Types, Extensibility. El lenguaje predeterminado del proyecto es C++.The default language of the project is C++.

Agregar un paquete VSPackageAdding a VSPackage

Puede agregar un paquete VSPackage a la aplicación de shell aislado.You can add a VSPackage to your isolated shell application. Los pasos siguientes muestran cómo crear uno que agrega comandos de menú.The following steps show how to create one that adds menu commands.

Para agregar un nuevo paquete de VSTo add a new VSPackage

  1. Agregue un proyecto de paquete de Visual Studio denominado MenuCommandsPackage.Add a Visual Studio Package project named MenuCommandsPackage.

  2. En el información básica de VSPackage página del asistente, establezca nombre de la compañía a Fabrikam y nombre de VSPackage a FabrikamMenuCommands.On the Basic VSPackage Information page of the wizard, set Company name to Fabrikam and VSPackage name to FabrikamMenuCommands. Elija el botón Siguiente.Choose the Next button.

  3. En la página siguiente, seleccione comando de menú y, a continuación, elija siguiente.On the next page, select Menu Command and then choose Next.

  4. En la página siguiente, establezca nombre de comando a Fabrikam Command y Id. de comando a cmdidFabrikamCommandy, a continuación, elija siguiente.On the next page, set Command name to Fabrikam Command and Command ID to cmdidFabrikamCommand, and then choose Next.

  5. En el seleccionar opciones de proyecto de prueba página, desactive las opciones de prueba y, a continuación, elija la finalizar botón.On the Select Test Project Options page, clear the test options, and then choose the Finish button.

  6. En el proyecto ShellExtensionsVSIX, abra el archivo source.extension.vsixmanifest.In the ShellExtensionsVSIX project, open the source.extension.vsixmanifest file.

    El activos sección debe contener una entrada para el proyecto VSShellStub.AboutBoxPackage.The Assets section should contain an entry for the VSShellStub.AboutBoxPackage project.

  7. Elija la New botón.Choose the New button.

  8. En el Agregar nuevo activo ventana, en la tipo lista, seleccione Microsoft.VisualStudio.VsPackage.In the Add New Asset window, in the Type list, select Microsoft.VisualStudio.VsPackage.

  9. En el origen lista, asegúrese de que un proyecto en la solución actual está seleccionada.In the Source list, make sure that A project in the current solution is selected. En el proyecto cuadro de lista, seleccione MenuCommandsPackage.In the Project list box, select MenuCommandsPackage.

  10. Guarde y cierre el archivo.Save and close the file.

  11. Recompile la solución e iniciar la depuración de shell aislado.Rebuild the solution and start debugging the isolated shell.

  12. En la barra de menús, elija herramientas menú, a continuación, comando Fabrikam.On the menu bar, choose Tools menu, then Fabrikam Command.

    Debería aparecer un cuadro de mensaje.A message box should appear.

  13. Detenga la depuración de la aplicación.Stop debugging the application.

Agregar un componente MEFAdding a MEF Component Part

Los pasos siguientes muestran cómo agregar un componente MEF en la aplicación de shell aislado.The following steps show how to add a MEF component part to your isolated shell application.

Para agregar un componente MEFTo add a MEF component

  1. En el Agregar nuevo proyecto cuadro de diálogo Visual C#, extensibilidad, use la Editor margen plantilla para agregar un proyecto.In the Add New Project dialog box, under Visual C#, Extensibility, use the Editor Margin template to add a project. Denomínelo ShellEditorMargin.Name it ShellEditorMargin.

  2. En el proyecto ShellExtensionsVSIX, abra el archivo Source.extension.vsixmanifest en la vista de diseño, no en la vista de código.In the ShellExtensionsVSIX project, open the Source.extension.vsixmanifest file in the Design view, not the Code view.

  3. En el Asset sección, elija agregar contenido.In the Asset section, choose Add Content.

  4. En el Agregar nuevo activo ventana, en la tipo lista, seleccione Microsoft.VisualStudio.MefComponent.In the Add New Asset window, in the Type list, select Microsoft.VisualStudio.MefComponent.

  5. En el origen lista, asegúrese de que un proyecto en la solución actual está seleccionada.In the Source list, make sure that A project in the current solution is selected. En el proyecto cuadro de lista, seleccione ShellEditorMargin.In the Project list box, select ShellEditorMargin.

  6. Guarde y cierre el archivo.Save and close the file.

  7. Recompile la solución e iniciar la depuración de shell aislado.Rebuild the solution and start debugging the isolated shell.

  8. Abra un archivo de texto.Open a text file.

    Un margen de color verde que contiene las palabras "¡Hello world!"A green margin that contains the words "Hello world!" debe mostrarse en la parte inferior de la ventana de archivo de texto.should be displayed at the bottom of the text file window.

  9. Detenga la depuración de la aplicación.Stop debugging the application.

Agregar un proyecto VSIX genéricoAdding a Generic VSIX Project

Para agregar un proyecto VSIX genéricoTo add a generic VSIX project

  1. En el Agregar nuevo proyecto cuadro de diálogo Visual C#, extensibilidad, use la VSIXProject plantilla para agregar un proyecto.In the Add New Project dialog box, under Visual C#, Extensibility, use the VSIXProject template to add a project. Denomínelo EmptyVSIX.Name it EmptyVSIX.

  2. En el proyecto ShellExtensionsVSIX, abra el archivo Source.extensions.vsixmanifest en la vista de diseño, no en la vista de código.In the ShellExtensionsVSIX project, open the Source.extensions.vsixmanifest file in the Design view, not the Code view.

  3. En el Assets sección, elija nuevo.In the Assets section, choose New.

  4. En el Agregar nuevo activo ventana, en la tipo , seleccione el tipo de contenido que se va a agregar.In the Add New Asset window, in the Type list, select the kind of content you want to add.

  5. En origen, asegúrese de que el un proyecto de la solución actual opción está seleccionada.In Source, make sure that the A project in current solution option is selected. En el cuadro de lista, seleccione el nombre del proyecto VSIX.In the list box, select the name of your VSIX project.

  6. Guarde y cierre el archivo.Save and close the file.

  7. Si este proyecto incluye código compilado, debe modificar el proyecto para que el ensamblado está incluido en la salida.If this project includes compiled code, you must edit the project so that the assembly is included in the output.

    1. Descargue el proyecto VSIX y abra el archivo de proyecto.Unload the VSIX project and open the project file.

    2. En la primera <PropertyGroup> un bloqueo, cambie el valor de <CopyBuildOutputToOutputDirectory> a true.In the first <PropertyGroup> block, change the value of <CopyBuildOutputToOutputDirectory> to true.

    3. Guardar y recargar el proyecto.Save and reload the project.

  8. Compile y ejecute la solución.Build and run the solution.

Vea tambiénSee Also

Tutorial: creación una aplicación básica de Shell aisladoWalkthrough: Creating a Basic Isolated Shell Application