Tutorial: Publicar una extensión de Visual StudioWalkthrough: Publishing a Visual Studio Extension

En este tutorial se muestra cómo publicar una extensión de Visual Studio en Visual Studio Marketplace.This walkthrough shows you how to publish a Visual Studio extension to the Visual Studio Marketplace. Cuando se agrega la extensión Marketplace, los desarrolladores pueden usar extensiones y actualizaciones para buscar allí extensiones nuevas y actualizadas.When you add your extension to the Marketplace, developers can use Extensions and Updates to browse there for new and updated extensions.

Requisitos previosPrerequisites

Para seguir este tutorial, debe instalar el SDK de Visual Studio.To follow this walkthrough, you must install the Visual Studio SDK. Para obtener más información, consulte instalar el SDK de Visual Studio.For more information, see Installing the Visual Studio SDK.

Crear una extensión de Visual StudioCreate a Visual Studio Extension

En este caso se utilizará una extensión predeterminada de VSPackage, pero los mismos pasos son válidos para cada tipo de extensión.In this case we will use a default VSPackage extension, but the same steps are valid for every kind of extension.

  1. Crear un VSPackage en C# llamado "TestPublish" que tiene un comando de menú.Create a VSPackage in C# named "TestPublish" that has a menu command. Para obtener más información, consulte crear la primera extensión: Hello World.For more information, see Creating your First Extension: Hello World.

Empaquetar la extensiónPackage your Extension

  1. Actualizar vsixmanifest extensión con la información correcta sobre el nombre del producto, autor y versión.Update the extension vsixmanifest with the correct information about product name, author, and version.

    actualizar la extensión vsixmanifest

  2. Compilar la extensión versión modo.Build your extension in Release mode. Ahora la extensión se empaquetarán como una extensión VSIX en la carpeta \bin\Release.Now your extension will be packaged as a VSIX in the \bin\Release folder.

  3. Puede hacer doble clic en VSIX para comprobar la instalación.You can double click the VSIX to verify the installation.

Probar la extensiónTest the Extension

Antes de distribuir la extensión, compilar y probar para asegurarse de que está instalado correctamente en la instancia experimental de Visual Studio.Before you distribute the extension, build, and test it to make sure it is installed correctly in the experimental instance of Visual Studio.

  1. En Visual Studio, inicie la depuración.In Visual Studio, start debugging. Para abrir una instancia experimental de Visual Studio.to open an experimental instance of Visual Studio.

  2. En la instancia experimental, vaya a la herramientas menú y haga clic en extensiones y actualizaciones... . La extensión TestPublish debe aparecer en el panel central y habilitarse.In the experimental instance, go to the Tools menu and click Extensions and Updates.... The TestPublish extension should appear in the center pane and be enabled.

  3. En el herramientas menú, asegúrese de que vea el comando de prueba.On the Tools menu, make sure you see the test command.

