Adaptación de paquetes VSIX

Artículo
10/10/2023

Puede localizar un paquete VSIX creando un archivo Extension.vsixlangpack para cada idioma de destino y, a continuación, colocándolos en la carpeta correcta. Cuando se instala un paquete localizado, el nombre localizado de la extensión se muestra junto con una descripción localizada. Si proporciona un archivo de licencia localizado o una dirección URL que apunta a la información localizada, también se muestran.

Si el contenido del paquete VSIX incluye un VSPackage que agrega comandos de menú u otra interfaz de usuario, vea Localizar comandos de menú para obtener información sobre cómo localizar los nuevos elementos de la interfaz de usuario.

Estructura de directorios

Cuando un usuario instala una extensión, Extensiones y Novedades comprueba el nivel superior del paquete VSIX para una carpeta cuyo nombre coincide con la configuración regional de Visual Studio del equipo de destino. Si Extensiones y Novedades encuentra un archivo .vsixlangpack en la carpeta , sustituye los valores localizados en ese archivo por los valores correspondientes en el archivo .vsixmanifest. Estos valores se muestran cuando se instala la extensión. En el ejemplo siguiente se muestra la estructura de directorios de un paquete VSIX localizado en español (es-ES) y francés (fr-FR).

.
├── MyExtension.dll
├── Extension.vsixmanifest
├── [Content_Types].xml
├── es-ES
│   └── Extension.vsixlangpack
└── fr-FR
    └── Extension.vsixlangpack

Nota:

Las plantillas de proyecto compatibles con VSIX en el SDK de Visual Studio generan un manifiesto VSIX y le asignan el nombre source.extension.vsixmanifest. Cuando Visual Studio compila el proyecto, copia el contenido de ese archivo en Extension.VsixManifest en el paquete VSIX.

El archivo Extension.vsixlangpack

El archivo Extension.vsixlangpack sigue el esquema del paquete de idioma VSIX 2.0. Este esquema tiene un PackageLanguagePackManifest, que va seguido inmediatamente de un Metadata elemento secundario. El elemento Metadata puede contener hasta 6 elementos secundarios, , DisplayNameDescription, MoreInfo, License, ReleaseNotesy Icon. Estos elementos secundarios corresponden a los DisplayNameelementos secundarios , Description, MoreInfo, License, ReleaseNotesy Icon del Metadata elemento del archivo Extension.vsixmanifest .

Al crear un archivo vsixlangpack, debe establecer la Include in Vsix propiedad en true. De lo contrario, se omitirá el texto de instalación localizado.

Para establecer la propiedad Include in Vsix

En Explorador de soluciones, haga clic con el botón derecho en el archivo Extension.vsixlangpack y, a continuación, haga clic en Propiedades.
En la cuadrícula de propiedades, haga clic en Incluir en Vsix y establezca su valor trueen .

Ejemplo

Descripción

En el ejemplo siguiente se muestran partes pertinentes de un archivo Extension.vsixmanifest . El archivo también incluye el archivo Extension.vsixlangpack correspondiente para español. Los valores del paquete de idioma reemplazan los valores del manifiesto si la configuración regional de Visual Studio del equipo de destino está establecida en español.

Código

[Extension.vsixmanifest]

<?xml version="1.0" encoding="utf-8"?>
<PackageManifest ...>
  <Metadata ...>
    <DisplayName>Family Tree</DisplayName>
    <Description>This extension places a custom treeview control in the toolbox that is optimized for handling family tree information.</Description>
    <MoreInfo>http://www.contoso.com/products/FamilyTree.htm</MoreInfo>
    <License>Eula.rtf</License>
    <ReleaseNotes>ReleaseNotes.rtf</ReleaseNotes>
    <Icon>Icon.png</Icon>
  </Metadata>
  <Installation .../>
  <Dependencies .../>
  <Prerequisites .../>
  <Assets .../>
</PackageManifest>

[Extension.vsixlangpack]

<?xml version="1.0" encoding="utf-8"?>
<PackageLanguagePackManifest Version="2.0.0" xmlns="http://schemas.microsoft.com/developer/vsx-schema/2011">
  <Metadata>
    <DisplayName>Arbol de Familia</DisplayName>
    <Description> Esta extensión pone control personalizado en la caja de herramientas por manejar información de familia.</Description>
    <MoreInfo> http://www.contoso.com/products/es/ArbolDeFamilia.htm</MoreInfo>
    <License>Eula.rtf</License>
    <ReleaseNotes>ReleaseNotes.rtf</ReleaseNotes>
    <Icon>Icon.png</Icon>
  </Metadata>
</PackageLanguagePackManifest>

Consulte también

Title	Descripción
Referencia del esquema 2.0 del paquete de idioma VSIX	Un paquete de idioma VSIX describe la información de localización de un archivo de implementación .vsix.
Anatomía de un paquete VSIX	Describe la estructura y el contenido de un paquete vsix.
Localización de comandos de menú	Muestra cómo localizar otros recursos de texto en una extensión.

Compartir vía