Tutorial: Publicar una extensión de Visual StudioWalkthrough: Publish 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 en Marketplace, los desarrolladores pueden usar extensiones y actualizaciones para buscar extensiones nuevas y actualizadas.When you add your extension to the Marketplace, developers can use Extensions and Updates to browse 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 Install the Visual Studio SDK.

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

En este artículo usa una extensión predeterminada de VSPackage, pero los pasos son válidos para cada tipo de extensión.This article uses a default VSPackage extension, but the 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 su primera extensión: Hola mundo.For more information, see Create your first extension: Hello World.

Empaquetar la extensiónPackage your extension

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

    actualizar extensión vsixmanifest

  2. Compilar la extensión versión modo.Build your extension in Release mode. Ahora la extensión se empaqueta como un archivo VSIX en la carpeta \bin\Release.Now your extension is packaged as a VSIX in the \bin\Release folder.

  3. Hacer doble clic en el archivo 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, compilarla y probarla 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's installed correctly in the experimental instance of Visual Studio.

  1. En Visual Studio, inicie la depuración para abrir una instancia experimental de Visual Studio.In Visual Studio, start debugging 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.In the experimental instance, go to the Tools menu and click Extensions and Updates. La extensión TestPublish debe aparecer en el panel central y habilitarse.The TestPublish extension should appear in the center pane and be enabled.

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

Publicar la extensión de Visual Studio MarketplacePublish the extension to the Visual Studio Marketplace

  1. Asegúrese de que ha creado 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's 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 inicie 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. Esta opción desplaza a la página de administración para todas sus extensiones.This option navigates 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 are prompted to create one at this time.

    Cargar en Marketplace

  6. Elija el editor que desee utilizar para cargar la extensión.Choose the publisher you want to use to upload your extension. Puede cambiar los 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 extensión, puede elegir cargar un archivo VSIX directamente a Visual Studio Marketplace 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 ejemplo, la extensión, TestPublish.vsix se carga.In this example, the extension, TestPublish.vsix is uploaded. Arrastre y coloque la extensión o 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. Busque la extensión en la carpeta \bin\Release del proyecto.Find your extension 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 source.extension.vsixmanifest archivo desde 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:Find more details about each below:

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

    • Nombre para mostrar de su extensión.Display Name of your extension. Este nombre es rellena automáticamente desde el source.extension.vsixmanifest archivo.This name 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. Esta versión está rellena automáticamente desde el source.extension.vsixmanifest archivo.This version is auto-populated from the source.extension.vsixmanifest file.

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

    • Logotipo de que se utiliza para la extensión.Logo that is used for your extension. Este logotipo es rellena automáticamente desde el source.extension.vsixmanifest archivo si se proporciona.This logo is auto-populated from the source.extension.vsixmanifest file if provided.

      • Descripción breve de lo que hace la extensión.Short description of what your extension does. Esta descripción es rellena automáticamente desde el source.extension.vsixmanifest archivo.This description is 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.

      • Versiones compatibles de Visual Studio permite elegir qué versiones de Visual Studio funcionará la extensión en.Supported Visual Studio versions lets you choose which versions of Visual Studio your extension will work on. Solo se instala la extensión para esas versiones.Your extension is only installed to those versions.

      • ** Compatible de Visual Studio edition le permite elegir qué ediciones de Visual Studio funcionará la extensión en.**Supported Visual Studio edition lets you choose which editions of Visual Studio your extension will work on. Solo se instala la extensión para esas ediciones.Your extension is only installed to those editions.

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

      • Categorías.Categories. Elija hasta tres son una mejor opción para la extensión.Pick up to three that are a best fit for your extension.

      • Etiquetas son palabras clave que ayudan a los usuarios encontrar 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 Marketplace.Tags can help increase the search relevance of your extensions in the Marketplace.

      • Categoría de precios 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 al 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 permite a los usuarios dejar preguntas en la página de entrada de extensión.Allow Q&A for your extension lets users leave questions on your extension entry page.

  9. Haga clic en guardar y cargar.Click Save & Upload. Esta opción se retrocede para el publicador de la página de administración.This option takes 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 su 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ía en Marketplace seleccionando ver 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 ahora es pública.After clicking Make Public, your extension is now public. Buscar para la extensión de Visual Studio Marketplace.Search the Visual Studio Marketplace for your extension.

Agregar usuarios adicionales para administrar la 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. Vaya a la cuenta de publicador que desea agregar usuarios adicionales.Navigate to the publisher account you wish to add additional users to.

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

    Agregar usuarios adicionales

  3. A continuación, puede especificar la dirección de correo electrónico del usuario que desea agregar y conceder el nivel adecuado de acceso bajo seleccionar 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 options:

    • Creador: el usuario puede publicar extensiones, pero no se puede ver o administrar 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 pueden editar la configuración del publicador ni 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 extensiones, editar la configuración del publicador y administrar el acceso.Owner: The user can publish and manage extensions, edit publisher settings, and manage access.

Instalar la extensión de Visual Studio MarketplaceInstall the extension from the Visual Studio Marketplace

Ahora que se ha publicado 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 Online y, a continuación, busque TestPublish.Click Online and then search for TestPublish.

  3. Haga clic en Descargar.Click Download. Luego, la extensión está programada para instalación.The extension is then 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 el 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 usó para publicar TestPublish.Pick the publisher that you used to publish TestPublish. La lista de TestPublish aparece.The listing for TestPublish appears.

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

Para quitar la extensión de su 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. La extensión, a continuación, está programada para desinstalarla.The extension is then 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.