Publicar la extensión en el catálogo de soluciones de Visual StudioPublish the Extension to the Visual Studio Marketplace

  1. Asegúrese de que ha generado la versión de lanzamiento de la extensión y que esté actualizada.Make sure that you have built the Release version of your extension and that it is up-to-date.

  2. En un explorador web, abra el Visual Studio Marketplace sitio Web.In a web browser, open the Visual Studio Marketplace website.

  3. En la esquina superior derecha, haga clic en iniciar sesión en.In the upper-right corner, click Sign in.

  4. Para ello, use la cuenta de Microsoft.Use your Microsoft account to sign in. Si no tiene una cuenta de Microsoft, puede crear uno en este momento.If you do not have a Microsoft account, you can create one at this point.

  5. Haga clic en publicar extensiones.Click Publish extensions. Esto le remitirá a la página de administración para todas las extensiones.This will navigate you to the manage page for all your extensions. Si no tienes una cuenta de publicador, deberá crear uno en este momento.If you don't have a publisher account, you will be prompted to create one at this time.

    Cargar en Marketplace

  6. Elija el editor que desea utilizar para cargar la extensión.Choose the publisher you want to use to upload your extension. Puede cambiar publicadores, haga clic en los nombres de publicador que aparecen a la izquierda.You can change publishers by clicking on the publisher names listed on the left. Haga clic en nueva extensión y seleccione Visual Studio.Click on New extension and select Visual Studio.

  7. En 1: cargar la extensión, puede cargar un archivo VSIX directamente en el catálogo de soluciones de Visual Studio o agregar un vínculo a su propio sitio Web.In 1: Upload extension, you can choose to upload a VSIX file directly to Visual Studio Marketplace or just add a link to your own website. En este caso, se cargará la extensión, TestPublish.vsix.In this case, we will upload our extension, TestPublish.vsix. Arrastre y coloque la extensión o bien use el haga clic en vínculo para buscar el archivo.Drag and drop your extension or use the click link to browse for the file. La extensión puede encontrarse en la carpeta \bin\Release del proyecto.Your extension can be found in the \bin\Release folder of the project. Haga clic en Continuar.Click Continue.

  8. En 2: proporcionar detalles de la extensión, algunos campos están rellena automáticamente desde el archivo source.extension.vsixmanifest de la extensión.In 2: Provide extension details, some fields are auto-populated from the source.extension.vsixmanifest file from your extension. Encontrará más detalles sobre cada una a continuación:More details about each can be found below:

    • Nombre interno se usará en la dirección URL de la página de detalles de la extensión.Internal Name will be used in the URL of the extension's detail page. Para obtener un ejemplo, se producirán en una dirección URL de publicar una extensión en el nombre de publicador "myname" y especificando el nombre interno para que sea "myextension" "marketplace.visualstudio.com/items?itemName=myname.myextension" para la extensión página de detalles.For an example, publishing an extension under the publisher name "myname" and specifying the internal name to be "myextension" will result in a URL of "marketplace.visualstudio.com/items?itemName=myname.myextension" for your extension's detail page.

    • Nombre para mostrar de la extensión.Display Name of your extension. Esto es rellena automáticamente desde el archivo source.extension.vsixmanifest.This is auto-populated from the source.extension.vsixmanifest file.

    • Versión número de la extensión que se va a cargar.Version number of the extension you are uploading. Esto es rellena automáticamente desde el archivo source.extension.vsixmanifest.This is auto-populated from the source.extension.vsixmanifest file.

    • Identificador de VSIX es el identificador único que Visual Studio usa para la extensión.VSIX ID is the unique identifier that Visual Studio uses for your extension. Esto es necesario si desea que tengan la extensión puede actualizar automáticamente.This is required if you would like to have your extension be auto-updated. Esto es rellena automáticamente desde el archivo source.extension.vsixmanifest.This is auto-populated from the source.extension.vsixmanifest file.

    • Logotipo de que se usará para la extensión.Logo that will be used for your extension. Esto se rellenarán automáticamente desde el archivo source.extension.vsixmanifest si se proporciona.This will be auto-populated from the source.extension.vsixmanifest file if provided.

      • Descripción breve de de lo que hace la extensión.Short description of what your extension does. Esto se rellenarán automáticamente desde el archivo source.extension.vsixmanifest.This will be auto-populated from the source.extension.vsixmanifest file.

      • Información general sobre es un buen lugar para incluir capturas de pantalla e información detallada sobre lo que hace la extensión.Overview is a good place to include screenshots and detailed information about what your extension does.

      • Admite versiones de Visual Studio le permite seleccionar qué versiones de Visual Studio la extensión funcionarán en.Supported Visual Studio versions lets you choose which versions of Visual Studio your extension will work on. La extensión solo se instalará para esas versiones.Your extension will only be installed to those versions.

      • Ediciones de Visual Studio compatibles le permite seleccionar qué ediciones de Visual Studio la extensión se pueden usar en.Supported Visual Studio editions lets you choose which editions of Visual Studio your extension will work on. La extensión solo se instalará a esas ediciones.Your extension will only be installed to those editions.

      • Tipo.Type. El tipo más común de las extensiones están herramientas.The most common type of extensions are Tools.

      • Categorías.Categories. Seleccionar hasta tres que son una mejor se adapte a su extensión.Pick up to three that are a best fit for your extension.

      • Etiquetas son palabras clave que ayudan a los usuarios buscar la extensión.Tags are keywords that help users find your extension. Las etiquetas pueden ayudar a aumentar la relevancia de la búsqueda de las extensiones en el mercado.Tags can help increase the search relevance of your extensions in the Marketplace.

      • Precios de categoría es el costo de la extensión.Pricing Category is the cost of your extension.

      • Repositorio de código fuente le permite compartir un vínculo en el código fuente con la Comunidad.Source code repository allows you to share a link to your source code with the community.

      • Permitir preguntas y respuestas para la extensión permitirá a los usuarios dejar preguntas en la página de entrada de la extensión.Allow Q&A for your extension will allow users to leave questions on your extension entry page.

  9. Haga clic en guardar y cargar.Click Save & Upload. Esto le llevará página de administración de nuevo en el publicador.This will take you back to your publisher manage page. Aún no se ha publicado la extensión.Your extension has not yet been published. Para publicar la extensión, haga doble clic en la extensión y seleccione hacer público.To publish your extension, right-click on your extension and select Make Public. Puede ver cómo la extensión será similar en Marketplace seleccionando vista extensión.You can view how your extension will look like on Marketplace by selecting View Extension. Para los números de adquisición, haga clic en informes.For acquisition numbers, click on Reports. Para realizar cambios en la extensión, haga clic en *editar.To make changes to your extension, click on *Edit.

    Menú de la entrada de extensión

  10. Después de hacer clic hacer público, la extensión es pública ahora.After clicking Make Public, your extension is now public. Buscar en Visual Studio Marketplace para la extensión.Search the Visual Studio Marketplace for your extension.

Agregar usuarios adicionales para administrar su cuenta de publicadorAdd Additional Users to Manage your Publisher Account

Marketplace admite la concesión de permisos de usuarios adicionales para acceder y administrar una cuenta de publicador.Marketplace supports granting additional users permissions to access and manage a publisher account.

  1. Navegue a la cuenta del publicador que se va a agregar usuarios adicionales.Navigate to the publisher account you wish to add additional users to.

  2. Seleccione miembros y haga clic en agregarSelect Members and click on Add

    Agregar usuarios adicionales

  3. A continuación, puede especificar la dirección de correo electrónico del usuario que se va a agregar y conceder el nivel adecuado de acceso en seleccione un rol.You can then specify the email address of the user you wish to add and grant the right level of access under Select a role. Puede elegir entre las siguientes opciones:You can choose from the following:

    • Creador: el usuario puede publicar extensiones, pero no se puede ver o administrar las extensiones publicadas por otros usuarios.Creator: The user can publish extensions, but cannot view or manage extensions published by other users.

    • Lector: el usuario puede ver las extensiones, pero no se puede publicar o administrar extensiones.Reader: The user can view extensions, but cannot publish or manage extensions.

    • Colaborador: el usuario puede publicar y administrar extensiones, pero no se puede editar la configuración del publicador o administrar el acceso.Contributor: The user can publish and manage extensions, but cannot edit publisher settings or manage access.

    • Propietario: el usuario puede publicar y administrar las extensiones, edite la configuración del publicador y administrar el acceso.Owner: The user can publish and manage extensions, edit publisher settings, and manage access.

Instale la extensión desde el catálogo de soluciones de Visual StudioInstall the Extension from the Visual Studio Marketplace

Ahora que se publica la extensión, instalarlo en Visual Studio y pruébela.Now that the extension is published, install it in Visual Studio and test it there.

  1. En Visual Studio, en el herramientas menú, haga clic en extensiones y actualizaciones... .In Visual Studio, on the Tools menu, click Extensions and Updates....

  2. Haga clic en en línea y, a continuación, busque TestPublish.Click Online and then search for TestPublish.

  3. Haga clic en Descargar.Click Download. A continuación, se programará para instalar la extensión.The extension will then be scheduled for install.

  4. Para completar la instalación, cierre todas las instancias de Visual Studio.To complete the installation, close all instances of Visual Studio.

Quitar la extensiónRemove the Extension

Puede quitar la extensión de Visual Studio Marketplace y de su equipo.You can remove the extension from the Visual Studio Marketplace and from your computer.

Para quitar la extensión de Visual Studio MarketplaceTo remove the extension from the Visual Studio Marketplace

  1. Abra la Visual Studio Marketplace sitio Web.Open the Visual Studio Marketplace website.

  2. En la esquina superior derecha, haga clic en publicar extensiones.In the upper-right hand corner, click Publish extensions. Seleccione el publicador que utiliza para publicar TestPublish.Pick the publisher that you used to publish TestPublish. Se muestra la lista de TestPublish.The listing for TestPublish is displayed.

  3. Haga doble clic en la entrada de extensión y haga clic en quitar le pedirá que confirme si desea quitar la extensión.Right-click on the extension entry and click Remove You will be asked to confirm if you want to remove the extension. Haga clic en Aceptar.Click OK.

Para quitar la extensión del equipoTo remove the extension from your computer

  1. En Visual Studio, en el herramientas menú, haga clic en extensiones y actualizaciones... .In Visual Studio, on the Tools menu, click Extension and Updates....

  2. Seleccione TestPublish y, a continuación, haga clic en desinstalar.Select TestPublish and then click Uninstall. A continuación, se programará la extensión para la desinstalación.The extension will then be scheduled for uninstall.

  3. Para completar la desinstalación, cierre todas las instancias de Visual Studio.To complete the uninstallation, close all instances of Visual Studio.